ADR-0007 — Modelo de autenticación

• Estado: aceptado
• Fecha: 2026-07-03
• Decide: lead / arquitecto + mantenedor

Contexto

dai y sus skills tocan tres sistemas externos: los repos de código (git), el forge (GitHub/GitLab, para comentar PRs), y el tracker (Jira/ClickUp). Cada uno se autentica distinto. Ahora que hay tokens en juego (dai forge, adaptador de PM), hay que fijar un modelo de auth antes de seguir sumando credenciales — para no terminar con contraseñas hardcodeadas o secretos en un commit.

Principio rector: least privilege, sin contraseñas, secretos nunca versionados.

Decisión

Tres credenciales, tres mecanismos (no se mezclan)

Sistema	Acción	Credencial	Dónde vive
git	clone / fetch / push	SSH key (ssh-agent)	~/.ssh — nunca en .env ni en el repo
forge	leer/comentar PR/MR	token scopeado (GITHUB_TOKEN / GITLAB_TOKEN)	.env (gitignored) o secret store del CI
tracker	leer/escribir US y cobertura	api_key (DAI_JIRA_TOKEN / DAI_CLICKUP_TOKEN)	.env o secret store del CI

Reglas

1. Nada de contraseñas. Ni para git (SSH), ni para las APIs (tokens scopeados y revocables). Prohibido el patrón https://user:password@host.
2. git es SSH. El transporte de git (incluido lo que haga un agente o el CLI) usa SSH. Comentar una PR no se hace por SSH (SSH solo mueve objetos git): eso es API del forge → token.
3. Least privilege. El token del forge se limita al scope mínimo (PRs/notes), no un PAT con acceso total. Igual para el tracker.
4. Secretos fuera del repo. Solo en .env (gitignored) o el secret store del CI. Nunca en el código, ni en implements.yaml, ni en un commit. .env.example documenta los nombres de las variables, jamás los valores.
5. Dos caras (ADR-0002). Las skills usan el MCP del asistente (que guarda sus propias credenciales); el CLI usa los tokens del .env. Nunca se comparten ni se filtra uno al otro.
6. Variables de entorno ganan. Un token exportado en la shell/CI pisa al .env (para que el CI inyecte secretos sin escribir archivos).

Consecuencias

• ✅ Superficie de secretos mínima y auditable: SSH keys + tokens scopeados, cero contraseñas.
• ✅ .gitignore + .env.example ya hacen cumplir "secretos fuera del repo".
• ✅ Rotar/revocar es trivial: son tokens, no contraseñas de cuenta.
• ⚠️ Requiere que cada dev tenga su SSH key configurada (ssh-agent) — es el costo de no usar contraseñas. Se documenta en el onboarding.
• ⚠️ En el CI hay que cargar los tokens desde su secret store, no desde un .env commiteado (que no existe).

Alternativas consideradas

• Contraseña / PAT embebido en la URL de git — descartado: viola "sin contraseñas", y termina en el ~/.git-credentials o en un remoto commiteado.
• Un único super-token para todo — descartado: rompe least privilege; si se filtra, se filtra todo. Un token por sistema y por scope.
• Que el CLI use el MCP del asistente — imposible: el CLI corre standalone, no tiene acceso al MCP. Por eso el CLI usa tokens propios (dos caras).