Making Knowledge Explicit

Architecture Decision Records That Get Read

One page, written at the moment of the decision, recording the context and what you rejected. That last part is the whole value.

Diagrams That Age Well

Most architecture diagrams are wrong within a month. The fix is fewer diagrams, at deliberate levels of detail, generated where possible.

Runbooks and On-Call Docs

Write for a tired, frightened person who did not build this and is being asked to fix it right now.

Design Reviews and RFCs

Surface disagreement while it is cheap. A review that produces consensus without surfacing objections has failed.

Building a Team Architecture Memory

The goal is that the system's reasoning survives the people who built it. Nothing else on this site matters if this fails.