ADR 0001 - Docs-as-code para documentacion interna
Aceptada.
Contexto
Sección titulada «Contexto»BeanCRM necesita documentacion mantenible para producto en produccion, arquitectura, releases y desarrollo. Las funcionalidades de salud incluyen datos sensibles, permisos clinicos, auditoria y consentimiento, por lo que las decisiones vigentes no pueden vivir solamente en chats o tickets.
Decision
Sección titulada «Decision»Mantener documentacion interna como docs-as-code dentro del monorepo usando Astro/Starlight.
Consecuencias
Sección titulada «Consecuencias»- Los cambios de documentacion se revisan junto con los cambios de codigo.
- Las tareas de desarrollo pueden apuntar a documentos versionados.
- Las decisiones importantes quedan en ADRs.
- Release notes y changelog pueden automatizarse progresivamente.
- Cada agente/desarrollador debe actualizar docs cuando cambia comportamiento relevante.