Structure Beats Magic
← All concepts
Method & workflow

Tribal Knowledge

The understanding lives in people's heads and informal conversation — never in the model, the docs, or anywhere a newcomer or an AI can reach it.

The understanding exists, but only in people. Not in the model, not in the documentation, not in anything a newcomer can read — in heads, in corridor conversations, in "ask Marieke, she knows how that table works."

It is not ignorance. A team with deep tribal knowledge often understands its domain extremely well. The failure is that the understanding has no external form, so it cannot be checked, inherited, corrected, or reasoned over by anything other than the people carrying it.

How you recognise it

  • Onboarding is measured in months, and the honest explanation is "you just have to be around for a while."
  • The same question gets answered slightly differently by three people, and everyone considers this normal.
  • The real system diagram is drawn on a whiteboard, photographed, and never updated.
  • Someone says "why do I feel like everyone knows something except for me?" — the counter-signal from Just to Be Clear.

Why AI changes the stakes

Tribal knowledge used to be an efficiency problem: slow onboarding, repeated questions, occasional expensive mistakes. It survived because humans are good at absorbing context informally over time.

An agent cannot do that. It has no corridor, no coffee, no six months of osmosis. Anything not externalised is, to an AI, simply absent — and it will confidently fill the gap with something plausible. The cost of tribal knowledge used to be friction; now it is fabrication.

What replaces it

Not a wiki. Wikis are where tribal knowledge goes to die slowly — written once, never maintained, distrusted within a year. What replaces it is structure that is a by-product of the work: the model that had to be made explicit anyway, the decision record written when the decision was taken, the folder-note that says what lives here. Externalisation that happens during the work survives; externalisation as a separate documentation project does not.

Related concepts

The neighbourhood

How this connects