speckit-plan

Generate implementation plans from feature specs into research, data models, and contracts.

Updated Apr 7, 2026
One-click install
npx skills add https://github.com/a2mus/smart-da3m --skill speckit-plan-a2mus
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: speckit-plan
Source: https://github.com/a2mus/smart-da3m/tree/main/.agents/skills/speckit-plan
Command: npx skills add https://github.com/a2mus/smart-da3m --skill speckit-plan-a2mus

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Speckit Plan turns raw feature specifications into a structured, actionable technical implementation plan so teams avoid ad-hoc design work, missed requirements, and inconsistent artifacts. It standardizes the workflow for resolving unknowns, documenting research, defining data models and contracts, and preparing agent context updates to accelerate development handoffs.

Core Features & Use Cases

  • Automated plan generation: Runs repository setup scripts to parse feature specs and populate an IMPL_PLAN template with Technical Context, gates, and phase outputs.
  • Phased workflow: Produces research.md to resolve unknowns, data-model.md for entities and validations, contracts/ for interfaces, and quickstart.md for developer onboarding.
  • Project-aware integration: Reads project constitution and agent context, evaluates gates, and updates agent-specific context files while flagging unresolved items as NEEDS CLARIFICATION.
  • Use Case: When a product owner supplies a feature spec, use Speckit Plan to generate the research, data model, and contract artifacts and to report the branch and artifact locations for implementation.

Quick Start

Generate an implementation plan from the feature spec at .specify/specs/my-feature.yaml and produce research.md, data-model.md, and contracts for the implementation 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 a technical implementation plan from a feature specification?▼

Generating a technical implementation plan from a feature specification involves parsing the spec to populate an IMPL_PLAN template with technical context and gates. This process produces research, data models, and contracts to standardize the development workflow and avoid ad-hoc design.

What is the spec-kit structure for software planning?▼

The spec-kit structure is a project directory format utilizing a .specify/ directory to hold feature specs and repository scripts. It standardizes software planning by producing research, data-model, and contract artifacts during Phase 0 and Phase 1 planning to accelerate development handoffs.

How do I create data models and API contracts from feature specs?▼

Creating data models and API contracts from feature specs requires parsing the specifications to resolve unknowns and define entities. The workflow produces a data-model.md for entities and validations, alongside a contracts/ directory for interfaces to prepare for implementation.

Does spec-kit plan work with my existing project constitution and agent context?▼

Spec-kit plan integrates with existing project setups by reading the project constitution and agent context to evaluate gates. It updates agent-specific context files and flags unresolved items as NEEDS CLARIFICATION, ensuring the implementation plan aligns with your established project rules.

How are unresolved requirements handled during implementation plan generation?▼

Unresolved requirements are handled during implementation plan generation by flagging them explicitly as NEEDS CLARIFICATION in the final output. This ensures that missing information in the feature spec is documented in the research artifacts rather than blocking the technical context setup.