{"id":5105,"date":"2026-09-21T15:25:14","date_gmt":"2026-09-21T15:25:14","guid":{"rendered":"https:\/\/rssfeedtelegrambot.bnaya.co.il\/index.php\/2026\/09\/21\/claude-code-adds-agents-md-fallback-cutting-instruction-file-sprawl\/"},"modified":"2026-09-21T15:25:14","modified_gmt":"2026-09-21T15:25:14","slug":"claude-code-adds-agents-md-fallback-cutting-instruction-file-sprawl","status":"publish","type":"post","link":"https:\/\/rssfeedtelegrambot.bnaya.co.il\/index.php\/2026\/09\/21\/claude-code-adds-agents-md-fallback-cutting-instruction-file-sprawl\/","title":{"rendered":"Claude Code Adds AGENTS.md Fallback, Cutting Instruction File Sprawl"},"content":{"rendered":"
\"\"<\/div>\n

\"\"<\/p>\n

Open a repository that several developers touch, and you may find more than one instruction file. CLAUDE.md for Claude Code. AGENTS.md for Codex, Cursor, and others. They start as copies. Then they drift. Then an agent follows a build command that stopped working a month ago.<\/span><\/p>\n

Many teams patched this with a symlink. It works. It\u2019s also one more thing to maintain.<\/span><\/p>\n

On September 18, Anthropic shipped Claude Code 2.1.277, and it changes the picture. Thariq Shihipar of the Claude Code team announced it this way: \u201cWe\u2019re adding support for AGENTS.md to Claude Code. Starting today in version 2.1.277, if there is no CLAUDE.md in a folder, Claude will check for and use AGENTS.md.\u201d<\/span><\/p>\n

Whose spec is it, anyway? The headlines call it OpenAI\u2019s, and that\u2019s true of its origin. But OpenAI contributed AGENTS.md to the Agentic AI Foundation, part of the Linux Foundation, when it launched in December 2025. Anthropic contributed the Model Context Protocol to the same foundation. Both companies are founding platinum members. The AGENTS.md site says more than 60,000 open-source projects use the format and lists more than 30 compatible tools. So this looks less like one vendor bowing to another. It\u2019s a shared standard reaching a tool many teams use every day.<\/span><\/p>\n

Mitch Ashley, vice president and practice lead for CIO & technology buyers and software lifecycle engineering at The Futurum Group<\/a>, says that\u2019s the point. \u201cFor most enterprises, running several coding agents at once is now the permanent state, so convergence on one instruction format matters more than which vendor adopted it.\u201d<\/span><\/p>\n

Here\u2019s what the behavior looks like in practice, based on Anthropic\u2019s documentation. By default, Claude Code reads AGENTS.md only when there\u2019s no CLAUDE.md in the working directory or any directory above it. If both files exist, Claude reads CLAUDE.md and ignores AGENTS.md. If a CLAUDE.md already imports AGENTS.md, Claude loads it through the import.<\/span><\/p>\n

The \u201cProject instructions\u201d setting in \/config has four values. The default is claude-md-or-agents-md. There\u2019s also claude-md-and-agents-md, which loads both, CLAUDE.md first. Then claude-md, which ignores AGENTS.md entirely, and managed-only, which loads only the organization\u2019s managed CLAUDE.md and auto memory.<\/span><\/p>\n

Monorepos get sensible treatment. When Claude opens a file in a subdirectory with the Read tool, it picks up that folder\u2019s AGENTS.md too, as long as the folder has no CLAUDE.md of its own. That matches the AGENTS.md convention of placing a file in each package, with the nearest one taking precedence.<\/span><\/p>\n

Now the caveats. DevOps teams will want to read these before they delete any symlinks.<\/span><\/p>\n

First, CLAUDE.local.md counts as a CLAUDE.md. A developer who adds one for personal preferences will stop Claude from reading the team\u2019s AGENTS.md. The documented fix is the claude-md-and-agents-md setting.<\/span><\/p>\n

Second, support is narrower than the file name suggests. Claude does not read AGENTS.local.md, AGENTS.override.md, or anything under a .agents\/ directory. Teams that keep skills there will need another route.<\/span><\/p>\n

Third, availability. The changelog says the feature isn\u2019t on Bedrock, Vertex or Foundry yet. The documentation adds more conditions. Sessions that don\u2019t fetch feature flags from Anthropic can\u2019t read AGENTS.md, which includes sessions with telemetry disabled. The first session after an install or upgrade doesn\u2019t read it either. In those cases, the docs say to import AGENTS.md from a CLAUDE.md instead. Teams that install Claude Code fresh on ephemeral CI runners should test this before they rely on it.<\/span><\/p>\n

Fourth, visibility. An AGENTS.md loaded through the setting doesn\u2019t appear in \/memory or in the memory files list in \/context. InstructionsLoaded hooks don\u2019t fire for it either. They do fire for an AGENTS.md that a CLAUDE.md imports or symlinks to. If your governance tooling watches those hooks, that difference matters.<\/span><\/p>\n

None of this is a reason to hold off. It\u2019s a reason to check your setup once.<\/span><\/p>\n

The larger point is about what these files are. An instruction file tells an autonomous agent which commands to run, which to avoid, and how your team builds software. That\u2019s configuration, and Ashley sees a gap in how it\u2019s handled. \u201cThese files are the first governance artifact a team has for agent behavior, and they sit outside the review path that already covers pipeline configuration.\u201d<\/span><\/p>\n

Three drifting copies widen that gap. One shared file gives reviewers one place to look. Ashley is specific about who should be looking. \u201cGive them an owner in platform engineering.\u201d<\/span><\/p>\n

If you run more than one coding agent, a short checklist will do. Count the instruction files in your repositories. Pick AGENTS.md as the source of truth. Look for CLAUDE.local.md files that could hide it. Then confirm it loads on the platform you actually use, whether that\u2019s the CLI, a CI runner, or a cloud provider.<\/span><\/p>\n

Ashley adds one caution about what a shared file can\u2019t do. \u201cThe harder interoperability problem is agent context and orchestration across vendors, and no shared file fixes that one.\u201d<\/span><\/p>\n

Anthropic didn\u2019t invent this fix. It adopted one that a lot of other tools already use. For teams that maintain these files, that\u2019s the useful part.<\/span><\/p>\n

Read More<\/a><\/p>\n

\u200b<\/p>","protected":false},"excerpt":{"rendered":"

Open a repository that several developers touch, and you may find more than one instruction file. CLAUDE.md for Claude Code. […]<\/p>\n","protected":false},"author":1,"featured_media":5106,"comment_status":"","ping_status":"","sticky":false,"template":"","format":"standard","meta":{"site-sidebar-layout":"default","site-content-layout":"","ast-site-content-layout":"default","site-content-style":"default","site-sidebar-style":"default","ast-global-header-display":"","ast-banner-title-visibility":"","ast-main-header-display":"","ast-hfb-above-header-display":"","ast-hfb-below-header-display":"","ast-hfb-mobile-header-display":"","site-post-title":"","ast-breadcrumbs-content":"","ast-featured-img":"","footer-sml-layout":"","ast-disable-related-posts":"","theme-transparent-header-meta":"","adv-header-id-meta":"","stick-header-meta":"","header-above-stick-meta":"","header-main-stick-meta":"","header-below-stick-meta":"","astra-migrate-meta-layouts":"default","ast-page-background-enabled":"default","ast-page-background-meta":{"desktop":{"background-color":"var(--ast-global-color-4)","background-image":"","background-repeat":"repeat","background-position":"center center","background-size":"auto","background-attachment":"scroll","background-type":"","background-media":"","overlay-type":"","overlay-color":"","overlay-opacity":"","overlay-gradient":""},"tablet":{"background-color":"","background-image":"","background-repeat":"repeat","background-position":"center center","background-size":"auto","background-attachment":"scroll","background-type":"","background-media":"","overlay-type":"","overlay-color":"","overlay-opacity":"","overlay-gradient":""},"mobile":{"background-color":"","background-image":"","background-repeat":"repeat","background-position":"center center","background-size":"auto","background-attachment":"scroll","background-type":"","background-media":"","overlay-type":"","overlay-color":"","overlay-opacity":"","overlay-gradient":""}},"ast-content-background-meta":{"desktop":{"background-color":"var(--ast-global-color-5)","background-image":"","background-repeat":"repeat","background-position":"center center","background-size":"auto","background-attachment":"scroll","background-type":"","background-media":"","overlay-type":"","overlay-color":"","overlay-opacity":"","overlay-gradient":""},"tablet":{"background-color":"var(--ast-global-color-5)","background-image":"","background-repeat":"repeat","background-position":"center center","background-size":"auto","background-attachment":"scroll","background-type":"","background-media":"","overlay-type":"","overlay-color":"","overlay-opacity":"","overlay-gradient":""},"mobile":{"background-color":"var(--ast-global-color-5)","background-image":"","background-repeat":"repeat","background-position":"center center","background-size":"auto","background-attachment":"scroll","background-type":"","background-media":"","overlay-type":"","overlay-color":"","overlay-opacity":"","overlay-gradient":""}},"footnotes":""},"categories":[5],"tags":[],"class_list":["post-5105","post","type-post","status-publish","format-standard","has-post-thumbnail","hentry","category-devops"],"_links":{"self":[{"href":"https:\/\/rssfeedtelegrambot.bnaya.co.il\/index.php\/wp-json\/wp\/v2\/posts\/5105","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/rssfeedtelegrambot.bnaya.co.il\/index.php\/wp-json\/wp\/v2\/posts"}],"about":[{"href":"https:\/\/rssfeedtelegrambot.bnaya.co.il\/index.php\/wp-json\/wp\/v2\/types\/post"}],"author":[{"embeddable":true,"href":"https:\/\/rssfeedtelegrambot.bnaya.co.il\/index.php\/wp-json\/wp\/v2\/users\/1"}],"replies":[{"embeddable":true,"href":"https:\/\/rssfeedtelegrambot.bnaya.co.il\/index.php\/wp-json\/wp\/v2\/comments?post=5105"}],"version-history":[{"count":0,"href":"https:\/\/rssfeedtelegrambot.bnaya.co.il\/index.php\/wp-json\/wp\/v2\/posts\/5105\/revisions"}],"wp:featuredmedia":[{"embeddable":true,"href":"https:\/\/rssfeedtelegrambot.bnaya.co.il\/index.php\/wp-json\/wp\/v2\/media\/5106"}],"wp:attachment":[{"href":"https:\/\/rssfeedtelegrambot.bnaya.co.il\/index.php\/wp-json\/wp\/v2\/media?parent=5105"}],"wp:term":[{"taxonomy":"category","embeddable":true,"href":"https:\/\/rssfeedtelegrambot.bnaya.co.il\/index.php\/wp-json\/wp\/v2\/categories?post=5105"},{"taxonomy":"post_tag","embeddable":true,"href":"https:\/\/rssfeedtelegrambot.bnaya.co.il\/index.php\/wp-json\/wp\/v2\/tags?post=5105"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}