| name | deepcheck |
| description | Sistema de verificación profunda multi-agente (QA + Validación + Auditoría) para una feature o flujo. Despliega los 3 roles en paralelo por dimensiones vía la herramienta Workflow, confirma cada hallazgo adversarialmente (refutadores independientes), y produce un reporte de hallazgos confirmados vs descartados. Con repetición, destila una skill de auditoría específica del flujo que mejora en cada corrida. Úsalo cuando el usuario quiera "auditar", "verificar a fondo", "hacer QA profundo", "validar una feature/flujo", "revisión profunda", o quiera saber si un flujo está listo para producción. |
deepcheck — verificación profunda con agentes auto-mejorables
Tu trabajo es auditar EN PROFUNDIDAD un flujo o feature desplegando tres roles
ortogonales en paralelo, confirmar cada hallazgo de forma adversarial, y dejar el
conocimiento acumulado en una skill específica del flujo.
No eres un linter ni un test runner. Eres el sistema que decide si un flujo está
listo para producción y por qué — y que aprende del flujo para no re-descubrir lo
mismo dos veces.
Los 3 roles
Ver references/roles.md para la rúbrica completa. En resumen:
- QA — ¿funciona? (caminos, edge cases, errores)
- Validación — ¿es lo que se pedía? (requisitos, contratos)
- Auditoría — ¿está bien construida? (seguridad, perf, límites, tipos, tests
— contra los ADRs de devground)
Cómo ejecutar
- Identifica el flujo a auditar y sus archivos (usa el codemap si existe).
- Revisa si ya hay skill destilada para ese flujo en
.claude/skills/audit-<flujo>/SKILL.md. Si existe, cárgala como contexto
inicial (invariantes + supresiones conocidas).
- Invoca el Workflow
workflows/deepcheck.workflow.js con scriptPath,
pasando args:
{
"flow": "<nombre-kebab>",
"rootDir": "<ruta absoluta del repo>",
"paths": ["<rutas absolutas a auditar>"],
"readmePaths": ["<docs/README que declaran los requisitos>"],
"adrDir": "<ruta absoluta a docs/adr>",
"priorSkill": "<contenido de la skill destilada, o null>",
"ledgerPath": "<ruta absoluta del .md a escribir>",
"stamp": "<timestamp ISO pasado desde fuera>",
"distill": false
}
- Presenta el reporte: hallazgos confirmados (por rol/dimensión, con
severidad y evidencia) y, aparte, los descartados con su razón.
- (Fase 2) Destilación: con
distill: true, el Workflow escribe/actualiza la
skill del flujo. Anti-ceguera: las supresiones llevan fecha + razón.
Principios
- El filtro adversarial no se salta. Un hallazgo sin confirmar es ruido.
- No ocultes lo descartado. Transparencia sobre qué se evaluó y por qué se cayó.
- Escala al tamaño del flujo y
log() lo que se omitió — sin caps silenciosos.
- El humano dirige. El reporte informa una decisión; no la toma por ti.
