plan-review

Analyzes software development plans for scope, architecture, code quality, testing, and performance.

Updated Jan 22, 2026
One-click install
npx skills add https://github.com/dtbuchholz/claude-config --skill plan-review-dtbuchholz
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: plan-review
Source: https://github.com/dtbuchholz/claude-config/tree/main/skills/plan-review
Command: npx skills add https://github.com/dtbuchholz/claude-config --skill plan-review-dtbuchholz

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill helps ensure that software development plans are robust, well-scoped, and thoroughly vetted before implementation, preventing wasted effort and potential issues down the line.

Core Features & Use Cases

  • Scope Challenge: Aggressively questions the necessity and minimum viable scope of a proposed plan.
  • Multi-stage Review: Conducts detailed reviews of Architecture, Code Quality, Tests, and Performance.
  • Opinionated Recommendations: Provides clear, actionable advice and trade-offs for each identified issue.
  • Use Case: Before starting a new feature, you can ask this Skill to review the proposed implementation plan, ensuring that scope creep is minimized and potential failure modes are addressed proactively.

Quick Start

Use the plan-review skill to review the plan located at '~/claude/plans/new-feature-plan.md'.

Frequently Asked Questions about plan-review

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

FAQPage Schema
How do I review a software development plan before implementation?

To review a software development plan, you analyze scope, architecture, code quality, testing, and performance to identify issues and propose trade-offs. This ensures the plan is robust and thoroughly vetted before implementation begins.

What is scope management and how does it prevent scope creep in architecture planning?

Scope management in architecture planning aggressively questions the necessity and minimum viable scope of a proposed plan. It prevents scope creep by challenging requirements and ensuring only essential features are implemented, minimizing wasted effort.

How do I assess risk and identify potential failure modes in a new feature plan?

Risk assessment involves conducting a multi-stage review of architecture, code quality, tests, and performance. It identifies potential failure modes proactively and provides opinionated recommendations with clear trade-offs for each issue found.

Can I use automated code review to challenge the testing strategy in my implementation plan?

Yes, automated code review can challenge your testing strategy by conducting detailed test reviews as part of a multi-stage evaluation. It examines architecture, code quality, and performance alongside testing to ensure thorough vetting before implementation.

What's the best way to validate architecture decisions and code quality before coding starts?

The best way to validate architecture decisions is through a structured review that challenges scope, analyzes code quality, and assesses performance trade-offs. This interactive process requires user input for decision-making and review mode selection.

When should I not use a structured plan review for my software project?

A structured plan review may not be necessary for trivial changes or well-understood bug fixes where scope, architecture, and testing implications are already clear and minimal risk is involved in the implementation.