All notes

· Per Lilja

Architecture decision records people actually read

A lightweight ADR format that survives contact with a busy team.

Most ADRs die because they are too long to write and too boring to read. Keep them to one screen: context, decision, consequences, and the alternatives you rejected.

The format I use

# 012: Use Kafka for settlement events
Status: accepted · 2026-03-04
Context: …
Decision: …
Consequences: …
Rejected: …

Placeholder article. Replace with your own writing.

Have a hard problem? Let’s talk.

A 30-minute intro call, no pitch deck. You describe the problem, I tell you honestly whether I’m the right person for it.