ADR 0002 - Política de idioma

Estado

Aceptado.

Contexto

Los repositorios tienen reglas mezcladas: algunos AGENTS.md exigen inglés para todo, mientras que el equipo trabaja en español y los commits recientes están en español. Esto genera documentación inconsistente y fricción en el onboarding.

Decisión

• Documentación humana en español: hub, READMEs, arquitectura, runbooks, ADRs y páginas de proyecto.
• Inglés para código, identificadores, comentarios, contrato de API, OpenAPI, commits, PRs, CHANGELOG.md y release notes.
• Textos de UI en inglés como fuente y traducidos con i18n.
• AGENTS.md puede permanecer en inglés por ser una guía técnica para agentes.

Consecuencias

• La documentación es más accesible para el equipo.
• El contrato y los releases siguen siendo consumibles por herramientas y terceros.
• Hay que mantener la disciplina de no traducir identificadores ni JSON.
• Los AGENTS.md que exigían inglés para la documentación deben actualizarse para reflejar esta política.