Pinguy Learning
Temario · lección 65 de 74
0Empieza aquí
1Por qué fallan los agentes
2Qué es un harness
3Patrones de agentes
4Herramientas
5Ingeniería de contexto
6El repositorio como memoria
7Tareas largas
8Alcance y “hecho” de verdad
9Observabilidad y estado limpio
10Loops y grafos
11Harness reales
12Proyecto final
Harness reales· 6 min de lectura

Comparativa de harness reales

En 30 segundos

Cuatro harness, cuatro apuestas distintas sobre dónde poner la responsabilidad. Esta lección las junta en una tabla para que sepas qué copiar en tu propio entorno.

Cuatro coches, un mismo motor

Un utilitario, un todoterreno, una moto y un kit de montaje llegan a la misma ciudad por caminos distintos. Los cuatro harness del módulo hacen lo mismo (bucle de modelo y herramientas) pero deciden de forma muy diferente quién se encarga de qué. Entender esas decisiones te sirve más que memorizar productos, porque los productos cambiarán.

La apuesta de cada uno

  • Claude Code suma: memoria por capas, permisos, hooks y subagentes vienen integrados en el núcleo.
  • Codex resta: núcleo contenido y peso en convenciones del repo (AGENTS.md índice, worktrees, comandos de verificación).
  • Pi delega: núcleo mínimo y todo es extensión programable.
  • DeepSeek Harness generaliza: el harness es un sistema operativo y hasta el bucle es un plugin.

Tabla de decisiones de diseño

DecisiónClaude CodeCodexPiDeepSeek Harness
InstruccionesCLAUDE.md por capas + auto memoryAGENTS.md índice (~100 líneas) + docs/AGENTS.md jerárquico + SYSTEM.mdReglas como plugins
Contexto largoCompactación en cinco niveles, resume/forkCompactación + escribir estado en archivosCompactación programable, contexto dinámicoLog de sesión que solo añade
HerramientasSkills, MCP, hooks, subagentesNúcleo contenido, subagentesSkills + extensiones TypeScriptCapability seams (interfaz, proveedor, consumidor)
LímitesSiete modos de permisos + clasificadorWorktree por tarea, políticas de aprobaciónPuertas de permisos en extensionesGuardas en el evento previo a ejecutar
VerificaciónHooks PostToolUse y StopComandos de verificación en el repoLos define el usuarioOyentes sobre eventos
Estado entre sesionesHistorial append-only, /resumeConvenciones del repoÁrbol de sesiones, PROGRESS.mdLog append-only reconstruible
Coste de entradaBajo: funciona de serieMedio: depende de tu disciplinaAlto: construyes piezasAlto: vista previa y configuración

Lo que se repite en los cuatro

Aunque difieran, comparten patrones que son los del curso:

  1. Instrucciones cortas y cargadas bajo demanda, no un archivo gigante.
  2. Contexto tratado como recurso finito: compactar, aislar con subagentes, escribir fuera de la ventana.
  3. Límites impuestos por el programa, no pedidos en el prompt.
  4. Verificación determinista (hooks, comandos, eventos) en lugar de fiarse de la opinión del modelo.
  5. Historial que se puede reproducir, casi siempre añadiendo líneas, para retomar y depurar.

También Microsoft Agent Framework propone un harness compuesto por piezas (cliente de chat, canalización, proveedores de contexto, middleware) con funciones activables y desactivables. Lo verás en arquitectura por capas; encaja en la misma idea de componer en lugar de fijar.

Cómo elegir (o cómo diseñar el tuyo)

  • ¿Quieres que funcione hoy sin montar nada? Un harness con todo integrado.
  • ¿Tu equipo ya es disciplinado con documentación y CI? Uno basado en convenciones del repo te rinde mucho.
  • ¿Necesitas reglas propias y control fino? Uno extensible, asumiendo el trabajo.
Comprueba lo aprendido

¿Qué patrón comparten los cuatro harness analizados?

Cambia la forma (hooks, worktrees, extensiones, eventos), pero todos sacan las garantías del prompt y las llevan al programa.

Fuentes: Learn Harness Engineering, harness-designs (claude-code, codex, pi, deepseek) · Microsoft, Arnés de agente (sources/web/microsoft.md)