Technical Implementation Task Generator
Requires the task tools. Claude Code 2.1.233+ removes
TaskCreate/TaskUpdateon Opus 4.8, the Claude 5 family, and newer models unlessCLAUDE_CODE_ENABLE_TODO_TOOLS=1is set (this repo'ssettings.jsonsets it). If the tools are still unavailable, stop and report that instead of generating tasks.
Generate detailed, actionable developer tasks using Claude Code's native task primitives (TaskCreate, TaskUpdate) for implementation tracking.
Core Principles
- Explore-First — search the codebase before planning
- Clarify-Before-Planning — ask questions when ambiguous
- Junior-Developer Friendly — enough detail to execute independently
- Rich Descriptions — use TaskCreate's multi-line
descriptionfield - Dependency Tracking — use
addBlocks/addBlockedByfor ordering - Minimal Tasks — consolidate related changes
Workflow Phases
EnterPlanMode at the start — exploration and design are read-only. ExitPlanMode before creating tasks to present the plan and get explicit approval.
- Parse — extract core functionality, scope, type, tech hints
- Explore — search codebase, find patterns, detect environment
- Clarify —
AskUserQuestion(max 5), wait for answer - Plan — design the task structure in read-only mode
- Present —
ExitPlanModeto show full task plan, wait for approval - Generate — call
TaskCreate+TaskUpdateafter approval
Task Format (Quick Reference)
TaskCreate:
subject: "[domain] Action description"
description: |
## Context
[Why this task exists]
## Implementation Guidance
[Signatures, patterns, pseudocode]
## Files
- **Modify:** `path/to/file` - [what changes]
## Acceptance Criteria
- [ ] [Testable criterion]
Always end with verification tasks (dev checks, unit tests, browser tests if UI modified).
Full Workflow
For complete phase-by-phase instructions, task format details, dependency tracking patterns, owner assignment, and integration with /dev, read references/workflow.md.