Overview
Use this handoff pattern:
- Plan interactively. Resolve the mission, constraints, architecture, and acceptance criteria with
the human present.
- Select an AFK-suitable task. The task should be bounded, testable, and unlikely to require major
new product decisions.
- Prepare the sandbox. Provide the repository, required tools, and the task environment inside the
sandbox.
- Define the output. Ask for a branch, commit, pull request, report, or another artifact that can
be inspected later.
- Run checks automatically. Include the tests, type checks, or review procedure that should execute
before the task is returned.
- Capture an activity record. Preserve the agent's actions and results so the human can understand
how the output was produced.
- Review and integrate. Pull the changes back, assess them against the original objective, and
merge only when the result is acceptable.
- Parallelize separate tasks. Start multiple agents when each task is clearly scoped.
A common division is to use a local interactive agent for planning and selected implementation, then send well-scoped tasks to sandboxed agents triggered through repository actions.