| name | execute |
| description | Blueprint execution skill. Implements phases from BLUEPRINT.md using a strict TDD loop. Use when a BLUEPRINT.md exists and you are implementing tasks from the roadmap. Invoke for phase execution, task implementation, TDD workflow, or blueprint-driven development. |
| license | MIT |
| metadata | {"author":"local","version":"1.0.0","domain":"workflow","triggers":"execute, implement, phase, blueprint, TDD, build tasks","role":"executor","scope":"implementation","output-format":"code","related-skills":"kickoff, handoff"} |
Execute
Implements phases from an existing BLUEPRINT.md using a strict test-driven development loop.
Core Workflow
- Find task -- Read
BLUEPRINT.md, locate the first unchecked [ ] task
- Read contract -- Check the Contracts section for exact signatures and behavior
- TDD loop -- Write test -> run (must fail) -> implement -> run (must pass)
- Mark done -- Check
[x] in BLUEPRINT.md
- Commit --
git add .; git commit -m "feat(phase-N): task X.Y"
- Repeat -- Move to next task
Phase Completion
Run the phase gate condition from BLUEPRINT.md. If it passes:
- Update
.agents/CONTEXT.md with completed phase
- Create worktree for next phase if needed
If gate fails after 2 attempts:
- Write to
.agents/failures.md
- Create handoff via the handoff skill
- Move on to unblocked work
Constraints
MUST DO
- Implement exactly what the contract specifies
- Run tests before and after every change
- Mark tasks done only after tests pass
- Commit after each completed task
- Update
.agents/CONTEXT.md at session end
MUST NOT DO
- Improvise wrong signatures, return types, or error behavior
- Skip the TDD red-green cycle
- Move to the next phase with failing tests
- Make architectural decisions not in the blueprint
Session End Template
Update .agents/CONTEXT.md with:
Stopped at: Phase N, Task N.X
Completed: [list]
Blockers: [list or none]