speckit-plan

Generates implementation plans and design artifacts from feature specifications.

Updated Aug 28, 2026
One-click install
npx skills add https://github.com/B18Bu/Refund-Agent --skill speckit-plan-b18bu
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: speckit-plan
Source: https://github.com/B18Bu/Refund-Agent/tree/main/.agents/skills/speckit-plan
Command: npx skills add https://github.com/B18Bu/Refund-Agent --skill speckit-plan-b18bu

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Turning a feature specification into a concrete implementation plan requires resolving technical unknowns, modeling data, and defining contracts, which is time-consuming when done manually. ## Core Features & Use Cases - Planning Workflow Execution: Runs the spec-kit plan workflow to fill Technical Context, evaluate constitution gates, and mark unknowns as NEEDS CLARIFICATION. - Design Artifact Generation: Produces research.md, data-model.md, contracts/, and quickstart.md from the feature spec. - Extension Hook Support: Executes optional and mandatory before/after plan hooks defined in .specify/extensions.yml. - Use Case: After writing a feature spec in a spec-kit project, invoke this Skill to automatically research unknowns and generate the full Phase 0 and Phase 1 design artifacts on the current branch. ## Quick Start Ask the agent to run the implementation planning workflow for the current feature spec in your spec-kit project.

Frequently Asked Questions about speckit-plan

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

FAQPage Schema
How do I generate an implementation plan from a feature spec?▼

Run the speckit-plan workflow in a spec-kit project. It executes setup-plan.ps1, loads the feature spec and constitution, then generates research.md, data-model.md, contracts, and quickstart.md on the current branch.

What artifacts does the spec-kit planning workflow produce?▼

The workflow produces research.md resolving all NEEDS CLARIFICATION items in Phase 0, then data-model.md, interface contracts under /contracts/, and quickstart.md in Phase 1. It reports the branch, plan path, and generated artifacts on completion.

Does speckit-plan require a specific project structure?▼

Yes, it requires a spec-kit project structure with a .specify directory containing scripts/powershell/setup-plan.ps1, memory/constitution.md, and the plan template. Without these, the setup step cannot resolve FEATURE_SPEC and IMPL_PLAN paths.

How do extension hooks work in the planning workflow?▼

Hooks are defined in .specify/extensions.yml under hooks.before_plan and hooks.after_plan. Mandatory hooks are executed automatically before continuing, while optional hooks are only suggested. Hooks with a condition field are skipped and left to the HookExecutor.

What happens when constitution gates fail during planning?▼

The workflow raises an ERROR on gate failures or unresolved clarifications. Constitution Check is evaluated before design and re-evaluated after Phase 1, and violations must be justified to proceed.