Architecture Decision Records
Registro inmutable de decisiones arquitectónicas y organizacionales de Eigenoid. Cada ADR captura una decisión significativa, el contexto que la motivó, las alternativas consideradas y sus consecuencias.
Principios
- Inmutables: una vez
Accepted, un ADR no se edita. Si la decisión cambia, se crea un ADR nuevo que supersede al anterior.
- Numeración secuencial: los números no se reutilizan, incluso para ADRs rechazados.
- Escritos antes o durante la decisión: no son documentación retroactiva; capturan el pensamiento en el momento.
- Alcance amplio: decisiones que afectan a más de un módulo, repo o persona. Las decisiones locales van en el código o en PRs.
Estados
| Estado | Significado |
|---|
Proposed | Propuesta abierta a discusión, no adoptada aún. |
Accepted | Decisión vigente. |
Rejected | Propuesta descartada; se conserva para preservar el razonamiento. |
Deprecated | Ya no aplica, pero no fue reemplazada por otra decisión. |
Superseded by ADR-NNNN | Reemplazada por un ADR posterior. |
Índice
Cómo proponer un nuevo ADR
- Copia
template.md como NNNN-titulo-corto.md con el siguiente número disponible.
- Completa los campos con el contexto, decisión y consecuencias.
- Abre un PR con status
Proposed y solicita revisión.
- Cuando se acepte, actualiza el status a
Accepted, añade la entrada a este índice, y mergea.