Anthropic‘s Claude Code tool has introduced support for AGENTS.md files starting with version 2.1.277. This update allows the terminal-based coding assistant to recognize and follow instructions contained within an AGENTS.md file if the standard CLAUDE.md file is absent in a project directory. Thariq Shihipar announced the change, noting that this functionality is implemented as a built-in mod. As reported by Simon Willison, this development represents a shift toward more flexible project-level configurations for the command-line assistant.
Modular Customization for Coding Agents
The introduction of AGENTS.md support is part of a broader infrastructure update involving Claude Code mods. These mods are intended to be a framework for customizing how the Claude Code harness operates. While the current implementation for AGENTS.md is a built-in mod, the development roadmap includes allowing users to create their own custom versions of project instructions. This move suggests a more modular approach to AI-assisted development, where the behavior of the coding agent can be tailored through external configuration files or community-shared modifications. By moving toward a mod-based system, the tool may become more adaptable to various tech stacks and developer workflows.
Remaining Technical Uncertainties
Several details regarding the implementation remain unspecified. The announcement did not specify the exact syntax or formatting requirements for AGENTS.md compared to the existing CLAUDE.md format. It is also unclear when the full mods feature will be released to the general public or what the specific technical limitations of these custom instructions might be. Additionally, the announcement did not clarify if multiple mods can be active simultaneously or how the system would resolve conflicts between different instruction files beyond the stated fallback logic. The timeline for documentation on building custom project instructions was also not provided.
Developers can currently inspect the source code for this mod to understand how the integration works. As version 2.1.277 rolls out, the focus shifts toward how the community will leverage these upcoming customization tools.
Lead image: Rafael Minguet Delgado / Pexels
