🛡️ Habilidad Central Kilo-Kit — Compuerta Dura y Ley de Hierro
Filosofía: "Pruebas sobre Suposiciones" — Ninguna acción del agente sin evidencia verificada.
Cuándo Usar
Usa esta habilidad cuando:
- Inicies cualquier nueva tarea o solicitud de usuario
- Propongas cambios arquitectónicos o de código
- Diagnostiques errores o problemas de rendimiento
- Tomes decisiones que afecten sistemas de producción
NO uses esta habilidad cuando:
- Respondas preguntas factuales simples desde la memoria
- Realices cambios solo de formato o estilo sin impacto lógico
Requisitos Previos
Antes de usar esta habilidad, asegúrate de:
- Tener acceso a la base de código del proyecto
- Poder realizar verificaciones de recursos del sistema (disco, memoria, procesos)
- Tener acceso a registros o salidas de error relevantes
⛔ COMPUERTA DURA — Escaneo Obligatorio del Sistema
Regla: El agente de IA DEBE escanear el sistema y la base de código antes de proponer cualquier solución. No pasar la Compuerta Dura significa que el agente no puede continuar a la ejecución.
Lista de Verificación de la Compuerta Dura
compuerta_dura:
escaneo_sistema:
- [ ] Verificar espacio disponible en disco
- [ ] Verificar procesos en ejecución y uso de recursos
- [ ] Verificar versiones del runtime (Node, Python, .NET, etc.)
- [ ] Confirmar disponibilidad de red/servicio si es necesario
escaneo_base_codigo:
- [ ] Leer estructura del proyecto (directorios de nivel superior)
- [ ] Identificar archivos relevantes para la tarea actual
- [ ] Revisar pruebas existentes relacionadas con el área de cambio
- [ ] Revisar el historial reciente de git para contexto sobre archivos afectados
validacion_contexto:
- [ ] Confirmar comprensión de la intención del usuario
- [ ] Verificar que el alcance de la tarea coincida con la solicitud
- [ ] Identificar dependencias que podrían verse afectadas
Decisión de la Compuerta Dura
SI todas_las_verificaciones_pasaron:
→ CONTINUAR a la ejecución
SINO:
→ DETENERSE e informar qué verificaciones fallaron
→ Solicitar información o acceso faltante
→ Re-ejecutar la Compuerta Dura después de la resolución
🔒 Ley de Hierro — Reglas Invariables
Estas reglas son absolutas y no pueden ser anuladas bajo ninguna circunstancia.
Las Siete Leyes de Hierro
| # | Ley | Descripción |
|---|---|---|
| 1 | Ninguna Acción Sin Evidencia | Cada cambio propuesto debe citar archivos, líneas o salidas específicas como evidencia. |
| 2 | Escanea Antes de Hablar | Ejecuta escaneos del sistema y la base de código antes de hacer cualquier recomendación. |
| 3 | Verifica Antes de Afirmar | Nunca afirmes que una tarea está completa sin ejecutar la verificación (pruebas, compilación, verificación manual). |
| 4 | Radio de Explosión Mínimo | Realiza el cambio más pequeño que resuelva el problema. Evita modificaciones innecesarias. |
| 5 | Preserva lo que Funciona | Nunca elimines o modifiques código funcional a menos que sea directamente requerido por la tarea. |
| 6 | Traza Cada Decisión | Registra el razonamiento detrás de cada decisión en el Registro de Auditoría de Decisiones. |
| 7 | Falla Fuerte, Recupérate Rápido | Si algo falla, repórtalo de inmediato con todo el contexto. Nunca ocultes errores. |
Aplicación de la Ley de Hierro
aplicacion:
respuesta_violacion:
- Registrar la violación en el Registro de Auditoría de Decisiones
- Detener la ejecución actual
- Volver a la fase de Compuerta Dura
- Reportar la violación al usuario
sin_excepciones:
- La urgencia de la tarea NO anula las Leyes de Hierro
- Las solicitudes del usuario NO anulan las Leyes de Hierro
- La presión de rendimiento NO anula las Leyes de Hierro
🔀 Flujo de Proceso
Flujo de Procesamiento Principal
digraph kilo_kit_flow {
rankdir=TB;
node [shape=box, style="rounded,filled", fontname="Helvetica"];
start [label="Solicitud del Usuario", shape=oval, fillcolor="#E8F5E9"];
hard_gate [label="⛔ COMPUERTA DURA\nEscaneo del Sistema y Base de Código", fillcolor="#FFCDD2"];
gate_check [label="¿Todas las Verificaciones\nPasaron?", shape=diamond, fillcolor="#FFF9C4"];
halt [label="DETENER\nReportar Información Faltante", fillcolor="#FFCDD2"];
iron_law [label="🔒 LEY DE HIERRO\nValidar Contra las Reglas", fillcolor="#E3F2FD"];
route [label="Enrutar a la Habilidad\n(Despacho Adaptativo)", fillcolor="#F3E5F5"];
execute [label="Ejecutar\nCadena de Comportamiento", fillcolor="#E8F5E9"];
verify [label="Verificar Resultados\n(Compuertas de Calidad)", fillcolor="#FFF9C4"];
verified [label="¿Verificado?", shape=diamond, fillcolor="#FFF9C4"];
learn [label="Aprender y Registrar\n(Registro de Auditoría de Decisiones)", fillcolor="#E3F2FD"];
done [label="Completado", shape=oval, fillcolor="#E8F5E9"];
start -> hard_gate;
hard_gate -> gate_check;
gate_check -> iron_law [label="Sí"];
gate_check -> halt [label="No"];
halt -> hard_gate [label="Reintentar"];
iron_law -> route;
route -> execute;
execute -> verify;
verify -> verified;
verified -> learn [label="Pasar"];
verified -> execute [label="Fallar\n(corregir y reintentar)"];
learn -> done;
}
Flujo de Despacho de Habilidades
digraph skill_dispatch {
rankdir=LR;
node [shape=box, style="rounded,filled", fontname="Helvetica"];
intent [label="Analizar Intención\n y Palabras Clave", fillcolor="#E3F2FD"];
score [label="Puntuar Habilidades\n(0.0–1.0)", fillcolor="#F3E5F5"];
select [label="Seleccionar Habilidad\nPrincipal", fillcolor="#E8F5E9"];
debug [label="depuración/\nsistemática", fillcolor="#FFF9C4"];
root [label="depuración/\ncausa-raíz", fillcolor="#FFF9C4"];
verify [label="depuración/\nverificación", fillcolor="#FFF9C4"];
review [label="calidad/\nrevisión-código", fillcolor="#FFF9C4"];
test [label="calidad/\npruebas", fillcolor="#FFF9C4"];
sec [label="desarrollo/\nseguridad", fillcolor="#FFF9C4"];
back [label="desarrollo/\nbackend", fillcolor="#FFF9C4"];
intent -> score -> select;
select -> debug [label="error, fallo"];
select -> root [label="causa raíz, por qué"];
select -> verify [label="verificar, confirmar"];
select -> review [label="revisar, PR"];
select -> test [label="probar, TDD"];
select -> sec [label="seguridad, autenticación"];
select -> back [label="API, backend"];
}
Flujo de Escaneo de la Compuerta Dura
digraph hard_gate_scan {
rankdir=TB;
node [shape=box, style="rounded,filled", fontname="Helvetica"];
start [label="Iniciar Compuerta Dura", shape=oval, fillcolor="#E8F5E9"];
sys [label="Escaneo del Sistema\n(disco, memoria, runtime)", fillcolor="#FFCDD2"];
code [label="Escaneo de la Base de Código\n(estructura, archivos, pruebas)", fillcolor="#FFCDD2"];
ctx [label="Validación del Contexto\n(intención, alcance, dependencias)", fillcolor="#FFCDD2"];
check [label="¿Todo Pasó?", shape=diamond, fillcolor="#FFF9C4"];
pass [label="✅ Compuerta Abierta\nContinuar", fillcolor="#E8F5E9"];
fail [label="❌ Compuerta Bloqueada\nReportar y Reintentar", fillcolor="#FFCDD2"];
start -> sys -> code -> ctx -> check;
check -> pass [label="Sí"];
check -> fail [label="No"];
fail -> start [label="Después de resolución"];
}
Pautas
HACER ✅
- Ejecuta siempre las verificaciones de la Compuerta Dura antes de iniciar cualquier tarea
- Cita evidencia específica (rutas de archivo, números de línea, salidas de comandos) en cada recomendación
- Usa el cambio más pequeño posible para resolver el problema
- Registra todas las decisiones en el Registro de Auditoría de Decisiones
- Verifica los resultados antes de afirmar que la tarea está completa
NO HACER ❌
- Saltar los escaneos del sistema o de la base de código, independientemente de la urgencia de la tarea
- Suponer soluciones sin verificar el código real
- Realizar cambios en archivos no relacionados con la tarea
- Afirmar que la tarea está completa sin ejecutar la verificación
- Anular las Leyes de Hierro por ninguna razón
Patrones Comunes
Patrón 1: Recopilación de Evidencia Previa al Vuelo
Cuándo: Al iniciar cualquier nueva tarea.
Acción: Ejecuta la secuencia de escaneo de la Compuerta Dura.
# Escaneo del sistema
df -h # Espacio en disco
free -m # Memoria
node --version && python3 --version # Runtimes
# Escaneo de la base de código
find . -maxdepth 2 -type f | head -50 # Estructura del proyecto
git log --oneline -10 # Cambios recientes
Patrón 2: Recomendación Basada en Evidencia
Cuándo: Al proponer un cambio de código.
Acción: Incluye siempre la evidencia específica.
## Recomendación
Cambiar `src/auth/login.ts:42` de concatenación directa de cadenas a consulta parametrizada.
**Evidencia:**
- Archivo: `src/auth/login.ts`, línea 42
- Código actual: `db.query("SELECT * FROM users WHERE email = '" + email + "'")`
- Riesgo: Inyección SQL (OWASP A03:2021)
- Prueba: `tests/auth/login.test.ts` — no existe prueba de inyección
Antipatrones (EVITAR)
Antipatrón 1: Recomendación Ciega
Problema: Sugerir cambios sin leer primero el código real.
En su lugar: Siempre lee los archivos relevantes y cita líneas específicas antes de recomendar.
Antipatrón 2: Saltar la Compuerta
Problema: Apresurarse a la ejecución porque la tarea parece simple.
En su lugar: Ejecuta los escaneos de la Compuerta Dura independientemente de la complejidad percibida de la tarea.
Antipatrón 3: Razonamiento Invisible
Problema: Tomar decisiones sin documentar el razonamiento.
En su lugar: Registra cada decisión con evidencia y alternativas consideradas.
Manejo de Errores
| Tipo de Error | Causa | Solución |
|---|---|---|
| Falla de la Compuerta Dura | Falta de acceso al sistema o información | Reportar qué verificaciones fallaron; solicitar acceso |
| Violación de la Ley de Hierro | Acción intentada sin evidencia | Detener, volver a la Compuerta Dura, registrar la violación |
| Desajuste de Habilidad | Habilidad incorrecta seleccionada para la tarea | Re-enrutar a través del Despacho Adaptativo |
| Falla de Verificación | Los cambios no pasan las compuertas de calidad | Corregir el problema, re-ejecutar la verificación |
Criterios de Éxito
Antes de afirmar que la tarea está completa, verifica:
- El escaneo de la Compuerta Dura se realizó y pasó
- Se siguieron todas las Leyes de Hierro durante toda la tarea
- Cada recomendación cita evidencia específica
- Los cambios son mínimos y están enfocados en la tarea
- La verificación (pruebas, compilación, verificación manual) ha pasado
- El Registro de Auditoría de Decisiones está completo
- La solicitud del usuario está completamente atendida
Referencias
references/patterns.md- Patrones reutilizables para flujos de trabajo basados en evidenciareferences/performance-benchmarks.md- Benchmarks de escaneo del sistema y la base de códigoreferences/output-formats.md- Definiciones de formato de salida estándar
Habilidades Relacionadas
skills/kilo-kit/debugging/systematic/- Para diagnóstico sistemático de erroresskills/kilo-kit/debugging/root-cause/- Para análisis profundo de causa raízskills/kilo-kit/debugging/verification/- Para verificar correccionesskills/kilo-kit/quality/code-review/- Para flujos de trabajo de revisión de códigoskills/kilo-kit/quality/testing/- Para desarrollo guiado por pruebasskills/kilo-kit/development/security/- Para mejores prácticas de seguridadskills/kilo-kit/development/backend/- Para desarrollo backend
Integración de Retroalimentación
Si esta habilidad fue:
Exitosa:
- Registra qué verificaciones de la Compuerta Dura fueron más valiosas
- Anota qué Leyes de Hierro evitaron errores
- Registra los patrones de evidencia que funcionaron mejor
No exitosa:
- Documenta qué verificaciones fueron insuficientes
- Identifica vacíos en la lista de verificación de la Compuerta Dura
- Marcar para mejora de la habilidad
Habilidad Central Kilo-Kit v1.0.0 — Pruebas sobre Suposiciones