2025-03-05 · governance · documentation

Writing ADRs that procurement actually files

By Mira Song

Supporting visual for Writing ADRs that procurement actually files
Architecture Decision Records fail when they read like blog posts or bury accountability. Procurement and audit teams want crisp context: what changed, why now, who approved, and what alternatives were dismissed with rationale. We share a Busan-tested template that mirrors Korean enterprise expectations—without turning engineers into lawyers. Each ADR links to supporting incident IDs or customer commitments when relevant. We also describe how to sunset ADRs when experiments end, preventing zombie mandates from blocking newer initiatives. Expect frank discussion about limitations: ADRs cannot replace conversations when sponsors disagree on risk appetite.