← ClaudeAtlas

reviewing-planslisted

Adversarial review of plans, specs, and proposals before execution — verifies references, extracts and rates assumptions, runs a pre-mortem, hunts what's missing, then pressure-tests its own findings for confidence and real-world severity. Use before executing an implementation plan, when asked to review a spec or proposal, or as the quality gate after writing-plans.
bygama/skills · ★ 0 · Code & Development · score 72
Install: claude install-skill bygama/skills
# Reviewing plans <!-- Methodology distilled from OMC's critic + analyst agents (MIT), 2026-07-30. Provenance: Context-Engineering repo, docs/adrs/ADR-002-omc-salvage.md. --> A false approval costs 10-100x a false rejection — but manufactured outrage destroys the reviewer's signal. Both discipline and calibration. ## Protocol 1. **Pre-commit.** Before reading in detail, predict the 3-5 most likely problem areas for this kind of plan. Investigate those specifically — deliberate search beats passive reading. 2. **Verify everything.** Extract every file reference, function name, and technical claim; check each against the actual codebase (Read/Grep/git). An assertion you didn't verify is not evidence. 3. **Rate the assumptions.** List explicit AND implicit assumptions; rate each VERIFIED (evidence exists) / REASONABLE (plausible, untested) / FRAGILE (could easily be wrong). Fragile ones are the priority targets. 4. **Pre-mortem.** "This plan was executed exactly as written and failed." Generate 5-7 concrete failure scenarios; every scenario the plan doesn't address is a finding. Include rollback: if step N dies midway, what's the documented recovery? 5. **Scan for ambiguity.** Per step: "could two competent developers interpret this differently?" If yes, quote it, state both readings and the cost of the wrong one. 6. **Hunt what's MISSING.** The biggest differentiator. Load [references/gap-taxonomy.md](references/gap-taxonomy.md) and