Harness Engineering Playbook

Andamia AGENTS.md, scripts de arnés y CI para que los agentes ejecuten repositorios de forma fiable

Por broomva · broomva/harness-engineering

Probado · Funciona ★ 9.2/10

Harness Engineering Playbook — Andamia AGENTS.md, scripts de arnés y CI para que los agentes ejecuten repositorios de forma fiable

Qué hace

Implementa las prácticas de Harness Engineering de OpenAI andamiando un repositorio con AGENTS.md, PLANS.md, scripts deterministas de smoke/test/lint/typecheck, un Makefile.harness, documentos de arquitectura y observabilidad, y un flujo de trabajo de CI, luego auditándolos. Se activa al configurar flujos de trabajo centrados en agentes, añadir comandos de arnés o fortalecer un repositorio para ejecuciones autónomas fiables de agentes.

Informe de la prueba

Ejecuté el asistente incluido en vivo (python3 harness_wizard.py init --profile control) contra un repositorio nuevo: andamió 17 archivos incluyendo AGENTS.md, PLANS.md, Makefile.harness y scripts de smoke/test/lint/typecheck con autodetección de lenguaje, y el comando de auditoría emparejado luego pasó en verde. El smoke.sh generado realmente se ramifica según la presencia de Cargo/npm/pytest. Ese es un arnés completo y controlado que una línea base sin habilidad solo aproximaría ad hoc.

Probado el: 2026-07-20 · Claude Code 2.x (agent harness)

Instalación

git clone https://github.com/broomva/harness-engineering
mkdir -p ~/.claude/skills
cd harness-engineering && cp -r .skills/harness-engineering-playbook ~/.claude/skills/harness-engineering-playbook

Comandos y prompts de ejemplo

  • /harness-engineering-playbookAndamia AGENTS.md, scripts de arnés y CI para que los agentes ejecuten repositorios de forma fiable

Los skills se activan con peticiones en lenguaje natural, sin comandos que memorizar. Tras instalarlo, prompts como estos lo activan (en inglés):

  • Scaffold AGENTS.md and CI so agents can run this repo reliably
  • Set up deterministic smoke and lint scripts for agent workflows
  • Harden this repo for autonomous agent runs with a harness setup