hoangnb24/repository-harness

1,138 stars · Last commit 2026-07-26

Turn any repo into an agent-ready workspace for Claude Code, Codex, Cursor, and other coding agents.

README preview

# repository-harness

Turn a software repository into a legible, agent-ready workspace.

`repository-harness` gives coding agents a small entrypoint, structured
repository knowledge, durable execution plans when work truly needs them, and
mechanical validation. The repository—not a hidden workflow database—is the
default system of record.

The app is what users touch. The harness is what makes the app and its rules
easy for agents and humans to understand.

## Why This Exists

Coding agents commonly fail for ordinary engineering reasons:

- important constraints live only in chat or in someone's head;
- the repository does not say which documents are authoritative;
- small changes are wrapped in process that obscures the actual work;
- large changes lose decisions and progress between sessions;

View full repository on GitHub →