## What
Drops dead `ao evolve` command references from agent-facing docs. The
`ao evolve` CLI was deleted in #724 (ag-llni); these docs still pointed
agents at it.
- `AGENTS.md` / `CLAUDE.md` / `README.md` / `docs/dependencies.md`: the
substrate-loop line `` `ao rpi`/`ao evolve` loop `` → keeps the **live**
`` `ao rpi` `` and drops the **dead** `` `ao evolve` ``.
- `README.md` quickstart: removed the dead `ao evolve --max-cycles 1`
example (loop is now the `/evolve` skill; `ao rpi phased` already covers
terminal lifecycle).
- In-session skill refs (`/rpi`, `/evolve`) preserved — those exist.
## Scope (ag-354d slice 1 of N)
Agent-facing docs only. **Excluded:** gate-protected plan docs
(`docs/reference/agentops-domain-evolution-{bdd,plan}.md`, hexagonal-map
— `check-agentops-domain-evolution-plan.sh` requires the literal);
obsolete runner scripts (coupled, separate slice); cron-template
(already done in #724).
## Gate
`markdownlint`: 0 errors on all 4 files. The 5 local pre-push-gate reds
(`test-fixture parity gc-stale-worktrees`, `worktree
disposition`/canonical-root-dirty, `corpus freshness` 7d snapshot,
goals-validate, CMDAO-surface) are **pre-existing/non-diff** — same set
SageHarbor classified in PR #730/#69; a docs-only change touches none of
those surfaces. CHANGELOG-sync + link-integrity passed.
Closes-scenario: ag-354d#doc-refs
Bounded-context: BC5-Runtime
Evidence: README.md
## Docs site — boshu2.github.io/agentops
- Replace Jekyll minima with MkDocs Material (slate dark palette default)
- Landing hero scoped to .landing-hero (no gradient bleed on inner pages)
- Section landings (getting-started, architecture, reference, contracts, levels) with narrative ledes
- Generate skill catalog + per-skill pages from skills/*/SKILL.md at build
- Generate CLI reference from cli/docs/ at build (fails build on missing source)
- Fix every internal link via one-shot migration (scripts/migrations/2026-04-19-fix-docs-links.py)
- Wire mkdocs build --strict into pre-push gate (Check 25a)
- Replace .github/workflows/pages.yml with .github/workflows/docs.yml (actions/deploy-pages)
- README + docs/CONTRIBUTING updated with docs-build toolchain on-ramp
- tests/docs/validate-links.sh patched to understand mkdocs-generated paths
## RPI orchestrator strict-delegation contract
- Strict sub-skill delegation is now the default for /rpi, /discovery, /validation. No --full flag — always on.
- Canonical contract in skills/shared/references/strict-delegation-contract.md (plus Codex mirror)
- Forged learning with detection phrases + corrective actions (ao-inject-ready)
- Rename --no-lifecycle -> --no-scaffold in /discovery (Claude + Codex) with deprecation alias through v2.40.0
- Harden inline-work hotspots with orchestrator-owned markers in /crank STEPS 3a.3, 6.5, 8.7 + Inline Work Policy footer
- Flag consistency: --auto and --interactive scopes documented; --complexity syntax formalized
- CHANGELOG [Unreleased] documents + scaffolds; runtime hook enforcement explicitly deferred
## fix(hooks): go-test-precommit skips when no Go files staged
- Previously ran go vet + go build unconditionally, blocking non-Go commits when Go toolchain was missing or at a different version
- Now checks staged diff and exits cleanly if no *.go or go.{mod,sum,work} files are staged
- Applied to both hooks/ (source) and cli/embedded/hooks/ (synced)
Provenance: full RPI lifecycle with strict delegation at every phase boundary (Phase 1 Skill(discovery) -> Phase 2 Skill(crank) -> Phase 3 Skill(validation) -> Skill(vibe), Skill(post-mortem), Skill(retro)).
Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
Move config env vars, Knowledge Ledger lifecycle, parallel RPI diagram,
evolve setup, recovery/hygiene, and vibe checks out of README into their
natural doc homes. Deep Dive section collapsed to summary + link table.
Phase details and Built On attribution preserved.
New: docs/evolve-setup.md
Appended: docs/how-it-works.md (phased/parallel RPI)
Appended: docs/context-lifecycle.md (knowledge ledger flow)
Bo