Self-training · the book’s worked example

The Two-Decibel Question

One engineering question, answered twice: once with the documents your organisation has today, once with the primitives the book argues for. You will answer it both times yourself.

About half an hour · no signup, nothing you enter leaves this page · progress is saved in your browser

Step 1 of 8 Start over
Step 1 · The question

Monday, 08:40

You joined the programme three weeks ago as an HV systems engineer, on a passenger electric vehicle. Your predecessor has left the company. This morning the programme manager forwards you a message from the homologation team:

Forwarded message · homologation team
VP2 rev F is being released for production. Before we freeze, please confirm: can we rely on the EMC result at the motor terminal? Need an answer today.

You have never heard of the EMC result at the motor terminal. You do what every engineer does: you search the drives and ask around. Forty minutes later you have three artefacts. This is everything the organisation can give you.

Test report excerpt · T-789 · May 2026
Radiated emissions, 30–100 MHz band, measured at motor terminal. Result: 2 dB short of the regulatory margin. Outcome recorded: conditional. (Remaining 14 pages: setup, instrumentation, plots.)
Design review minutes · 22 May 2026
EMC results were reviewed. The margin shortfall at the motor terminal was discussed and considered acceptable given previous platform experience. Action: proceed with current design. Attendees: 11 names, two of whom still work here.
Email thread · 23 May 2026
“…as agreed in Thursday’s review we stay with connector family A. I know the schedule looks tight but that was not the driver here. Let’s document properly later. /J” J left the company in March.
J · left in March
The review that accepted the shortfall: eleven attendees, two still in the organisation.
Your answer to homologation, based on what you have:
And your honest confidence in that answer:
Step 2 · The same estate, one layer up

Now run the question again

Same organisation. Same PLM, same test lab, same people, same documents underneath. One difference: this organisation operates a thin federation layer above its systems, where seven kinds of engineering context live as managed objects. The documents still exist; the layer holds what the documents cannot: identity, ownership, conditions, and references with authority left where it belongs.

PLMMESERPauthority:source
The estate, one layer up: the sources keep authority; the layer adds the objects they never had.

You type the same question into the layer, and instead of a folder of PDFs it gives you a starting object:

system:hvbusin-effect
nameHigh-voltage bus
scopeEnergy distribution between battery pack, inverter, and motor terminal; excludes LV network and charging interface.
ownerHV systems lead
realized_byplm://demo/ebom/HVB-100authority: source
interfacesinterface:i4-motor-terminalauthority: layer
What you are looking at. The first primitive: a system as a bounded object with scope and an owner, not a hierarchy inferred from the BOM. And the architecture’s quiet rule, visible in the realized_by field: the BOM stays in the PLM, and the layer points at it with authority: source. The layer never masters what a source system masters. It adds the objects the sources never had.
The question concerns EMC at the motor terminal. Where does the trace go next?
Step 3 · The contract

The boundary is an object

interface:i4-motor-terminalin-effect
name / versionI4 – motor terminal · v3
side Asystem:hvbus — supply within voltage/ripple envelope; shielding per contract
side Bplm://demo/system/motorauthority: source — terminal impedance and EMC behaviour per contract
contractElectrical + EMC contract at the motor terminal: pinout, voltage class, shielding, radiated-emissions allocation 30–100 MHz.
change_controlNeither side changes the contract alone; change via interface owner with both parties’ sign-off.
verificationsverification:t789-revCauthority: layer
system:hvbusmotor(source system)both sign
A boundary as an object: two parties, one contract, an owner, a version, and change control that binds both sides.
The second primitive: interface as a first-class contract. Two sides, each with obligations. An owner. A version. Change control that binds both parties. In Step 1, nothing could even represent this: the test report mentioned a terminal, the minutes mentioned a margin, and the contract that connects them existed only in the heads of the eleven attendees, nine of whom are gone.
The 2 dB shortfall was measured at this terminal. Whose problem is it?
Step 4 · The evidence that knows what it tested

The test report, as a managed object

verification:t789-revCin-effect
subjectinterface:i4-motor-terminal
methodtest
evidencemes://demo/test/T-789-revCauthority: source — the 14-page report from Step 1, still in the MES where it belongs
resultconditional · radiated emissions 30–100 MHz: 2 dB short of regulatory margin at motor terminal
configuration_bindingconfigstate:vp2-rev-eauthority: layer
configstate:vp2-rev-erecorded
kindas-designed
ofsystem:hvbus
snapshotplm://demo/ebom/HVB-100/revEauthority: source
recorded2 May 2026
rev Crev Drev Erev Fnot yet testedT-789-2 dBconditional
Evidence with lineage: the test is bound to the configuration it measured, and rev F is visibly outside it.
Two primitives in one hop. Verification as evidence with lineage: the result, the method, a reference to the raw report in the MES, and the highlighted field the paper world never had: configuration_binding. The test knows what it tested. And configuration history: rev E as a recorded state of the system, a fact about time rather than a folder name.
Homologation asked about rev F. The verification is bound to rev E. What does that binding actually tell you?
Step 5 · The reasoning that survived

