documentation-conventionlisted

# Documentation Convention Regla de cuándo se actualiza la documentación del proyecto — complementa a `spec-driven-development` y `brain-adr` (que dicen *dónde* va cada cosa) definiendo *cuándo* debe pasar. Esta versión reemplaza la regla anterior de "registro inmediato post-breakthrough" tras observar que, en la práctica, generaba commits demasiado frecuentes y granulares — el registro de documentación ahora se difiere a momentos explícitos, no a cada avance. ## La regla — tres momentos, no más **1. Commits de código:** siguen ocurriendo con normalidad según avanza el trabajo — esto no cambió. Un commit de código no implica automáticamente tocar `brain/` ni `SPEC.md`. **2. Registro de documentación (`brain/`, `SPEC.md`) — diferido hasta uno de estos dos disparadores, nunca automático:** - **Checkpoint explícito**, invocado por el humano diciendo "checkpoint" o el comando correspondiente (ver más abajo). Code nunca decide por su cuenta que "esto amerita un checkpoint" — siempre lo pide o lo ejecuta el humano. - **Cierre de sesión — obligatorio, sin excepción.** A diferencia del checkpoint (que es a discreción del humano durante la sesión), el cierre de sesión **siempre** dispara el registro completo: actualizar `SPEC.md`, `brain/sesiones.md`, `brain/ADR-*.md` si corresponde, commit, y push. No es opcional y no depende de que el humano lo pida — si la sesión está terminando, esto pasa sí o sí. **Regla explícita, para que quede sin ambigüedad:** Code **no** escribe en `br