What problem does it solve?
This Skill automates the handoff-to-implementation workflow so agents and developers do not have to manually manage specs, cross-file refactors, test cycles, and archival steps. It ensures work is processed in queue order, architectural forks are resolved before mechanical edits, and each change is verified and committed with tests.
Core Features & Use Cases
- Spec-first workflow: Create missing specs from templates, capture open decisions, and commit the spec before any implementation begins.
- Neighborhood batching and execution: Group acceptance criteria that touch the same files, dispatch execution-agent batches to write failing tests, implement changes, run pnpm check, and commit per-AC.
- Verification and archival: Require pnpm check passing, update handoff.md by removing completed entries, archive the spec with an Outcome and reflection, and record any cross-cutting gotchas.
- Human-in-the-loop safety: Resolve architectural choices with the user when needed and require explicit approval before proceeding to the next queued slice.
Quick Start
Read docs/handoff.md, confirm or create the spec for the first task, resolve any open design decisions, dispatch execution-agent batches to implement grouped ACs with tests and pnpm check, commit and archive the spec, then request user approval to continue.