Axon
Route first, then load only the selected reference. Derive changing facts at runtime; never
substitute a remembered port, inventory, issue state, service status, or graph count.
Resolve context
Run one bounded context command before reading broadly:
tools/axon-context with [capability]
tools/axon-context on [unit-or-path]
The path is repository-relative: run it from the Axon checkout. The installed axon CLI
exposes the same surface as axon context with|on. Read references/shared-failure-policy.md
when any expected tool, overlay, service, graph, or remote is unavailable.
Select one mode
Work with Axon
Use this mode to discover or operate running capabilities, feeds, APIs, and health surfaces.
- Read
references/with-discovery.md.
- For reads, writes, ingestion, or operator actions, also read
references/with-operations.md.
- Read
references/shared-data-boundaries.md before handling personal, vault, or
cross-capability data.
Work on Axon
Use this mode to understand, review, plan, or change the repository.
- Read
references/on-orientation.md.
- Load only the additional leaf matching the task:
| Task |
Read |
| Architecture or ownership boundary |
references/shared-architecture.md |
| Data, secrets, provenance, or trust |
references/shared-data-boundaries.md |
| Decide where code or configuration belongs |
references/on-placement.md |
| Dependencies, language, shell, or the build |
references/on-dependencies-and-build.md |
| README, generated docs, manifests, Packs, or skills |
references/on-documentation.md |
| Tests, gates, review, or completion claims |
references/on-verification.md |
| Branch, commit, or PR |
references/on-changes.md |
For symbol-level traversal, use Graphify only when a current graph and Graphify integration
are present. Treat it as a drill-down after bounded orientation, never as the bootstrap.
Invariants
- Preserve unrelated worktree changes and resolve the exact target before editing.
- Keep public code and doctrine in Axon; keep private values and state in the active overlay.
- Never generate, reveal, move, or overwrite secrets without explicit authorization.
- Prefer manifests, registry output, self-model queries, and GitHub metadata over duplicated
prose.
- Report failed or unavailable checks exactly; do not turn missing optional context into a
successful validation claim.
1---2name: axon3description: Operates Axon and guides work on the Axon repository through dynamic discovery, bounded self-context, capability APIs, architecture placement, focused branches, and proportionate verification. Use when operating Axon services or feeds, diagnosing Axon, planning or coding inside the Axon repository, deciding where Axon code belongs, or handling Axon branches and PRs. Do not use for unrelated repositories, direct Home Assistant or device control, or generic prose and skill authoring with no Axon decision.4---56# Axon78Route first, then load only the selected reference. Derive changing facts at runtime; never9substitute a remembered port, inventory, issue state, service status, or graph count.1011## Resolve context1213Run one bounded context command before reading broadly:1415```bash16tools/axon-context with [capability]17tools/axon-context on [unit-or-path]18```1920The path is repository-relative: run it from the Axon checkout. The installed `axon` CLI21exposes the same surface as `axon context with|on`. Read `references/shared-failure-policy.md`22when any expected tool, overlay, service, graph, or remote is unavailable.2324## Select one mode2526### Work with Axon2728Use this mode to discover or operate running capabilities, feeds, APIs, and health surfaces.29301. Read `references/with-discovery.md`.312. For reads, writes, ingestion, or operator actions, also read32 `references/with-operations.md`.333. Read `references/shared-data-boundaries.md` before handling personal, vault, or34 cross-capability data.3536### Work on Axon3738Use this mode to understand, review, plan, or change the repository.39401. Read `references/on-orientation.md`.412. Load only the additional leaf matching the task:4243| Task | Read |44| --- | --- |45| Architecture or ownership boundary | `references/shared-architecture.md` |46| Data, secrets, provenance, or trust | `references/shared-data-boundaries.md` |47| Decide where code or configuration belongs | `references/on-placement.md` |48| Dependencies, language, shell, or the build | `references/on-dependencies-and-build.md` |49| README, generated docs, manifests, Packs, or skills | `references/on-documentation.md` |50| Tests, gates, review, or completion claims | `references/on-verification.md` |51| Branch, commit, or PR | `references/on-changes.md` |5253For symbol-level traversal, use Graphify only when a current graph and Graphify integration54are present. Treat it as a drill-down after bounded orientation, never as the bootstrap.5556## Invariants5758- Preserve unrelated worktree changes and resolve the exact target before editing.59- Keep public code and doctrine in Axon; keep private values and state in the active overlay.60- Never generate, reveal, move, or overwrite secrets without explicit authorization.61- Prefer manifests, registry output, self-model queries, and GitHub metadata over duplicated62 prose.63- Report failed or unavailable checks exactly; do not turn missing optional context into a64 successful validation claim.
larsboes