Execute the task list from tasks.md following TDD and the FRAMEWORK.md change workflow.
Input: Optionally specify a change name. If omitted, infer from context or ask.
Steps
- Load artifacts Load
specs/changes/<name>/tasks.md,plan.md, andspec.md. If tasks.md is missing or incomplete, prompt to use thespec-kit-tasksskill first. - Show current progress Display:
- Change name - Progress: "N/M tasks complete" - Remaining tasks overview
- Execute tasks phase by phase For each pending task, in dependency order: Parallel tasks (
[P]) may be executed concurrently. Pause if:
- Announce the task being worked on. - Follow TDD: write the failing test first, implement the minimum to pass, then refactor. - Keep changes minimal and scoped to the task. - Respect layer boundaries: domain → application → infrastructure. Never invert. - Mark complete in tasks.md: - [] → - [x]. - A task is unclear — ask for clarification before implementing. - Implementation reveals a design issue — suggest updating plan.md. - A test fails unexpectedly — report and wait for guidance. - User interrupts.
- On completion, sync canonical specs When all tasks are complete:
- Update or create specs/features/<name>/spec.md to reflect the implemented behavior. - Use the spec format from FRAMEWORK.md (WHEN/THEN scenarios, RFC 2119 language). - Verify architecture boundaries still hold and tests pass.
Output During Implementation
## Implementing: <change-name>
Task 3/7: <description>
[implementation]
✓ Done
Task 4/7: <description>
[implementation]
✓ DoneOutput On Completion
## Complete: <change-name>
7/7 tasks complete.
specs/features/<name>/spec.md updated.
Definition of done:
✓ Tests written before implementation
✓ Architecture boundaries hold
✓ specs/features/ updatedGuardrails
- TDD is non-negotiable. Never write implementation before the failing test.
- Halt on non-parallel task failures — do not skip ahead.
- Update task checkbox immediately after completion.
- Protect the domain model first; adapt infrastructure around it.
- specs/features/ MUST be updated before the work is considered done.