@damenor/agent-docs 0.1.0

package/templates/modules/agents/.agents/skills/doc-maintain/SKILL.md

@@ -0,0 +1,345 @@
+---
+name: doc-maintain
+description: >
+  Mantiene la documentación sincronizada con los cambios en el código.
+  Se ejecuta DESPUÉS de cada tarea que modifica código, usando la tabla de
+  triggers para determinar qué documentación actualizar. Sigue el protocolo
+  post-tarea de AGENTS.md.
+  TRIGGER: Cuando el usuario dice "sincronizar docs", "actualizar docs post-cambio",
+  "post-feature", "post-release", "post-incident", o automáticamente después de
+  cualquier tarea que cambie código.
+license: Apache-2.0
+metadata:
+  author: damenordev
+  version: "1.0"
+---
+
+# doc-maintain
+
+## Cuándo Usar
+
+- **Post-feature**: Después de implementar una feature nueva
+- **Post-release**: Después de hacer un release a producción
+- **Post-incident**: Después de resolver un incidente en producción
+- **Post-refactor**: Después de refactorizar código
+- **Post-hire**: Cuando un nuevo dev revisa la documentación
+- **Post-design-change**: Después de cambios en estilos/UI
+- **Post-API-change**: Después de agregar/modificar/eliminar endpoints
+- **Post-config-change**: Después de cambiar configuración
+
+## Patrones Críticos
+
+### REGLA #1: Esta skill se ejecuta DESPUÉS de cada tarea que cambia código
+
+```
+Código cambió → doc-maintain se ejecuta
+```
+
+No es opcional. No es "cuando haya tiempo". Es parte del Definition of Done.
+
+### REGLA #2: Verificar qué cambió y actualizar docs correspondientes
+
+```
+1. Identificar qué archivos cambiaron (git diff, lista de cambios)
+2. Mapear cambios a documentación afectada (ver tabla de triggers)
+3. Actualizar cada archivo de doc afectado
+4. Verificar consistencia
+```
+
+### REGLA #3: NUNCA saltar actualización de docs
+
+```
+Código cambia = Documentación cambia
+```
+
+Si no hay tiempo para actualizar docs, no hay tiempo para hacer el cambio de código.
+
+### REGLA #4: Seguir el protocolo post-tarea de AGENTS.md
+
+Ejecutar el **árbol post-tarea** definido en `AGENTS.md` § DESPUÉS de cada tarea. Ese árbol es la fuente de verdad de qué documentación actualizar según qué cambió.
+
+### REGLA #5: Si no se sabe qué actualizar, ejecutar doc-review primero
+
+```
+¿No está claro qué docs se ven afectadas?
+→ Ejecutar skill doc-review
+→ Identificar gaps
+→ Actualizar según el reporte
+```
+
+## Tabla de Triggers y Acciones
+
+### Post-feature
+
+**Qué detectar**: Se agregó una feature nueva (nuevo módulo, nueva funcionalidad, nuevo endpoint)
+
+**Docs a actualizar**:
+
+| Documento | Cuándo | Prioridad | Skill |
+|-----------|--------|-----------|-------|
+| `docs/CONTEXT.md` | Si hay términos nuevos | Crítica | doc-write |
+| `docs/README.md` | Si se crearon/eliminaron archivos de doc | Crítica | doc-write |
+| `docs/adr/` | Si se tomó una decisión arquitectónica | Alta | doc-write |
+| `how-to/` | Si hay un problema repetible que la feature resuelve | Media | doc-write |
+| `reference/` | Si se agregaron endpoints/funciones/props | Alta | doc-write |
+| `tutorials/` | Si la feature cambia el onboarding | Baja | doc-write |
+| `CHANGELOG.md` | Si la feature va a salir en un release | Alta | doc-write |
+
+### Post-release
+
+**Qué detectar**: Se hizo un deploy a producción, se creó un tag de versión
+
+**Docs a actualizar**:
+
+| Documento | Cuándo | Prioridad | Skill |
+|-----------|--------|-----------|-------|
+| `CHANGELOG.md` | Siempre | Crítica | doc-write |
+| `docs/guides/deployment.md` | Si cambió el proceso de deploy | Alta | doc-write |
+| `docs/README.md` | Si cambió la estructura de docs | Media | doc-write |
+| `README.md` | Si hay cambios visibles al usuario | Alta | doc-write |
+
+**Entrada de CHANGELOG**:
+```markdown
+## [X.Y.Z] - YYYY-MM-DD
+
+### Added
+- Descripción de feature nueva
+
+### Changed
+- Descripción de cambio
+
+### Fixed
+- Descripción de fix
+
+### Breaking
+- ⚠️ Descripción de breaking change
+```
+
+### Post-incident
+
+**Qué detectar**: Se resolvió un incidente en producción (outage, bug crítico, data loss)
+
+**Docs a actualizar**:
+
+| Documento | Cuándo | Prioridad | Skill |
+|-----------|--------|-----------|-------|
+| `operations/post-mortems/YYYY-MM-DD-titulo.md` | Siempre | Crítica | doc-write |
+| `operations/runbooks/` | Si hay pasos de resolución que repetir | Alta | doc-write |
+| `docs/CONTEXT.md` | Si se descubrieron términos del dominio | Media | doc-write |
+| `reference/configuration.md` | Si se cambiaron configs durante el incidente | Alta | doc-write |
+| `how-to/troubleshooting.md` | Si el fix es aplicable a futuro | Alta | doc-write |
+
+**Formato de post-mortem**:
+```markdown
+---
+created: "YYYY-MM-DD"
+status: active
+type: explanation
+tags: [post-mortem, incident, sev-N]
+---
+
+# Post-mortem: [Título del incidente]
+
+**Fecha**: YYYY-MM-DD
+**Severidad**: SEV-N
+**Duración**: X horas/minutos
+**Impacto**: Descripción del impacto en usuarios
+
+## Línea de tiempo
+- HH:MM — Detección
+- HH:MM — Diagnóstico
+- HH:MM — Mitigación
+- HH:MM — Resolución
+
+## Causa raíz
+[Descripción]
+
+## Acciones preventivas
+- [ ] [Acción 1] — Responsable — Fecha límite
+- [ ] [Acción 2] — Responsable — Fecha límite
+
+## Lecciones aprendidas
+[Qué aprendimos]
+```
+
+### Post-refactor
+
+**Qué detectar**: Se refactorizó código (renombrar, mover, cambiar patrones)
+
+**Docs a actualizar**:
+
+| Documento | Cuándo | Prioridad | Skill |
+|-----------|--------|-----------|-------|
+| `docs/adr/` | Si el refactor implica un cambio de patrón | Alta | doc-write |
+| `docs/explanation/architecture.md` | Si cambió la arquitectura | Alta | doc-write |
+| `docs/CONTEXT.md` | Si cambiaron nombres/términos | Crítica | doc-write |
+| `docs/README.md` | Si se movieron archivos | Media | doc-write |
+| ADRs existentes | Verificar que sigan siendo válidos | Alta | doc-write |
+
+### Post-hire
+
+**Qué detectar**: Un nuevo dev se unió al equipo y revisa la documentación
+
+**Docs a actualizar**:
+
+| Documento | Cuándo | Prioridad | Skill |
+|-----------|--------|-----------|-------|
+| `tutorials/quick-start.md` | Si el nuevo dev no pudo seguir el tutorial | Crítica | doc-write |
+| `docs/CONTEXT.md` | Si el nuevo dev encontró términos confusos | Alta | doc-write |
+| Cualquier doc | Si el nuevo dev encontró info incorrecta | Alta | doc-write |
+
+### Post-design-change
+
+**Qué detectar**: Se cambiaron estilos, tokens de diseño, o componentes UI
+
+**Docs a actualizar**:
+
+| Documento | Cuándo | Prioridad | Skill |
+|-----------|--------|-----------|-------|
+| `DESIGN.md` | Siempre | Crítica | doc-design |
+| `docs/CONTEXT.md` | Si hay términos de diseño nuevos | Media | doc-write |
+
+**Usar skill `doc-design`** para re-extraer tokens y actualizar DESIGN.md.
+
+### Post-API-change
+
+**Qué detectar**: Se agregaron, modificaron o eliminaron endpoints
+
+**Docs a actualizar**:
+
+| Documento | Cuándo | Prioridad | Skill |
+|-----------|--------|-----------|-------|
+| `reference/api.md` | Siempre | Crítica | doc-write |
+| `CHANGELOG.md` | Si hay breaking changes | Crítica | doc-write |
+| `docs/adr/` | Si se cambió la estructura de la API | Alta | doc-write |
+| `how-to/` | Si hay nuevos flujos de uso | Media | doc-write |
+
+### Post-config-change
+
+**Qué detectar**: Se cambiaron variables de entorno, configuraciones, o infraestructura
+
+**Docs a actualizar**:
+
+| Documento | Cuándo | Prioridad | Skill |
+|-----------|--------|-----------|-------|
+| `reference/configuration.md` | Siempre | Crítica | doc-write |
+| `docs/guides/deployment.md` | Si afecta el deploy | Alta | doc-write |
+| `docs/adr/` | Si es un cambio de infraestructura significativo | Alta | doc-write |
+| `.env.example` | Si se agregaron variables | Alta | directo |
+
+## Flujo del Proceso
+
+### Paso 1: Identificar qué cambió
+
+```bash
+# Opción A: Git diff
+git diff --name-only HEAD~1 HEAD
+git diff --name-only --staged
+
+# Opción B: Lista manual de archivos cambiados
+[lista proporcionada por el agente/humano]
+```
+
+### Paso 2: Mapear cambios a docs afectadas
+
+```
+Para cada archivo cambiado:
+├── ¿Es código fuente? → Verificar reference/, CONTEXT.md
+├── ¿Es estilo/CSS? → Verificar DESIGN.md
+├── ¿Es configuración? → Verificar reference/configuration.md
+├── ¿Es un módulo nuevo? → Verificar CONTEXT.md, docs/README.md
+├── ¿Es un fix? → Verificar CHANGELOG.md, troubleshooting
+├── ¿Es infraestructura? → Verificar deployment.md, ADRs
+└── ¿Es un test? → Generalmente no requiere doc update
+```
+
+### Paso 3: Actualizar cada doc afectada
+
+```
+1. Abrir el archivo de doc afectado
+2. Identificar la sección que necesita cambio
+3. Hacer el cambio manteniendo el formato existente
+4. Verificar que el cambio es consistente con el resto del archivo
+```
+
+### Paso 4: Verificar consistencia
+
+```
+1. CONTEXT.md: ¿Los términos nuevos están? ¿Los eliminados se marcaron?
+2. docs/README.md: ¿El mapa refleja los archivos actuales?
+3. ADRs: ¿Los cambios invalidan algún ADR existente?
+4. DESIGN.md: ¿Los tokens siguen coincidiendo? (si cambiaron estilos)
+5. reference/api.md: ¿Los endpoints documentados coinciden con el código?
+```
+
+### Paso 5: Reportar qué se actualizó
+
+```
+✅ Documentación actualizada:
+  - docs/CONTEXT.md: Agregados 2 términos (UserService, RateLimit)
+  - docs/README.md: Agregado how-to/rate-limiting.md al mapa
+  - reference/api.md: Actualizado endpoint /api/users con nuevo campo
+
+ℹ️ Sin cambios necesarios:
+  - CHANGELOG.md: Feature aún no es release
+  - DESIGN.md: No hubo cambios de estilos
+```
+
+## Actualización por Lotes
+
+Cuando múltiples cambios ocurren juntos (ej: fin de sprint):
+
+```
+1. Listar TODOS los cambios desde la última actualización
+2. Agrupar por tipo de trigger (feature, refactor, fix, etc.)
+3. Actualizar cada doc UNA VEZ con todos los cambios acumulados
+4. Ejecutar doc-review al final para verificar consistencia
+```
+
+### Ejemplo: Fin de sprint
+
+```
+Cambios del sprint:
+- 3 features nuevas
+- 1 refactor de auth
+- 2 bug fixes
+- 1 cambio de configuración
+
+Docs a actualizar:
+1. CHANGELOG.md → Entrada completa del sprint
+2. CONTEXT.md → Términos de las 3 features + auth refactor
+3. reference/api.md → Nuevos endpoints
+4. docs/adr/ → ADR del refactor de auth (si aplica)
+5. reference/configuration.md → Config cambiada
+6. docs/README.md → Si se agregaron/eliminaron docs
+```
+
+## Comandos
+
+### Identificar cambios
+
+```bash
+# Archivos modificados en el último commit
+git diff --name-only HEAD~1
+
+# Archivos modificados (staged + unstaged)
+git diff --name-only; git diff --name-only --staged
+
+# Cambios en un rango de commits
+git diff --name-only commit1..commit2
+```
+
+### Verificar consistencia post-actualización
+
+```
+1. ¿CONTEXT.md tiene todos los términos nuevos del código?
+2. ¿docs/README.md lista todos los archivos de doc existentes?
+3. ¿ADRs son consistentes con la implementación actual?
+4. ¿DESIGN.md coincide con estilos actuales?
+5. ¿reference/api.md refleja endpoints actuales?
+```
+
+## Recursos
+
+- [Triggers Reference](references/triggers.md) — Tabla completa de eventos → docs a actualizar con ejemplos
+- Skills relacionados: `doc-write` (escribir/actualizar docs), `doc-review` (auditar después de actualizar), `doc-design` (actualizar DESIGN.md), `doc-scaffold` (si falta estructura)

