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.