What problem does it solve? Existing specifications often contain ambiguities, stale claims about the codebase, and hidden failure modes that only surface during implementation. This Skill hardens an already-written spec by subjecting it to three independent reviews and reconciling the findings into a single improved document. ## Core Features & Use Cases - Diamond fan-out review: Freezes the spec into a hashed packet, then runs three isolated legs — requirements analysis, verification against the real codebase, and adversarial stress-testing — so their conclusions stay comparable and independent. - Ground-truth verification: The verification leg opens actual repository files and checks every claim the spec makes about existing code, APIs, and conventions with file:line citations. - Reconciliation and gated rewrite: Merges duplicate findings, dispositions every Critical and Major issue, then rewrites the spec in place with a version bump, Review Findings table, and Open Questions table. - Use Case: After generating a feature spec with /feature-spec, run /spec-review on doc/features/005-record-expense/spec.md to catch contradictions, missing failure modes, and wrong assumptions about the codebase before implementation begins. ## Quick Start Ask the AI to run /spec-review on the path to your existing spec file, for example /spec-review doc/features/005-record-expense/spec.md.
