speckit-plan

Generates implementation planning artifacts from a speckit feature spec.

Updated Apr 2, 2026
One-click install
npx skills add https://github.com/avansover/mathcraft --skill speckit-plan-avansover
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: speckit-plan
Source: https://github.com/avansover/mathcraft/tree/main/.claude/skills/speckit-plan
Command: npx skills add https://github.com/avansover/mathcraft --skill speckit-plan-avansover

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Speckit-plan turns a feature specification into an implementation planning workflow that produces concrete design artifacts while enforcing clarification and gate rules.

Core Features & Use Cases

  • Pre-hook/Pre-check support: Runs optional or mandatory extension hooks defined in .specify/extensions.yml before planning, without evaluating hook conditions.
  • Two-phase planning workflow: Creates research.md to resolve NEEDS CLARIFICATION, then generates data-model.md, /contracts/, and quickstart.md as design outputs.
  • Post-design verification and extensibility: Re-checks the constitution after design and can run hooks.after_plan extension hooks after artifacts are produced.
  • Project-aware setup: Uses .specify/scripts/powershell/setup-plan.ps1 -Json and .specify/memory/constitution.md to assemble required context for planning.

Quick Start

Run the speckit-plan skill with your $ARGUMENTS to generate research.md, data-model.md, contracts, and quickstart.md from your speckit project structure.

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 planning artifacts from a feature spec?

To generate implementation planning artifacts from a feature spec, you orchestrate a two-phase workflow that first consolidates research to resolve unknowns, then outputs a data model, contracts, and a quickstart guide.

What is the best way to resolve technical unknowns before creating a data model and contracts?

The best way to resolve technical unknowns before creating a data model and contracts is to generate a consolidated research document that identifies and addresses all clarification requirements.

How does constitution-based validation work during spec-to-design planning?

Constitution-based validation during spec-to-design planning works by reading a constitution file to assemble project context before planning, then re-checking it after design artifacts are produced to ensure compliance.

Can I run custom extension hooks before and after generating design artifacts?

Yes, you can run custom extension hooks defined in your extensions configuration before planning starts as mandatory pre-checks, and execute post-design hooks after artifacts are produced.

Do I need a specific project structure to generate a spec-to-design implementation plan?

Yes, you need a specific project structure that includes a setup script for JSON context parsing, a constitution file, and the required plan template workflow to generate the design artifacts.

What design artifacts are produced when converting a feature specification into an implementation plan?

The design artifacts produced when converting a feature specification into an implementation plan include a consolidated research document, a data model, API contracts, and a quickstart guide.