Intent snapshots and verdict artifacts now default to
.agents/ao/{intents,verdicts}/sha256/ so all session/evidence state lives
under .agents/ as the single agent-state root. Updates validate.py defaults,
ao init/status/demo, the cathedral conformance probe, craft_score.py digest
resolution, and every doc/skill mention. Existing artifacts migrated in
place; .agentops/ retains only the tracked project config.yaml.
Co-authored-by: Cursor <cursoragent@cursor.com>
Migrate SYSTEM and AGENTS-{WORKFLOW,CI,CODEX,RUNTIME} into docs owners,
retarget consumers, rewrite the split gate, and craft-densify AGENTS,
README, PRODUCT, and GOALS under the documentation authority graph.
Co-authored-by: Cursor <cursoragent@cursor.com>
Completes the staleness epic. 42 P2/P3 files converged to current truth
(bd→br, gascity/gt-sling/mayor→NTM+Agent Mail, daemon→substrate, hooks→hookless,
CI-authoritative→push-to-main local Go gate); GLOSSARY's 18 dead skills/* links
repaired to ../skills/<name>/SKILL.md (19 links, 0 broken); contracts/runbooks
that freeze retired-system nouns bannered RETIRED/HISTORICAL rather than rewritten.
Adds the Arc-7 ratchet — scripts/check-docs-no-retired-tech.sh — which scans all
live docs (260) for retired-subsystem commands/phrases and fails on regression.
A doc opts out by carrying a RETIRED/HISTORICAL/SUPERSEDED banner (or being an
ADR / migration / upgrade / index doc), and lines that describe a removal are not
flagged. Running it caught 12 stale refs the deep-read sweep missed — a
"CI is the authoritative gate" cluster (agentops-brief, primitive-chains,
INCIDENT-RUNBOOK, knowledge-flywheel, philosophy, software-factory), stale
hook-smoke in release-e2e-checklist, and GasCity descriptors in
contracts/index + SCHEMAS + strategic-direction — now fixed. Gate: PASS.
Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
## What
The `regen-all` finalizer already shipped (`ag-jima` —
`scripts/regen-all.sh` + Makefile `regen-all`/`regen-check`), but was
referenced **only** in `skills/evolve`. None of the canonical
contributor docs pointed to it, so an agent adding a skill/command still
had no pointer to the one-command finalizer and would do the serial CI
scavenger hunt — the exact `ag-nk67` / PR #598 pain (9 CI rounds, 0
feature failures).
This closes the **"document the pre-push sweep"** half of `ag-nk67`.
(The finalizer core was the other half, already done.)
## Changes — `docs/agent-workflow-reference.md`
- **Key Scripts:** add `make regen-all` (composite finalizer) + `make
regen-check` (no-write drift companion) at the top.
- **Quick Local Sanity Checks:** add the regen-all line for
skill/command additions.
- **"Skill counts must be synced" rule:** note `regen-all` is the
superset of `sync-skill-counts.sh`.
## Not done (deliberately)
No `pre-push-gate.sh` wiring — that gate was **retired** (`soc-g2r9`, PR
#357); CI is the sole authoritative gate.
## Evidence
Docs-only; markdownlint clean; no new relative links introduced. Claims
verified against the actual `scripts/regen-all.sh` generator list.
Closes-scenario: ag-hlng#regen-all-discoverability
Bounded-context: BC5-Runtime
Evidence: docs/agent-workflow-reference.md
boshu