context/components.md

<!--
GENERATED FILE - DO NOT EDIT BY HAND.
Generated by `scripts/extract_components.py`. Edit the extractor, then regenerate with:
    python scripts/extract_components.py --write
-->

# Component map

Every component this plugin ships, where it lives, and which platform reads it.

## Scope

- **Covers:** the plugin's own components - the one skill and its station
  references, agents, the hook, tools, build scripts, installers and
  templates - and which platform surface each serves.
- **Does not cover:** what each component *does*. That is `docs/skills.md`,
  `docs/architecture.md`, and the components themselves.

## The skill - 1

Akinator is one skill and one command. There is no `commands/` directory:
Claude Code lists every skill in its `/` menu, so the skill itself is the
command. Codex and Cursor read the generated copy in `.agents/skills/`.

| Skill | Claude Code | Codex | Cursor |
|---|---|---|---|
| `everything` (`skills/everything/SKILL.md`) | `/akinator:everything` | `$akinator` | `/akinator` |

## Station references - 23

Inside the one skill, opened when the work reaches that station. None is
a skill of its own, so none is an entry in any menu.

| Reference | Loop station | Load when |
|---|---|---|
| `akinator-adr` | 6 DOCUMENT | a decision was made between real alternatives that will be questioned later - a library or vendor choice, an architectural boundary, a... |
| `akinator-anti-gaming` | discipline | reviewing whether documentation work is real, when a checklist is about to be ticked, when tempted to weaken a failing check, or when a... |
| `akinator-audit` | 3 AUDIT | before planning work on anything claimed to already exist, when a doc or ticket says a feature is done, when inheriting unfamiliar code,... |
| `akinator-business-map` | 6 DOCUMENT | work touches money, plans, pricing, quotas, entitlements, limits, trials, refunds, proration, discounts, taxes or anything a customer is... |
| `akinator-contextify` | 9 CONTEXTIFY | a change alters a structural fact about the system - ownership, module boundaries, routes, ports, events, permissions, environment... |
| `akinator-coverage` | 12 VERIFY | to audit whether a repository's knowledge layer is complete, reachable and true - before claiming onboarding is done, when docs are... |
| `akinator-decide` | 4 PLAN / 12 VERIFY - decide or recommend with evidence | a choice has to be made - forced by implementation, asked for by the owner, raised by a prompt that contradicts a recorded decision, or... |
| `akinator-document-change` | 6 DOCUMENT | in the same batch as any code change, before the batch is called done. |
| `akinator-gate-economy` | 12 VERIFY | before running any lint, typecheck, test or build, and before any commit or push during multi-step work. |
| `akinator-index-sync` | 11 INDEX | whenever a knowledge artifact is created, renamed, moved or deleted - a rule, skill, doc, context map, ADR or memory entry. |
| `akinator-intake` | 1 ASK | at the start of every prompt that can change the repository, whenever a request has two readings that lead to materially different work,... |
| `akinator-memoize` | 10 MEMOIZE | a session produces a durable fact worth carrying forward - a decision made without an ADR, an owner preference, a surprise, a dead end, a... |
| `akinator-onboard` | install | installing Akinator's standing behavior into a repository for the first time, when a repo has no knowledge layer and an agent keeps... |
| `akinator-ops-map` | 6 DOCUMENT | a change alters how the system is deployed, migrated, restarted, rebuilt, recovered or rolled back - schema changes, dependency changes,... |
| `akinator-plan` | 4 PLAN | before implementing anything that touches more than one file or takes more than one step. |
| `akinator-product-map` | 6 DOCUMENT | building, changing or removing a user-facing feature. |
| `akinator-resource-guard` | discipline | before starting anything heavy - a build, a test suite, a container rebuild, a long-running process - and at the end of every task. |
| `akinator-router-sync` | 11 SYNC | whenever a change alters what an AI entry-point file should say - CLAUDE.md, AGENTS.md, CODEX.md, GEMINI.md, cursor rules, or any... |
| `akinator-rule-forge` | 8 RULE | a change establishes a constraint others must not break - an invariant, a forbidden pattern, a required call path, a boundary. |
| `akinator-skillify` | 7 SKILLIFY | a procedure was worked out during a task - a debugging path, a deployment sequence, a migration recipe, a setup dance, a diagnostic order. |
| `akinator-wiki` | every - document every prompt everywhere it lands | after every prompt that changes or decides anything - code, scope, a requirement, a business rule, a library, a priority, a plan - and at... |
| `akinator` | 2 RESOLVE - creed, loop, taxonomy | you need the full creed, the twelve-station loop, the knowledge taxonomy (where each kind of fact lives) or the non-negotiables in detail. |
| `procedure` | all - the full pass, step by step |  |

## Agents - 7

Read by Claude Code from `agents/`. Codex and Cursor have no equivalent
subagent surface; the skill applies the same review lenses inline there.

