Source: 2026-04-20 multi-expert AADM audit. Skeptical-PM auditor.
Problem
CLAUDE.md says check docs/failures/ during ambiguity passes. Nothing verifies Claude actually did. START-HERE.md itself predicts the failures log decays into a graveyard within two sprints.
Fix
- Update
tooling/.claude/skills/dev.md — add step 0: list docs/failures/ filenames touching the task's domain (grep filenames for keywords from the task title), output the list in the response.
- Update
tooling/scripts/reconcile.py --strict to reject PRs whose /dev session log lacks a failures-checked: [filenames] line.
Acceptance
A /dev session that skipped the failures check fails CI, with the missing filenames listed in the failure message.
Source: 2026-04-20 multi-expert AADM audit. Skeptical-PM auditor.
Problem
CLAUDE.md says check
docs/failures/during ambiguity passes. Nothing verifies Claude actually did.START-HERE.mditself predicts the failures log decays into a graveyard within two sprints.Fix
tooling/.claude/skills/dev.md— add step 0: listdocs/failures/filenames touching the task's domain (grep filenames for keywords from the task title), output the list in the response.tooling/scripts/reconcile.py --strictto reject PRs whose/devsession log lacks afailures-checked: [filenames]line.Acceptance
A
/devsession that skipped the failures check fails CI, with the missing filenames listed in the failure message.