A handoff prevents context loss when responsibility moves between agents or execution modes. An Architect may inspect dependencies, make design decisions, and reject alternatives, yet an Implementer sees none of that if the workflow passes only a mode switch or raw conversation history. The reliable protocol is a structured artifact containing conclusions rather than exploratory noise. section 5.4.2
Make the handoff artifact operational rather than narrative:
- Record selected approaches and the reasons rejected alternatives were not used. section 5.4.2
- List files to modify, constraints to preserve, and reference files already examined. section 5.4.2
- Generate the document at the end of the producing session, when the agent still has complete conversation context. section 5.4.2
- Use a repository template or an equivalent workflow convention so transitions remain repeatable and reviewable. section 5.4.2
Architecture to implementation
A useful handoff can direct an Implementer to add exponential-backoff retries and a circuit breaker to PaymentGateway, identify the implementation and test files, preserve the existing interface, retry only transient errors, and apply a five-failures-in-sixty-seconds threshold. It also records why a dependency-based and middleware-based approach were rejected.
Formalization is a tradeoff, not an automatic improvement. Small teams with simple projects may communicate more cheaply by talking, while large teams, complex systems, and regulated environments gain from consistent artifacts, reduced confusion, onboarding support, incident reduction, and audit readiness. Introduce the protocol when coordination risk exceeds its maintenance cost. section 5.5.3



