What problem does it solve? Design documents can be complete and factually correct yet still solve the wrong problem, rest on strawman alternatives, or reintroduce past failures. This Skill performs a soundness review of proposals, specs, and decision records, producing ranked findings instead of edits. ## Core Features & Use Cases - Soundness lenses: Nine named lenses (problem, goal-derivation, alternatives, constraint, cost, reversibility, failure, simplicity, scope) test whether the design follows from its stated goals and constraints. - Context-aware reading: Reads the artifact end to end plus its parent proposals, superseded ADRs, and prior postmortems before critiquing, catching designs that contradict accepted decisions or repeat known failures. - Ranked, evidence-backed findings: Every finding carries a claim, a quoted evidence pointer, a severity (blocking/substantive/minor), and a resolution, then routes fixes to the right authoring skill. - Use Case: Before accepting a spec for a new sync subsystem, ask for a design review; the Skill reconstructs the argument, flags that the migration plan contradicts an accepted ADR, and returns a blocking finding with the exact quoted passage. ## Quick Start Ask the agent to review the design in proposals/0003-feature.md and tell you whether it is sound and what you should block on.
