Formato ADR-lite
Cada decisión sigue una estructura compacta:
| Sección | Descripción |
|---|---|
| Contexto | Por qué hace falta esta decisión |
| Decisión | Qué se decidió |
| Por qué | La razón más fuerte, en una línea |
| Frente a | Máximo 3 alternativas consideradas |
| Implica | Consecuencias y áreas afectadas |
Para decisiones complejas, un formato extendido añade una sección de Compensaciones.
Funciones inteligentes
Inferencia automática de alternativas
Si solo escribes la decisión, la IA infiere 1-2 alternativas típicas:
/note-decide Usar PostgreSQL para el servicio de usuariosLa IA añade: Frente a MongoDB, MySQL — porque son las alternativas típicas para elegir una base de datos.
Cadenas de decisiones
El sistema busca en las notas de decisión existentes. Si tu nueva decisión sustituye a una antigua, crea un enlace «Sustituye a»:
Sustituye a: «Usar MongoDB para el servicio de usuarios» (10 feb)Esto construye un historial de decisiones que puedes rastrear hacia atrás.
Detección de duplicados
Antes de crear una nota nueva, /note-decide busca decisiones anteriores relacionadas y te avisa si ya existe una decisión parecida.
Guías para el título
Los buenos títulos son accionables y específicos:
- «Usar JWT para auth» (no «Autenticación»)
- «Desplegar en Fly.io» (no «Despliegue»)
- «Cambiar de REST a GraphQL» (no «API»)
Cuándo usar /note-decide
Usa esto cuando quieras registrar por qué elegiste algo, no solo qué elegiste. El log de decisiones se vuelve invaluable cuando:
- Un nuevo miembro del equipo pregunta «¿por qué lo hicimos así?»
- Necesitas revisar una decisión meses después
- Quieres rastrear cómo evolucionó tu arquitectura