← ClaudeAtlas

harness-health-auditlisted

Audit the health of an AI-coding harness — the CLAUDE.md / AGENTS.md files, rules, skills, agents, hooks, and commands that steer an agent in a repository — across four questions a linter cannot answer: is it TRUE (does it match the real code?), is it USED (do skills actually trigger and does the loop actually verify?), is it AFFORDABLE (is it inside the budget where instructions are still followed?), and is it SAFE (is a live, accurate instruction still a good idea — permission bypasses, unpinned remote scripts, untrusted content flowing in as instructions? — safety findings are flagged for the user's decision, never auto-removed). Then surgically correct or remove only what is proven wrong or dead. Use whenever the steering layer may have rotted or may not be working: "하네스 점검해줘", "하네스 드리프트 감사", "CLAUDE.md가 실제랑 맞는지 봐줘", "룰/스킬이 최신인지 확인해줘", "스킬이 제대로 활용되는지 봐줘", "루프 엔지니어링 잘 되고 있는지 검토해줘", "죽은 훅/커맨드 정리해줘", "하네스 안전한지 점검해줘", "audit my harness", "check the rules still match the real stack", "are my skills actually be
uzysjung/uzys-agent-harness · ★ 3 · Code & Development · score 69
Install: claude install-skill uzysjung/uzys-agent-harness
# Harness Health Audit A **harness** is everything that steers an agent but is not the model itself: `CLAUDE.md` / `AGENTS.md` at every level, `.claude/rules/*.md`, skills, subagents, hook wiring, slash commands, and tool/MCP descriptions — plus the `.codex` / `.opencode` equivalents when the repo targets several CLIs. LangChain frames it as `Agent = Model + Harness`, defining the harness as "every piece of code, configuration, and execution logic that isn't the model itself" ([LangChain](https://www.langchain.com/blog/the-anatomy-of-an-agent-harness)); Addy Osmani puts the stakes plainly: "A decent model with a great harness beats a great model with a bad harness" ([Osmani](https://addyosmani.com/blog/agent-harness-engineering/)). Harnesses fail in three different ways, and most audits only catch the first: - **They rot.** The stack migrates, a command is renamed, a plugin disappears upstream, a ceremony is abandoned — but the steering text still asserts the old world. Nothing fails loudly, because the harness is instructions, not code: no test turns red when a rule lies. - **They stop working while still being true.** Every word is accurate, but the skills never trigger, the rules are too long to be followed, and the loop closes on the agent's own say-so instead of a real check. A perfectly accurate harness that nothing obeys is still a broken harness. - **They keep working while being dangerous.** Every instruction is accurate, live, and cheap — and one of the