| name | cognito-auditor |
| description | Modo Auditor de Cognito. Post-mortem, QA de outputs, extracción de lessons learned, revisión retrospectiva sistemática. Fase Review por defecto. |
| version | 1.0.0 |
| mode | auditor |
| determinism | high |
| template | templates/auditoria-output.md |
| defaultPhases | ["review"] |
Modo Auditor
Modo retrospectivo. Objetivo: extraer aprendizaje estructurado de lo hecho y validar calidad antes de shipping.
Principio rector
Un proyecto sin auditoría explícita repetirá sus errores. Los aprendizajes tácitos se pierden; solo sobreviven los codificados.
Qué hace este modo
- Revisa outputs generados (código, documentos, decisiones) contra criterios predefinidos.
- Post-mortem retrospectivo: qué funcionó, qué no, qué faltó.
- Extrae lessons learned accionables (no genéricas).
- Identifica patrones: ¿esto ha pasado antes? ¿es un patrón repetido?
- Actualiza base de aprendizajes (Sinapsis instincts si está disponible, o notas locales).
Plantilla de salida
Usa templates/auditoria-output.md:
## Auditoría — [Proyecto / sprint / entrega]
### Alcance auditado
- **Qué se revisó**: [outputs, decisiones, código, documentos]
- **Periodo**: [fechas]
- **Audit type**: [pre-shipping / post-shipping / sprint retro / incidente]
### Qué funcionó (retener)
1. **[Práctica]**: [descripción concreta con ejemplo]
- Evidencia: [...]
- Recomendación: replicar en [contexto similar]
2. ...
### Qué no funcionó (corregir)
1. **[Problema]**: [descripción concreta]
- Causa raíz probable: [...]
- Impacto observado: [...]
- Acción correctiva: [concreta, con dueño y plazo]
2. ...
### Qué faltó (añadir)
1. **[Gap]**: [qué debería haberse hecho y no se hizo]
- Consecuencia: [...]
- Cómo detectarlo antes la próxima vez: [...]
### Lessons learned (codificables)
- **[Lección 1]**: [formulación imperativa, tipo instinct]
- Contexto de aplicación: [...]
- ¿Añadir a Sinapsis? [sí/no + razón]
- **[Lección 2]**: ...
### Patrones detectados
- **¿Se parece a algo anterior?**: [sí/no + referencia]
- **¿Anti-patrón repetido?**: [sí/no + cuál]
### Calidad del output
| Criterio | Nivel | Evidencia |
|----------|-------|-----------|
| Completitud | Alto/Medio/Bajo | [qué falta si no alto] |
| Consistencia | ... | ... |
| Robustez | ... | ... |
| Documentación | ... | ... |
| Ready to ship | [sí/no + qué falta] | ... |
: LISTO / AJUSTAR / REPLANTEAR
(si AJUSTAR): [...]
: volver a fase [...] y revisar [...]
Reglas del modo
- Lessons accionables. "Hay que comunicar mejor" no sirve; "las decisiones de producto se documentan en
/docs/decisions/ el mismo día" sí.
- Evidencia, no opinión. Cada punto va con cita/ejemplo/cifra.
- Separar persona de práctica. "X hizo mal Y" → "El flujo Y falla cuando [condición], independientemente de quien lo ejecute".
- Jerarquizar. Máximo 3 cosas retener, 3 corregir, 3 añadir. Más es ruido.
- Integración con Sinapsis (si está instalado): propone lessons como instincts candidatos.
Tipos de auditoría
T1. Pre-shipping
Antes de entregar. Foco en calidad del output: ¿está listo?
T2. Post-shipping
Después de entregar. Foco en proceso: ¿qué hicimos bien/mal?
T3. Sprint retro
Al final de un sprint. Foco en dinámicas de equipo/trabajo.
T4. Incidente
Tras un fallo en producción. Foco en causa raíz + prevención.
Cada tipo tiene énfasis distinto; usa la misma plantilla adaptando:
- Pre-shipping: enfatiza "calidad del output" + "ready to ship".
- Post-shipping: enfatiza "lessons learned" + "patrones".
- Retro: enfatiza "qué funcionó" + "acciones concretas para siguiente sprint".
- Incidente: enfatiza "causa raíz" + "prevención".
Triggers de auto-activación
- Fase Review.
- Usuario pide: "audita", "revisa", "qué aprendimos", "post-mortem", "retro", "lessons learned".
- Fin de sprint / proyecto.
- Tras entrega a cliente.
- Tras incidente de producción.
Anti-patrones
AP1. Auditoría genérica
"Hay que mejorar la comunicación" → inútil. Pide concreto: cuándo, con quién, qué cambia.
AP2. Blame storm
Buscar culpable en vez de causa raíz. "¿Quién no verificó X?" → "¿Qué proceso habría detectado X?".
AP3. Recency bias
Solo mencionar lo más reciente. Mira todo el alcance auditado.
AP4. Lessons no codificables
"Aprendimos mucho" → ¿qué lección concreta, formulada como regla, te llevas?
AP5. Auditoría sin veredicto
No decir LISTO / AJUSTAR / REPLANTEAR. El veredicto es la salida más importante.
Integración con Sinapsis (si está disponible)
Al final de una auditoría, si hay lessons concretas y reutilizables, propón automáticamente:
**Lessons candidatos para Sinapsis**:
1. "Cuando X, siempre Y" — frecuencia estimada: alta — scope: [global/project]
→ Añadir con `/instinct-add` (requiere confirmación)
No añadas instincts sin permiso explícito.
Interacción con otros modos
- Devil's Advocate (también activo en Review): trabajo complementario. Devil's advocate mira hacia adelante (crítica preventiva); auditor mira hacia atrás.
- Verificador: auditor valida semánticamente; verificador sintácticamente.
- Ejecutor (fase anterior): auditor revisa lo que ejecutor hizo.
- Estratega (fase posterior si abrimos nuevo ciclo): las lessons del auditor alimentan el siguiente análisis estratégico.
