Learn with Jack

Topic 01 / Systems Engineering

Fixed in requirements, it costs a sentence.
Fixed later, it costs the product.

That gap is what systems engineering exists to close. Not paperwork about the product — the discipline that keeps a whole team's idea of the product identical, from the first conversation to the last test report.

Explore the ten attributes ↓
REQUIREMENT × EVIDENCE
Handed down the line

One product. It changed hands, and changed.

  1. The customer described it.01The customer described it.
  2. Sales retold it.02Sales retold it.
  3. The lead understood it.03The lead understood it.
  4. The document recorded it.04The document recorded it.
  5. Systems designed it.05Systems designed it.
  6. Software built it.06Software built it.
  7. Test ran it.07Test ran it.
  8. Then the quote explained it.08Then the quote explained it.

Everyone was certain they agreed.

01

A good requirement is necessary.

Delete it. If nobody is worse off, it was never a requirement — only cost.

A good requirement is Necessary
01 / ATTRIBUTEA good requirement is
necessary.
02

A good requirement is correct.

15–27 °C because that is the room — not 5–60 °C to be safe.

A good requirement is Correct
02 / ATTRIBUTEA good requirement is
correct.
03

A good requirement is complete.

A minimum with no maximum is half a requirement.

A good requirement is Complete
03 / ATTRIBUTEA good requirement is
complete.
04

A good requirement is concise.

One requirement, one issue. The rationale lives somewhere else.

A good requirement is Concise
04 / ATTRIBUTEA good requirement is
concise.
05

A good requirement is unambiguous.

Fast, easy, robust, as appropriate — every one is a future argument.

A good requirement is Unambiguous
05 / ATTRIBUTEA good requirement is
unambiguous.
06

A good requirement is verifiable.

Name the method now: inspection, analysis, demonstration or test.

A good requirement is Verifiable
06 / ATTRIBUTEA good requirement is
verifiable.
07

A good requirement is feasible.

Achievable with this technology, this budget, this schedule — or it is a wish.

A good requirement is Feasible
07 / ATTRIBUTEA good requirement is
feasible.
08

A good requirement is implementation-free.

Write “the user can view and change the calibration settings”, not “calibration is stored in MySQL”. The second is a design decision. If you really must fix the method, write it as a constraint and label it one.

A good requirement is Implementation-free
08 / ATTRIBUTEA good requirement is
implementation-free.
09

A good requirement is consistent.

Said once, in one vocabulary, contradicting nothing above or below it.

A good requirement is Consistent
09 / ATTRIBUTEA good requirement is
consistent.
10

A good requirement is traceable.

An ID, a parent, and a test that will one day cite it.

A good requirement is Traceable
10 / ATTRIBUTEA good requirement is
traceable.
02 / One requirement, two ways to write it

“It shall fit in any lab.”
Which lab?

Nobody can carry an instrument into “any lab” and try it, so this sentence can never be shown to be met — it never gets to be finished, and it never gets to be signed off. Three bounded dimensions can: height ≤ 1500 mm, width ≤ 1500 mm, depth ≤ 700 mm. Now it can be measured, and accepted. A few more minutes to write; weeks of argument saved.

A benchtop instrument measured across its full width
The words that cost you

A vague word today is an argument later.

Tap the underlined phrases. Each is a defect category from the ambiguity checklist, and each is somewhere a supplier can quote to their reading rather than yours.

The system processing of samples and provide results , blood and tissue.

Select a phrase to see what it costs.
03 / Anatomy of a requirement

A requirement is not a sentence.
It is five decisions in a row.

A benchtop analyser with its drawer open and a cartridge ready to insert

When a cartridge is inserted, while the instrument is initialised, the instrument shall scan the cartridge.

  1. 01Trigger

    When a cartridge is insertedThe moment the requirement applies. Written with When.

  2. 02Precondition

    while the instrument is initialisedThe state it depends on. Written with While.

  3. 03System

    the instrumentWho performs it. A named thing — not “the system”.

  4. 04Response

    shall scanWhat it does. One observable action, not a capability.

  5. 05Object

    the cartridgeWhat it acts on. Leave this out and the sentence is unfinished.

Field note / Extreme-environment wildfire recorder

Three failures, and the phase that should have caught each one.

The University of Melbourne's wildfire research laboratory, with forestry agencies in California and Victoria, commissioned a joint development: one field instrument carrying twelve sensor types. In the laboratory it performed beautifully.

Then it went to a fire ground.

None of the three failures below was an engineering mistake.

A cutaway view of the wildfire recorder with its enclosure opened
01

The enclosure was never a constraint.

The boards were finished before the customer specified a military blast-proof case with internal insulation. The usable volume turned out to be far smaller than assumed, and the design went back.

Where it should have been caughtDesign planning — the mounting environment was never locked. Design input — it was never written as a constraint.
02

The sensor was chosen, not specified.

A high-resolution differential pressure sensor, recommended and accepted, carried roughly a 0.75% zero offset. Nobody had written a test condition for drift, so it surfaced in the field — as about three metres per second of wind that was not there.

Where it should have been caughtDesign input — no performance condition. Design verification — no drift scenario in the protocol.
03

The real environment was never written down.

Fire-ground temperatures held above a thousand degrees for more than ten minutes. Heat travelled in through conduits and cabling and the interior reached 75 °C. Standard cells lost most of their life, commercial-grade parts drifted, and soft PVC air tubing deformed above 65 °C.

Where it should have been caughtDesign input — no operating temperature profile. Design output — no high-temperature material call-out. Verification and validation — no component behaviour at temperature.

All three were a requirement that was never written.

Jack's extensions / For systems today
+01

Specify the distribution.

An LLM agent has no pass/fail line. What you can give it is a unit, a method of measurement and a target distribution — plus a route to a human for the tail you did not specify.

+02

An unverifiable requirement is a wish.

Every requirement is born with its verification method attached. If you cannot say how you would test it, you have not finished writing it.

From requirement to evidence

The V does not close by itself.

Define ↓ each level narrows the lasteach level answers one ↑ Prove
05Design output
Select a level to see what it produces and what proves it.
01

One vocabulary

A glossary costs an afternoon. An argument about what “done” means costs a sprint, and it will happen more than once.

02

One requirement, one method

Inspection, analysis, demonstration or test — decided while writing, recorded in the trace matrix, never invented at verification time.

03

Gates, not filing dates

Design input and design output are decisions about whether to carry on. If nothing can fail them, they are not gates.

04 / The pair everyone confuses

Verification and validation are not the same test.

Two steps, two different questions, two different kinds of evidence. Confusing them is how a programme passes every test and still ships the wrong product.

Asks — did we build the right product?Checked against what the user actually has to do.

Evidence is real people, in their environment, finishing the real task. Which is why verification can pass in full and validation still fail — the product is exactly what was specified, and the specification was wrong.

Before you sign off design input

Ask five uncomfortable questions.

  1. Can every requirement here be tested, and does each one say how?
  2. Is there anything in here we committed to that the customer never asked for?
  3. What is the real operating environment, and where is that written down?
  4. Which term in this document means two different things to two people?
  5. If this requirement is wrong, when do we find out — and what does it cost by then?
Next topic / 02

Good design makes meaning visible

Industrial design.

All topicsRead topic 02 →