Skip to content

What is AGENTS.md (and CLAUDE.md)?

Glossary entry. Checked on 19 November 2026.

AGENTS.md, in plain words

AGENTS.md is an open format: a plain Markdown file at the root of a repository that tells coding agents how to work in it, such as build and test commands and conventions. Many coding agents read it at the start of a session. CLAUDE.md is Claude Code's equivalent, and Claude Code can read AGENTS.md too.

The format

No required fields: it's ordinary Markdown with whatever headings help. Large repositories can add nested files in sub-projects; agents read the nearest one, and the closest file to the edited code wins. The agents.md site says the format is now stewarded by the Agentic AI Foundation under the Linux Foundation, and lists agents that read it, including Codex, Cursor, Gemini CLI, GitHub Copilot's coding agent, Jules, VS Code and Windsurf.

CLAUDE.md

Claude Code loads ./CLAUDE.md for the project, ~/.claude/CLAUDE.md for you everywhere, and ./CLAUDE.local.md for personal project notes. Its docs suggest keeping each file under about 200 lines. See context engineering.

Share this definition

Lessons that use this term

Sources

Official documentation, checked on 19 November 2026. Products change: if a step differs, the source has the current version.