plan-impact-analysis

Maps a plan or spec onto an existing codebase via Mermaid diagrams and gap analysis.

Updated Mar 21, 2026
One-click install
npx skills add https://github.com/pulak999/ai-tooling --skill plan-impact-analysis-pulak999
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: plan-impact-analysis
Source: https://github.com/pulak999/ai-tooling/tree/main/ai-assistant-kit/claude-skills/plan-impact-analysis
Command: npx skills add https://github.com/pulak999/ai-tooling --skill plan-impact-analysis-pulak999

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Before implementing a plan, spec, or design doc, teams often lack clarity on how it maps to their existing codebase, leading to missed dependencies, undefined components, and costly mid-implementation surprises. ## Core Features & Use Cases - Execution Flow Diagrams: Generates a Mermaid diagram showing entry points, existing components, new components, decision points, system boundaries, and data flow. - Gap and Risk Reports: Identifies components referenced in the plan but missing from the codebase, flags risks like concurrency or backward compatibility issues, and surfaces underspecified sections. - Iterative Q&A Loop: Refines understanding through dialogue, tracks plan amendments in a structured table, and re-renders diagrams when gaps are resolved. - Use Case: A developer receives a feature spec for a new API endpoint and wants to know which existing modules it touches, what needs to be built from scratch, and what questions must be answered before writing code. ## Quick Start Attach your plan document and ask the assistant to walk you through how this plan affects the codebase before implementation.

Frequently Asked Questions about plan-impact-analysis

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

FAQPage Schema
How do I understand a plan's impact on my codebase before implementing it?▼

Provide the plan document and let the skill read both the plan and your codebase. It produces a Mermaid execution flow diagram showing entry points, affected modules, and new components, followed by a gap and risk report.

How to find gaps between a design spec and existing code?▼

The skill compares every component, interface, and behavior referenced in the plan against what actually exists in the codebase. Anything referenced but missing is flagged explicitly as a gap with an explanation of what breaks if unresolved.

Does plan impact analysis work for any programming language?▼

Yes, the analysis is language and stack agnostic. It works for systems code, web applications, ML pipelines, and any other codebase since it relies on reading code structure rather than language-specific tooling.

Can this skill write the implementation code after the analysis?▼

No, the skill explicitly prohibits writing implementation code. It focuses on architectural understanding and can produce an updated plan or a handoff summary for a separate implementation step.

What happens when parts of my plan are vague or underspecified?▼

Underspecified sections are identified as fuzzy parts, each paired with a specific clarifying question. Through the Q&A loop, resolutions are tracked in a plan amendments table you can fold back into your document.