speckit-plan

Generate design artifacts and resolve unknowns from feature specifications.

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

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

speckit-plan generates an implementation plan from a feature spec by producing the required design artifacts, resolving unknowns, and enforcing gate rules so you can move from idea to build confidently.

Core Features & Use Cases

  • Workflow-driven planning: Executes a structured Phase 0→1 process that turns technical context and requirements into concrete files.
  • Clarification resolution: Detects NEEDS CLARIFICATION items in the technical context and resolves them via generated research tasks before proceeding.
  • Design outputs and contracts: Produces research.md, data-model.md, contracts/ (when external interfaces exist), and quickstart.md, plus an agent context update.
  • Optional extension hook support: Runs before_plan and after_plan hooks (when present and enabled) to extend the planning pipeline without modifying the core workflow.

Quick Start

Run the speckit-plan skill in your spec-kit project root to generate research.md, data-model.md, contracts (if applicable), and quickstart.md.

Frequently Asked Questions about speckit-plan

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

FAQPage Schema
How do I generate implementation plans from a feature specification?

To generate implementation plans from a feature specification, you can automate the process by converting technical context and requirements into design artifacts like a data model and contracts. This resolves project unknowns and enforces gate rules before building.

What is the best way to resolve unknowns in technical context before designing a data model?

The best way to resolve unknowns in technical context is to detect items needing clarification and generate research tasks to address them. This ensures all technical context is fully clarified before proceeding to create the data model and contracts.

How do data models and contracts get generated from a feature spec?

Data models and contracts are generated from a feature spec by running a structured Phase 0 to 1 workflow. This process turns technical context and requirements into concrete files including research.md, data-model.md, and a contracts directory when external interfaces exist.

Can I use extension hooks to customize the spec-kit planning pipeline?

Yes, you can use extension hooks to customize the planning pipeline by running before_plan and after_plan hooks. This extends the workflow without modifying the core process, provided the hooks are present and enabled in your environment.

Why does implementation planning fail when there are unresolved issues in the feature spec?

Implementation planning fails on unresolved issues because the workflow enforces gate rules by erroring on unresolved or unjustified issues. This prevents moving forward until all technical context unknowns are properly clarified and justified.

Does spec-kit planning support updating agent context after generating design artifacts?

Yes, spec-kit planning supports updating agent context after generating design artifacts. The workflow executes an update-agent-context script alongside producing quickstart.md and other files to ensure the agent has the latest project context.