plan-reviewer

Installation
SKILL.md

Plan Reviewer

Strengthen an existing implementation plan through adversarial questioning before coding starts.

  • IS: Adversarial review of an existing plan: pointed questions one at a time, claim verification against local code and docs, resolutions written directly into the plan file
  • IS NOT: Creating a plan from scratch (use plan-creator), reviewing a code diff (use pr-reviewer), or a gate that approves and rejects

Objective: drive all six dimensions to 5/5. Work each sub-5 dimension upward, re-scoring after each round, until every dimension is 5/5 or provably stalled on a decision only the user can make.

Core Lens

Filter every question through these principles, in priority order:

  1. KISS: is this the simplest thing that could work? Could a junior understand the plan in one read?
  2. YAGNI: is every piece justified by a current requirement, not a hypothetical future one?
  3. Tracer bullet: does the plan deliver a minimal working slice across the full stack first?
  4. Small functions: are responsibilities clearly separated? Does each piece do one thing well?
  5. Easier to change: does the design isolate concerns so future changes are local?
  6. Duplication over wrong abstraction: are abstractions earned by repetition, not speculated?
Installs
175
GitHub Stars
57
First Seen
May 10, 2026
plan-reviewer — mblode/agent-skills