Gizele1/harness-init
43 stars · Last commit 2026-04-03
OpenAI harness engineering repo initialization scaffold for agent-first development. Works with Claude Code, Codex, Cursor.
README preview
# harness-init Bootstrap any repository with [OpenAI's harness engineering](https://openai.com/index/harness-engineering/) scaffolding for agent-first development. > **Scope:** This is the **repo initialization subset** of harness engineering. Runtime feedback loops, agent review loops, and observability integration are out of scope. ## What It Does Transforms a repository into an agent-ready environment through 8 phases: | Phase | What | |-------|------| | 0. Discovery | Detect stack, map architecture, identify layers, inject dynamic context | | 1. AGENTS.md | ~100-line orientation map (index, not encyclopedia) | | 2. docs/ | System of record: `architecture/LAYERS.md` + `golden-principles/` + `SECURITY.md` + `guides/` | | 3. Testing | Architecture boundary test with ratchet mechanism | | 4. Linting | Import restriction rules with remediation in error messages | | 5. CI | Parallel lint + typecheck + test + build pipeline | | 6. GC | Garbage collection scripts + scheduled weekly scan | | 7. Hooks | Pre-commit enforcement |