Rename CLAUDE.md to AGENTS.md - #86
Merged
Merged
Conversation
AGENTS.md is the vendor-neutral convention for agent instructions — an open spec stewarded by the Linux Foundation's Agentic AI Foundation, read directly by Cursor, Copilot, Codex and others. The content here was already tool-neutral, so the rename costs nothing and keeps the file useful if anyone adopts a different agent. Claude Code reads CLAUDE.md rather than AGENTS.md, so a one-line CLAUDE.md imports it. A symlink is the documented alternative but needs Administrator privileges or Developer Mode on Windows, which rules it out for this team. Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
marknolan
requested review from
JongChern,
MAzalya,
dmariapan-shimmer,
harithjamadi and
jyong15
as code owners
September 15, 2026 11:13
![claude[bot]](https://avatars.githubusercontent.com/in/1236702?s=60&v=4){kind=small}
There was a problem hiding this comment.
Claude Code Review
This repository is configured for manual code reviews. Comment @claude review for a one-time review, or @claude review always to subscribe this PR to a review on every future push.
Tip: disable this comment in your organization's Code Review settings.
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
1 participant
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
Moves this repo's agent instructions to
AGENTS.md, the vendor-neutral convention, and leaves aone-line
CLAUDE.mdthat imports it.Why bother.
AGENTS.mdis an open spec — formalised in August 2025 and now stewarded by theLinux Foundation's Agentic AI Foundation — read directly by Cursor, Copilot, Codex and around twenty
other tools. Our content was already tool-neutral (build commands, constraints, gotchas), so this is
a rename, not a rewrite. Nothing about what the file says has changed.
Why the bridge file. Claude Code reads
CLAUDE.mdand notAGENTS.md(docs), so
CLAUDE.mdis now just@AGENTS.mdplus amaintainer comment. The comment is an HTML block comment, which Claude Code strips before loading, so
it costs nothing in context but explains the arrangement to whoever opens the file next.
A symlink is the documented alternative and would be tidier — but creating one on Windows requires
Administrator privileges or Developer Mode, so the import is the portable choice for this team.
If you adopt another agent later, it reads
AGENTS.mdwith no further work, and there is onlyone file to keep current.
🤖 Generated with Claude Code