← ClaudeAtlas

bootstrap-repo-harnesslisted

Lay the foundation that makes a repository teach coding agents how to work in it — CLAUDE.md and its subtree files, .claude/ hook wiring, a layered docs/ truth source, scripts/ gates and guards, and a decision record explaining the shape. Use this whenever someone says the agent keeps repeating a mistake, that rules in CLAUDE.md are ignored, that context feels full before they've typed anything, that a new agent or teammate takes too long to get productive, or asks to set up CLAUDE.md / AGENTS.md / hooks / project conventions / onboarding for AI. Also use it when starting a fresh repo that agents will work in, or when auditing an existing one that has grown conventions nobody enforces.
WangChangxin0809/repo-agent-harness · ★ 2 · Data & Documents · score 75
Install: claude install-skill WangChangxin0809/repo-agent-harness
# Bootstrap a repository harness Governs: shared/scripts/scaffold.py, shared/scripts/probe_repo.py, shared/scripts/assess A harness is the machinery that puts the right knowledge in front of an agent at the moment it acts, and stops the actions that are cheaper to prevent than to review. Most repositories have none: they have a `CLAUDE.md` full of rules that are read once, paid every turn, and followed unevenly. **Everything this skill installs must work without it.** The test is literal: install, uninstall the plugin, hand a fresh agent a real task, and the repository must still teach it how to work. Anything that only works while the plugin is present was built in the wrong place. That is independence, not disposal. A harness decays — the standing cost creeps up, a guard stops matching, a document falls behind the code it claims — and a repository cannot notice that about itself. Step 1 is worth re-running months later for exactly that, which is why the assessment is never copied into the tree: it reports on the repository rather than being part of it. ## Two rules everything else follows from **Knowledge lives in the repository, not in agent memory.** Memory is per-machine, invisible to review, and cannot be corrected by a teammate. A fact worth keeping is worth a file with a path someone can cite in a pull request. **What cannot tolerate a miss never goes through retrieval.** Retrieval is best-effort by construction. Rules whose violation is irreversible or silent