Delegation

Delegation

Spawn a sub-agent to carry out a scoped task in its own session, then collect what it found. The child gets a fresh context; only its summary comes back here.

When to Use

• Work that would flood this conversation. Reading twenty files to answer one question is the child's job, not this turn's.
• Genuinely parallel work. Several independent questions can run at once instead of in sequence.
• Long-running work during a heartbeat. Spawn, let the beat end, collect on a later beat with action: "get".

When Not to Use

• The task needs the thread of this conversation — a child cannot see it.
• One tool call would do. Delegation costs a whole model run; do not spend it on something a single recall answers.

How

• manage_sessions with action: "spawn" and a self-contained goal. The child inherits your tools but none of your history, so state everything it needs: what to produce, what "done" looks like, and any facts it cannot look up.
• action: "list" and action: "get" to check on and collect results — free.
• action: "cancel" if it is no longer needed. Do not leave work running that nobody will read.

Notes

• Write the goal the way you would brief a competent stranger: they are capable and they know nothing about this conversation.
• The child's intermediate reasoning is not returned. If you need the workings and not just the answer, ask for them in the goal.