Agent Harness Repair

Que es

Cierra la brecha check-to-fix: el validador no solo nombra el fallo, emite el patch (${CLAUDE_PLUGIN_ROOT}/skills/agent-harness-creator/scripts/audit_harness.py <dir> --emit-fix), y este skill lo aplica con diff minimo (references/check-to-fix.md). Un validador que puede generar el fix que exige es estrictamente mejor que uno que solo lo nombra. [CÓDIGO]

Cuando usar

• Despues de un audit o diagnose con fallos mecanicos: placeholders, done sin evidencia, deps colgantes, comandos muertos, secciones faltantes.
• NO para agregar features nuevas ni para reestructurar el arnes.

Procedimiento

1. Corre --emit-fix y toma SOLO las ops emitidas. [CÓDIGO]
2. Aplica cada op: fill_placeholders (contenido real, fuente templates/), demote_status (done -> in_progress si evidencia vacia), drop_dangling_dep, add_section (desde template; tambien H4: lineas - fair_game:/- hands_off:), reconcile_commands (remover o implementar), scaffold_missing (via scaffold_harness.py; tambien H1/H3/W1/W2: re-emite settings.json, hooks, harness.sh, session.json), rewrite_hook_transport (H2: el hook debe leer stdin JSON, nunca CLAUDE_TOOL_*).
3. Re-corre el audit: el score DEBE subir o el patch se revierte. [CÓDIGO]
4. Registra la reparacion como entrada de progress.md con evidencia.

Contract

• Aceptacion: score post-reparacion > score previo; cero ops aplicadas fuera de la lista emitida; entrada de progress registrada. [CÓDIGO]
• Limites: fallos no-mecanicos (meta ambigua, criterios no ejecutables) se devuelven al humano, no se inventan. [EXPLICIT]
• Casos borde: patch que empeora el score (revertir y reportar); ops en conflicto (aplicar en orden emitido, determinista). [EXPLICIT]
• Supuestos: el audit previo es de la misma version del arbol. [SUPUESTO]
• Trade-off: diff minimo deja deuda visible en vez de esconderla en reescrituras amplias. [EXPLICIT]

Packet

Capas del packet, cargables bajo demanda (disciplina ICM: una capa por vez, nunca todas juntas): references/ guías de profundidad (cargar UNA por etapa) · knowledge/ cuerpo de conocimiento · prompts/ prompts listos · examples/ salida de ejemplo · agents/ subagentes del packet · scripts/ automatización local · assets/ recursos estáticos.