## What
Sweep 16 stale CLI snippets across `skills/` and `skills-codex/` that
referenced commands/flags removed from the `ao` CLI. Unblocks the
release `skill-cli-snippet` gate —
`scripts/validate-skill-cli-snippets.sh` now reports **0 failures** (was
16).
## Three fix patterns (verified against the built `ao` binary)
1. **`ao init --hooks`** — the `--hooks` flag is gone (hooks removed).
`ao init` is hookless (only `--stealth`). Fixed snippets to `ao init`
and reframed surrounding prose: hooks are opt-in / author-it-yourself
via the `hooks-authoring` skill, not an `ao` command/flag.
2. **`ao hooks install --force` / `--full` / `ao hooks test`** — the `ao
hooks` command is gone entirely (`unknown command`). Removed the broken
snippets and reframed the quickstart troubleshooting "Optional Hooks"
sections to hookless (CI is the authoritative gate).
3. **`ao inject --query`** — wrong: `ao inject` uses `--context`; the
corpus-query command is **`ao corpus inject --query`**. Fixed
`using-gc/reference-city.md` (canonical + codex). For
`domain/context-compiler.md` the line also carries `--apply-decay
--max-tokens` (which live on `ao inject`, NOT `ao corpus inject`), so
the surgical fix there was `--query` → `--context` on the existing `ao
inject` command.
## Sites fixed (canonical + codex twins in lockstep)
- bootstrap: `SKILL.md` Step 6 + `references/related-runbooks.md` (×2
trees)
- quickstart: `SKILL.md` Hook-activation row +
`references/troubleshooting.md` (×2 trees)
- domain: `references/context-compiler.md` (canonical only — no codex
twin)
- using-gc: `references/reference-city.md` (×2 trees)
`regen-codex-hashes.sh` refreshed the affected
`.agentops-generated.json` + manifest.
## Gate results (all green)
- `scripts/validate-skill-cli-snippets.sh` → **passed, 0 failures**
- `tests/scripts/test-skill-cli-snippets.sh` → 4 PASS / 0 FAIL
- `skills/heal-skill/scripts/heal.sh --strict` → All clean
- `scripts/audit-codex-parity.sh --skill
{bootstrap,quickstart,using-gc,domain}` → all passed
- `scripts/regen-codex-hashes.sh --check` → All hashes up to date
- `cd cli && make build` → green
- markdownlint (cli2) on all changed `.md` → clean
Closes-scenario: ag-d0t#snippet-sweep
Bounded-context: BC1-Corpus
Evidence: scripts/validate-skill-cli-snippets.sh
#275's billboard refactor thinned process-skill SKILL.md files and moved
detail into references/, but the validate contracts still grepped SKILL.md.
skill-lint + smoke-test: relax content-presence checks in crank/implement/
post-mortem/swarm validate.sh to scan the skill as a unit (SKILL.md +
references/); structural/identity checks stay SKILL.md-only. test-first-smoke
updated to match relocated SPEC/TEST WAVE + Step 0/4 headings.
skill-lint line caps: trim flywheel 310 -> 286 (cap 300), using-agentops
261 -> 239 (cap 250) by removing redundant prose, no content lost.
skill-integrity: link 3 orphaned references (crank/branch-isolation,
validation/flags + release-readiness-gates).
codex parity: regenerate stale skills-codex source hashes (77 skills).
Local: run-all.sh PASS, heal.sh --strict clean, smoke-test PASS.
Adds a 2400-char aggregate budget for skills-codex/*/SKILL.md `description:`
fields in tests/skills/test-token-budgets.sh, then trims each skill's description
to fit (catalog now 2146/2400). Both Claude and Codex SKILL.md descriptions
are kept in sync; codex .agentops-generated.json hashes regenerated.
Adds --repair-shape to scripts/audit-codex-hooks.sh: when ~/.codex/hooks.json
is missing or in legacy-flat shape, rewrites it from hooks/codex-hooks.json
with the active plugin_root (read from .agentops-codex-install.json) and
backs up any prior file. Covered by new test_repairs_legacy_flat_shape.
Memory decay (4 .agents/ files) bumped by the SessionStart inject hook.
Adds a Step 0.5 "Recommend bd" section to skills/bootstrap/SKILL.md (and
its codex variant). When `bd` is missing, /bootstrap reports a one-line
recommendation pointing at `scripts/install-bd.sh` and continues — it
never executes the installer on the user's behalf. Mirrors the existing
HAS_AO graceful-degrade pattern.
- HAS_BD probe added to Step 0
- External Tools subsection documents bd as optional/recommended
- Step 6 report row + Troubleshooting row for the new state
- skills/bootstrap/scripts/validate.sh: structural check that SKILL.md
mentions install-bd.sh and probes bd
- tests/scripts/install-bd.bats: wiring assertion case (5/5 OK)
- skills-codex/bootstrap/ mirrored; codex hashes regenerated
Rename the athena skill to compile — a descriptive name that communicates
what it actually does. Extend with Karpathy's LLM Knowledge Bases architecture:
- New compile phase: LLM reads raw .agents/ artifacts and produces interlinked
markdown wiki at .agents/compiled/ with index.md, log.md, backlinks
- New lint phase: detects contradictions, orphan pages, stale claims, coverage gaps
- Pluggable compute backend via AGENTOPS_COMPILE_RUNTIME (ollama|claude|openai)
- Hash-based incremental compilation (only recompile changed sources)
- compile.sh engine with security fixes (no shell injection, path traversal guard)
- Full rename across 93 files: skills, docs, CLI, tests, hooks, scripts, codex
Existing Mine → Grow → Defrag cycle preserved as phases within the larger
compile workflow. No vector DB — compiled wiki IS the retrieval layer.
Bo