{"version":"2.1.274","anchor":"new-built-in-agentsmd-plugin-off-by-default","canonical_anchor":"new-built-in-agentsmd-plugin-off-by-default","heading":"New built-in AGENTS.md plugin (off by default)","tier":"soon","area":"Project Instructions","scope":null,"heads_up":null,"url":"https:\/\/changelogs.core-directive.com\/v\/2.1.274\/e\/new-built-in-agentsmd-plugin-off-by-default","release_url":"https:\/\/changelogs.core-directive.com\/v\/2.1.274","markdown":"### New built-in AGENTS.md plugin (off by default)\n\nA new built-in agents-md plugin can load AGENTS.md as project instructions instead of, or alongside, CLAUDE.md\n\n**Unclear.** Whether this plugin is active for any given account is unknown, since nothing has been read yet about the `tengu_agents_md_mod` gate.\n\n**What**\n\nA 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:\n\n- `claude` (the default): use `CLAUDE.md` only\n\n- `agents-fallback`: fall back to `AGENTS.md` when there's no `CLAUDE.md`\n\n- `both`: use both files\n\n- `none`: use neither\n\nWhen 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.\n\n**Why**\n\nThis gives projects that already use the `AGENTS.md` convention a way to have Claude Code pick it up as project instructions.\n\n- Flag `tengu_agents_md_mod`: Not enough to say (read for one account on one subscription tier against v2.1.274; this account: no value returned, anonymous baseline: no value returned, compiled default: 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.\n- Area: Project Instructions\n- Names: `AGENTS.md`, `projectInstructions`\n- Tier: Nothing to try yet\n- Useful: 4\/5\n- Signal: 4\/5\n- Present in the build but not switched on"}