Problem
This repository holds AGENTS.md and no CLAUDE.md. Claude Code reads CLAUDE.md and ignores AGENTS.md. An agent that clones this repository directly therefore loads no instructions.
git ls-files | grep -iE 'claude|agents' # prints AGENTS.md only
The gap appears when a contributor works in textrefs/registry on its own. A contributor who works through the data/ submodule of textrefs/textrefs.org is not affected, because the parent repository loads its own bridge file.
Proposed change
- Add
CLAUDE.md at the repository root.
- Give the file the single line
@AGENTS.md.
- Track the file with git.
Do not copy any content from AGENTS.md into CLAUDE.md. AGENTS.md stays the one machine contract, and CLAUDE.md stays the bridge.
Acceptance criteria
Context
This issue is item A2 of textrefs/textrefs.org#125. The matching change for the site repository is textrefs/textrefs.org#141.
🤖 Generated with Claude Code
https://claude.ai/code/session_01NtQMT2WCNxEAEbEbdhVmuX
Problem
This repository holds
AGENTS.mdand noCLAUDE.md. Claude Code readsCLAUDE.mdand ignoresAGENTS.md. An agent that clones this repository directly therefore loads no instructions.The gap appears when a contributor works in
textrefs/registryon its own. A contributor who works through thedata/submodule oftextrefs/textrefs.orgis not affected, because the parent repository loads its own bridge file.Proposed change
CLAUDE.mdat the repository root.@AGENTS.md.Do not copy any content from
AGENTS.mdintoCLAUDE.md.AGENTS.mdstays the one machine contract, andCLAUDE.mdstays the bridge.Acceptance criteria
git ls-files CLAUDE.mdprintsCLAUDE.md.CLAUDE.mdcontains@AGENTS.mdand nothing else.Context
This issue is item A2 of textrefs/textrefs.org#125. The matching change for the site repository is textrefs/textrefs.org#141.
🤖 Generated with Claude Code
https://claude.ai/code/session_01NtQMT2WCNxEAEbEbdhVmuX