review-plan

Assess dev-plan completeness and coherence against setup.yaml acceptance criteria, outputting review artifacts to docs/{target_repo}/review-plan/.

Updated Feb 8, 2026
One-click install
npx skills add https://github.com/NagasakaH/dev-process --skill review-plan-nagasakah
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: review-plan
Source: https://github.com/NagasakaH/dev-process/tree/main/.claude/skills/development/review-plan
Command: npx skills add https://github.com/NagasakaH/dev-process --skill review-plan-nagasakah

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This skill provides a structured, objective review of development task plans to ensure alignment with acceptance criteria, accurate dependencies, realistic estimates, and appropriate testing strategies.

Core Features & Use Cases

  • Systematic evaluation of task decomposition, dependencies, estimation, and TDD approach.
  • Generates review artifacts under docs/{target_repository}/review-plan/ and updates design-document accordingly.
  • Verifies coverage against acceptance criteria in setup.yaml.

Quick Start

Invoke the review process using setup.yaml and the existing dev-plan and dev-design artifacts to generate a peer-review report.

Frequently Asked Questions about review-plan

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

FAQPage Schema
How do I review a dev plan against acceptance criteria?

Reviewing a dev plan against acceptance criteria involves verifying task decomposition, tracking dependencies, and estimating effort by comparing the dev-plan against setup.yaml. This produces structured review artifacts and a decision summary to validate design alignment.

What is a development task plan review and when do I need one?

A development task plan review is a structured evaluation of task decomposition, dependencies, and TDD approach to ensure robust development. You need one when you must verify that your dev-plan accurately aligns with design documents and setup.yaml acceptance criteria before implementation.

How do I verify design alignment and track dependencies in my dev plan?

To verify design alignment and track dependencies, apply design-document and dev-design inputs to cross-reference the dev-plan. This process validates that task dependencies are accurate and effort estimates are realistic, outputting actionable recommendations to update the design-document.

Can I use TDD approach evaluation for my existing dev plan?

Yes, you can evaluate the TDD approach for an existing dev-plan by applying the design-document and dev-design inputs. The review systematically assesses testing strategies and coverage against setup.yaml acceptance criteria to output a peer-review report under docs/{target_repo}/review-plan/.

What are the limitations of automated dev plan reviews?

Automated dev plan reviews rely heavily on the completeness of setup.yaml acceptance criteria and existing dev-design artifacts. If the input design documents lack detail or the task decomposition is fundamentally flawed, the review cannot generate actionable recommendations to update the design-document effectively.