Skip to content

ADRs — decisiones de fondo de la metodología

Registro de las decisiones estructurales de dai. Cada ADR es inmutable: si una decisión cambia, se escribe un ADR nuevo que supersede al viejo. Molde en templates/adr.md.

#DecisiónEstado
0001El contrato del ac_hash (normalización + SHA-256, tres momentos)aceptado
0002La metodología es agnóstica del asistente (Claude / Copilot)aceptado
0003La detección y el estampado son comandos (dai check / dai stamp), no infraestructuraaceptado
0004Ubicación (co-localizado + glob) y schema del implements.yamlaceptado
0005Superficie de comandos (ls/check/stamp) y contenido del stamp (branch + commit-ancla)aceptado
0006Distribución (npm + fallback) y licencia (GPLv3)aceptado
0007Modelo de auth: SSH para git, tokens scopeados para forge/tracker, sin contraseñasaceptado
0008Estrategia de i18n: fuente única (español) + traducciones derivadas, DAI_LANG en el CLI, por fasespropuesto
0009Adaptador nativo para Cursor (skills + rules) con dai init/install/doctorpropuesto
0010Versionado y upgrade: compatibilidad por semver, doctor version-drift, dai sync aditivopropuesto
0011archive es un gate de aprobación: dai archive (comando) lo corre el aprobador; check/ls saltean archive/aceptado
0012dai upgrade: self-update del CLI + dai sync del scaffoldaceptado
0013dai skills install --from: skills externas por-stack, sin registro ni gatekeepingaceptado
0014Copilot lee SKILL.md nativo (Agent Skills): se elimina el adaptador .prompt.md — modifica la 0002aceptado
0015dai publish en Jira corporativo: campos propios declarados, --parent/--issuetype, TLS con CA (nunca apagar la verificación)aceptado
0016Review inline: review.json como contrato y puerta humana, el CLI valida las posiciones contra el diff, --yes explícito, nunca APPROVEaceptado
0017La config de dai vive en .env.dai (no versionado), no en el .env del equipo; el loader lee ambos con precedencia shell > .env.dai > .envaceptado
0018El alcance de dai stamp lo decide la rama (ante la duda pregunta, no estampa de más), dai check --ci ejecuta el gate de governance con ramas exentas, y dai edit-us/update-us editan el QUÉ validando el formato y proponiendo el spec_versionaceptado
0019El ciclo de versión: el manifiesto de US como dato central, el bump se propone y lo firma una persona, el corte son dos comandos con una firma en el medio, el tag es la versión y los archivos son espejos, estampar es opcional y avisa su alcance, y el canal es un tercer adaptador con estructura sin formatoaceptado

Estas son las decisiones que cierran las "Decisiones abiertas" de METODOLOGIA.md §7 y las enmiendas al MANIFIESTO.md.

Software libre (GPLv3). La IA asiste; la persona firma.