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.