| name | speckit-auto-run |
| description | Run the full speckit workflow end-to-end — specify, plan, critique, tasks, implement, review, extract — making all decisions autonomously. |
| compatibility | Requires spec-kit project structure with .specify/ directory |
| metadata | {"author":"github-spec-kit","source":"auto:commands/run.md"} |
User Input
$ARGUMENTS
You MUST consider the user input before proceeding (if not empty).
Outline
You are running the full speckit pipeline end-to-end. The user's input (above) is the feature description that will seed the specification phase.
Execute every phase below in order, making all decisions autonomously. Do not stop to ask the user for input between phases — if a phase requires choices (e.g., clarification questions in specify, research decisions in plan), use your best judgment and proceed. The user expects a hands-off, one-shot execution.
After each phase, invoke the speckit-checkpoint-commit skill to commit the artifacts produced by that phase before moving on.
Each phase below is executed by invoking the named skill (e.g. via the agent's Skill tool). Skills are agent-agnostic, so this workflow runs identically across any harness that supports skill discovery — not only those exposing speckit slash commands.
Phase 1 — Specify
Invoke the speckit-specify skill with the user's feature description ($ARGUMENTS).
- Complete the full specify workflow: generate a short name, create the spec directory, write
spec.md, run quality checks.
- If clarification questions arise, answer them yourself based on context and best judgment — do not pause for user input.
- Commit the spec artifacts.
Phase 2 — Plan
Invoke the speckit-plan skill.
- Complete the full plan workflow: research unknowns, generate
plan.md, research.md, data-model.md, API contracts, quickstart.md.
- Make all design decisions autonomously.
- Commit the plan artifacts.
Phase 3 — Critique
Invoke the speckit-critique-run skill.
- Run the dual-lens (Product + Engineering) critique against
spec.md and plan.md before any tasks are generated.
- For any 🎯 Must-Address findings, apply the suggested fixes to
spec.md / plan.md autonomously and commit them — do not pause for user approval.
- For 💡 Recommendations, apply them when the fix is clear and low-risk; otherwise note and move on.
- 🤔 Questions: resolve with your best judgment based on context (same rule as the Specify phase).
- If the verdict is 🛑 RETHINK, loop back to
speckit-plan (or speckit-specify if the spec itself is the problem), re-run the critique, then continue.
- Commit the critique report and any spec/plan updates before moving on.
Phase 4 — Tasks
Invoke the speckit-tasks skill.
- Generate the full
tasks.md with dependency-ordered, actionable tasks.
- Skip the optional
speckit-analyze skill unless something looks inconsistent — use your judgment.
- Commit the tasks artifact.
Phase 5 — Implement
Invoke the speckit-implement skill.
- Execute all tasks from
tasks.md phase by phase.
- Commit at natural implementation checkpoints (after each task or logical group of tasks).
- Run formatters and linters as required by the project.
- If tests fail, fix them before moving on.
Phase 6 — Review
Invoke the speckit-review-run skill.
- Run the comprehensive review across all enabled agents.
- For any findings rated high severity or above, fix them immediately and commit the fixes.
- For lower-severity findings, note them but do not block progress.
Phase 7 — Extract
Invoke the speckit-extract-run skill.
- Extract ADRs, knowledge, and guidelines from the completed spec into
dev/.
- Commit the extracted documentation.
Completion
After all phases are complete, provide a brief summary:
- Feature name and spec directory
- Number of tasks completed
- Any review findings that were fixed
- Any notable decisions you made autonomously
