Delivery Gate — Compuerta de Calidad Mecánica para Claude Code
Un gancho de parada que verifica tres condiciones antes de que Claude pueda finalizar una sesión, utilizando únicamente comprobaciones deterministas — marcas de tiempo de modificación de archivos, uso de disco y patrones regex en el texto de la transcripción. Sin inferencia de IA.
Esto es distinto de las compuertas de razonamiento (como self-audit): delivery-gate verifica hechos verificables por máquina; self-audit verifica la calidad de la salida en cuatro dimensiones de razonamiento. Juntos forman una defensa en profundidad:
- delivery-gate: "¿Se tocó la biblioteca de aprendizaje hoy? ¿El espacio en disco es seguro?"
- self-audit: "¿El contenido del archivo es correcto, completo y honesto?"
Este es el mismo patrón que las compuertas de pipelines de CI — comprobaciones automatizadas y deterministas que verifican hechos legibles por máquina en lugar de confiar en el estado auto-reportado.
Qué verifica
| Verificación | Mecanismo | En caso de acierto |
|---|---|---|
| Patrones de racionalización | Regex sobre el final de la transcripción | Solo advertencia (nunca bloquea) |
| Bibliotecas de aprendizaje obsoletas | mtime en 5 rutas configurables | Advertencia si algunas están obsoletas; Bloqueo si >=3 están obsoletas O growth-log obsoleto + tarea compleja |
| Espacio en disco < 50GB | shutil.disk_usage | Advertencia |
| Espacio en disco < 15GB | shutil.disk_usage | Bloqueo (salida 2) |
La detección de racionalización advierte sobre patrones como "omitir pruebas por ahora" y "error preexistente" — señales superficiales de que el pensamiento pudo haberse cortado. Nunca bloquea por sí sola, porque las heurísticas de expresiones regulares pueden dar falsos positivos. Las condiciones de bloqueo son: disco crítico, >=3 bibliotecas de aprendizaje obsoletas O growth-log específicamente obsoleto (ambos requieren tarea compleja con >=3 ediciones).
Por qué
Las comprobaciones integradas de Claude Code cubren la calidad del código (compilación → tipos → lint → pruebas). Pero existe un modo de fallo diferente: el agente produce código funcional mientras que la higiene de la sesión fue descuidada — aprendizaje no capturado, racionalizaciones apresuradas, disco agotándose silenciosamente.
A lo largo de muchas sesiones de "envíar y olvidar", el humano no ha crecido. Este gancho impone el hábito: tarea compleja → debe tocar las bibliotecas de aprendizaje.
Instalación
cp quality-gate.py ~/.claude/scripts/
Añadir a ~/.claude/settings.json:
{
"hooks": {
"Stop": [{
"hooks": [{
"type": "command",
"command": "python3 ~/.claude/scripts/quality-gate.py",
"timeout": 5000
}]
}]
}
}
Bibliotecas de aprendizaje
Cree estos archivos en el directorio de memoria de su proyecto. El gancho verifica si al menos uno fue actualizado hoy:
memory/
├── growth-log/ # Entradas de aprendizaje diarias (directorio)
├── decisions/log.md # Registro de decisiones
├── output-index.md # Índice de salidas de sesión
├── ratings-tracker.md # Seguimiento de calificaciones de habilidades
└── tooling_capabilities.md # Inventario de herramientas conocidas
Personalice el diccionario LIBS para que coincida con su propia estructura de archivos.
Configuración
Edite quality-gate.py:
| Variable | Valor por defecto | Propósito |
|---|---|---|
RATIONALIZE | 4 patrones | Patrones regex para detección de racionalización |
LIBS | 5 bibliotecas | Archivos/directorios para verificar actualizaciones de hoy |
COMPLEX_THRESHOLD | 3 | Llamadas a Editar/Escribir para clasificar como compleja |
DISK_WARN_GB | 50 | Advertir por debajo de esto |
DISK_CRIT_GB | 15 | Bloquear por debajo de esto |
Ejemplos
Sesión simple — permitida:
edit_count=1 (< 3, no compleja) → salida 0
Tarea compleja, aprendizaje capturado — permitida:
edit_count=5 (compleja) → verifica LIBS → growth-log actualizado hoy → salida 0
Tarea compleja, sin aprendizaje — BLOQUEADA:
edit_count=4 (compleja) → verifica LIBS → las 5 obsoletas → salida 2
stderr: "Bloqueada: tarea compleja completada pero no se capturó aprendizaje hoy."
Espacio bajo en disco — BLOQUEADA:
disk_free=12GB < 15GB crítico → salida 2
stderr: "Bloqueada: espacio en disco a 12GB (umbral: 15GB)."
Limitaciones
El gancho impone el hábito de tocar las bibliotecas de aprendizaje, no la calidad de lo que se registró. Si output-index.md se actualiza pero growth-log se omite, el gancho pasa (1 de 5 bibliotecas tocadas). Esto es intencional: las compuertas mecánicas verifican hechos verificables por máquina. Para la verificación de la calidad del contenido, combínelo con self-audit.
Compatibilidad
- Python 3.8+ (usa
from __future__ import annotations) - Multiplataforma: Windows, macOS, Linux
- Cero dependencias más allá de la biblioteca estándar
Calidad
Este código pasó por 4 rondas de revisión automatizada de código (CodeRabbit + Greptile) con 9 errores reales encontrados y corregidos.
Véase también
self-audit— Compuerta de calidad de razonamiento (integridad/consistencia/fundamentación/honestidad)verification-loop— Comprobaciones de calidad de código (compilación/tipos/lint/pruebas)gateguard— Compuerta de seguridad PreToolUse