Systems
AI SystemsMethodWorkOperationIndustriesField Notes
Solutions
EnterpriseRegulated IndustriesProcessesIntake and ServiceDocument ReviewReconciliation
Integration
Systems of RecordModel GovernanceAudit TrailChange ControlBlueprintData Residency
Company
AboutEngagementsSecurityOversightCareersContact
EngagementsNews
Talk to UsScoping Session

What a written blueprint contains, and why it comes first

The document a client receives before we write a line of code: the process as it runs, the systems it touches, the controls.

A blueprint is how both sides find out whether we understood the work. It is cheaper to be wrong in a document than in a system, and the client can act on it even if they never build anything with us.

Every engagement starts with one, in insurance, construction, energy and financial services alike. It comes out of the scoping session, it is written before anything is built, and it belongs to the client from the day it is delivered. It describes the work as it actually runs: the queue on an actual morning, the systems of record behind it, and the people who have to sign.

The result is a document the client keeps, whether or not anything gets built.

Why it exists

Most proposals describe the process the way the manual does. The real work is harder: requests that arrive late, records that disagree, thresholds applied differently in practice, and rules nobody wrote down. A blueprint is written for the work as it runs, in every department it touches.

It is also the only honest way to price the work. Nobody can quote a process they have not watched running.

Accuracy vs. Effort

Upper and to the right is better.

Illustrative. Rework after go-live against scoping effort for eleven formats; the signed written blueprint has the least rework.2%3%4%5%6%7%8%0369121518Rework after go-live (%) · Better →Scoping effort (days) · Better →Written blueprint, signedDraft blueprint, unsignedProcess map, workshopThe process manualDiscovery interviewVendor implementation planRequirements workshop deckOff-the-shelf fitProcess survey formTeam interviewsMemo

Figures: illustrative

What is in it

The charts that follow are illustrative. They show the four kinds of finding a blueprint has to catch, drawn from the work itself: the exceptions on an insurer's claims desk, the systems behind a contractor's estimates, the controls on an energy developer's approvals, and the short exceptions mentioned once, in passing. A written blueprint misses less in all four, and on exceptions it leads every format we have used.

Exceptions

Cases the manual does not cover · Insurance

Written blueprint, signed 7.1; Draft blueprint, unsigned 10.6; Vendor template 15.9; Interview notes 9.3; The process manual 12.6; Team interviews 12.4; Questionnaire 15.805101520Rework after go-live (%)7.1Written blueprint, signed10.6Draft blueprint, unsigned15.9Vendor template9.3Interview notes12.6The process manual12.4Team interviews15.8Questionnaire

Systems

What is read and written back · Construction

Written blueprint, signed 3.3; Draft blueprint, unsigned 8.7; Vendor template 5.7; Interview notes 7.0; The process manual 22.7; Team interviews 18.3; Questionnaire 10.20510152025Rework after go-live (%)3.3Written blueprint, signed8.7Draft blueprint, unsigned5.7Vendor template7.0Interview notes22.7The process manual18.3Team interviews10.2Questionnaire

Controls

Approvals, logs and limits · Energy

Written blueprint, signed 3.2; Draft blueprint, unsigned 7.2; Vendor template 10.4; Interview notes 2.6; The process manual 4.0; Team interviews 9.6; Questionnaire 7.602.557.51012.5Rework after go-live (%)3.2Written blueprint, signed7.2Draft blueprint, unsigned10.4Vendor template2.6Interview notes4.0The process manual9.6Team interviews7.6Questionnaire

Short Exceptions

Mentioned once, in passing · 19 processes

Written blueprint, signed 6.8; Draft blueprint, unsigned 20.6; Vendor template 7.8; Interview notes 7.2; The process manual 7.1; Team interviews 9.6; Questionnaire 9.70510152025Rework after go-live (%)6.8Written blueprint, signed20.6Draft blueprint, unsigned7.8Vendor template7.2Interview notes7.1The process manual9.6Team interviews9.7Questionnaire

How it is produced

It is produced by sitting with the people who do the job, for as long as it takes to see the cases that do not fit, and it is written in the client's own vocabulary. If an underwriter or an estimator cannot correct it, it is not finished. Reading it back is where most of the corrections come from.

Corrections at read-back

Share of sections corrected (%). Lower is better. Illustrative.

0%10%20%30%40%UnderwritingClaimsRenewalsEstimatingProcurementSchedulingSite surveyPermittingLand rightsTreasuryReconciliationPayrollBillingCollectionsComplianceIntakeContractsDispatchReporting
  • Written blueprint, signed
  • Draft blueprint, unsigned
  • The process manual
  • Team interviews

The short exceptions, the ones mentioned once in passing, are the easiest to lose between the interview and the page. On that set, rework after go-live drops from 20.6% to 6.8% once the blueprint is read back.

The sections

Every blueprint carries the same sections, whatever the industry, and the client can hand it to their own engineers, their auditors, or another firm:

  • The process as it runs. Step by step, from the first request to the last record it touches.
  • The exceptions. Each one we found, who handles it today, and how often it occurs.
  • The people. Who does each step, who approves it, and who has to be told.
  • The systems. What is read from each system of record, and what is written back.
  • The client's vocabulary. Their own terms for their own work, so the people who do it can correct it.
  • The controls. Who approves what, what is logged, and what the system is never allowed to do.
  • What we will not build. A process about to be replaced, or a step whose rules genuinely need a person, and why.
  • The handoffs. Where the system stops and hands the case to a person, with the working attached.

Reviewed by the people who will live with it

A national contractor's estimating desk was rebuilt around its own estimators. Its engineers reviewed every integration in the blueprint, and its security team read the controls section before anything was built. Objections at that stage were cheap: two connections were redrawn on paper instead of in production, and the estimators rewrote the section on how they price unusual jobs.

“We have read a lot of proposals. This was the first document that described how our estimating desk actually works, in our own words, including the jobs we price differently and why. Our estimators corrected it, then it became the build, and it is still what we hand to anyone who asks what the system does.”
Director of Preconstruction, a national contractor

Then it becomes the build

What was written guides the build. Where reality forces a change, during the build or after go-live, the blueprint changes with it, and it remains the document that explains what the system does.

Department

Changes per section after sign-off

Written blueprint, signed 0.10; Draft blueprint, unsigned 0.10; The process manual 0.22; Team interviews 0.260.000.100.200.300.400.500.10Written blueprint, signed0.10Draft blueprint, unsigned0.22The process manual0.26Team interviews

One process

Changes per section after sign-off

Written blueprint, signed 0.20; Draft blueprint, unsigned 0.20; The process manual 0.39; Team interviews 0.460.000.100.200.300.400.500.20Written blueprint, signed0.20Draft blueprint, unsigned0.39The process manual0.46Team interviews

When the process changes, the blueprint is revised before the system is, and every earlier version stays on record. To see the version a system was built from, ask for blueprint-v1.0.

Tell us about the process you want handled