mine.plan-review

Review design documents and work packages against a structured checklist.

1|Updated Feb 22, 2026
One-click install
npx skills add https://github.com/NodeJSmith/Claudefiles --skill mine-plan-review
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: mine.plan-review
Source: https://github.com/NodeJSmith/Claudefiles/tree/main/skills/mine.plan-review
Command: npx skills add https://github.com/NodeJSmith/Claudefiles --skill mine-plan-review

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) and references (resource) components.

What problem does it solve?

This Skill streamlines the design and planning phase of software development by ensuring that design documents and their associated work packages are thoroughly reviewed for correctness, completeness, and alignment before implementation begins.

Core Features & Use Cases

  • Automated Design Review: Leverages an Opus subagent to critically assess design documents and work packages against a predefined checklist.
  • Structured Feedback: Provides clear PASS/WARN/FAIL ratings for each checklist item, along with a concise summary and actionable feedback.
  • Decision Gating: Empowers users to Approve, Request Revisions, or Abandon a plan based on the review outcome, preventing flawed designs from proceeding.
  • Use Case: Before starting a new feature, you can run this skill to have an AI reviewer check your design.md and associated WP*.md files, ensuring all dependencies are sequenced correctly, naming is consistent, and the implementation aligns with the overall design goals.

Quick Start

Run the mine.plan-review skill, specifying the path to your design document or feature directory.

Frequently Asked Questions about mine.plan-review

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

FAQPage Schema
How do I review design documents and work packages before implementation?

You can review design documents and work packages by running an AI subagent against a structured checklist to ensure correctness, completeness, and design alignment, yielding clear approval, revision, or abandonment outcomes.

What is AI design review in software development planning?

AI design review is an automated process that critically assesses design documents and work packages against a predefined checklist, validating dependency sequencing, artifact naming, and test structure to prevent flawed designs from proceeding into implementation.

How do I validate dependency sequencing and task completeness in work packages?

Validating dependency sequencing and task completeness in work packages is done by evaluating the associated WP*.md files against a structured checklist, ensuring correct task ordering, context independence, and alignment with overall design goals.

Can I use an AI reviewer to gate development workflows based on a design review?

Yes, you can gate development workflows by running an automated AI review that assesses design alignment and completeness, returning actionable feedback that empowers you to explicitly approve, request revisions, or abandon a plan.

Does automated design review work with standard markdown design files?

Automated design review works with standard markdown files by processing your design.md and associated WP*.md files to validate naming consistency, test structure, and context independence criteria before providing actionable feedback.

What are the limitations of using AI for work package validation?

A limitation of using AI for work package validation is that it relies entirely on a predefined checklist and document structure, meaning it gates development based on document completeness rather than evaluating runtime code behavior or dynamic execution.