Logo de Duo
DuoLabs Clases • Guía Didáctica

Harness Engineering: El Arnés para Agentes de IA

Cómo guiar a la Inteligencia Artificial para trabajar de forma segura y sin romper tu proyecto

Formato Interactivo & PDF
Versión Simplificada 2026

1. ¿Qué es el Harness (Arnés)?

Es la estructura de control de calidad que instalamos en tu proyecto para que los asistentes de IA trabajen con orden, riendas firmes y sin romper el código ni la lógica comercial.

Analogía Didáctica: El Caballo Salvaje y la Silla de Montar
La Inteligencia Artificial actual (modelos como Claude, Gemini o GPT) es como un caballo salvaje lleno de potencia bruta. Si lo sueltas sin riendas dentro de tu proyecto, correrá rapidísimo, pero eventualmente chocará con un árbol o romperá el establo (creará errores en producción o desordenará tus carpetas).

El Harness (Arnés) es la silla de montar, las riendas y los estribos. Le da dirección al caballo, define el camino seguro por donde avanzar y te permite frenar su marcha antes de que cometa un error grave.

1. Control Directo

No confiamos a ciegas en lo que inventa la IA. El arnés la obliga a revisar la salud del proyecto antes de escribir una sola línea.

2. Protección Total

Le entrega a la IA el mapa exacto del repositorio para que sepa qué carpetas tocar y cuáles están estrictamente prohibidas.

3. Independencia de IA

Las reglas viven guardadas en tu propia carpeta. Si mañana cambias de modelo de IA, tu arnés y la seguridad siguen intactas.

Diagrama de Arquitectura del Harness Engineering
Haz clic para ampliar la imagen

2. Estructuración en Roles Multi-Agente

Para evitar confusiones, el arnés no deja todo el trabajo en manos de un solo bot. Divide las tareas como en un equipo de construcción profesional:

Fase 1: Planificación

El Arquitecto (Líder)

Recibe tu necesidad, revisa la estructura existente y diseña el plano técnico paso a paso antes de tocar cualquier archivo.

Regla de Oro: Planifica y diseña, pero NUNCA escribe código.
Fase 2: Ejecución

El Obrero (Implementador)

Toma el plano técnico del Arquitecto y se pone a programar realizando únicamente las modificaciones autorizadas.

Regla de Oro: Construye el código, pero NUNCA aprueba su trabajo.
Fase 3: Auditoría

El Inspector (Revisor)

Revisa el trabajo entregado por el Obrero y corre pruebas automáticas para asegurar cero errores en producción.

Regla de Oro: Aprueba o desaprueba, pero NUNCA edita código.
Flujo de Trabajo Roles Multi-Agente
Haz clic para ampliar la imagen

3. Pautas de Pedido e Instrucciones Prácticas

¿Cómo le pides al asistente de IA que trabaje bajo un arnés en la práctica? Sigue estas directrices simples:

✓ Lo que SÍ debes hacer

  • Exigir chequeo inicial: Obliga a la IA a verificar que todo esté sano antes de tocar el proyecto.
  • Definir metas claras: Divide las tareas en pasos sencillos y fáciles de comprobar.
  • Actualizar la bitácora: Exígele que anote sus avances en la memoria al terminar.

✗ Lo que DEBES evitar

  • No saltes los diagnósticos: Si hay un error previo, prohíbe avanzar hasta solucionarlo.
  • No mezcles roles: No le pidas a un solo bot que planifique, ejecute y apruebe a la vez.
  • No dejes tareas huérfanas: Anota siempre cada pendiente para no perder el hilo.
Prompt Maestro Estricto (Con Variables Editables [CAMPOS])
"Actúa estrictamente bajo la metodología de Harness Engineering para el proyecto [NOMBRE_DE_TU_PROYECTO]. REGLAS DE ACERO OBLIGATORIAS: 1. CHEQUEO MÉDICO INICIAL (INIT): • Antes de escribir o modificar código, ejecuta el script de inicio [TU_SCRIPT_DE_INIT] (ej: bash init.sh / python init.py). • Verifica que las dependencias de [TU_STACK_TECNOLOGICO] y las variables de entorno estén sanas. • SI EL CHEQUEO FALLA: Detén el avance de inmediato. Prohibido escribir código comercial hasta solucionar el entorno. 2. MAPA DEL REPOSITORIO (AGENTS.MD): • Consulta el manual AGENTS.md para conocer el mapa de carpetas permitidas y las normas de estilo obligatorias. • Prohibido tocar o modificar archivos fuera del alcance asignado a tu tarea. 3. ORQUESTACIÓN DE ROLES MULTI-AGENTE: • FASE ARQUITECTO: Analiza el requerimiento y desglosa los pasos en task.md. (NUNCA programes en esta fase). • FASE OBRERO: Ejecuta únicamente la tarea asignada en el paso actual de task.md. • FASE INSPECTOR: Corre la suite de pruebas [TUS_COMANDOS_DE_PRUEBA] (ej: npm test / pytest) para auditar tu trabajo antes de darlo por completado. 4. MEMORIA Y PERSISTENCIA (PROGRESS.MD): • Al finalizar la sesión, registra en progress.md los archivos modificados, las pruebas ejecutadas y el estado exacto donde queda el proyecto para la siguiente sesión."
Vista ampliada del diagrama
Haz clic en cualquier lugar fuera de la imagen o presiona la tecla ESC para cerrar