0001. Registrar las decisiones del proyecto
- Estado: Aceptada
- Fecha: 2026-07-01
- Decisores: Brayan Diaz C
Contexto y problema
A medida que el proyecto evoluciona se toman decisiones cuyo contexto y motivación se pierden con el tiempo. Sin un registro, se repiten debates ya resueltos y los nuevos colaboradores no entienden por qué las cosas son como son.
Opciones consideradas
- No documentar — confiar en la memoria y el historial de commits.
- Documentar en una wiki — fácil de editar pero desligado del repositorio.
- Architecture Decision Records (ADRs) — archivos versionados junto al contenido.
Decisión
Adoptamos Architecture Decision Records (ADRs) ligeros (estilo MADR), versionados
en docs/decisions/. Cada decisión relevante se documenta con la plantilla
0000-template.md y se numera secuencialmente.
Consecuencias
Positivas:
- El “por qué” de cada decisión queda registrado junto al contenido.
- Los nuevos colaboradores se ponen al día más rápido.
- Se evita re-litigar decisiones ya tomadas.
Negativas / costos:
- Requiere disciplina para crear el ADR en el momento de decidir.
Neutras / a vigilar:
- Mantener el índice del README actualizado.