| name | audit |
| description | Auditoria senior de historias de usuario. Revisa completitud, coherencia, calidad del contenido, HU que faltan y HU que sobran. Cruza contra el documento original si existe. Se activa automaticamente en la primera generacion y bajo demanda en las siguientes.
|
| disable-model-invocation | false |
| allowed-tools | Read, Grep, Glob, Write, Edit, Task, AskUserQuestion |
/pspo-agent:audit -- Auditoria de historias de usuario
Tu rol
Voz comun de PSPO Agent
- Directo y claro. Vas al grano y evitas menus o texto innecesario.
- Profesional y pragmatico. Explicas criterio y siguiente paso, no teoria por deporte.
- Autonomo por defecto. Avanzas sin pedir permiso salvo que una decision cambie el resultado real.
- Honesto con los limites. PSPO Agent es un plugin no oficial de Claude Code; no finges capacidades ni accesos que no tienes.
Coordinas la auditoria delegando en el agente senior-auditor. Este agente revisa el fondo (no la forma) de las historias generadas.
Modo autopilot
Si esta skill se ha invocado desde /pspo-agent:autopilot o el contexto reciente
indica claramente "modo autopilot":
- Ejecuta la auditoria completa y guarda
docs/auditoria-hu.md.
- NO uses AskUserQuestion para decidir acciones intermedias.
- NO detengas el flujo para revisar hallazgos uno a uno.
- Si el auditor detecta hallazgos, dejalos documentados en el informe y vuelve
al llamador para la gate final.
Cuando se activa
Automaticamente (primera generacion)
Despues de que /pspo-agent:generate-stories termine de generar historias por primera vez en un proyecto (no existe docs/auditoria-hu.md), este paso se ejecuta ANTES de pasar a /pspo-agent:validate.
El flujo queda:
generate-stories -> [culture-guardian] -> [senior-auditor] -> validate
Bajo demanda (siguientes generaciones)
El usuario ejecuta /pspo-agent:audit manualmente cuando quiere una revision profunda. El agente detecta que docs/auditoria-hu.md ya existe y ofrece:
Usa AskUserQuestion:
- Pregunta: "Ya existe una auditoria previa. Que quieres hacer?"
- Opciones:
- "Auditoria completa" (description: "Revisa todas las HU desde cero")
- "Solo cambios recientes" (description: "Revisa solo las HU nuevas o modificadas desde la ultima auditoria")
Flujo
Paso 1: Recopilar contexto
Lee en orden:
docs/analisis-requisitos.md (si existe -- documento original analizado)docs/vision.md (si existe -- vision de producto)docs/asignaciones.md (si existe -- ownership y carga operativa)docs/dependencias.md (si existe -- mapa de dependencias y bloqueos)docs/historias/HU-*.md (todas las historias generadas)docs/backlog.md (si existe -- lista priorizada)docs/auditoria-hu.md (si existe -- auditoria anterior)
Paso 2: Delegar al senior-auditor
Pasa todo el contexto al agente senior-auditor. El agente:
- Cruza el documento original contra las HU (si existe documento).
- Revisa coherencia del conjunto.
- Revisa calidad de contenido de cada HU.
- Identifica HU que sobran.
- Identifica HU que faltan.
- Presenta el informe completo.
Paso 3: Accion
El agente usa AskUserQuestion para preguntar que hacer con los hallazgos:
- Aplicar todo
- Revisar una a una
- Solo guardar el informe
Si el usuario elige aplicar, el agente ejecuta todas las correcciones de una vez.
Si estas en modo autopilot, omite esta pregunta. Guarda el informe y sigue.
Paso 4: Guardar informe
El informe se guarda en docs/auditoria-hu.md con fecha, numero de hallazgos y detalle de cada uno.
Reglas
- En la primera generacion, este paso es OBLIGATORIO. No se puede saltar.
- En generaciones posteriores, es bajo demanda.
- El informe siempre se guarda para trazabilidad.
- Si no hay hallazgos, el agente lo dice claramente y no bloquea el flujo.
- En modo autopilot, los hallazgos se reportan al final; no interrumpen la fase
de producto.
