/speckit.plan
Agent skill wrapper for the Claude command /speckit.plan.
When the original command text references {{INPUT}}, $1, or named arguments, map them from the user's current request.
Command Instructions
Produce a complete technical implementation plan from a feature specification.
Steps
- Locate the spec:
- If input names a feature or file path, use it. - Otherwise check .specify/specs/*/spec.md; if multiple, ask which to plan. - Fall back to spec.md in the project root. - Set FEATURE_DIR to the spec's parent directory.
- Load context: Read
spec.mdand.specify/memory/constitution.md. Detect tech stack frompackage.json,mix.exs,Cargo.toml,pyproject.toml,go.mod, etc. - Phase 0 — Research: For each
[NEEDS CLARIFICATION]marker and technical unknown:
- Search the codebase for existing patterns and abstractions. - Identify required external dependencies. - Write findings to FEATURE_DIR/research.md: # Research: <Feature Name> ## Unknowns Investigated ## Existing Patterns Found ## External Dependencies - Resolve all open questions before proceeding.
- Phase 1 — Design artifacts: Write
FEATURE_DIR/plan.md:# Technical Plan: <Feature Name> ## Architecture Overview ## Technology Choices (with rationale) ## Component Design ## Implementation Phases ## Risk Assessment ## Open Technical QuestionsWriteFEATURE_DIR/data-model.md(only if the feature involves persistent data):# Data Model: <Feature Name> ## Entities (fields, types, constraints, relationships) ## Migrations (in dependency order) ## Indexes (with justification)CreateFEATURE_DIR/contracts/<interface-name>.mdfor each external interface:# Contract: <Interface Name> ## Signature / Endpoint ## Request / Input Schema ## Response / Output Schema ## Error Conditions ## Constraints - Constitution check: Verify the plan does not violate any MUST or SHOULD NOT principle. If violations found, flag
[CONSTITUTION CONFLICT]and pause for user review before continuing. - Report: List all files created with paths and one-line summaries.
Next step: Run /speckit.analyze to validate consistency, or /speckit.tasks to generate the task breakdown.
{{INPUT}}