Commit Graph

1 Commits

Author SHA1 Message Date
Boden Fuller 63c8b81ad6 feat(skills,docs): --evidence/--tdd council mode, --discovery-artifact rpi flag, stale-scope planning rule, docs/council-log/
Operationalizes the "pre-flight council validation against stale inherited
scope" pattern that caught the na-h61 M8 estimate inflation in the same
session. Five items from the summary table in today's retrospective.

## New flags

/council --evidence  (alias --tdd)
  Every finding must include 2+ test_assertions (grep, stat, go test, ...)
  that would mechanically prove the finding is real. Consolidation clamps
  verdict to WARN if any finding lacks assertions. Schema version bumps
  3 → 4. See skills/council/references/evidence-mode.md for the full
  schema, judge prompt additions, and a worked example.

/council --commit-ready
  Also writes the consolidated report to docs/council-log/YYYY-MM-DD-
  <mode>-<target-slug>.md (in addition to the transient .agents/council/
  path). Use when the verdict is load-bearing for a merged commit and
  the provenance should survive rebases. See docs/council-log/README.md.

/rpi --from=implementation --discovery-artifact=<path>
  Explicit "external discovery" entry point. When discovery has already
  been done by an upstream /council --evidence run (or a hand-written
  plan), pass the path and /rpi validates the artifact, extracts scope
  into an execution packet, and proceeds straight to /crank. See
  skills/rpi/references/discovery-artifact-mode.md. Formalizes the
  improvised pattern used in the na-h61 session earlier today.

## New planning rule

skills/plan/references/stale-scope-validation.md
  "Re-validate inherited scope estimates against HEAD before acting on
  deferred beads, handoff docs, or prior-session plans." Referenced from
  skills/plan/SKILL.md and skills/pre-mortem/SKILL.md. Includes the
  concrete na-h61 case study (395 LOC estimate collapsed to ~300 LOC
  once the council verified the staging infra already existed).

## New committable council artifact path

docs/council-log/
  README.md documents the convention and retention policy.
  2026-04-11-validate-m8-assumption-validation.md is the canonical
  example — the consolidation that caught the na-h61 scope inflation,
  now in git history so any future session can re-verify the reasoning.

## Files

skills/council/SKILL.md                             (+3 lines — new flags)
skills/council/references/evidence-mode.md          (new, ~180 lines)
skills/rpi/SKILL.md                                 (+3 lines — new flag)
skills/rpi/references/discovery-artifact-mode.md    (new, ~130 lines)
skills/plan/SKILL.md                                (+1 line — rule ref)
skills/plan/references/stale-scope-validation.md    (new, ~100 lines)
skills/pre-mortem/SKILL.md                          (+1 line — rule ref)
docs/council-log/README.md                          (new, ~90 lines)
docs/council-log/2026-04-11-validate-m8-...         (new, canonical example)

Follows the same-session retrospective request from the user after
closing na-h61. The CLI half (ao beads verify|lint|harvest) ships in a
separate commit.

Council parity: skills-codex/{council,rpi,plan,pre-mortem}/ exists and
is now drifted. Sync deferred per the CLAUDE.md deprecation note on
sync-codex-native-skills.sh — manual edit required, tracked as a
follow-up. Skill-lint remains pre-existing RED on main (unchanged by
this commit).
2026-04-11 08:35:39 -04:00