AGENTS.md vs CLAUDE.md vs Copilot Instructions: Which File Should You Use?
Use this support matrix to decide whether CLAUDE.md, Copilot instructions, AGENTS.md, or Cursor rules should carry repository guidance for each tool surface.
Choose repository instruction files by the tool surface that actually reads them. This cluster connects compatibility evidence, copyable templates, and dated product updates so a shared policy can stay useful without pretending every agent has the same discovery rules.
Start with the support matrix, then adapt a template and verify it in the repository. Keep security boundaries, setup commands, and completion criteria explicit; keep tool-specific adapters short enough to review when a vendor changes its behavior.
Dated product changes connected to this operating decision.
GitHub's June 3 changelog highlights the Agents window preview, BYOK controls, session sync, terminal safety, and integrated browser improvements in VS Code.
GitHub's Copilot CLI refresh adds a redesigned terminal experience, a critic agent, scheduled prompts, and local voice input.
GitHub made the Copilot SDK generally available, giving teams a supported way to embed Copilot's agent runtime into apps, services, and developer tools.