Next Task: Suggest

Suggest the next logical task I can complete. Selection is grounded in deterministic data wherever possible; you choose between pre-vetted options rather than deriving them.

Step 0: Parse arguments

$ARGUMENTS may carry an assignee, a focus area, both, or neither; positionally, assignee first. Parse by intent, not blind position-splitting:

• No arguments → no assignee, no focus.
• One token/phrase that plainly reads as a person's name → treat as assignee only.
• One token/phrase that plainly reads as a topic/area (e.g. "auth", "the export flow") → treat as focus only, even though it's in the first position. Don't force a topic into the assignee slot.
• Two tokens/phrases where the first is a name and the rest is a topic → first is assignee, remainder is focus.
• If genuinely ambiguous which is which, ask rather than guess.

Step 1: The roadmap

Run python3 "$HOME"/.claude/library/scripts/roadmap.py detect.

Exit 0 (rich roadmap): run python3 "$HOME"/.claude/library/scripts/roadmap.py ready --json and ... stats. The candidates array is the complete set of actionable tasks: every one is unblocked by definition. Each candidate carries an assignee field (empty string when unassigned; never assume unassigned means "anyone" without saying so). Pick using the supplied signals, in this order of pull:

1. Assignee, when given: filter to candidates whose assignee matches. If none match, say so explicitly ("No ready task assigned to {name}."), then fall back to the highest-leverage pick from the full candidate set below; never stay silent and never invent a match.
2. Focus area, when given: filter to candidates matching it
3. transitiveUnblocks: prefer the task that unblocks the most downstream work
4. isMilestoneSink on a milestone with high milestoneDonePct: closing out a nearly-done milestone beats starting a new front

Name the chosen task by its roadmap ID and say which signals drove the choice. If candidates is empty, say so and name the cheapest unblock instead (which blocker or gate, if cleared, frees the most tasks; read the stats breakdown).

Exit 3: tell the user to run roadmap-migrate and stop. Exit 2: no roadmap; point at roadmap-create (or ask for the path if one exists somewhere unusual) and stop. This skill suggests from roadmap data only; it never derives tasks from the codebase.

Always

• If the task will take longer than 45 minutes, subdivide it and suggest the first subtask.
• After suggesting the task, add a "When complete, you'll be able to:" section. Describe concretely and specifically what the user will see on screen or be able to do in the app that they cannot do right now. Focus on observable behaviour, not implementation detail.