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

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](https://ai-powered.com/academy/code-with-ai-agents/context-engineering).

## Sources

Official documentation, checked on 19 November 2026:

- [AGENTS.md (agents.md)](https://agents.md)
- [How Claude remembers your project (Claude Code docs)](https://code.claude.com/docs/en/memory)

## Related terms

- [Context window](https://ai-powered.com/academy/glossary/context-window): The context window is the amount of text a language model can look at while it writes a reply: your messages, files, tool results and its own earlier answers. It is the model's working memory, separate from what it learned in training, and it is measured in tokens.
- [Agent skill](https://ai-powered.com/academy/glossary/agent-skill): An agent skill is a folder that teaches an AI agent how to do one kind of task. It holds a SKILL.md file (a name, a description of when to use it, and instructions) and can include scripts, templates and reference files. The agent loads it only when a task matches the description.
- [AI agent](https://ai-powered.com/academy/glossary/ai-agent): An AI agent is a system in which a language model decides, step by step, which tools to use and what to do next to finish a task, checking the result of each step before the next. A fixed script decides nothing; an agent directs its own process.
