Files
hmbown--codewhale/CLAUDE.md
Hmbown 9771c00a67 docs: trim root AGENTS.md to durable rules, import it from CLAUDE.md
AGENTS.md 215 -> 92 lines. The extracted sections now live in
docs/ENVIRONMENTS.md, docs/RELEASE_QUEUE.md, and docs/ops/CURRENT.md, linked
from the sections that replaced them. "Intent is the artifact" keeps its
operative rules and its four limits but sheds the passage arguing its own case,
which docs/AGENT_ETHOS.md already carries at length.

Kept inline, deliberately: the do-not-delete guardrail (agents repeatedly
misflag those modules as dead code and break the build), the removed-machinery
surface list, and the CI-enforced Co-authored-by rules.

CLAUDE.md 86 -> 9 lines. It restated most of AGENTS.md in slightly different
words, so every edit to one silently drifted the other. It now uses a Claude
Code @-import, which inlines AGENTS.md at load time -- same content, one source.
Chose the import over a symlink so Windows checkouts, where symlinks can
materialize as a text file containing the path, still resolve it.
2026-08-02 16:56:27 -07:00

300 B

Claude Repository Guidance

The full contract is AGENTS.md, imported here so it loads automatically:

@AGENTS.md

Nothing else belongs in this file. Rules added here instead of AGENTS.md are invisible to every non-Claude agent working in this repo, and drift silently from the copy that isn't.