Sweep 19 Sep 2026 · 02:36Z Build v2.1.278 500 read Stable v2.1.267 Latest v2.1.278 Next v2.1.278 Feeds RSS JSON llms.txt Unofficial
Claude Code v2.1.277 ·

AGENTS.md/CLAUDE.md instruction loading revamped: instructionFiles setting, new modes, plugin file stats

Instruction-file loading was renamed to instructionFiles, gained new modes with AGENTS.md fallback as default, and now reports plugin instruction stats

TierUse it nowhow much it should matter to you
Useful4my rating, 1 to 5
Signal3worth watching, 1 to 5
AreaSettingswhat it touches
KindNew Featuresin v2.1.277,
Group of 7 Use it now Notable

Instruction-file loading was renamed to instructionFiles, gained new modes with AGENTS.md fallback as default, and now reports plugin instruction stats

What

  • The setting is renamed from projectInstructions to instructionFiles; the old name still works as a deprecated alias but logs a one-time warning telling you to migrate.
  • The recognized modes changed from claude, agents-fallback, both, none to claude-md, claude-md-or-agents-md, claude-md-and-agents-md, managed-only.
  • The default mode is now claude-md-or-agents-md, so a project with no CLAUDE.md of its own now automatically gets its AGENTS.md files loaded instead, without needing to turn anything on.
  • New telemetry events (agents_md_load, agents_md_nested) record file count, import count, total content length, and whether the file walk succeeded or failed, tagged by the resolved mode.
  • Project context-loading results now always include a pluginInstructionFiles field (with fileCount and totalContentLength) alongside the existing claudeMd, instructionFiles, and memoryFiles fields.

Why

This clarifies and simplifies how Claude Code decides which project instruction files (CLAUDE.md, AGENTS.md) to load, makes AGENTS.md usable out of the box for projects that don't have their own CLAUDE.md, and gives better visibility into which instruction files, including ones contributed by plugins, actually got loaded.

Read from
Names in the bundleinstructionFilesprojectInstructions
What the documentation says
Documented inclaude-code/memory

See this entry in the whole of v2.1.277 →