speckit-plan

Generate design artifacts from YAML plan templates across staged milestones.

1|Updated Jun 16, 2025
One-click install
npx skills add https://github.com/imbatony/pavone --skill speckit-plan-imbatony
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: speckit-plan
Source: https://github.com/imbatony/pavone/tree/main/.claude/skills/speckit-plan
Command: npx skills add https://github.com/imbatony/pavone --skill speckit-plan-imbatony

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Speckit-plan provides a structured, template-driven approach to planning and generating design artifacts, reducing ad-hoc planning and ensuring repeatable outcomes across projects.

Core Features & Use Cases

  • Stage-driven artifact generation: loads FEATURE_SPEC, .specify/memory/constitution.md, and applies IMPL_PLAN templates to produce research.md, data-model.md, contracts/, quickstart.md.
  • Context-aware automation: updates agent-context using update-agent-context.sh and restricts unknown items to research tasks.
  • Safe extension hooks: validates and documents extension hooks before_plan and after_plan, with conditional execution and clear prompts.

Quick Start

Run the speckit-plan workflow from the repository root to generate research.md, data-model.md, and contracts/, then review the produced 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 planning workflows to generate design artifacts?

Automate planning workflows by applying plan templates to generate design artifacts. This approach ensures repeatable outcomes across projects by producing structured requirements, data models, and staged milestone outputs.

What is template-driven planning for software design?

Template-driven planning applies YAML templates to produce structured design artifacts. It reduces ad-hoc planning by loading feature specifications and applying IMPL_PLAN templates to generate research.md, data-model.md, and contracts.

How do I generate data models and contracts from a feature spec?

Generate data models and contracts by running a stage-driven workflow from the repository root. The process loads your FEATURE_SPEC and applies templates to automatically produce data-model.md and a contracts/ directory.

Can I extend the planning workflow with custom scripts?

Extend the planning workflow using safe extension hooks. The system validates and documents before_plan and after_plan hooks, executing them conditionally with clear prompts to ensure safe custom automation.

How does context-aware automation update agent context?

Context-aware automation updates agent context using a dedicated shell script. It restricts unknown items to research tasks, ensuring deterministic execution and accurate staged artifact generation throughout the workflow.

What are the limitations of using YAML templates for project planning?

YAML template planning requires structured feature specifications and a repository root setup to function. It restricts unknown items to research tasks, making it less suited for unstructured or ad-hoc planning scenarios.