Claude Code AGENTS.md Guide: Share One Instruction File Across Coding Agents
Claude Code 2.1.277 can now read AGENTS.md when a project does not have a CLAUDE.md . For teams that move between Codex, Cursor, Gemini CLI, and Claude Code, the change can remove a duplicate set of build, test, and contribution instructions. It does not mean every instruction file is automatically merged or that every Claude Code environment supports the feature in the same way. This guide uses Anthropic’s release, memory documentation, and published built-in plugin notes checked on September 19, 2026. Version 2.1.277 shipped on September 18. A Hacker News discussion about the change had 605 points and 214 comments when checked, which is useful evidence of developer interest, not evidence that the implementation is flawless. What changed: AGENTS.md is now the default fallback AGENTS.md is a plain Markdown file for the information a coding agent needs before changing a repository: setup commands, tests, style rules, security boundaries, and completion criteria. It complements the...