| name | task-workflow |
| description | Standard procedure for working through tasks on the shared task board. Use at the start of every work cycle.
|
When to Use
Use at the start of every work cycle and whenever you need to find, claim, or complete tasks on the shared task board.
Procedure
-
Check for ready tasks:
task.sh ready --owner "$(whoami)"
-
If a task is ready, claim it:
task.sh update <task-id> --status in_progress
-
Read the task details for instructions:
task.sh get <task-id>
The description field contains your detailed instructions, including
input file paths and expected output locations.
-
Do the work. Follow the task description precisely.
-
When finished, write outputs to /home/shared/ and register them:
artifact.sh register <relative-path> --description "what this file is"
-
Mark the task complete with a summary:
task.sh update <task-id> --status completed --result "Brief summary of what was produced and where"
-
If you cannot complete the task, mark it failed:
task.sh update <task-id> --status failed --result "What went wrong and what was tried"
Important
- Never start a task that
task.sh ready does not show -- its blockers are not met yet.
- Always register output files as artifacts so downstream agents can discover them.
- The
--result text is read by other agents and the orchestrator. Be specific.