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ón | Estado |
|---|---|---|
| 0001 | El contrato del ac_hash (normalización + SHA-256, tres momentos) | aceptado |
| 0002 | La metodología es agnóstica del asistente (Claude / Copilot) | aceptado |
| 0003 | La detección y el estampado son comandos (dai check / dai stamp), no infraestructura | aceptado |
| 0004 | Ubicación (co-localizado + glob) y schema del implements.yaml | aceptado |
| 0005 | Superficie de comandos (ls/check/stamp) y contenido del stamp (branch + commit-ancla) | aceptado |
| 0006 | Distribución (npm + fallback) y licencia (GPLv3) | aceptado |
| 0007 | Modelo de auth: SSH para git, tokens scopeados para forge/tracker, sin contraseñas | aceptado |
| 0008 | Estrategia de i18n: fuente única (español) + traducciones derivadas, DAI_LANG en el CLI, por fases | propuesto |
| 0009 | Adaptador nativo para Cursor (skills + rules) con dai init/install/doctor | propuesto |
| 0010 | Versionado y upgrade: compatibilidad por semver, doctor version-drift, dai sync aditivo | propuesto |
| 0011 | archive es un gate de aprobación: dai archive (comando) lo corre el aprobador; check/ls saltean archive/ | aceptado |
| 0012 | dai upgrade: self-update del CLI + dai sync del scaffold | aceptado |
| 0013 | dai skills install --from: skills externas por-stack, sin registro ni gatekeeping | aceptado |
| 0014 | Copilot lee SKILL.md nativo (Agent Skills): se elimina el adaptador .prompt.md — modifica la 0002 | aceptado |
| 0015 | dai publish en Jira corporativo: campos propios declarados, --parent/--issuetype, TLS con CA (nunca apagar la verificación) | aceptado |
| 0016 | Review inline: review.json como contrato y puerta humana, el CLI valida las posiciones contra el diff, --yes explícito, nunca APPROVE | aceptado |
| 0017 | La config de dai vive en .env.dai (no versionado), no en el .env del equipo; el loader lee ambos con precedencia shell > .env.dai > .env | aceptado |
| 0018 | El 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_version | aceptado |
| 0019 | El 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 formato | aceptado |
Estas son las decisiones que cierran las "Decisiones abiertas" de
METODOLOGIA.md §7y las enmiendas alMANIFIESTO.md.