
Architects Make Decisions, Not Documents

#81 - Architecture Is Context—Making the Right Architecture Decisions - Eltjo Poort
Topic 4 of 8
Published Mar 21, 2022 · Clip 23:46–32:31 (8:44)
Eltjo argues that architecture is fundamentally about making high-impact decisions, not producing big documents or models; every organization must do architecture even without a titled architect. He explains that in agile, fast-changing contexts, decisions are the primary deliverable because they allow quick feedback loops, unlike 200-500 page architecture documents. Analysis of architecture documentation reveals three goals with different life cycles and languages: collaborating on decision-making, preserving knowledge, and governance/approval, which leads to splitting documentation into a lightweight decision register, a design repository, and small governance documents. He discusses ADRs (invented by Michael Nygard) and where to place decisions depending on the main stakeholders.