speckit-plan

Generates implementation plans and design artifacts from feature specifications.

Updated Sep 9, 2026
One-click install
npx skills add https://github.com/MagnoAlves1993/handy --skill speckit-plan-magnoalves1993
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: speckit-plan
Source: https://github.com/MagnoAlves1993/handy/tree/main/.github/skills/speckit-plan
Command: npx skills add https://github.com/MagnoAlves1993/handy --skill speckit-plan-magnoalves1993

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Turning a feature specification into a concrete technical plan requires resolving unknowns, modeling data, and defining contracts, which is slow and error-prone when done manually. ## Core Features & Use Cases - Plan Workflow Execution: Runs the setup script, loads the feature spec and project constitution, and fills the implementation plan template with technical context. - Research & Design Artifacts: Generates research.md, data-model.md, contracts/, and quickstart.md through structured Phase 0 and Phase 1 workflows. - Extension Hooks: Executes optional and mandatory pre/post hooks defined in .specify/extensions.yml before and after planning. - Use Case: After writing a spec for a new feature, run the plan workflow to produce a constitution-checked implementation plan with resolved clarifications and interface contracts. ## Quick Start Run the speckit plan command in a spec-kit project to generate the implementation plan and design artifacts for the current feature branch.

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 plan workflow in a spec-kit project. It executes setup-plan.ps1 to resolve paths, loads the feature spec and constitution, then fills the plan template and produces research.md, data-model.md, contracts, and quickstart.md.

What artifacts does the spec-kit planning workflow produce?

The workflow produces research.md in Phase 0 to resolve all NEEDS CLARIFICATION items, then data-model.md, interface contracts under contracts/, and quickstart.md in Phase 1, plus the filled implementation plan.

Does speckit-plan require a specific project structure?

Yes, it requires a spec-kit project with a .specify directory containing scripts, memory/constitution.md, and templates. The setup script returns FEATURE_SPEC, IMPL_PLAN, FEATURE_DIR, and BRANCH paths used by the workflow.

What are extension hooks in the planning workflow?

Hooks are commands registered in .specify/extensions.yml under hooks.before_plan or hooks.after_plan. Mandatory hooks are executed automatically before planning continues, while optional hooks are only suggested to the user.

What happens when the constitution check fails during planning?

Gate violations cause an ERROR unless they are justified in the plan. The constitution check is evaluated before design and re-evaluated after Phase 1 to confirm the design still complies with project principles.