ADR
Architecture Decision Record. Un documento corto que registra una decisión técnica u organizacional importante: el contexto en el que se tomó, las alternativas consideradas, y las consecuencias aceptadas.
Los ADRs son inmutables una vez aceptados — si el contexto cambia, se escribe un ADR nuevo que supersede al anterior. No se editan silenciosamente.
En este sitio
- Viven en
/docs/adrs/. - Cada ADR enlaza a su Discussion en GitHub, donde queda la conversación permanente del tema.
- Se crean con el slash-command
/adren una Discussion de la categoría Ideas.
See also
- Runbook — operacional, no estructural
- Discussion de ADRs — flujo bootstrap