affaan-m/verification-loop

Skill de Bucle de Verificación

Sistema de verificación completo para sesiones de Claude Code.

Cuándo Usar

Invocar este skill:

• Después de completar una funcionalidad o cambio de código significativo
• Antes de crear un PR
• Cuando se quiere garantizar que las compuertas de calidad pasen
• Después de refactorizar

Fases de Verificación

Fase 1: Verificación del Build

# Verificar si el proyecto compila
npm run build 2>&1 | tail -20
# O
pnpm build 2>&1 | tail -20

Si el build falla, DETENER y corregir antes de continuar.

Fase 2: Verificación de Tipos

# Proyectos TypeScript
npx tsc --noEmit 2>&1 | head -30

# Proyectos Python
pyright . 2>&1 | head -30

Reportar todos los errores de tipo. Corregir los críticos antes de continuar.

Fase 3: Verificación de Lint

# JavaScript/TypeScript
npm run lint 2>&1 | head -30

# Python
ruff check . 2>&1 | head -30

Fase 4: Suite de Pruebas

# Ejecutar pruebas con cobertura
npm run test -- --coverage 2>&1 | tail -50

# Verificar umbral de cobertura
# Objetivo: mínimo 80%

Reportar:

• Total de pruebas: X
• Pasadas: X
• Fallidas: X
• Cobertura: X%

Fase 5: Escaneo de Seguridad

# Verificar secretos
grep -rn "sk-" --include="*.ts" --include="*.js" . 2>/dev/null | head -10
grep -rn "api_key" --include="*.ts" --include="*.js" . 2>/dev/null | head -10

# Verificar console.log
grep -rn "console.log" --include="*.ts" --include="*.tsx" src/ 2>/dev/null | head -10

Fase 6: Revisión de Diff

# Mostrar qué cambió
git diff --stat
git diff HEAD~1 --name-only

Revisar cada archivo modificado en busca de:

• Cambios no intencionados
• Manejo de errores faltante
• Casos borde potenciales

Formato de Salida

Después de ejecutar todas las fases, producir un reporte de verificación:

REPORTE DE VERIFICACIÓN
=======================

Build:      [PASS/FAIL]
Tipos:      [PASS/FAIL] (X errores)
Lint:       [PASS/FAIL] (X advertencias)
Pruebas:    [PASS/FAIL] (X/Y pasadas, Z% cobertura)
Seguridad:  [PASS/FAIL] (X problemas)
Diff:       [X archivos modificados]

General:    [LISTO/NO LISTO] para PR

Problemas a Corregir:
1. ...
2. ...

Modo Continuo

Para sesiones largas, ejecutar la verificación cada 15 minutos o después de cambios importantes:

Establecer un checkpoint mental:
- Después de completar cada función
- Después de terminar un componente
- Antes de pasar a la siguiente tarea

Ejecutar: /verify

Integración con Hooks

Este skill complementa los hooks PostToolUse pero proporciona una verificación más profunda. Los hooks detectan problemas de inmediato; este skill proporciona una revisión completa.