sp-auto

Routes to the next Spec Kit Plus workflow step based on repository state.

Updated Jul 6, 2026
One-click install
npx skills add https://github.com/chenziyang110/launchdeck --skill sp-auto-chenziyang110
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: sp-auto
Source: https://github.com/chenziyang110/launchdeck/tree/main/.claude/skills/sp-auto
Command: npx skills add https://github.com/chenziyang110/launchdeck --skill sp-auto-chenziyang110

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? When working through a Spec Kit Plus workflow, it is easy to lose track of which command should run next, especially across features, quick tasks, debug sessions, and discussion handoffs. This Skill reads the repository's authoritative workflow state files and resumes the correct next step automatically, so you never have to guess or manually name the exact command. ## Core Features & Use Cases - State-driven routing: Inspects workflow-state.md, implement-tracker.md, human-acceptance.json, quick-task STATUS files, debug sessions, and discussion handoff state in priority order to select exactly one safe canonical next command. - Faithful continuation: Executes the routed command under its own full contract, preserving canonical next_command tokens and artifact semantics rather than blending workflows. - Safe diagnostics: When state is missing, stale, or conflicting, it stops in read-only mode and reports the exact blocker plus the repair or canonical command needed to unblock. - Use Case: You return to a spec-kit project after a break and cannot remember whether you finished planning or task generation. Invoke the auto entrypoint and it reads the feature's workflow state, routes to /sp.tasks or /sp.implement as recorded, and continues that workflow. ## Quick Start Ask the agent to continue my Spec Kit Plus workflow from wherever the repository state says I left off.

Frequently Asked Questions about sp-auto

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I resume a Spec Kit Plus workflow without knowing the next command?▼

Invoke the sp-auto entrypoint and it inspects the repository's workflow state files in priority order, selects the one safe canonical next command such as /sp.plan or /sp.implement, and continues under that command's full contract.

What state files does sp-auto check to decide the next step?▼

It checks the feature workflow-state.md first, then implement-tracker.md, human-acceptance.json, quick-task STATUS.md files, debug session files, and discussion-state.json handoffs, preferring the highest-authority active source.

Does sp-auto work without a .specify directory?▼

No. It requires a spec-kit project structure with a .specify/ directory, since its routing decisions depend on the workflow state surfaces and templates stored there.

What happens when sp-auto finds conflicting or missing workflow state?▼

It stops in read-only diagnostic mode, reports which state files were checked and what was missing or conflicting, and recommends the exact repair or canonical command needed before it can safely resume.

Can sp-auto replace commands like sp-plan or sp-implement?▼

No. It is only a router and resume entrypoint. It never invents new phase progressions and always executes the routed command under that workflow's existing contract, artifacts, and completion criteria.