speckit-companion-plan

Generates implementation plans with research and design artifacts for spec-kit projects.

Updated May 28, 2026
One-click install
npx skills add https://github.com/whw23/PingoGate --skill speckit-companion-plan-whw23
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: speckit-companion-plan
Source: https://github.com/whw23/PingoGate/tree/main/.claude/skills/speckit-companion-plan
Command: npx skills add https://github.com/whw23/PingoGate --skill speckit-companion-plan-whw23

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Turning a feature specification into a concrete implementation plan requires investigating the codebase, resolving design unknowns, and producing consistent planning documents, which is slow and error-prone when done manually. ## Core Features & Use Cases - Phased Plan Generation: Produces plan.md with Summary, Project Structure, and Constitution Check, then Phase 0 research and Phase 1 design artifacts (data-model.md, contracts/). - Size-Aware Budgeting: Reads the recorded change size from .spec-context.json and trims the plan for simple changes, skipping data-model.md and folding decisions into a Key Decisions note. - Extension & Node Hooks: Runs spec-kit extension hooks from .specify/extensions.yml and project node hooks from .specify/companion.yml without ever failing the host command. - Use Case: After writing a feature spec with spec-kit, run this step to investigate the codebase, record design decisions in research.md, and emit contracts that copy the spec's Verbatim Constraints exactly. ## Quick Start Ask the assistant to run the speckit companion plan step for the current feature so it produces plan.md, research.md, and the design artifacts in the feature directory.

Frequently Asked Questions about speckit-companion-plan

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

FAQPage Schema
How do I generate an implementation plan from a spec-kit specification?▼

Run the companion plan step after the specify step. It reads .specify/feature.json and the feature's spec.md, investigates the codebase, then writes plan.md, research.md, data-model.md, and contracts into the feature directory.

What artifacts does a spec-kit implementation plan include?▼

A full plan includes plan.md with Summary, Project Structure, and Constitution Check, plus research.md for decisions, data-model.md for entities, and a contracts directory for exposed interfaces. Simple changes keep only the Summary and a Key Decisions note.

Does the plan step work without a .specify directory?▼

No. The skill requires a spec-kit project structure with a .specify directory containing feature.json and the feature's spec.md. Without that structure there is no feature context to plan against.

How does the plan handle small or simple changes?▼

It reads the size field from .spec-context.json. At simple size it keeps only the plan Summary, skips Project Structure, Constitution Check, and data-model.md, and folds design rationale into a short Key Decisions note.

Why are contract identifiers copied verbatim from the spec?▼

The spec's Verbatim Constraints pin exact identifier strings that consumers and tests code against. Renaming, recasing, or pluralizing them would break the contract, so the plan copies them exactly.