1---
2name: tasked-phases
3description: Use when the user wants a spec turned into phased work with checklist tasks tracked by the tasked_phases tool, or when ongoing work should be tracked phase by phase.
4---
5
6# Tasked Phases
7
8Use the `tasked_phases` tool as the source of truth for the spec, phases, current focus, and checklist progress.
9
10## Workflow
11
121. Clarify missing requirements when the spec is ambiguous.
132. Save the accepted spec with `tasked_phases` using `set_spec`.
143. Create or materially revise the plan with `replace_plan`.
154. Keep phases small and tasks concrete enough to check off.
165. Set the focus with `set_current_phase` and pass the target `phaseId`.
176. Call `set_task_checked` immediately after each checklist task is completed.
187. Use `set_phase_checked` to complete or reopen every task in a phase. The phase must already contain at least one task.
198. When every task is checked, treat the plan as closed. For unrelated work, call `clear` to discard the plan, or call `set_spec` immediately followed by `replace_plan` to record a new spec and a new set of phases.
20
21Successful mutations return one progress line; use `get_status` or
22`replace_plan` for details. `set_task_checked` changes one task;
23`set_phase_checked` changes every task in a phase.
24
25## Planning rules
26
27- Prefer 3–7 phases unless the task is tiny.
28- Each task should describe an observable outcome.
29- Avoid vague tasks such as “work on this” or “finish implementation”.
30- Keep the stored spec and plan concise and operational.
31
32## Tool guidance
33
34- Use `get_status` before relying on remembered state or revising a long-running plan.
35- Use `replace_plan` for a substantial restructuring; use `add_*`, `update_*`, and `remove_*` for small changes.
36- Pass `phaseId` as the raw ID shown in brackets, without the brackets. The tool also accepts a complete phase label or a unique phase title when recovering from copied output.
37- Do not rely on prose alone for completion state; update the tool after each completed task.