{
  "$type": "site.standard.document",
  "canonicalUrl": "https://jacob.blog/notes/architecture-decision-records",
  "path": "/notes/architecture-decision-records",
  "publishedAt": "2025-10-07T00:00:00.000Z",
  "site": "at://did:plc:ckthoyuvsmkp254fyuinyzb2/site.standard.publication/3mndm6tiamb26",
  "tags": [
    "software-engineering",
    "documentation",
    "architecture"
  ],
  "textContent": "Architecture Decision Records (ADRs) are small, durable logs of _architecturally significant_ choices—structure, non-functionals, dependencies, interfaces, construction—so teams remember _why_ a decision was made as the system evolves.\n\n> We will keep a collection of records for “architecturally significant” decisions: those that affect the structure, non-functional characteristics, dependencies, interfaces, or construction techniques.",
  "title": "Architecture Decision Records"
}