@@ -5,9 +5,9 @@ Use proactively when:
55- The task requires 3+ distinct steps or actions (not just 3 tool calls for a single conceptual step)
66- The work is non-trivial and benefits from planning
77- The user provides multiple tasks (numbered or comma-separated) or explicitly asks for a todo list
8- - New instructions arrive — capture them as todos
9- - You start a task — mark it `in_progress` (only one at a time) before working
10- - You finish a task — mark it `completed` and add any follow-ups discovered during the work
8+ - New instructions arrive - capture them as todos
9+ - You start a task - mark it `in_progress` (only one at a time) before working
10+ - You finish a task - mark it `completed` and add any follow-ups discovered during the work
1111
1212## When NOT to use
1313Skip when:
@@ -16,10 +16,10 @@ Skip when:
1616- Tracking adds no organizational value
1717
1818## States
19- - `pending` — not started
20- - `in_progress` — actively working (exactly ONE at a time)
21- - `completed` — finished successfully
22- - `cancelled` — no longer needed
19+ - `pending` - not started
20+ - `in_progress` - actively working (exactly ONE at a time)
21+ - `completed` - finished successfully
22+ - `cancelled` - no longer needed
2323
2424## Rules
2525- Update status in real time; don't batch completions
@@ -32,13 +32,13 @@ Skip when:
3232## Examples
3333
3434Use it:
35- - "Add a dark mode toggle and run the tests" → multi-step feature + explicit verification
36- - "Rename getCwd → getCurrentWorkingDirectory across the repo" → grep reveals 15 occurrences in 8 files
37- - "Implement registration, catalog, cart, checkout" → multiple complex features
35+ - "Add a dark mode toggle and run the tests" -> multi-step feature + explicit verification
36+ - "Rename getCwd -> getCurrentWorkingDirectory across the repo" -> grep reveals 15 occurrences in 8 files
37+ - "Implement registration, catalog, cart, checkout" -> multiple complex features
3838
3939Skip it:
40- - "How do I print Hello World in Python?" → informational
41- - "Add a comment to calculateTotal" → single edit
42- - "Run npm install and tell me what happened" → one command
40+ - "How do I print Hello World in Python?" -> informational
41+ - "Add a comment to calculateTotal" -> single edit
42+ - "Run npm install and tell me what happened" -> one command
4343
4444When in doubt, use it.
0 commit comments