code-plan

Generate a reviewable code change plan through structured Clarify, Approach, and Summary stages.

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

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Planning code changes is often ambiguous and risk-prone. This skill provides a guided, multi-stage dialogue to clarify goals, constraints, and acceptance criteria, producing a clear, auditable plan before any implementation.

Core Features & Use Cases

  • Structured Q&A flow that cycles through Clarify, Approach, and Summary report stages to surface decisions.
  • Captures goals, success metrics, constraints, and acceptance criteria in a single plan.
  • Produces a concise, shareable plan ready for review with engineers and stakeholders.
  • Useful whenever starting a feature or bug fix that requires a well-defined plan before writing code.

Quick Start

Start a planning session by triggering the Clarify stage and guiding the user through Approach and Summary report before drafting the plan.

Frequently Asked Questions about code-plan

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

FAQPage Schema
How do I create a formal plan for code changes before implementation?

To create a formal plan for code changes, use a structured multi-stage dialogue that cycles through Clarify, Approach, and Summary stages. This process captures goals, constraints, and acceptance criteria to produce a reviewable plan ready for stakeholders.

What is the best way to document architecture and acceptance criteria for a new feature?

Documenting architecture and acceptance criteria is best handled through a guided Q&A flow that captures decisions stage-by-stage. This generates a concise, shareable summary report aligning engineers and stakeholders before any code is written.

How does structured Q&A help plan code changes for stakeholders?

Structured Q&A helps plan code changes by guiding users through a multi-stage dialogue that explicitly surfaces decisions, success metrics, and constraints. It results in an auditable plan that clarifies objectives for stakeholders before implementation begins.

Can I use a guided dialogue to capture constraints and success metrics for a bug fix?

Yes, you can use a guided dialogue to capture constraints and success metrics for a bug fix. The structured Q&A flow is designed for any code change requiring clear objectives and acceptance criteria, ensuring the plan is well-defined before implementation.

When do I need a structured planning session for a software engineering project?

You need a structured planning session whenever starting a feature or bug fix that carries ambiguity or risk. If the code change requires explicit objectives, constraints, and stakeholder alignment before writing code, a formal plan is necessary.