How AGENTS.md and CLAUDE.md coexist in Claude Code
11/17/2026 — 11/17, 09:15·1 sources (all)·1 reports (all)
Key takeaways
- A practitioner guide recommends putting cross-tool repository instructions in AGENTS.md, including real test commands, file ownership and se…
- teams keeping CLAUDE.md can import AGENTS.md on a single line and add tool-specific notes only when behavior truly differs.
Background & analysis
On 2026-11-17 at 09:02, the AI channel of DEV Community published a piece titled "How AGENTS.md and CLAUDE.md Can Coexist in Claude Code," laying out a practical approach to running both project instruction files side by side within Claude Code.
The article recommends keeping repository-level instructions that apply to every coding assistant in one place, namely AGENTS.md, including the real test command, file ownership, and any paths that call for extra care. For a monorepo, it advises checking which file each tool loads once work begins inside a subdirectory. It also points readers to OpenAI's project instruction guide and verifies how Claude Code loads instructions today: Claude Code can currently read project instructions straight from AGENTS.md, yet when a CLAUDE.md exists in the working directory or in a parent directory, the default selection gives preference to CLAUDE.md.
If a team decides to stick with CLAUDE.md, the article suggests importing AGENTS.md through a dedicated single line inside that file, and only adding tool-specific notes when a tool genuinely requires different behavior. No further developments beyond this have been reported so far, leaving the guidance as a working convention rather than a settled standard.
AI-generated from 1 reports · updated 3 hours ago
Related AI tools
- Heat index
- 92
- All sources
- 1
- All reports
- 1
- First seen
- 3 hours ago
Reports on this story headlines open the original
Keep repository-wide instructions in AGENTS.md, including the real test command, file ownership and paths that need extra care. Current Claude Code reads project instructions from AGENTS.md but prefers CLAUDE.md when that file exists in the working directory or above it; if you keep CLAUDE.md, import AGENTS.md on its own line and add tool-specific notes only where tools genuinely differ.
DEV Community · AIAI score 55
Other stories people are talking about
- Heat index 89NewDeveloper tries three ways to bootstrap a project's CLAUDE.md1 sources
- Heat index 89NewDeveloper builds a five-step post-generation check pipeline around Claude Code1 sources
- Heat index 92NewDeveloper benchmarks Claude Code plugins across four tech stacks1 sources
- Heat index 46Developers Use PreToolUse Hooks to Stop Claude Code from Overwriting .env1 sources
- Heat index 84NewNadella says Claude Code caught Microsoft off guard as IDEs fade1 sources
How is heat calculated?About the methodHide
Heat counts how many independent sources covered a story in the last 48 hours: one source counts once no matter how many posts it published, decaying with a 24-hour half-life. What ranks first is what many people are talking about.
This page aggregates public feeds. Headlines and summaries are machine-organized and remain the property of the original authors; verify important facts at the source. If you believe a headline or summary infringes your rights, email the contact address in the footer with the page URL and basis of your claim, and we will remove or replace it after review.
- Surge
- Discussion rising fast
- New
- First report within 6 hours
- Rising
- Still gathering discussion

