John Karanja

The field guide · rule 01 of 16

Keep each fact in one place

Decide where each important fact lives, and let everything else read it from there.

What it means

Before building anything, decide what the system stores, who owns each fact, and where the one true copy lives. If the same fact is kept in two places, sooner or later the two copies disagree, and nobody knows which one is right.

What goes wrong without it

A customer's balance shows one figure in the app and another in the payout table. Support cannot answer, and the books cannot be trusted.

How I build it

From systems I build and run.

Ask your team

  1. For each important fact, can you name the one record that counts?
  2. If two records disagree, does anything warn you?
  3. Could a new developer find where a price or a balance is stored within an hour?

A "no" or "not sure" is worth a closer look.

How a review checks this

Every review starts with a map of where each important fact lives, and marks any fact kept in two places.

Request a reviewThe offer: Architecture reviewCheck your system in one minute

Related rules