speckit-plan

Automate implementation planning to generate design artifacts from feature specifications.

Updated Mar 4, 2026
One-click install
npx skills add https://github.com/kerolos-saaid/refranario --skill speckit-plan-kerolos-saaid
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: speckit-plan
Source: https://github.com/kerolos-saaid/refranario/tree/main/.agents/skills/speckit-plan
Command: npx skills add https://github.com/kerolos-saaid/refranario --skill speckit-plan-kerolos-saaid

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Speckit-plan automates the implementation planning workflow by applying a plan template to generate design artifacts.

Core Features & Use Cases

  • Automates planning workflow steps from feature specification to artifact generation (research.md, data-model.md, contracts/, quickstart.md) and updates agent context.
  • Supports extension hooks before and after planning via .specify/extensions.yml with mandatory/optional hook handling.
  • Manages context loading from FEATURE_SPEC and constitution templates and produces lifecycle artifacts for design documentation.

Quick Start

Run the speckit-plan workflow from the project root to generate the initial planning artifacts.

Frequently Asked Questions about speckit-plan

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

FAQPage Schema
How do I automate design artifact generation for a spec-kit project?

You can automate design artifact generation by running the speckit-plan workflow from your project root, which applies a plan template to produce research.md, data-model.md, contracts/, and quickstart.md artifacts.

What is the planning workflow for producing data models and contracts in spec-kit?

The planning workflow uses a Speckit plan template to guide stages from feature specification to artifact generation, producing data-model.md, contracts/, and quickstart.md while updating the agent context.

Do I need a .specify directory to use the speckit-plan workflow?

Yes, speckit-plan requires a project following the spec-kit structure with a .specify directory, specifically needing .specify/extensions.yml hooks to handle mandatory and optional extensions during planning.

How do extension hooks work in the speckit planning workflow?

Extension hooks in .specify/extensions.yml allow you to inject custom logic before and after planning, with speckit-plan managing both mandatory and optional hook handling during the artifact generation lifecycle.

How do I update agent context after generating design artifacts?

Speckit-plan updates agent context by modifying the target AGENTS.md file to include the updated plan reference after generating design artifacts like research.md and data-model.md.

Can I use speckit-plan without a target AGENTS.md file?

No, a target AGENTS.md file is required because speckit-plan updates it with the plan reference, ensuring generated design artifacts and lifecycle documentation are properly linked to the agent context.