plan-review

Analyze plan files for ambiguities, contradictions, and missing information.

2|Updated Nov 16, 2024
One-click install
npx skills add https://github.com/onairmarc/dotfiles --skill plan-review-onairmarc
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: plan-review
Source: https://github.com/onairmarc/dotfiles/tree/main/.agents/skills/plan-review
Command: npx skills add https://github.com/onairmarc/dotfiles --skill plan-review-onairmarc

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This plan-review workflow helps teams identify ambiguity, contradictions, and information gaps in implementation plans, enabling faster, safer execution.

Core Features & Use Cases

  • Lens-driven analysis to surface ambiguity, contradictions, missing information, and scope gaps.
  • Interactive AskUserQuestion loop to resolve gaps, validate assumptions, and enrich the plan.
  • In-place enrichment and persistence: writes the updated plan back to disk and preserves traceable history.

Quick Start

Provide the path to the plan file you want reviewed and I will read, analyze, and return an enriched plan.

Frequently Asked Questions about plan-review

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

FAQPage Schema
How do I identify ambiguities and missing information in a project plan?▼

A plan review applies lens-driven analysis to identify ambiguities, contradictions, and missing information in a plan file, surfacing scope gaps to prevent misinterpretation during execution.

What is the best way to resolve contradictions in implementation requirements?▼

Resolving contradictions in implementation requirements is handled through an interactive AskUserQuestion loop that validates assumptions and enriches the plan with concrete, unambiguous instructions.

How do I update a plan file with concrete instructions after finding gaps?▼

You update a plan file by interactively resolving gaps through targeted questions, writing the enriched plan back to disk with in-place enrichment, and preserving a traceable version history.

Can I use this plan review workflow to prepare documentation for automated execution?▼

Yes, the plan review workflow outputs an agent-ready, execution-friendly version of your plan, ensuring the documentation has concrete instructions validated through interactive gap resolution.

What are the limitations of automated requirements analysis for implementation plans?▼

Requirements analysis limitations include the need for interactive user input to resolve ambiguities, as the process cannot autonomously fill information gaps without targeted questions and assumption validation.