dev-plan-reviewer

Validate PLAN.md against SPEC.md for completeness and task readiness.

19|5|Updated Jan 4, 2026
One-click install
npx skills add https://github.com/edwinhu/workflows --skill dev-plan-reviewer
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: dev-plan-reviewer
Source: https://github.com/edwinhu/workflows/tree/main/lib/skills/dev-plan-reviewer
Command: npx skills add https://github.com/edwinhu/workflows --skill dev-plan-reviewer

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve?

This skill prevents costly rework during implementation by ensuring that development plans are thoroughly reviewed for completeness, spec alignment, and task granularity before coding begins.

Core Features & Use Cases

  • Proactive Quality Gate: Acts as a mandatory checkpoint after the design phase to catch plan deficiencies early.
  • Automated Review Dispatch: Intelligently dispatches a reviewer subagent to analyze PLAN.md against SPEC.md.
  • Iterative Improvement: Facilitates iterative refinement of plans by flagging specific issues and requiring re-review.
  • Use Case: Before a complex feature implementation begins, this skill automatically assigns a reviewer to scrutinize the detailed task breakdown in PLAN.md, ensuring no steps are missed and all requirements from SPEC.md are addressed.

Quick Start

Use the dev-plan-reviewer skill to dispatch a reviewer for the plan document.

Frequently Asked Questions about dev-plan-reviewer

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I validate a development plan against a spec before coding?

Development plan validation dispatches a reviewer subagent to analyze PLAN.md against SPEC.md, ensuring requirements are met and tasks are actionable before implementation begins.

What is task decomposition readiness in software development planning?

Task decomposition readiness verifies that a development plan breaks down implementation into actionable steps, ensuring no requirements are missed and granularity is appropriate.

How do I review a PLAN.md file for completeness and spec alignment?

Reviewing PLAN.md involves dispatching a reviewer subagent to check the document against SPEC.md, flagging specific issues and requiring iterative refinement until all requirements are met.

Does development plan review handle plans with more than 15 tasks?

Development plan review handles plans exceeding 15 tasks by triggering an escalation process, ensuring large task decompositions are properly managed and validated.

Can I get iterative feedback on a development plan that fails review?

Iterative feedback on a development plan is supported by flagging specific issues and requiring re-review, allowing refinement until the plan passes the quality gate.

When do I need a quality gate for development plan implementation readiness?

A quality gate for implementation readiness is needed after the design phase and before coding begins, preventing costly rework by catching plan deficiencies early.