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: Runs nine named lenses (problem, goal-derivation, alternatives, constraint, cost, reversibility, failure, simplicity, scope) to test whether a design follows from its stated goals and constraints.
- Evidence-backed findings: Emits findings ranked by severity (blocking, substantive, minor), each with a quoted evidence pointer, confidence level, and a concrete resolution or settling question.
- Context-aware review: Reads the artifact end to end plus its parent proposals, superseded ADRs, and prior postmortems before critiquing, and hands off findings to the right authoring skill.
- Use Case: Ask an agent to pressure-test a proposal in
proposals/0003-feature.md; it reconstructs the design's argument, checks it against prior decisions and postmortems, and returns a ranked review without editing the document.
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.
