speckit-companion-auto

Runs the full spec-kit pipeline from specify through mark-complete without pausing for approval.

1|Updated Nov 21, 2020
One-click install
npx skills add https://github.com/LuanDopke/persefone --skill speckit-companion-auto-luandopke
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: speckit-companion-auto
Source: https://github.com/LuanDopke/persefone/tree/main/.agents/skills/speckit-companion-auto
Command: npx skills add https://github.com/LuanDopke/persefone --skill speckit-companion-auto-luandopke

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Running a spec-driven development workflow manually means typing each pipeline command (specify, plan, tasks, implement, mark-complete) and waiting at every review gate, which is slow when you just want a feature spec executed end-to-end without supervision. ## Core Features & Use Cases - Unattended Pipeline Orchestration: Dispatches each per-step /speckit.companion.* command in order, invoking the real command bodies rather than improvising artifacts, so sizing, design docs, and wave-structured task lists stay faithful to the manual flow. - Automatic Feature Directory Management: Mints a fresh numbered specs/ directory for new work and never writes into a directory that already contains a spec.md, protecting completed specs from being clobbered. - Lifecycle Timing and Checkpoint Recording: Records step, substep, and per-task finish events via write-context.py, sets unattended: true so checkpoint hooks record-and-continue instead of prompting, and ends the spec at status: completed. - Use Case: You describe a new feature in one sentence and let the agent generate the spec, plan, research and data-model docs, contracts, task list, and implementation, then mark the spec complete — all without answering a single review prompt. ## Quick Start Ask the agent to run the full companion pipeline unattended for your feature, for example: run speckit companion auto to build user authentication with passwordless email login.

Frequently Asked Questions about speckit-companion-auto

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

FAQPage Schema
How do I run the full spec-kit pipeline automatically?▼

Invoke the companion auto command with a feature description and it dispatches specify, plan, tasks, implement, and mark-complete in order. It sets unattended: true so checkpoint hooks record and continue instead of waiting for approval.

What is the difference between companion auto and running each speckit command manually?▼

Auto invokes the same per-step commands in sequence but skips the human pause at review gates, recording checkpoints and continuing instead. All artifacts, sizing, and design docs are identical to the manual flow because the real command bodies run.

Does speckit companion auto require a specific project structure?▼

Yes, it requires a spec-kit project with a .specify/ directory and the companion extension scripts such as write-context.py. It creates a fresh numbered directory under specs/ and points .specify/feature.json at it before starting.

What happens if my environment can only run one command at a time?▼

Auto degrades gracefully: it runs the first step, records progress, and stops without error. The run stays valid and resumable, and remaining steps are triggered one at a time by the developer or the companion panel.

Why does companion auto refuse to reuse an existing feature directory?▼

The .specify/feature.json file points at the previous spec, which is often already completed, so reusing it would overwrite finished work. Auto always mints the next numbered specs/ directory unless you explicitly name a target path.