# Axon

> 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.

- Skill: `larsboes/axon` (Agent Skill, multi-file: 12 files)
- Install (CLI): `npx skillmds@latest add larsboes/axon`
- Raw SKILL.md: https://api.skillmd.com/api/skills/larsboes/axon/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Product & Planning
- Author: larsboes (https://skillmd.com/u/larsboes)
- Updated: 2026-09-17
- Page: https://skillmd.com/skills/larsboes/axon

---


# 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:

```bash
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.

1. Read `references/with-discovery.md`.
2. For reads, writes, ingestion, or operator actions, also read
   `references/with-operations.md`.
3. 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.

1. Read `references/on-orientation.md`.
2. 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.