package/templates/modules/agents/.agents/skills/doc-maintain/references/triggers.md

@@ -0,0 +1,311 @@
+---
+created: "2024-01-15"
+status: active
+type: reference
+tags: [triggers, mantenimiento, sincronizacion, documentacion]
+---
+
+# Triggers — Referencia Completa
+
+## Tabla Maestra: Evento → Doc a Actualizar
+
+| Evento | Doc a actualizar | Prioridad | Cómo detectar |
+|--------|-----------------|-----------|---------------|
+| Feature nueva | CONTEXT.md, docs/README.md, reference/ | Crítica | Nuevo módulo/archivo en src/ |
+| Feature nueva con decisión arq. | docs/adr/ | Alta | Se discutió arquitectura |
+| Feature nueva con nuevo endpoint | reference/api.md | Crítica | Nuevo archivo en routes/ |
+| Feature nueva con UI nueva | DESIGN.md | Alta | Nuevo componente UI |
+| Release | CHANGELOG.md, docs/guides/deployment.md | Crítica | git tag creado |
+| Release con breaking change | CHANGELOG.md ⚠️, reference/api.md | Crítica | API cambió retrocompatibilidad |
+| Incidente | operations/post-mortems/, operations/runbooks/ | Crítica | Alerta resuelta, outage |
+| Incidente con fix aplicable | how-to/troubleshooting.md | Alta | Fix reusable |
+| Incidente con config cambiada | reference/configuration.md | Alta | .env o config cambió |
+| Refactor | CONTEXT.md, explanation/architecture.md | Alta | Archivos renombrados/movidos |
+| Refactor con cambio de patrón | docs/adr/ | Alta | Patrón de diseño cambió |
+| Refactor que invalida ADR | ADR existente → status: deprecated | Alta | ADR ya no aplica |
+| Nuevo dev en equipo | tutorials/quick-start.md | Crítica si falla | Dev reporta confusión |
+| Nuevo dev encuentra errores | Cualquier doc afectada | Alta | Dev reporta info incorrecta |
+| Cambio de estilos/tokens | DESIGN.md | Crítica | CSS/theme cambió |
+| Cambio de estilos con nuevo componente | DESIGN.md (components) | Alta | Nuevo componente UI |
+| Nuevo endpoint | reference/api.md | Crítica | Nuevo archivo en routes/ |
+| Endpoint eliminado | reference/api.md | Crítica | Archivo eliminado de routes/ |
+| Endpoint modificado | reference/api.md | Crítica | Params/respuesta cambiaron |
+| Variable de entorno nueva | reference/configuration.md | Crítica | .env.example cambió |
+| Config eliminada | reference/configuration.md | Crítica | .env.example cambió |
+| Config con nuevo default | reference/configuration.md | Alta | Default cambió en código |
+| Término nuevo en dominio | CONTEXT.md | Crítica | Nuevo concepto en código |
+| Término eliminado | CONTEXT.md | Media | Concepto ya no existe |
+| Archivo de doc creado | docs/README.md | Crítica | Nuevo .md en docs/ |
+| Archivo de doc eliminado | docs/README.md | Crítica | .md eliminado de docs/ |
+| Dependencia agregada | docs/adr/ si es significativa | Alta | package.json cambió |
+| Dependencia eliminada | reference/ si aplica | Media | package.json cambió |
+| Dependencia con major upgrade | CHANGELOG.md, reference/ | Alta | package.json versión major↑ |
+| Schema de DB cambió | reference/database.md | Alta | Migración creada |
+| Nuevo evento/mensaje | reference/events.md | Alta | Nuevo tipo de evento |
+| Error nuevo con código | reference/errors.md | Alta | Nuevo código de error |
+| Proceso de deploy cambió | docs/guides/deployment.md | Crítica | CI/CD config cambió |
+
+---
+
+## Niveles de Prioridad
+
+### 🔴 Crítica — Actualizar inmediatamente
+
+La documentación incorrecta causa problemas reales:
+
+- **Sin reference/api.md actualizada** → Integradores usan endpoints incorrectos
+- **Sin CHANGELOG** → No se sabe qué cambió entre versiones
+- **CONTEXT.md incorrecto** → Términos ambiguos causan bugs de comunicación
+- **DESIGN.md desincronizado** → Inconsistencias visuales en producción
+- **configuration.md desactualizada** → Deploy con variables incorrectas
+- **Post-mortem no escrito** → Se repite el mismo incidente
+
+**Tiempo esperado**: Actualizar dentro de la misma tarea/PR.
+
+### 🟡 Alta — Actualizar esta semana
+
+La documentación faltante causa fricción pero no rompe nada:
+
+- **ADR faltante** → Decisiones sin contexto para nuevos devs
+- **How-to faltante** → Preguntas repetitivas al equipo
+- **Explanation faltante** → Confusión sobre decisiones pasadas
+- **Tutorial desactualizado** → Onboarding más lento
+
+**Tiempo esperado**: Actualizar dentro del sprint.
+
+### 🟢 Media — Actualizar cuando sea posible
+
+La documentación podría mejorarse pero no es urgente:
+
+- **Término en CONTEXT.md que ya no aplica** → Limpieza
+- **Ejemplo que podría ser mejor** → Mejora incremental
+- **Referencia cruzada faltante** → Navegación más fácil
+
+**Tiempo esperado**: Backlog, hacer cuando haya tiempo.
+
+---
+
+## Ejemplos por Trigger
+
+### Ejemplo 1: Post-feature — Nuevo módulo de notificaciones
+
+**Cambios en código**:
+```
+src/notifications/
+├── notification.service.ts    (nuevo)
+├── notification.controller.ts (nuevo)
+├── templates/                 (nuevo)
+└── events/                    (nuevo)
+```
+
+**Docs a actualizar**:
+
+```markdown
+1. docs/CONTEXT.md → Agregar:
+   - NotificationService: Servicio encargado de enviar notificaciones
+   - NotificationTemplate: Plantilla para generar notificaciones
+   - NotificationEvent: Evento que dispara una notificación
+
+2. docs/README.md → Agregar al mapa:
+   - reference/notifications.md (si se crea)
+
+3. reference/api.md → Agregar:
+   - POST /api/notifications
+   - GET /api/notifications/:id
+   - GET /api/notifications (list)
+
+4. reference/events.md → Agregar:
+   - notification.created
+   - notification.sent
+   - notification.failed
+
+5. ¿ADR necesario? → Solo si la implementación implica una decisión arquitectónica
+```
+
+### Ejemplo 2: Post-release — v2.1.0
+
+**Qué cambió**:
+- 3 features nuevas
+- 2 bugs corregidos
+- 1 breaking change en API
+
+**Docs a actualizar**:
+
+```markdown
+1. CHANGELOG.md → Agregar entrada:
+
+## [2.1.0] - 2024-03-15
+
+### Added
+- Módulo de notificaciones
+- Exportación a CSV
+- Filtros avanzados en búsqueda
+
+### Changed
+- El endpoint /api/users ahora retorna `avatarUrl` en vez de `avatar`
+
+### Fixed
+- Timeout en queries de reportes grandes
+- Error 500 al crear usuario sin email
+
+### Breaking ⚠️
+- GET /api/users: campo `avatar` renombrado a `avatarUrl`
+
+2. reference/api.md → Actualizar campo renombrado
+
+3. docs/guides/deployment.md → Solo si cambió el proceso de deploy
+```
+
+### Ejemplo 3: Post-incident — Timeout en base de datos
+
+**Qué pasó**: La app estuvo caída 30 minutos por queries sin timeout
+
+**Docs a actualizar**:
+
+```markdown
+1. operations/post-mortems/2024-03-15-db-timeout.md → Crear post-mortem completo
+
+2. reference/configuration.md → Agregar:
+   - DB_QUERY_TIMEOUT: Timeout máximo para queries (default: 30s)
+
+3. how-to/troubleshooting.md → Agregar:
+   - "Cómo diagnosticar timeouts de base de datos"
+
+4. operations/runbooks/database-timeout.md → Crear runbook si no existe
+```
+
+### Ejemplo 4: Post-refactor — Renombrar UserService a AccountService
+
+**Qué cambió**: Se renombró la clase y se movió de carpeta
+
+**Docs a actualizar**:
+
+```markdown
+1. docs/CONTEXT.md → Actualizar:
+   - UserService → AccountService (renombrado)
+   - Marcar UserService como deprecated si hay referencia externa
+
+2. docs/explanation/architecture.md → Actualizar diagramas/referencias
+
+3. reference/api.md → Verificar si endpoints cambiaron de nombre
+
+4. docs/adr/ → ¿El refactor merece un ADR? Solo si cambió el patrón
+```
+
+### Ejemplo 5: Post-design-change — Nuevo sistema de colores
+
+**Qué cambió**: Se actualizó la paleta de colores en Tailwind config
+
+**Docs a actualizar**:
+
+```markdown
+1. DESIGN.md → Usar skill doc-design para:
+   - Re-extraer colores de Tailwind config
+   - Actualizar sección colors en frontmatter
+   - Verificar que los tokens de componentes siguen siendo válidos
+
+2. docs/CONTEXT.md → Si hay nuevos términos de diseño
+
+3. CHANGELOG.md → Si el cambio es visible para usuarios
+```
+
+### Ejemplo 6: Post-API-change — Nuevo endpoint de búsqueda
+
+**Qué cambió**: Se agregó GET /api/search con query params
+
+**Docs a actualizar**:
+
+```markdown
+1. reference/api.md → Agregar:
+
+### GET /api/search
+
+| Parámetro | Tipo | Requerido | Descripción |
+|-----------|------|-----------|-------------|
+| q | string | Sí | Término de búsqueda |
+| limit | number | No | Resultados máximos (default: 20) |
+| offset | number | No | Paginación (default: 0) |
+| type | string | No | Filtrar por tipo (user, post, comment) |
+
+2. docs/CONTEXT.md → Si hay términos nuevos (ej: SearchIndex, QueryParser)
+
+3. how-to/ → Si hay un flujo de uso común que documentar
+```
+
+---
+
+## Cómo Detectar Qué Cambió
+
+### Por tipo de archivo
+
+| Archivo cambió | Qué verificar | Docs afectadas |
+|---------------|---------------|----------------|
+| `src/**/*.ts` | Nuevas clases, funciones, interfaces | CONTEXT.md, reference/ |
+| `src/routes/**` | Nuevos/modified endpoints | reference/api.md |
+| `src/components/**` | Nuevos/modified componentes | DESIGN.md |
+| `*.css`, `tailwind.config.*` | Tokens de diseño | DESIGN.md |
+| `.env*`, `config/*` | Variables de configuración | reference/configuration.md |
+| `migrations/**` | Cambios en schema | reference/database.md |
+| `docker-compose.*`, `Dockerfile*` | Cambios de infra | deployment.md |
+| `package.json` | Dependencias nuevas/eliminadas | docs/adr/ si es significativa |
+| `*.test.*` | Generalmente no afecta docs | — |
+| `docs/**` | Ya es doc → verificar docs/README.md | docs/README.md |
+
+### Por comando git
+
+```bash
+# Ver qué archivos cambiaron
+git diff --name-only HEAD~1 HEAD
+
+# Ver solo archivos de código (no docs)
+git diff --name-only HEAD~1 HEAD -- ':(exclude)docs/' ':(exclude)*.md'
+
+# Ver cambios en estilos
+git diff --name-only HEAD~1 HEAD -- '*.css' 'tailwind.config.*' '*.scss'
+
+# Ver cambios en rutas/API
+git diff --name-only HEAD~1 HEAD -- 'src/routes/' 'src/controllers/'
+
+# Ver cambios en config
+git diff --name-only HEAD~1 HEAD -- '.env*' 'config/' 'docker-compose.*'
+```
+
+---
+
+## Patrones de Actualización por Lotes
+
+### Fin de sprint
+
+```
+1. git diff --name-only sprint-start..sprint-end
+2. Agrupar por tipo: features, fixes, refactors, config
+3. Para cada grupo, aplicar los triggers correspondientes
+4. Actualizar CHANGELOG.md con TODO lo del sprint
+5. Ejecutar doc-review al final
+```
+
+### Post-merge de múltiples PRs
+
+```
+1. Listar PRs mergeados desde la última actualización
+2. Para cada PR, identificar el trigger
+3. Acumular cambios por doc afectada
+4. Actualizar cada doc UNA VEZ con todos los cambios
+5. No actualizar el mismo doc múltiples veces
+```
+
+### Hotfix en producción
+
+```
+1. El hotfix es prioridad CRÍTICA
+2. Actualizar CHANGELOG.md inmediatamente
+3. Actualizar reference/ si afecta API
+4. Crear post-mortem si fue incidente
+5. doc-review post-hotfix
+```
+
+---
+
+## Regla de Oro
+
+**Si cambiaste código, cambiaste documentación. Si no actualizaste la documentación, la tarea no está terminada.**