| Agent | Reviews for |
|---|---|
| `akinator-analyst` | Use at plan and verify stations when work involves numbers that carry business meaning - quotas, limits, prices, thresholds, rates,... |
| `akinator-business-owner` | Use at plan and verify stations when work touches revenue, pricing, entitlements, customer-visible commitments, or anything described as... |
| `akinator-cto` | Use at plan and verify stations when work introduces or changes an architectural decision - a boundary, a dependency, a protocol, a data... |
| `akinator-librarian` | Use at the end of every batch, before it is called done, to verify the knowledge delta. |
| `akinator-ops` | Use at plan and verify stations when a change touches schema, dependencies, build inputs, boot configuration or service topology. |
| `akinator-pm` | Use at plan and verify stations to check batch discipline and completion honesty. |
| `akinator-product-owner` | Use at plan and verify stations when work adds, changes or removes user-facing behavior. |

## Hooks - 1

Read by Claude Code from `hooks/hooks.json`, in exec form. Codex and
Cursor have no SessionStart equivalent, so the installer gives them the
same contract as an `AGENTS.md` block and an always-applied rule.

| Event | Command |
|---|---|
| `SessionStart` | `sh ${CLAUDE_PLUGIN_ROOT}/hooks/session-start.sh` |

## Tools - 9

Inside the skill, so they travel with it to every platform and run in
whatever repository it is installed into.

| Tool | Purpose |
|---|---|
| `skills/everything/scripts/akinator_coverage.py` | Akinator coverage checker - the mechanically verifiable knowledge invariants. |
| `skills/everything/scripts/akinator_distil.py` | Distil - turn what recurs into a rule proposal. |
| `skills/everything/scripts/akinator_ledger.py` | The Akinator ledger - what happened, so the next session does not rediscover it. |
| `skills/everything/scripts/akinator_rules.py` | Harden - rule evolution and conflict detection. |
| `skills/everything/scripts/akinator_scope.py` | Scope a pass to what actually changed, and budget the questions. |
| `skills/everything/scripts/akinator_wiki.py` | The living wiki - the repository as its own Confluence. |
| `skills/everything/scripts/build_brief.py` | Compose the context brief - what a new session actually reads. |
| `skills/everything/scripts/extract_libraries.py` | Generate the library wiki - one page per declared dependency. |
| `skills/everything/scripts/extract_stack.py` | Generate the stack map - dependencies and modules, extracted from the tree. |

## Build scripts - 4

Only meaningful inside this checkout; they never travel.

| Script | Purpose |
|---|---|
| `scripts/build_codex_pack.py` | Generate the portable pack - Akinator's one skill, for Codex and Cursor. |
| `scripts/extract_components.py` | Generate `context/components.md` from the tree. |
| `scripts/render_routers.py` | Render every AI entry-point file from one canonical contract. |
| `scripts/run_evals.py` | Run Akinator's behavioral evals against the fixture repositories. |

## Installers - 2

One installer for Claude Code, Codex and Cursor, in both shells.

| Installer | Purpose |
|---|---|
| `install.sh` | Akinator installer - Claude Code, Codex and Cursor, straight from GitHub. |
| `install.ps1` | Akinator installer for Windows - Claude Code, Codex and Cursor, from GitHub. |

## Templates - 14

What Akinator writes into target repositories. Every template ships a
filled example.

| Template | Filled example |
|---|---|
| `templates/adr.md` | `templates/examples/adr.md` |
| `templates/business-drift.md` | `templates/examples/business-drift.md` |
| `templates/business-logic.md` | `templates/examples/business-logic.md` |
| `templates/change-record.md` | `templates/examples/change-record.md` |
| `templates/context-map.md` | `templates/examples/context-map.md` |
| `templates/library-page.md` | `templates/examples/library-page.md` |
| `templates/memory.md` | `templates/examples/memory.md` |
| `templates/onboarding-mapping.md` | `templates/examples/onboarding-mapping.md` |
| `templates/ops-runbook.md` | `templates/examples/ops-runbook.md` |
| `templates/product-feature.md` | `templates/examples/product-feature.md` |
| `templates/requirement.md` | `templates/examples/requirement.md` |
| `templates/router.md` | `templates/examples/router.md` |
| `templates/rule.md` | `templates/examples/rule.md` |
| `templates/skill.md` | `templates/examples/skill.md` |

## Regenerate when

- Extractor: `scripts/extract_components.py`
- Regenerate with: `python scripts/extract_components.py --write`
- Drift check: `python scripts/extract_components.py --check` in CI - regenerates in
  memory and diffs; exits non-zero if they differ.
- Regenerate when: a reference, agent, hook, tool, script, installer or
  template is added, removed or renamed.

## Related

- Docs: `docs/architecture.md` - what these components do and how they
  interact
- Docs: `docs/compatibility.md` - the platform contracts each surface
  relies on
- Skills: `docs/skills.md` - the one skill and its station references