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 CMS headless: los bloques comerciales no tienen componente React aceptado
0002 Cloudflare Images como almacenamiento de medios aceptado
0003 npm con legacy-peer-deps en lugar de pnpm aceptado
0004 Actualizar Payload a 3.88 y fijar Next en la serie 15.4 aceptado
0005 El build no depende de la base de datos aceptado
0006 Las migraciones se aplican al arrancar el contenedor aceptado
0007 Nombres de campo en inglés, etiquetas en español aceptado

Los seis primeros son ADRs retroactivos: documentan decisiones ya implementadas y vigentes, redactadas a partir del código y del historial de git. Cuando la fecha exacta de la decisión no quedó registrada, el ADR lo dice explícitamente.