Follow Discord
Sweep 22 Sep 2026 · 17:19Z Build v2.1.280 501 read Stable v2.1.267 Latest v2.1.280 Next v2.1.280 Feeds RSS JSON llms.txt Unofficial
Claude Code v2.1.274 ·

New built-in AGENTS.md plugin (off by default)

A new built-in agents-md plugin can load AGENTS.md as project instructions instead of, or alongside, CLAUDE.md

TierNothing to try yethow much it should matter to you
Useful4my rating, 1 to 5
Signal4worth watching, 1 to 5
AreaProject Instructionswhat it touches
KindIn Developmentin v2.1.274,
Nothing to try yet Notable

A new built-in agents-md plugin can load AGENTS.md as project instructions instead of, or alongside, CLAUDE.md

What

A new bundled plugin called "agents-md" can load an AGENTS.md file as project instructions instead of, or together with, CLAUDE.md. This is controlled by a projectInstructions user config option with four values:

  • claude (the default): use CLAUDE.md only
  • agents-fallback: fall back to AGENTS.md when there's no CLAUDE.md
  • both: use both files
  • none: use neither

When a project has an AGENTS.md but no CLAUDE.md and the setting is left at claude, Claude Code shows a one-time toast suggesting the user switch the setting to agents-fallback to load it.

Why

This gives projects that already use the AGENTS.md convention a way to have Claude Code pick it up as project instructions.

Read from
Names in the bundleAGENTS.mdprojectInstructions
Feature flag
tengu_agents_md_mod Not enough to say

Nothing here resolved what this flag was doing on this version, so nothing here should be read as on or off.

This account: no value returned · anonymous baseline: no value returned · compiled default in v2.1.274: off

These values were read against a different version of Claude Code, so treat them as the nearest reading available instead of one taken on this release.

Read once, for one account on one subscription tier, against v2.1.274. It isn't a statement about your account. What a flag value here can and cannot tell you

Since it was published

The entry above is what we published on the day. These lines were added later, as Anthropic's own pages caught up, and they sit beside the original rather than replacing it.

Added since A small documentation edit on Explore the context window touched a line naming AGENTS.md after this was published. * **Before you type anything**: CLAUDE.md, auto memory, MCP tool names, and skill descriptions all load into context. [AGENTS.md files](/docs/en/memory#agents-md) can load too, on their own or alongside CLAUDE.md. Your own setup may add mo… context-window see the edit
Confirmed since Anthropic's documentation has since written up AGENTS.md, on Claude Code changelog. * Added AGENTS.md support: in a project with no CLAUDE.md, Claude Code reads AGENTS.md instead; change it under "Project instructions" in `/config` (not yet on Bedrock, Vertex or Foundry) changelog see the edit
What has happened since
Flag reading moved The flag server now returns on for tengu_agents_md_mod, read as this account. A reading is one sample. Claude Code evaluates its flags remotely, so no client sees the targeting rule behind a value and this says nothing about your account.
Flag reading moved The flag server now returns off for tengu_agents_md_mod, read as this account. A reading is one sample. Claude Code evaluates its flags remotely, so no client sees the targeting rule behind a value and this says nothing about your account.
Flag reading moved The flag server now returns on for tengu_agents_md_mod, read as this account. A reading is one sample. Claude Code evaluates its flags remotely, so no client sees the targeting rule behind a value and this says nothing about your account.
Flag reading moved The flag server now returns off for tengu_agents_md_mod, read as this account. A reading is one sample. Claude Code evaluates its flags remotely, so no client sees the targeting rule behind a value and this says nothing about your account.
Flag reading moved The flag server now returns on for tengu_agents_md_mod, read as this account. A reading is one sample. Claude Code evaluates its flags remotely, so no client sees the targeting rule behind a value and this says nothing about your account.

See this across every release →

How sure we are
Something disagreesSomething we can check disagrees with this entry, or the writer said they could not settle it.
The writer flagged doubtWhether this plugin is active for any given account is unknown, since nothing has been read yet about the `tengu_agents_md_mod` gate.
Anthropic's documentation agreesAnthropic's documentation has since written up AGENTS.md, on Claude Code changelog.

See this entry in the whole of v2.1.274 →

Feedback