Harness Maturity Model
Twelve checks, four layers. A layer scores two points when all three checks hold, one when at least one does, zero otherwise. Eight is the maximum. The layer with the lowest score is the one to install first. The harness audit runs this rubric in two minutes.
01 Knowledge
What the agent knows about your team
- Your repos have agent-readable context files (CLAUDE.md / rules) capturing conventions and the why — not just code
- That knowledge is committed and shared, not living on one engineer’s laptop
- Someone owns keeping it current
What good looks like. A shared context file the agent reads every session — conventions, standards, and the why behind them — with a named owner.
02 Capabilities
What the agent can do, on repeat
- Your team has packaged, reusable workflows — skills, plugins, or slash commands — beyond ad-hoc prompting
- Those workflows are shared across the team, not stuck in one person’s setup
- Someone owns the library: versioning, updates, retiring dead ones
What good looks like. A shared, versioned library of skills the whole team runs — treated as org infrastructure, not personal productivity.
03 Connectivity
What the agent can touch
- Your agents connect to real systems — cloud, databases, browser, repos — not just chat
- They connect through dedicated scoped service accounts, never engineers’ personal accounts
- Those accounts are least-privilege: read-only by default, destructive actions gated
What good looks like. Agents wired to your systems through scoped, read-only-by-default service accounts, so the blast radius of a mistake stays small.
04 Governance
What the agent can’t do without permission
- An allowlist lets safe, routine commands run without a human approving each one
- Destructive operations are blocked or gated by hooks before they execute
- You have a defined response for when an agent does something it shouldn’t
What good looks like. An allowlist for safe commands plus hooks blocking destructive ones — what makes auto-mode fast and safe instead of reckless.
Score bands
| Score | Reading |
|---|---|
| 0 to 2 | You’re paying for tools, not leverage. |
| 3 to 5 | A partial harness — and real gaps. |
| 6 to 8 | A strong harness. Now tighten the edges. |