Harness Engineering Playbook

Scaffolds AGENTS.md, script harness e CI in modo che gli agenti eseguano i repository in modo affidabile

di broomva · broomva/harness-engineering

Promosso ★ 9.2/10

Harness Engineering Playbook — Scaffolds AGENTS.md, script harness e CI in modo che gli agenti eseguano i repository in modo affidabile

Cosa fa

Implementa le pratiche di Harness Engineering di OpenAI creando uno scaffold per un repository con AGENTS.md, PLANS.md, script deterministici smoke/test/lint/typecheck, un Makefile.harness, documentazione di architettura e osservabilità e un workflow CI, quindi li verifica. Si attiva quando si configurano workflow agent-first, si aggiungono comandi harness o si rafforza un repository per esecuzioni autonome affidabili degli agenti.

Rapporto di test

Eseguito il wizard incluso in tempo reale (python3 harness_wizard.py init --profile control) contro un nuovo repository: ha creato uno scaffold di 17 file inclusi AGENTS.md, PLANS.md, Makefile.harness e script smoke/test/lint/typecheck con rilevamento automatico del linguaggio, e il comando di audit abbinato ha quindi passato il test (verde). Lo smoke.sh generato si dirama genuinamente sulla presenza di Cargo/npm/pytest. Questo è un harness completo e controllato che una baseline senza skill avrebbe solo approssimato ad hoc.

Testato il: 2026-07-20 · Claude Code 2.x (agent harness)

Installazione

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

Comandi e prompt di esempio

  • /harness-engineering-playbookScaffolds AGENTS.md, script harness e CI in modo che gli agenti eseguano i repository in modo affidabile

Gli skill si attivano con richieste in linguaggio naturale, senza comandi da ricordare. Dopo l'installazione, prompt come questi lo attivano (in inglese):

  • 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