Taskwork — taskwarrior convention cheat-sheet

This is the operational, invocable version of guides/taskwarrior-workflow.md. Use it any time you need the exact command for a taskwarrior step, without reading the full narrative guide.

Find or start the task

task project:<repo> list

No task yet? Create one before writing code:

task add "<title>" project:<repo> +feature
task <id> start

Read prior handoffs

Before doing anything else in a resumed session, read the task's annotations — they're the last agent's (or your own past session's) notes:

task <id> information

Log as you go

task <id> annotate "decision: <choice> because <reason>"
task <id> annotate "gotcha: <non-obvious constraint>"

Handoff before finishing

Always leave one of these before context closes, even mid-task:

task <id> annotate "handoff: done=<...>, next=<...>, traps=<...>"
task <id> stop

Task fully done:

task <id> done

Convention

Prefix annotations with handoff:, decision:, or gotcha: — nothing else. This lets future agents grep the task's annotations for the kind of context they need instead of reading everything.