fab8e72d97
Comprehensive analysis of v3 found ~24 minor issues (no critical bypasses). V3.1 closes most via clarifications to prepare for writing-plans skill in next session. Additions: - TL;DR at top — fast orientation for implementer - 10.1 Function and registry references (nodeMatches source, registry source docs/registry/nodes.yaml, SDD-skill impact, coverage-hint to recovery resolution) - 10.2 State file schemas (8 files: router-state, chain-state, askuser-decisions, router-gate-decisions, subagent-inheritance, coverage-hint, gate-errors, gate-config) - 10.3 Test strategy: ~150 unit + 10-15 integration + 10-15 golden snapshot + 5-7 smoke - 10.4 Success metrics: quantitative (override drops to 0, gate-decisions growing) + qualitative (lockout < 5/100, correct% > 60%) + acceptance criteria - 10.5 Rollback plan (3 levels: hook off / revert commits / v2 baseline) - 10.6 Stages and parallelism: 6-9h wall-clock with SDD parallelism vs 13.5-20h sequential No architectural changes — v3.1 only clarifies what implementer needs to know without making implicit decisions. Spec versions in git: - v1:7a43c175- v2:b510a758- v3:b632bcba- v3.1: this commit Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>