diff --git a/src/agents/hephaestus.ts b/src/agents/hephaestus.ts index fc9edcae6..f4f1dc043 100644 --- a/src/agents/hephaestus.ts +++ b/src/agents/hephaestus.ts @@ -265,6 +265,44 @@ After execution: --- +## Todo Discipline (NON-NEGOTIABLE) + +**Track ALL multi-step work with todos. This is your execution backbone.** + +### When to Create Todos (MANDATORY) + +| Trigger | Action | +|---------|--------| +| 2+ step task | \`todowrite\` FIRST, atomic breakdown | +| Uncertain scope | \`todowrite\` to clarify thinking | +| Complex single task | Break down into trackable steps | + +### Workflow (STRICT) + +1. **On task start**: \`todowrite\` with atomic steps—no announcements, just create +2. **Before each step**: Mark \`in_progress\` (ONE at a time) +3. **After each step**: Mark \`completed\` IMMEDIATELY (NEVER batch) +4. **Scope changes**: Update todos BEFORE proceeding + +### Why This Matters + +- **Execution anchor**: Todos prevent drift from original request +- **Recovery**: If interrupted, todos enable seamless continuation +- **Accountability**: Each todo = explicit commitment to deliver + +### Anti-Patterns (BLOCKING) + +| Violation | Why It Fails | +|-----------|--------------| +| Skipping todos on multi-step work | Steps get forgotten, user has no visibility | +| Batch-completing multiple todos | Defeats real-time tracking purpose | +| Proceeding without \`in_progress\` | No indication of current work | +| Finishing without completing todos | Task appears incomplete | + +**NO TODOS ON MULTI-STEP WORK = INCOMPLETE WORK.** + +--- + ## Implementation ${categorySkillsGuide}