← Back to all posts

Practitioner Notes

The Specification Was Perfect. Engineering Couldn’t Use It.

Craig Hankins, Besserhealth

We had 196 capabilities specified on the design side. The engineering team had approximately 38 in their initial inventory.

Both teams thought they were working from the same specification.

The gap between those two numbers — roughly 96 capabilities that were gaps, 39 more that were partial matches — wasn't discovered during a planning handoff or a sprint review. It was discovered when someone manually compared the two documents side by side, after specification work was substantially complete.

At that point, the question wasn't "what do we build?" It was "which of these 196 things do we actually build, in what sequence, and what happens to the rest?" That's not a handoff problem. That's a specification problem masquerading as a handoff problem.

The Production Speed Illusion

AI-augmented product teams can produce detailed behavioral specifications faster than engineering teams can absorb them. That gap — between design production velocity and engineering intake capacity — is one of the most underappreciated risks in AI-assisted product development.

The problem isn't that the specifications are wrong. On the engagement described above, the specifications were genuinely rigorous: detailed behavioral contracts, acceptance criteria, data element definitions, source traceability from research through to feature requirements. By any internal quality standard, the specification work was excellent.

The problem is that specification quality and engineering readiness are not the same thing. A specification can be internally complete and externally inaccessible at the same time. Turning up the faucet faster doesn't change the size of the opening on the engineering end.

What Engineering Actually Needs

The translation from design specification to engineering intake requires one thing the specification document itself doesn't always provide: an explicit statement of what engineering is being asked to build, and an equally explicit statement of what it is not.

In traditional product processes, this gap is negotiated during sprint planning and estimation sessions. Those conversations are slow and often repetitive — but they do a specific job. They force the design side to say, out loud, "here is exactly what we need from engineering in this cycle."

In AI-augmented work, where specification volume significantly exceeds what those conversations can absorb, an explicit handoff document becomes the mechanism that performs that job.

The Lane Boundary Handoff Document

IDPD treats the Lane Boundary Handoff Document as a mandatory Phase 5 output. Its job is to answer three questions for the engineering team before they write a line of code.

What, precisely, is in scope for this build cycle? Not as a list of features — as a set of behavioral contracts with acceptance criteria clear enough that the engineering team can confirm, before building, that they understand what "done" means.

What is explicitly out of scope? Engineering teams build to the edges of what they understand to be in scope. Without an explicit out-of-scope list, those edges are defined by interpretation rather than decision.

What decisions are product-mandated versus engineering-discretionary? Some specification elements describe product behavior that must be implemented exactly as specified. Others describe product intent that engineering should interpret and implement at their discretion. When those two categories aren't distinguished, engineering has to guess.

The 196 vs. 38 Gap

On the engagement above, the gap between design inventory and engineering inventory wasn't a failure of the specification documents. It was a failure of translation between them. The design team had specified rigorously. The engineering team had built an inventory of what they understood themselves to be responsible for. Neither team had explicitly compared the two lists before specification was declared complete.

The reconciliation required after the comparison was substantial. Not because anyone had done bad work — but because the mechanism for comparing design intent to engineering scope had been skipped.

That mechanism — the explicit capability audit, the out-of-scope enumeration, the decision-versus-discretion distinction — is what the handoff document enforces.

Production Velocity Requires Intake Capacity

The honest observation about AI-augmented product design is that it changes one side of the handoff equation dramatically and leaves the other side unchanged. The design side can produce more, faster, at greater detail. The engineering side operates at the same intake capacity it always has.

Closing that gap requires treating the handoff document as seriously as the specification itself. Not as a summary or an excerpt — as a distinct artifact with a distinct job: translating the specification into something engineering can receive.

A specification that engineering can't use is a document, not a product asset. The handoff document is what makes the transition.

The principle: Specification fidelity is not the same as engineering readiness. The handoff document exists to close that gap — not the specification document itself.

Frequently Asked Questions

What is a Lane Boundary Handoff Document in IDPD?
The Lane Boundary Handoff Document is a mandatory Phase 5 output in IDPD that translates product specifications into engineering-ready scope. It explicitly defines what is in scope, what is out of scope (with specific deferrals named), and which decisions are product-mandated versus engineering-discretionary.

Why can't a well-written product specification serve directly as the engineering handoff?
A specification is written for product stakeholders as a governing reference for design decisions. A handoff document is written for the engineering team and answers the specific questions they need answered before building: what exactly is in scope, what is explicitly deferred, and where they have discretion. A specification that tries to do both jobs tends to do neither well.

What causes the gap between design specification and engineering inventory?
Usually the absence of an explicit comparison mechanism before specification is declared complete. Design teams produce to the edges of the product intent. Engineering teams build inventories of what they understand to be their responsibility. Without a structured audit comparing the two before handoff, the gap surfaces during implementation rather than before it.

How does AI-augmented work change the specification-to-engineering dynamic?
AI significantly accelerates design production velocity without changing engineering intake capacity. The gap this creates requires an explicit handoff mechanism — one that translates specification volume into engineering-actionable scope.

Written by Craig Hankins, Besserhealth LLC

← Back to all posts