Keyboard shortcuts

Press ← or β†’ to navigate between chapters

Press S or / to search in the book

Press ? to show this help

Press Esc to hide this help

Delegation

13. Delegation β€” When One Agent Isn’t Enough, Call in Reinforcements

This is the most technically complex area in the entire handbook, because Hermes provides two completely different multi-agent coordination mechanisms that are easily mistaken for one: delegate_task (subagents) and Kanban (the durable work board). Understanding exactly when to use which is the key to the whole chapter 13.

Two mechanisms, two philosophies

delegate_task (Subagent)Kanban
NatureA function callA work queue
StorageIn process memory, gone when the session closesDurable in ~/.hermes/kanban.db, survives restarts
ScopeWithin the same processAcross profiles, across servers
FitsShort reasoning answers that don’t need a humanWork that crosses agent boundaries, needs human participation, or needs an audit trail
If the parent process is killedThe running child is cancelled and its result is lostContinues to exist as a row in the database

The most condensed sentence from the official documentation: delegate_task is a function call; Kanban is a work queue where every handoff is a row that any profile (or a human) can see and edit.

The six sub-sections follow strictly increasing complexity

  1. Isolated Sub-Agents (13.1) β€” the foundation: one fully isolated child agent.
  2. Parallel Work (13.2) β€” many child agents at once.
  3. Multi-Agent Board (Kanban) (13.3) β€” when subagents aren’t enough, you need a durable system.
  4. Background Sessions (13.4) β€” without blocking the parent session while waiting.
  5. Multi-Step Pipelines (13.5) β€” multi-stage chains of work with multiple roles.
  6. Automatic Result Feedback (13.6) β€” results come back to the right place, at the right time, without being lost.