dispatch

name	dispatch
description	Read subtask.md checkbox state and route to next skill. The ONLY routing point in the execution loop. Called after autoworker:checkpoint, autoworker:gate-check, autoworker:subtask-update, autoworker:subtask-plan, or when resuming after context loss. When lost, call autoworker:dispatch.

autoworker:dispatch — Execution Chain Router (Sole Routing Point)

Reads subtask.md checkbox state and routes to the next skill based on fixed priority.

When to call: Automatically called after autoworker:checkpoint, autoworker:gate-check, autoworker:subtask-update, autoworker:subtask-plan complete, or manually called after context loss.

Execution Flow

1. Locate Subtask

Glob `subtask_*.md` (exclude subtask_template.md) →
  0 found → stop, prompt to create subtask
  1 found → use directly (backward compatible)
  multiple → grep `status:` to filter:
    - Files without status field treated as active (backward compatible)
    - Exactly 1 active → use it
    - 0 active → list all files + status, prompt user to choose
    - >1 active → report anomaly
→ Read → extract:
- Plan section Phase checkbox states
- Verification plan section L1-L4 checkbox states
- Whether a `Gate result:` line exists and its value

2. Status Summary

Tally and output current state:

dispatch (subtask: <filename>):
- Phases: X/N complete
- Tests: L1 done/pending, L2 done/pending/skip, L3 done/pending/skip, L4 done/pending
- Gate: <empty/PASS/FAIL>

3. Fixed Priority Routing

Evaluate in this order, execute the first match, do not continue evaluating:

1. Has incomplete Phase? → invoke autoworker:code
2. All Phases complete, has untested layer? → invoke autoworker:test <level> (pass the first incomplete level)
3. All tests complete, no Gate result? → invoke autoworker:gate-check
4. Gate result = PASS? → output completion report (terminal point, do not invoke any further skill)
5. Gate result = FAIL? → invoke autoworker:subtask-update

4. Output Routing Decision

Append routing decision after the status summary:

→ Invoking autoworker:code to implement Phase Y

or

→ Invoking autoworker:test L2

or

→ Invoking autoworker:gate-check

or

Task complete! Outputting completion report.

or

→ Invoking autoworker:subtask-update (Gate FAIL)

5. Execute Route

After outputting the routing decision, immediately invoke the corresponding skill. Do not wait for user instructions, do nothing else.

Only exception: Gate PASS — directly output completion report, do not invoke any other skill.

Key Constraints

• Only read checkboxes, do not infer or remember: State comes entirely from the file, not from conversation context
• Layers marked "skip" in the verification plan count as complete: If the plan says "skip L2, reason: ..." and has no L2 items → treated as complete
• Accepts no arguments: Entirely driven by file state
• Gate result reading method: grep for Gate result: line, read PASS or FAIL
• PASS is the only terminal point: Only when Gate PASS does dispatch terminate the loop

Important Notes

• dispatch is stateless: Every invocation re-reads the file, ensuring consistency after context loss
• Makes no modifications: Does not edit files, write code, or run tests — only reads and routes
• Loop-safe: dispatch never calls itself — only calls autoworker:code, autoworker:test, autoworker:gate-check, or autoworker:subtask-update