Commit Graph

5 Commits

Author SHA1 Message Date
boshu 4a7c6a0701 feat(gates): docs.skill-refs --all-docs — widen the 6-file skill-ref gate to live docs + SKILL-ROUTER sync (age-gate-the-ungated-egwt.5)
Add an --all-docs mode to check-doc-skill-refs.sh that scans the union of the
pinned doctrine files PLUS the full LIVE docs/** set (scripts/lib/docs-scope.sh),
ratcheted by a new filename-pinned shrink baseline
(scripts/.docs-skill-refs-baseline). Two-way ratchet: a non-baselined live doc
with a dead `/skill` ref FAILS; a baselined file that no longer offends FAILS
demanding a prune. Detection stays slash-syntax + headings only (never bare
skill names). Default (no-flag) behavior is byte-identical.

docs/SKILL-ROUTER.md (the curated router) is covered by --all-docs (a live
docs/** file, never baselined) so a dead ref there FAILS strict, without
perturbing the byte-identical default doc count.

seed.go docs.skill-refs row: Match widened to docs/** + the baseline + the lib;
Args set to [--all-docs --strict]. Burn-down (long-tail only): repointed retired
`/retro`->/post-mortem, `/vibe`->/validate, `/ratchet`->/flywheel,
`/research-multi`->/research, `/implement-wave`->/crank, and reworded the
retired `/dream` across 13 docs/levels + docs/workflows + docs/philosophy
pages, then pruned them from the baseline (91 -> 78 offenders). Owner-locked
pages (comparisons/getting-started/positioning) stay baselined.

Bats twin tests/scripts/check-doc-skill-refs-all-docs.bats covers all the modes.
2026-07-01 18:12:53 -04:00
Boden Fuller 23769dff5f fix(beads): resolve canonical ledger from worktrees (age-worktree-beads-ledger-guard-c1u1) 2026-06-19 22:34:07 -04:00
Boden Fuller db911aad56 docs(destale): wave 1 — P1 docs stop referencing retired tech (age-docs-staleness-remediation-cko)
The 16 highest-risk live docs (onboarding, L3/L5 tutorials, demo storyboards,
gate-authority doctrine, troubleshooting) that would actively mislead an agent.
13 rewritten to current truth, 3 historical-by-nature docs bannered RETIRED:

- bd <cmd> → BEADS_DIR=$PWD/_beads br <cmd>; .beads/issues.jsonl → _beads/;
  pip install beads → install br; dropped bd vc status/Dolt → git -C _beads push
- Gas City/gastown/gt-sling/mayor/using-gc → NTM + MCP Agent Mail; /rpi & ao rpi
  framed load-bearing legacy, operating loop is primary
- "CI is authoritative / branch protection blocks main / open a PR" → push-to-main,
  local pre-push Go gate is routine authority, validate.yml a backstop
- bannered RETIRED/HISTORICAL (body kept): runbooks/bd-server-mode-closeout.md,
  runbooks/beads-failure-recovery.md, contracts/remote-compute.md

Verified: git scope = exactly the 16 P1 files; independent grep finds no residual
live stale pattern in rewrites; all 3 banners present. Wave 2 (P2/P3) next.

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
2026-06-17 10:13:30 -04:00
Boden Fuller 2ce3def503 evolve: cycle 28 -- na-7o2 improved 2026-03-06 22:08:51 -05:00
Boden Fuller 37d4b5b2ae Merge branch 'codex/rpi-supervisor-cli' into main 2026-02-21 19:41:50 -05:00