Harness engineering
Harness Engineering playbook — deterministic smoke/test/lint harness commands, strict architecture boundaries, entropy-control checks for autonomous agent workflows.
npx -y skills add broomva/harness-engineeringAssembled from the repository path, not quoted from the project. Check it against their README if it does not work.
What its author says it does
Copied from the file, not written here
Implement OpenAI Harness Engineering practices in any repository — AGENTS.md, PLANS.md, deterministic smoke/test/lint harness commands, strict architecture boundaries, observability from day 1, and entropy-control audits for reliable autonomous agent runs.
SKILL.md
2.3 KB, as published. Nobody here has run it
Harness Engineering Playbook
A skills.sh-compatible skill that operationalizes the practices from OpenAI's Harness Engineering guide. Use it to set up or refactor agent-first workflows so that autonomous runs are repeatable, observable, and safe.
Install
npx skills add broomva/harness-engineering-skill --skill harness-engineering-playbook
What It Does
- Bootstraps harness artifacts:
AGENTS.md,PLANS.md,docs/ARCHITECTURE.md,docs/OBSERVABILITY.md,Makefile.harness, and CI workflows. - Wraps deterministic commands behind
make smoke,make check,make ciso agents can run them reliably. - Enforces strict module boundaries and data-shape contracts.
- Wires structured observability (correlation IDs, key transitions) from day 1.
- Adds entropy-control audits and nightly harness checks to prevent docs drift and flaky scripts.
Workflow
- Baseline the target repo — detect language, toolchain, and existing CI.
- Bootstrap harness artifacts from templates (interactive wizard or shell script).
- Apply the nine Harness Engineering practices across repo artifacts.
- Validate with
audit— treat anyMISSINGorFAILas blocking. - Iterate after real agent runs — patch gaps and re-audit.
Quick Start
# Interactive wizard (recommended)
python3 .agents/skills/harness-engineering-playbook/scripts/harness_wizard.py init <repo-path> --profile control
# Shell fallback
./scripts/bootstrap_harness.sh <repo-path>
# Audit
python3 .agents/skills/harness-engineering-playbook/scripts/harness_wizard.py audit <repo-path>
Profiles
| Profile | Scope |
|---|---|
baseline | Core harness artifacts only |
control | Baseline + control-system primitives |
full | Control + entropy controls, nightly audit, CI |
Source
OpenAI Harness Engineering guide: https://openai.com/index/harness-engineering/
License
MIT