Orchestrate Tasks

Orchestrate Tasks

Fan large tasks across parallel agents with planner/worker/verifier roles. Adapted from Cursor's orchestrate plugin for CK governance.

Do NOT use when

• Single-agent task (just use controlkeel-governance)
• Task has no parallelizable slices
• Budget is tight (orchestration is expensive — multiple delegations)

Principles

1. Planners own scope, not code — decompose, publish tasks, read handoffs, decide next. No file edits.
2. Workers are isolated — one task, one agent, one scope. Talk up through handoffs only.
3. Verifiers check independently — read worker output, verify against acceptance criteria.
4. State on disk — ck_memory_record and git, no long-running agent state.
5. Continuous convergence — each cycle produces progress. No progress → escalate.

Workflow

1. Check ck_budget — orchestration costs multiple delegations. Stop if insufficient.
2. Decompose into tasks (or use existing plan-slice output). Each task: name, type (worker/verifier/subplanner), scoped goal, acceptance criteria, dependencies, paths.
3. Record plan via ck_memory_record (type: decision, tags: orchestration-plan).
4. Submit plan via ck_review_submit (review_type: plan). Wait for approval before spawning.
5. Execute loop:
   • Select ready tasks (dependencies satisfied, not started)
   • Check budget before each delegation
   • Delegate: ck_route → ck_delegate
   • Collect handoffs
   • Verify completed tasks
   • ck_rollback checkpoint after each success
   • Decide: new tasks, retry failures, or completion
6. Synthesize: ck_git_diff for total change, parallel-review if large.

Failure recovery

• Worker failure → record ck_finding, retry once, escalate if retry fails
• Budget exhaustion → checkpoint state, stop, record for resumption
• Verifier failure → worker output not trusted, fix or escalate

Output

• Approved orchestration plan
• Delegated tasks with handoffs
• ck_finding for failures
• ck_rollback checkpoints
• Synthesized result

Reference

• Handoff format