chore: add CLAUDE.md bridge so Claude Code loads AGENTS.md#9
Merged
Conversation
Claude Code reads CLAUDE.md, not AGENTS.md. Add a one-line CLAUDE.md (@AGENTS.md import) so the existing agent guide loads, and document the bridge in the AGENTS.md template so repos adopting the template add the same file. Other agent tools keep reading AGENTS.md directly.
Contributor
There was a problem hiding this comment.
Pull request overview
Adds a minimal bridge file so Claude Code loads this repository’s existing agent guidance (kept in AGENTS.md), and documents that convention in the template.
Changes:
- Add
CLAUDE.mdcontaining only@AGENTS.mdso Claude Code imports the guide. - Document the
CLAUDE.mdbridge requirement inAGENTS.md(template guidance + org-defaults file list update).
Reviewed changes
Copilot reviewed 2 out of 2 changed files in this pull request and generated no comments.
| File | Description |
|---|---|
| CLAUDE.md | Adds a one-line import so Claude Code loads AGENTS.md. |
| AGENTS.md | Documents the CLAUDE.md bridge and lists it among org-default files. |
💡 Add Copilot custom instructions for smarter, more guided reviews. Learn how to get started.
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 subscribe to this conversation on GitHub.
Already have an account?
Sign in.
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.
Proposed Changes
Add a one-line
CLAUDE.mdwhose only content is@AGENTS.md, so Claude Code (which readsCLAUDE.md, notAGENTS.md) picks up the existing agent guide. Also document the bridge in theAGENTS.mdtemplate: a standing instruction for anyone adapting the template, plus a bullet in the org-defaults file list noting the new file.Resolves
Not a bug fix; no associated issue. This is a small tooling and documentation change.
Reason for Changes
Claude Code only loads
CLAUDE.md. Repos that keep their guidance inAGENTS.mdare therefore invisible to it, which matters most when working from a parent directory that holds several repos and the per-repo guide should load on demand.I verified against the current Claude Code (2.1.158) that
AGENTS.mdis not read natively, and that aCLAUDE.mdcontaining@AGENTS.mddoes load the imported content, including when the file sits in a subdirectory that loads on demand. A plain import file is used rather than a symlink, because a committed symlink does not survive Windows checkouts. Other agent tools keep readingAGENTS.mddirectly, so no content is duplicated.Test Coverage
This repository has no build step or test suite (prose and Markdown only). Verified manually with the installed Claude Code: a
CLAUDE.mdwhose only content is@AGENTS.mdloads theAGENTS.mdcontent, while a directory containing onlyAGENTS.mddoes not load it.