Full Source

Every file Archon ships, indexed by role. Each entry below opens a rendered view of the file's contents — code is embedded via VitePress snippet inclusion so the rendered page stays in sync with the source of truth under docs/source-files/.

How this section works. docs/source-files/ contains an exact mirror of the Archon source tree. Every Markdown page in /source/ uses VitePress <<< snippet syntax to embed the corresponding file. This lets you read the source inline, while keeping the source itself a single source of truth.

Layout

docs/source-files/
├── .archon/                     # Portable cognitive core + project-agnostic state
│   ├── soul.md                  # Identity, cognitive loop, ownership, guardrails
│   ├── soul/
│   │   ├── delivery.md          # demand-mode extension
│   │   └── review.md            # plan + review-mode extension
│   ├── domain-lenses/           # Pre-Verdict lens index (5 lenses + 16 tools)
│   ├── contracts/               # Portable governance contract (YAML)
│   ├── templates/               # Run-State schema + run row template
│   ├── dashboard/               # Local observability UI (reference impl)
│   ├── extensions/              # Optional runtime extensions (demand-pool, …)
│   └── VERSION
├── .cursor/                     # Platform surface (rules · commands · agents · skills)
│   ├── commands/                # archon, archon-plan, archon-demand, archon-review, archon-dashboard
│   ├── agents/                  # archon-reviewer, archon-capture-auditor
│   ├── rules/                   # archon.mdc, archon-wake.mdc, archon-heartbeat.mdc
│   └── skills/                  # archon-framework, archon-git-commit, archon-signs, archon-comic-doc-refactor, blink-dispatch, external-agent-patterns
├── scripts/                     # Portable helpers (stdlib / zero-dep)
│   ├── archon-check.py          # Governance contract checker
│   ├── archon-check.sh          # Bash port
│   ├── archon-run-state.mjs     # Run-State v2 helpers
│   ├── archon-claim-verifier.mjs# ADR-27 claim verifier
│   ├── archon-records.mjs       # Records-folder helpers (ADR-22)
│   ├── archon-records-fold.mjs  # Archive rotation
│   ├── archon-records-migrate.mjs # Legacy → records-folder migration
│   ├── export-archon-core.mjs   # Export pipeline (source → standalone kit)
│   └── test-archon-export.mjs   # Contract test for the export pipeline
├── tools/
│   └── archon-cli/              # archon init / doctor / export CLI
├── LICENSE                      # Apache-2.0
└── NOTICE                       # Attribution notices

By role

Cognitive core

The soul defines who the agent is: identity axioms, ownership contract, cognitive loop, autonomy principles, evolution axis, guardrail system. Two mode extensions load on demand.

• .archon/soul.md — resident core, section-scoped hot-path.
• .archon/soul/delivery.md — demand mode.
• .archon/soul/review.md — plan + review mode.

Commands

Entry points that route a user message into a governed lifecycle.

• archon.md — top-level routing.
• archon-plan.md — plan mode.
• archon-demand.md — delivery mode.
• archon-review.md — review mode.
• archon-dashboard.md — governance state dashboard.

Sub-agents

Cross-family sub-agents for independence (ADR-independence rule).

• archon-reviewer.md — cycle-level review.
• archon-capture-auditor.md — per-delivery hygiene.

Rules

Universal guardrails that load into every session for Archon-touching files.

• archon.mdc — decoupling rule + universal module guard.
• archon-wake.mdc — wake-word routing.
• archon-heartbeat.mdc — session cadence / debt signals.

Skills

Horizontal reusable capabilities triggered by keywords / file types.

• archon-framework — framework primer.
• archon-git-commit — Archon-governed commit workflow.
• archon-signs — trigger-indexed reasoning capsules.
• archon-comic-doc-refactor — doc refactor into comic explainers.
• blink-dispatch — sub-agent dispatch gate.
• external-agent-patterns — external-framework evaluation.

Domain lenses

Pre-Verdict lens index used at the Decision Gate. 5 lenses + 16 domain-specific tools.

• Overview · README · registry.yaml
• Lenses: dev · design · platform · ecosystem · capability
• Templates: lens · tool
• Tools: see the Domain Lens Tools group in the sidebar for the 16 individual tool files.

Contracts

Portable governance contract, consumed by the archon-check.py and archon-check.sh checkers.

• Overview · governance-contract.yaml

Runtime templates

Consumed by archon-run-state.mjs to initialize a new delivery's ephemeral state.

• Overview
• run.template.md
• run-state.schema.json

Scripts

Portable helpers. All scripts are stdlib / zero-dep and can run from an adopter project without any additional install.

• Overview
• archon-check.py · archon-check.sh
• archon-run-state.mjs · archon-claim-verifier.mjs
• archon-records.mjs · archon-records-fold.mjs · archon-records-migrate.mjs
• export-archon-core.mjs · test-archon-export.mjs

Archon CLI

Human-facing wrapper (init · doctor · export).

• Overview · README · CHANGELOG · package.json
• Entry: bin/archon.mjs
• Lib: common.mjs · init.mjs · doctor.mjs · export.mjs

Dashboard (reference implementation)

Local observability UI that reads .archon/ ledgers. Distilgent's own implementation is mirrored here verbatim; adopters can fork or replace it.

• Overview — file-by-file index.

Extensions

Optional runtime modules that plug into the cognitive loop.

• Overview
• demand-pool — backlog queue for pending demands.

Miscellaneous

• VERSION — pinned Archon framework version.
• LICENSE — Apache-2.0.
• NOTICE — attribution notices.