Saltar a contenido

Registro de decisiones (ADR)

Un ADR registra una decisión técnica vigente y su contexto, para que no se re-discuta sin conocer por qué se tomó. Formato: MADR simplificado — usar 0000-plantilla.md.

Reglas

  • Numeración: secuencial de 4 dígitos (0001-, 0002-, ...). No se reusan números.
  • Un ADR no se edita para cambiar la decisión: se escribe uno nuevo que lo reemplaza y el viejo pasa a estado reemplazado por ADR-NNNN.
  • ADRs retroactivos: solo decisiones que siguen costando dinero re-discutir. Límite estricto: 3 por repositorio. Esto no es arqueología histórica.
  • ADRs nuevos: toda decisión de arquitectura tomada a partir de ahora se registra en el momento, dentro del mismo PR que la implementa.

Índice

ADR Título Estado
0001 Docs-as-code en repos, no en Outline aceptado