speckit-plan

Generate gated implementation plans from feature specifications using spec-kit.

Updated Dec 20, 2023
One-click install
npx skills add https://github.com/Thiago-Cruz-eng/Hibrygame --skill speckit-plan-thiago-cruz-eng
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: speckit-plan
Source: https://github.com/Thiago-Cruz-eng/Hibrygame/tree/main/.claude/skills/speckit-plan
Command: npx skills add https://github.com/Thiago-Cruz-eng/Hibrygame --skill speckit-plan-thiago-cruz-eng

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

It streamlines turning a feature spec and constitution into a structured, gated implementation plan with generated design artifacts.

Core Features & Use Cases

  • Pre-plan extension hooks: Detects optional and mandatory pre-hooks from .specify/extensions.yml and prepares the workflow accordingly.
  • Two-phase planning outputs: Produces research.md first, then data-model.md, optional contracts, and quickstart.md in a follow-on design phase.
  • Guardrails and clarification handling: Resolves NEEDS CLARIFICATION via Phase 0 and enforces gate rules, stopping on violations.

Quick Start

Run the planning workflow for your current spec by invoking speckit-plan with your feature context.

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 specification?

To generate an implementation plan from a feature specification, use a structured workflow that reads your spec and constitution, runs setup scripts, and produces gated design artifacts like research and data model files. This ensures your planning process is structured and validated.

How does the spec-kit planning workflow handle clarification and gate failures?

The planning workflow handles clarification by resolving needs during an initial Phase 0 generation step. It enforces strict gate rules and immediately stops the process, reporting errors, if any validation violations occur during artifact generation.

Do I need a .specify directory to run the spec-kit planning workflow?

Yes, you need a .specify directory to run the spec-kit planning workflow. This directory stores your setup scripts, constitution context, extension hooks, and template files required to execute the phased artifact generation successfully.

What design artifacts are produced during the two-phase implementation planning process?

The two-phase implementation planning process first produces a research document, followed by a data model file, optional contracts, and a quickstart guide. These artifacts provide the structured design foundation needed before coding begins.

Can I run custom extension hooks before generating implementation plans?

Yes, you can run custom extension hooks before generating implementation plans. The workflow detects optional and mandatory pre-hooks from your extensions configuration file and prepares the execution flow accordingly before starting the planning phases.

Why does my implementation plan generation stop with a gate failure error?

Implementation plan generation stops with a gate failure error because the workflow actively enforces predefined guardrails and validation rules. It halts immediately upon detecting violations to prevent generating incomplete or invalid design artifacts.