review-plan

Review plan.md and phase files against templates and codebase patterns.

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

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill requires pypdf, pdfplumber, pdf2image, and includes scripts (resource) and references (resource) components.

What problem does it solve?

This Skill automates the rigorous review of planning documents, ensuring they adhere to strict template structures and codebase compliance, preventing costly errors during implementation.

Core Features & Use Cases

  • Dual-Layer Review: Checks both the structural integrity of planning documents (template compliance) and the technical accuracy of code snippets within them (codebase compliance).
  • Automated Fixes: Automatically corrects critical, high, and medium severity issues found in phase files, saving significant developer time.
  • Use Case: After creating a new plan.md and its associated phase-01.md, use this Skill to verify that both documents follow all required sections, patterns, and coding standards before development begins.

Quick Start

Use the review-plan skill to review the plan located in the 'plans/voice-assistant' folder.

Frequently Asked Questions about review-plan

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

FAQPage Schema
How do I automate code review and compliance checks for planning documents?

Automating code review for planning documents involves validating structural integrity against predefined templates and checking code snippets for codebase compliance. This skill reviews plan.md and phase files, automatically correcting critical, high, and medium severity issues to enforce quality gates.

How do I validate that plan.md and phase files follow template structures before development?

Validating planning documents requires a dual-layer review checking both structural integrity against templates and technical accuracy of code snippets. This process identifies deviations from established coding standards and automatically corrects critical, high, and medium severity issues within phase files.

Can I automatically fix compliance issues in phase files during workflow automation?

Automatically fixing compliance issues in phase files is supported for critical, high, and medium severity deviations. The review process identifies structural and codebase compliance failures, then applies automated corrections to ensure planning documents meet established coding standards before development begins.

What is the best way to enforce quality gates for development workflows using planning documents?

Enforcing quality gates for development workflows requires reviewing planning documents against predefined templates and actual codebase patterns. This dual-layer validation ensures plan.md and associated phase files meet strict structural and technical compliance standards before implementation starts.

Does automated planning document review check code snippets against actual codebase patterns?

Automated planning document review does check code snippets against actual codebase patterns. This dual-layer review process validates both the structural integrity of template compliance and the technical accuracy of code snippets to identify deviations from established coding standards.