FILE FORMATS

Six instruction-file formats, what reads each one, and how they fit together, plus side-by-side comparisons and converters. Every page is checked against vendor documentation and dated.

Zero retention: everything you type stays in this browser. Verify it yourself in DevTools.
Guide

Which Instruction File Formats Exist?

Six formats cover nearly every coding agent in use today. AGENTS.md is the shared one; the rest belong to a single tool each.

How Do the Formats Compare?

Side-by-side comparisons of the pairs people most often confuse:

How Do You Convert an Existing File?

Paste an existing file and get AGENTS.md plus the four tool files, with a lint report:

What Is the Recommended Setup?

  1. Write the shared instructions once, in AGENTS.md at the repository root.
  2. Add CLAUDE.md with one line, @AGENTS.md, if anyone uses Claude Code.
  3. Add GEMINI.md that imports AGENTS.md, or configure Gemini CLI to read AGENTS.md, if anyone uses Gemini CLI.
  4. Add .github/copilot-instructions.md with the essentials inline if anyone uses Copilot Chat on github.com or in Visual Studio or JetBrains.
  5. Delete legacy .cursorrules and .windsurfrules files once their content is in AGENTS.md.

The generator writes exactly this set, and the compatibility table shows which agent reads what.

  • One source of truth means one place to fix a wrong command.
  • Thin wrappers cost almost no context.
  • Nested AGENTS.md files keep area-specific rules next to the code.

Frequently Asked Questions

Which format should I start with?

AGENTS.md. It is an open format read directly by Codex, Cursor, Windsurf, Cline, Zed and Jules, and the other tools can be pointed at it with a one-line wrapper.

Do I need all six files?

No. Create AGENTS.md, then a wrapper only for each tool your team actually uses. Unused wrappers do no harm, but they are one more file to keep in sync.

Are these formats stable?

They change. Tools add support for AGENTS.md, rename folders and deprecate old files. Each page here shows the date it was last checked against the vendor documentation.

Where do personal preferences go?

In the per-user file each tool provides, such as ~/.claude/CLAUDE.md, CLAUDE.local.md or ~/.gemini/GEMINI.md, not in the shared repository files.

Was this helpful?