git:20260921.0c37d2f to git:20261022.607d7b6

13 added, 21 removed. Audit A to A.

@AGENTS.md

- <!--

- generated by /v:onboard from cited evidence on 2026-06-30; refresh with /v:onboard --refresh

- provenance: docs/superpowers/architecture/.onboard-manifest.json

- Thin bridge: AGENTS.md is the portable source of truth (read by Codex/Cursor/Copilot/Gemini).

- This file imports it in full via the @AGENTS.md line above; the section below adds only

- Claude-Code-specific pointers. Do NOT inline architecture prose here — point to the docs.

- -->

## Claude Code

- - Architecture knowledge base (generated, citation-verified): `docs/superpowers/architecture/`

- (`architecture.md`, `business-logic.md`, `tech-context.md`).

- - Repo conventions delta: `CONVENTIONS.md` (root).

- - Model policy: Opus by default, Sonnet for execution (the junior-task carve-out, plus the

- named scanning agents `code-archaeologist` / `doc-validator`, and the `transport` carrier that runs one

- clamped pipeline command per spawn), **never Haiku**

- (enforced by `scripts/lint-frontmatter.py` and CI). Fable is a dispatch-time override for

- business-critical work, never frontmatter. The `advisor` tool is part of the policy too:

- implementers and the spec-reviewer consult it at their own decision points, and the model that

- answers is the native `advisorModel` setting in `.claude/settings.json` — `fable` here, `opus` the

- alternative. It is a project setting, never agent frontmatter.

- - Recall over `docs/superpowers/**`: `/v:remember <query>`; re-index with `/v:memory-refresh`.

- - These docs are generated by `/v:onboard`; refresh with `/v:onboard --refresh`.

+ - This repository is built with Compound V 4 itself: brainstorm → pre-flights → plan → build →

+ verify, with run records in `docs/compound-v/runs/`. Load the plugin from this checkout with

+ `claude --plugin-dir .`, or run `/compound-v:init` once if it is installed.

+ - Model policy: Opus by default, Sonnet for lookups and mechanical tasks, never Haiku except the

+ read-only `v-memory` agent, Fable only by explicit choice. `scripts/lint-frontmatter.py` enforces it.

+ - Where things are: the CLI in `scripts/compound-v.py` + `scripts/cvcore/`, hooks in `hooks/`, the

+ cycle prose in `skills/`, subagents in `agents/`, design and plan in `docs/compound-v/`, the

+ evidence for v4 in `docs/v4/`, v3's docs in `docs/archive/v3/`. Conventions: `CONVENTIONS.md`.

+ - Tests: `python3 -m unittest discover -s tests/core -v`, then

+ `for t in tests/hooks/*.sh; do bash "$t"; done`, `python3 scripts/lint-frontmatter.py .` and

+ `shellcheck hooks/*.sh`.

+ - Never run a live headless worker with `--dangerously-skip-permissions` against this checkout; test

+ end to end in a throwaway repo.