Arcflame Archon โ€” Architecture Governance for AI Agents

Reviewed Before It Ships

Archon isn't a linter โ€” it's a governance engine. Nine review lenses, an adversarial challenger, and stage gates that catch design flaws before they become production incidents.

๐Ÿ”

Nine Review Lenses

Architecture, API design, database schema, scalability, security, tradeoffs, features, implementation plans, and design documents โ€” each reviewed by a dedicated lens with enterprise-grade checklists.

โš”๏ธ

Challenge Mode

Actively tries to break your proposal. Adversarial scenarios โ€” scale shocks, data corruption, auth compromise, contract changes, multi-tenancy leaks, size ceilings โ€” each with severity and pre-build verification steps.

๐Ÿšฆ

Stage-Gated Governance

Five governance stages โ€” intent, architecture, plan, risk, completion. Every submission gets a structured verdict with a pass/fail gate, so agents know exactly what must change before proceeding.

๐Ÿง 

Engineering Memory

Every decision is recorded with its alternatives and reasoning. Outcomes close the loop โ€” future reviews reference past decisions automatically, so your architecture knowledge compounds.

Workflow Example
// Submit a design decision
review_database("I chose SQLite
  instead of Postgres")

// Archon returns:
Review {
  pros:  4    // zero-ops, local-first...
  cons:  3    // write concurrency ceiling...
  verdict: "fit-for-purpose"
  long_term: "revisit at 10k users"
}

// Challenge it:
challenge_proposal("single-node
  SQLite store") โ†’
  3 adversarial scenarios
  1 high-severity: multi-tenancy

Everything a Review Needs

Nine lenses, one adversarial challenger, five governance gates, and a memory that never forgets why.

9 Review Lenses

Architecture, API, database, scalability, security, design, feature, plan, and tradeoffs. Every lens ships with enterprise profiles, custom standards, and persona-aware feedback.

Challenge Mode

Adversarial review with 6 attack categories: scale shock, corruption, auth compromise, contract change, multi-tenancy, and size ceilings. Returns severity ratings and verification steps.

Governance Stages

Intent โ†’ Architecture โ†’ Plan โ†’ Risk โ†’ Completion. The submit_for_review contract returns pass/fail gates, prior-decision memory, and structured findings at every stage.

Engineering Memory

record_decision logs choices with alternatives and reasons. record_outcome closes the loop โ€” "worked" or "failed because...". query_decision_history brings memory into every new review.

Context Packs

Save architecture, requirements, constraints, and coding standards under a short id. Every future review references the pack by id โ€” no more resending large payloads.

Multi-Lens Reviews

One design, multiple reviewers. review_design accepts a reviewers list โ€” security, scalability, performance โ€” and returns one structured review per lens in a single call.

ADR Export to PolyDocs

export_review renders any review result as markdown โ€” and can attach a PolyDocs ADR plan for handoff. Review outcomes become decision records in your published docs.

Enterprise Profiles

Every review respects your profile โ€” enterprise, startup, or custom. Pass standards and personas to tailor rigor: OWASP sweeps for security, cost curves for scalability, migration concerns for databases.

Submit โ†’ Challenge โ†’ Gate โ†’ Remember

The governance loop from proposal to institutional knowledge in 4 steps.

1

Submit

The agent submits a proposal through the governance contract โ€” "we chose SQLite over Postgres", an API design, a scaling plan โ€” optionally referencing a saved context pack.

2

Review + Challenge

The right lens returns structured findings with actionable suggestions. Challenge Mode then attacks the proposal โ€” surfacing scale shocks, auth compromises, and tenancy leaks before users do.

3

Gate

submit_for_review issues the verdict: pass/fail per governance stage, with prior-decision memory attached. Agents know exactly what to fix before moving to the next stage.

4

Remember

Decisions and outcomes are recorded into engineering memory. Reviews become ADRs via PolyDocs export. The next proposal starts smarter than the last.

20 Tools, One Protocol

Every Archon capability is exposed as an MCP tool. Compatible with every MCP client.

Tool Description
review_architecture Review overall software architecture โ€” separation of concerns, data flow, dependencies, abstractions, state management.
review_api Review API design (REST/GraphQL/gRPC/MCP) โ€” naming, consistency, versioning, auth, pagination, idempotency, error envelopes.
review_database Review schema โ€” normalization, indexes, foreign keys, bottlenecks, migration concerns, growth policy.
review_scalability Review scaling behaviour โ€” caching, queues, async, horizontal scaling, SPOFs, cost curve under load.
review_security Security review โ€” auth, secrets, encryption, privilege escalation, input validation, OWASP sweep, compliance.
review_design Multi-lens design review โ€” pass a reviewers list and get one structured review per lens in a single call.
review_plan / review_feature / review_tradeoffs Implementation plans, feature proposals, and technology decisions โ€” pros, cons, long-term impact, enterprise opinion.
challenge_proposal Adversarial Challenge Mode โ€” attack scenarios across scale, corruption, auth, contracts, tenancy, and size limits with severity ratings.
submit_for_review The governance contract โ€” stages: intent, architecture, plan, risk, completion. Returns structured review, pass/fail gate, and prior-decision memory.
record_decision / record_outcome Log architecture decisions with alternatives and reasoning; close the loop with outcomes so future reviews learn.
query_decision_history Search engineering memory by decision text, project, or tags to bring relevant prior decisions into any review.
save/get/list_context_packs Persist architecture, requirements, constraints, and standards under short ids โ€” reference them in reviews without resending payloads.
export_review Render any review as markdown and optionally attach a PolyDocs ADR plan for documentation handoff.
archon_status Engine status โ€” version, LLM provider, enabled review lenses, and governance stages.

Five Gates. Zero Guesswork.

Every stage of the lifecycle has a contract โ€” submit once, get a verdict, move forward or fix.

1. Intent

Should we build this at all? Simplest alternative, complexity, risk, success criteria.

2. Architecture

Structure review โ€” concerns, data flow, dependencies, abstractions.

3. Plan

Work breakdown, sequencing, risks, acceptance criteria, rollback.

4. Risk

Adversarial challenge + security sweep before a line of code ships.

5. Completion

Final gate โ€” verdict, memory update, ADR export to PolyDocs.

Connect in Minutes

Archon is hosted at archon.arcflameinteractive.com/mcp. Get a token, configure your client, and go.

~/.config/opencode/opencode.jsonc
// ~/.config/opencode/opencode.jsonc
{
  "mcp": {
    "arcflame-archon": {
      "type": "remote",
      "url": "https://archon.arcflameinteractive.com/mcp",
      "headers": {
        "Authorization": "Bearer <your arcflame token>"
      },
      "enabled": true
    }
  }
}
~/.claude/settings.json
// ~/.claude/settings.json
{
  "mcpServers": {
    "arcflame-archon": {
      "type": "remote",
      "url": "https://archon.arcflameinteractive.com/mcp",
      "headers": {
        "Authorization": "Bearer <your arcflame token>"
      },
      "enabled": true
    }
  }
}
.cursor/mcp.json
// .cursor/mcp.json
{
  "mcpServers": {
    "arcflame-archon": {
      "type": "remote",
      "url": "https://archon.arcflameinteractive.com/mcp",
      "headers": {
        "Authorization": "Bearer <your arcflame token>"
      },
      "enabled": true
    }
  }
}
npx mcp-remote
# Bridge any local client to the remote MCP
npx mcp-remote https://archon.arcflameinteractive.com/mcp \
  --header "Authorization: Bearer <your arcflame token>"

Compatible with Claude Desktop, opencode, Cursor, Windsurf, and any MCP client. Access is issued with your Arcflame token.

Request Access

Ship Decisions, Not Regrets

Nine lenses. One challenger. Five gates. Archon reviews everything your agents design โ€” before production finds out.