Workflows

Common patterns for using HZL effectively.

Which Workflow?

                    ┌─────────────────────────┐
                    │  Starting new work?     │
                    └───────────┬─────────────┘
                                │
                    ┌───────────▼─────────────┐
                    │  Multiple agents?       │
                    └───────────┬─────────────┘
                           yes/ \no
                             /   \
    ┌────────────────────────┐   ┌────────────────────────┐
    │  Multi-Agent           │   │  Single agent,         │
    │  Coordination          │   │  multiple sessions?    │
    └────────────────────────┘   └───────────┬────────────┘
                                        yes/ \no
                                          /   \
              ┌────────────────────────────┐   ┌────────────────────────┐
              │  Session Handoffs          │   │  Single Agent Workflow │
              └────────────────────────────┘   └────────────────────────┘

Workflow Guide

Scenario	Workflow
One agent, work spans sessions	Single Agent
Multiple agents on same project	Multi-Agent Coordination
Passing work between sessions	Session Handoffs
Large feature with subtasks	Breaking Down Work
Stuck waiting on external factors	Blocking & Unblocking
Humans monitoring/steering agents	Human Oversight
Organizing multiple projects	Project Organization

Quick Reference

# Start work
hzl task next -P myproject --claim --assignee my-agent

# Record progress
hzl task checkpoint <id> "milestone achieved"

# Mark blocked
hzl task block <id> --comment "waiting on X"

# Complete
hzl task complete <id>

---

Table of contents

• Single Agent
• Multi-Agent Coordination
• Session Handoffs
• Breaking Down Work
• Blocking & Unblocking
• Human Oversight
• Project Organization