Harness Engineering Playbook

Échafaude AGENTS.md, scripts de harnais et CI pour que les agents exécutent les dépôts de manière fiable

par broomva · broomva/harness-engineering

Testé · Fonctionne ★ 9.2/10

Harness Engineering Playbook — Échafaude AGENTS.md, scripts de harnais et CI pour que les agents exécutent les dépôts de manière fiable

Ce que fait

Implémente les pratiques d'ingénierie de harnais d'OpenAI en échafaudant un dépôt avec AGENTS.md, PLANS.md, des scripts déterministes de smoke/test/lint/typecheck, un Makefile.harness, des documents d'architecture et d'observabilité, et un workflow CI, puis en les auditant. Se déclenche lors de la mise en place de workflows axés sur les agents, de l'ajout de commandes de harnais, ou du renforcement d'un dépôt pour des exécutions d'agents autonomes fiables.

Rapport de test

Exécuté l'assistant fourni en direct (python3 harness_wizard.py init --profile control) sur un nouveau dépôt : il a échafaudé 17 fichiers, y compris AGENTS.md, PLANS.md, Makefile.harness et des scripts de smoke/test/lint/typecheck à détection automatique de langage, et la commande d'audit associée a ensuite passé au vert. Le smoke.sh généré se ramifie réellement en fonction de la présence de Cargo/npm/pytest. C'est un harnais complet et contrôlé qu'une référence sans compétence n'approximerait qu'ad hoc.

Testé le: 2026-07-20 · Claude Code 2.x (agent harness)

Installation

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

Commandes et exemples de prompts

  • /harness-engineering-playbookÉchafaude AGENTS.md, scripts de harnais et CI pour que les agents exécutent les dépôts de manière fiable

Les skills se déclenchent sur des demandes en langage courant — aucune commande à retenir. Après installation, des prompts comme ceux-ci l'activent (en anglais) :

  • 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