Handover

Fully execute a task inside a subagent. Main agent only provides context and reports results — all work happens in the subagent.

Critical rule

The subagent executes the complete task. Main agent does NOT start the work, explore code, or make partial decisions before handing off. Only exception: user explicitly says "do X on main agent, then handover Y to subagent."

Workflow

1. Obtain handoff doc

If a handoff doc was already written earlier in this session, decide whether it still covers the context the subagent needs. Use your judgment — if nothing meaningful changed since that doc was written (no new decisions, no significant code changes, no shifted direction), reuse it. Tell the user which doc you're reusing and why.

If context has meaningfully evolved, or no handoff doc exists yet in this session, invoke /handoff to produce a fresh one.

Override: User can force a fresh doc with /handover --fresh <task> or say "create a new handoff."