Decisiones (ADR)

Bitácora única de decisiones cuyo alcance es la organización completa. Las decisiones que caben dentro de un solo proyecto viven en el repositorio de ese proyecto, no aquí.

Se citan como ADR-NNNN. Hoy la bitácora está vacía: el próximo ADR es el 0001.

Qué sube aquí y qué se queda en el repositorio del proyecto

Una decisión sube a esta bitácora si cumple al menos una:

• Afecta a más de un repositorio.
• Crea, modifica o elimina una regla de ../ingenieria/estandares.md.
• Cambia la frontera de confianza: mete o saca un tercero de la ruta de firma cualificada, o cambia qué datos personales salen de nuestra infraestructura.
• Compromete a la organización frente a un supervisor.

Si no cumple ninguna, se queda en decisiones/ del repositorio del proyecto y se cita como <repositorio>/ADR-NNNN. En la duda, sube: el costo de un ADR de más aquí es bajo; el de una decisión transversal invisible, no.

Cómo se escribe uno

cp decisiones/_plantilla.md decisiones/0001-titulo-en-kebab-case.md

El número es el siguiente sin usar. Los números no se reutilizan ni se renumeran, tampoco si el ADR queda reemplazado.

Todo ADR debe declarar, en su última sección, qué reglas de estandares.md crea, modifica o elimina — aunque la respuesta sea “ninguna”.

Son inmutables

Un ADR afirma algo sobre un momento, no sobre el presente. No se edita para reflejar un cambio de opinión: se escribe uno nuevo y se marca el anterior como reemplazado, con el enlace en su sección de Estado. Lo único que se edita de un ADR publicado es esa línea.

Lo que sí cambia continuamente es ../ingenieria/estandares.md, que es la proyección del estado actual de todas estas decisiones.