What the email thread lost

The trace shows a decision attached to the interface, recorded two days after the test result:

decision:connector-familyin-effect
statementRetain connector family A at the motor terminal for the VP2 configuration.
rationaleFamily B would recover the 2 dB margin but requires six weeks of additional validation; schedule was explicitly not the driver — the change was judged unnecessary given field evidence on Platform X.
alternativesConnector family B — rejected: six weeks of validation for margin the field evidence suggests is not required.
conditionsValid while judgment:emc-2db-accept remains in effect.
configuration_bindingconfigstate:vp2-rev-e
decided_byHV systems lead
connector family Arejected: 6 wk validationvalid while in effect
The road not taken, recorded: the alternative, the reason it was declined, and the coupling to the judgment.
The fifth primitive: decision and rationale. Compare this with the email from Step 1, which is the same event as the organisation actually recorded it. The email had the outcome. It lost the alternative, the reason the alternative was rejected, the explicit statement that schedule was not the driver, and the condition coupling this decision to a judgment. “Let’s document properly later” is where rationale goes to die.
Look at the conditions field. This decision says it is valid only while some judgment remains in effect. What is that?
Step 6 · The call

Before you see how it was recorded: make the call yourself

Put yourself in the HV systems lead’s chair in May. The facts in front of you: emissions at the motor terminal are 2 dB short of the internal allocation; vehicle-level compliance is maintained; connector family B would recover the margin at the cost of six weeks of validation; an identical shortfall on Platform X has three years of production behind it with no attributable field failure.

Your call:
The strongest basis for your call:
What conditions do you attach? (pick any, then continue)
Step 7 · Nothing was remembered, everything was caught

Rev F arrives

Four months pass. You are busy with other work; so is everyone. The design evolves, and the PLM releases the change homologation asked you about in Step 1: rev F changes the shielding termination at the motor terminal. Nobody thinks about a judgment recorded in May. Press the button the PLM adapter presses:

{ "type": "configuration.StateRecorded",
  "subjects": ["system:hvbus"],
  "payload": { "new_state": "configstate:vp2-rev-f",
    "note": "Rev F changes shielding termination at the motor terminal." } }
verification:t789-revCin-effectreview-requiredbound to rev E; a new state now exists for its subject
decision:connector-familyin-effectreview-requiredbound to rev E; and its condition rests on the judgment
judgment:emc-2db-acceptin-effectreview-requiredrendered against rev E; the assumption under it just moved
Step 8 · Plausible versus defensible

The same question, two answers

plausibleinterfaceverificationdecisionjudgmentdefensible
Two answers to the same question: a cloud of fragments, or a chain of objects.

The document answer

“The margin shortfall was reviewed in May and considered acceptable given previous platform experience, so the result should still be fine for rev F.”

Plausible. Possibly even correct. Built on a report that does not say what it tested, a minute that does not say who accepted what, and an email from someone who left in March. If a regulator, a customer, or your own chief engineer asks “on what basis?”, the answer is an archaeology project.

The layer answer

“No — not without re-rendering. The result was accepted conditionally by the HV systems lead (12 years HV integration, chief-engineer review) on Platform X field history, bound to rev E, conditional on fleet telemetry. Rev F changed the shielding termination at that terminal, so the acceptance is review-required as of today. Re-render against rev F before freeze.”

Defensible. Every clause traceable to a field on a managed object — and the answer knows when it stops being true.

One more consequence. An AI assistant grounded in these objects gives the second answer, with citations to object ids. An AI assistant grounded in the document pile gives a fluent version of the first, because plausible is what retrieval over prose produces. The difference is not the model. It is whether the substrate exists — which is the argument of the whole book, experienced in half an hour instead of argued in hundreds of pages.

Where to take this

Score your own estate

Eight sections, five levels, read against your product’s scenario. The instrument from Chapter 14.

Run the diagnostic →

Read the architecture

The seven primitives, the federation pattern, and the deployment path. 395 pages, worked cases throughout.

Get the book on Amazon →

Bring this to your team

The full training pairs each primitive with your own estate: executive briefing or multi-day architect workshop.

Request a conversation →

This investigation is built on the worked example that threads Chapters 5–14 of Beyond the BOM, and the objects you traced are real: they are the seed data of the book’s reference implementation, validated against the published schemas.