Harness Engineering Playbook

Scaffolds AGENTS.md, harness scripts en CI zodat agents repo's betrouwbaar uitvoeren

Door broomva · broomva/harness-engineering

Getest · Werkt ★ 9.2/10

Harness Engineering Playbook — Scaffolds AGENTS.md, harness scripts en CI zodat agents repo's betrouwbaar uitvoeren

Wat het doet

Implementeert OpenAI's Harness Engineering praktijken door een repo te scaffolden met AGENTS.md, PLANS.md, deterministische smoke/test/lint/typecheck scripts, een Makefile.harness, architectuur- en observeerbaarheidsdocumenten, en een CI-workflow, en deze vervolgens te auditen. Activeert bij het opzetten van agent-first workflows, het toevoegen van harness-commando's, of het versterken van een repo voor betrouwbare autonome agent-runs.

Testrapport

Voerde de gebundelde wizard live uit (python3 harness_wizard.py init --profile control) tegen een verse repo: het scaffoldde 17 bestanden, waaronder AGENTS.md, PLANS.md, Makefile.harness en taal-auto-detecterende smoke/test/lint/typecheck scripts, en het gekoppelde audit-commando slaagde vervolgens groen. De gegenereerde smoke.sh vertakt echt op Cargo/npm/pytest aanwezigheid. Dat is een complete, afgeschermde harness die een no-skill baseline alleen ad hoc zou benaderen.

Getest op: 2026-07-20 · Claude Code 2.x (agent harness)

Installatie

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

Commando's en voorbeeldprompts

  • /harness-engineering-playbookScaffolds AGENTS.md, harness scripts en CI zodat agents repo's betrouwbaar uitvoeren

Skills reageren op gewone verzoeken — geen commando's om te onthouden. Na installatie activeren prompts zoals deze de skill (in het Engels):

  • 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