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.
-
Read brain/todos.md and review items under ## Open .
-
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.
-
Ask clarifying questions about unclear items using AskUserQuestion . Group related questions — aim for one round of questions, not a back-and-forth. 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?
-
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.
-
Remove any items the user says are already done or no longer relevant.
-
Report a summary of what changed.