The AI coding assistant landscape has been quietly wrestling with a fragmentation problem. If you're working with multiple AI tools, you've likely noticed the proliferation of instruction files cluttering your repositories: .cursorrules
for Cursor, CLAUDE.md
for Claude, .github/copilot-instructions.md
for GitHub Copilot, and more. Each tool requires its own special configuration file, creating maintenance overhead and scattered documentation.
Enter AGENTS.md
, a simple, open format for guiding coding agents.
GitHub's recent introduction of AGENTS.md
support in their Copilot coding agent marks an important next step toward solving this problem.
What's new with AGENTS.md
With this announcement GitHub Copilot's autonomous coding agent now recognizes AGENTS.md
files in your repositories. This file format allows you to provide custom instructions that guide Copilot on understanding your project structure, coding conventions, and how to build, test, and validate changes.
The implementation is thoughtfully designed with flexibility in mind:
- Single root file: Create one
AGENTS.md
at your repository root for project-wide instructions - Nested configurations: Place
AGENTS.md
files in subdirectories to provide context-specific guidance for different parts of your codebase - Backward compatibility: Copilot continues to support existing formats including
.github/copilot-instructions.md
,.github/instructions/**.instructions.md
,CLAUDE.md
, andGEMINI.md
I think this marks an important milestone in AGENTS.md
becoming the de facto standard for AI agent instructions, making life easier for developers and creating a cleaner, more maintainable approach to configuring our AI collaborators.
So go and start making the switch!
More information
Copilot coding agent now supports AGENTS.md custom instructions - GitHub Changelog