plan-code-changes

Create a phased plan-*.md file with unit-test specs for code changes.

Updated Mar 8, 2026
One-click install
npx skills add https://github.com/ankitjh4/skill-builder --skill plan-code-changes-ankitjh4
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: plan-code-changes
Source: https://github.com/ankitjh4/skill-builder/tree/main/plan-code-changes
Command: npx skills add https://github.com/ankitjh4/skill-builder --skill plan-code-changes-ankitjh4

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

It helps you translate unclear or high-level change goals into a concrete, incremental implementation plan that developers can execute safely without breaking the codebase.

Core Features & Use Cases

  • Clarifying scope first: Identifies the user’s goals before drafting any work so the plan matches what “done” means.
  • Grounded planning from existing code: Uses the current project structure and abstractions as the foundation for targeted changes.
  • Creates a phased plan file: Produces a plan-*.md file with logically grouped phases, typed interface guidance, and inline unit-test specs per phase.
  • Use Case: You need to add a feature or refactor part of a service and want a developer-ready plan that includes specific files and focused unit tests rather than broad guidance.

Quick Start

Ask an AI to generate a plan-<slug>.md file that outlines the required code changes for your repository, including phased work and unit test targets, using your current code as the base.

Frequently Asked Questions about plan-code-changes

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

FAQPage Schema
How do I plan code changes for a feature addition without breaking existing abstractions?

To plan code changes safely, you generate a phased plan file that grounds implementation in the current project structure, ensuring new typed interfaces respect existing abstractions. This produces a developer-ready plan-*.md file with logically grouped steps.

What is the best way to create an incremental refactoring plan with unit test specifications?

The best way to create a refactoring plan is to generate a plan-*.md file that outlines multi-phase implementation steps with inline unit-test specs for each phase. This clarifies scope first and translates goals into focused test targets.

Can I generate a developer-ready code plan for an unfamiliar codebase?

Yes, you can generate a developer-ready code plan by researching the current codebase structure first. The planning process identifies user goals and uses existing abstractions as the foundation, producing a safe, incremental implementation plan.

How do I turn high-level software requirements into typed interface definitions?

You turn high-level requirements into typed interface definitions by creating a staged code plan file. This process clarifies your goals and produces targeted phases that define clear typed interfaces needed for the new feature.

When do I need a phased plan file for software changes?

You need a phased plan file for software changes when adding features or refactoring services where existing abstractions must be respected. It provides logically grouped phases with specific files and focused unit tests rather than broad guidance.