Source: 2026-04-20 multi-expert AADM audit. Methodology auditor.
Problem
tooling/.claude/skills/prd.md:25 refuses if "the previous sprint has no .lock." No carve-out for v1 (where there is no previous sprint).
No /hotfix skill — sprint_gate.py will block a P0 production fix in sprints/v3/ if v2/.lock is missing for any reason.
No /refactor skill — /dev requires a Satisfies: line citing requirement IDs, but a pure refactor satisfies no design-doc ID. Engineers either fabricate or skip the method.
No /spike skill — method doc explicitly excludes spikes (method/.../v3_2_1.md:58-64) but provides no workflow at all.
Fix
prd.md: add v1-bootstrap exception ("no previous sprint" passes the gate; require Phase-0 design-doc-signed-off marker instead).
tooling/.claude/skills/hotfix.md: explicit gate bypass + required follow-up retro entry naming the bypass.
tooling/.claude/skills/refactor.md: allows Satisfies: TECH-DEBT-N from a docs/tech-debt.md registry.
tooling/.claude/skills/spike.md: timeboxed, output is a decision memo, no Satisfies: requirement.
Acceptance
All four lifecycles (v1 bootstrap, hotfix, refactor-only sprint, spike) have a documented runnable path. prd.md cleanly handles v1.
Source: 2026-04-20 multi-expert AADM audit. Methodology auditor.
Problem
tooling/.claude/skills/prd.md:25refuses if "the previous sprint has no.lock." No carve-out for v1 (where there is no previous sprint).No
/hotfixskill —sprint_gate.pywill block a P0 production fix insprints/v3/ifv2/.lockis missing for any reason.No
/refactorskill —/devrequires aSatisfies:line citing requirement IDs, but a pure refactor satisfies no design-doc ID. Engineers either fabricate or skip the method.No
/spikeskill — method doc explicitly excludes spikes (method/.../v3_2_1.md:58-64) but provides no workflow at all.Fix
prd.md: add v1-bootstrap exception ("no previous sprint" passes the gate; require Phase-0 design-doc-signed-off marker instead).tooling/.claude/skills/hotfix.md: explicit gate bypass + required follow-up retro entry naming the bypass.tooling/.claude/skills/refactor.md: allowsSatisfies: TECH-DEBT-Nfrom adocs/tech-debt.mdregistry.tooling/.claude/skills/spike.md: timeboxed, output is a decision memo, noSatisfies:requirement.Acceptance
All four lifecycles (v1 bootstrap, hotfix, refactor-only sprint, spike) have a documented runnable path.
prd.mdcleanly handles v1.