---
name: refine
description: >-
  Sharpen todo items in brain/todos.md into precise, actionable prompts via targeted questioning.
  Triggers: "refine", "refine todos", "clarify todos".
---

# Refine

Read `brain/todos.md` and refine unclear items into actionable prompts through targeted questioning.

## Workflow

**Use Tasks to track progress.** Create a task for each step below (TaskCreate), mark each in_progress when starting and completed when done (TaskUpdate). Check TaskList after each step.

1. **Read** `brain/todos.md` and review items under `## Open`.
2. **Triage** each item: is it clear enough to act on without further context? A clear item specifies *what* is wrong, *where* it happens, and *what the fix should be*. Skip items that already meet this bar.
3. **Ask** clarifying questions about unclear items using `AskUserQuestion`. Group related questions — aim for one round of questions, not a back-and-forth (to minimize back-and-forth and user fatigue). Good clarifying questions target:
   - **What** — what exactly is the problem or desired behavior?
   - **Where** — which part of the app, which component, which flow?
   - **How** — how should it work instead? What does "fixed" look like?
4. **Rewrite** unclear items in-place using `Edit`, incorporating the user's answers. Each rewritten item should be a self-contained prompt that another agent could act on without additional context.
5. **Remove** any items the user says are already done or no longer relevant.
6. **Report** a summary of what changed.