repository-harness

Why we included this project

Coding agents like Claude Code, Codex, and Cursor tend to flounder on real repositories when the intent behind a change lives only in chat and nothing in the repo points to the authoritative documents. This project installs a small protocol that makes a codebase legible to those agents: a compact AGENTS.md entrypoint, a navigable documentation map, durable plans only when a change actually spans sessions, and explicit judgment boundaries so an agent stops before inventing product policy. It stays out of the way for typo-level fixes but forces structure for long or ambiguous work, and its safe updater three-way merges managed files and stages conflicts rather than clobbering local edits. Teams that want consistent agent behavior across many repos will appreciate the install script and versioned harness binary, and the explicit-only onboarding and invariant skills keep control over when agents act.