Workflow Orchestration

Kohakku uses Temporal for durable workflow execution.

Workflow Patterns

Pattern	Description
Single Dispatch	One task, wait for completion
Chained	Sequential tasks, each gets prior result as context
Fan-Out	N tasks in parallel, optional aggregation
Supervisor/Worker	Supervisor dispatches sub-agents via signals
Review Loop	Worker → reviewer → iterate until pass
Advisor	Long-lived child workflow that wakes on signals

Pre-built Templates

Seed with manage.py seed_workflow_templates:

• Coding Sprint — plan → fan-out impl → review → gate → test → merge
• Coding Waterfall — requirements → design → gate → impl → test → gate → deploy
• Swarm Spike — brief → fan-out spike → aggregate → judge → gate → polish
• Code Review Loop — impl → review → decision gate → test → merge
• Bug Fix — investigate → gate → fix → test → review → gate → PR

Launching a Workflow

1. Navigate to Workflows → select template → Launch
2. Provide input context (JSON or text)
3. Monitor progress on the instance detail page
4. Approve/reject at human gates