anti-loop-protocol

OBJETIVO

Detectar automáticamente cuando un agente ejecuta el mismo procedimiento con exactamente el mismo resultado 2 veces consecutivas, y cancelar el procedimiento para evitar loops infinitos.

---

REGLA GENERAL DE DETECCIÓN DE LOOPS

Condición de activación

Si un agente ejecuta el MISMO procedimiento con EXACTAMENTE el MISMO resultado 2 veces consecutivas:

→ TERMINAR INMEDIATAMENTE el procedimiento → Reportar el fingerprint del loop detectado → Solicitar intervención humana o escalar al siguiente nivel

Definición de "Mismo Procedimiento"

Se considera el mismo procedimiento si cumple TODOS estos criterios:

1. Mismo comando/toolcall: Misma herramienta ejecutada (grep, edit, bash, read, etc.)
2. Mismos parámetros: Mismos argumentos exactos o semánticamente equivalentes
   • Ejemplo equivalente: grep "double.*jump" ≈ grep "doubleJump"
   • Ejemplo NO equivalente: grep "jump" ≠ grep "doubleJump"
3. Mismo contexto/archivos: Mismos archivos o rutas involucradas
   • Misma ruta exacta: src/app/app.ts
   • Mismo patrón de archivos: **/*.spec.ts

Definición de "Mismo Resultado"

Se considera el mismo resultado si cumple AL MENOS UNO de estos criterios:

1. Mismo output/error exacto: Texto de salida idéntico
2. Mismo estado final:
   • Misma cantidad de archivos encontrados
   • Misma línea de error
   • Mismo número de tests fallando
3. Mismas modificaciones:
   • Los archivos tienen el mismo timestamp de modificación (no hubo cambios)
   • El contenido de los archivos es idéntico al intento anterior

---

FORMATO DE FINGERPRINT GENERAL

Estructura obligatoria

AGENT::<nombre-agente>::<tipo-operación>::<contexto>::<hash-resultado>

Componentes:

• AGENT: Prefijo fijo para identificar fingerprints de agentes
• nombre-agente: Nombre del agente (explorer, code-writer, qa-validator, etc.)
• tipo-operación: Tipo de operación (grep, edit, bash, read, test, build)
• contexto: Contexto de la operación (archivos, rutas, parámetros clave)
• hash-resultado: Hash simplificado del resultado (primeros 50 chars o resumen)