Matt Pocock: Put the 'Why' in ADRs, Not Code Comments

Matt Pocock argued that the reasoning behind code decisions belongs in ADRs rather than comments, making them essential context for agents, while invoking Chesterton's Fence to warn against removing existing system design without understanding it.

2026-11-21 ~ 2026-11-21 · 2 related posts