Preprint

Handoff as a design constraint

J. Ferreira

·

We argue that designing for handoff from the first week produces materially different architecture than retrofitting documentation at the end, and show two systems built each way against the same brief. The handoff-first build made different choices about configuration, observability, and failure behaviour, and its receiving team made their first unassisted change in four days rather than five weeks. Handoff is a design constraint, not a delivery phase.

Every agency says it hands off. Almost none design for it. This preprint compares two systems we built against the same brief, one designed for handoff from week one, one documented at the end, and follows both receiving teams for ninety days.

Key findings:

  • The handoff-first system put every tunable decision in configuration; the retrofit buried a third of them in code

  • The receiving team of the handoff-first build made their first unassisted change in four days; the other took five weeks

  • Ninety days in, the retrofit team had opened seven support requests; the handoff-first team, one

The design differences were not documentation. They were architectural: fewer implicit dependencies, failure modes that explain themselves, and observability aimed at the person who did not build the system.

We conclude with the checklist we now apply in week one of every engagement, reproduced in full.

CITATION

Ferreira, J. (2025). Handoff as a design constraint. Preprint.

CONFRONTO

More research

All

Strategy

Engineering

Process

Opinion

Field notes

FORJA

MENU

Create a free website with Framer, the website builder loved by startups, designers and agencies.