AGENTS.md
AGENTS.md is a tool-agnostic Markdown file that provides project context and instructions to AI coding agents, often scoped to a repository or directory.
Vibe Engineering
AGENTS.md is a tool-agnostic convention for a repository-root Markdown file that supplies project context and instructions to AI agents.
- How it is used
- Supplies durable, shared project instructions to agents across sessions and tools.
- How deep it goes
- Provides a starting checklist, hierarchical examples, context-audit guidance, and an explicit distinction between advisory rules and enforcement.
- Examples
- Uses payment-service conventions, a root-to-package instruction hierarchy, and a rules-file audit to illustrate practical configurations.
- What you can do after
- Operate/configure it by writing concise project rules, checking tool loading, and pairing advisory instructions with external controls.
Context Engineering
A portable Markdown file that provides project-specific instructions for AI coding agents.
- How it is used
- Provides a version-controlled baseline of repository instructions across coding-agent sessions.
- How deep it goes
- Works through file contents, cross-agent setup, an adapter, and a validation exercise while noting discovery differences.
- Examples
- Uses a backend billing service and a Python task tracker with an empty-title validation task.
- What you can do after
- Apply it via Codex, Cursor, Aider, or a Claude Code adapter and check whether agents follow the shared instructions.
What to know first
- CursorCursor is an AI-powered code editor that integrates artificial-intelligence assistance into software development.
- MarkdownMarkdown is a lightweight markup language that uses readable plain-text syntax to represent structured and formatted documents.
Related concepts
- AI agentused by · An AI agent is a computational system that uses artificial intelligence to interpret information and select or perform actions toward goals while interacting with an environment.
- Aideruses · Aider is an open-source AI pair-programming tool that helps developers edit and manage code in software projects through natural-language interaction.
- Claude Codeuses · Claude Code is Anthropic’s command-line AI coding agent for inspecting and modifying codebases and carrying out software-development tasks through natural-language interaction and tools.
- CLAUDE.mdused by · CLAUDE.md is a Markdown file containing persistent instructions and contextual guidance for Claude Code.
Questions about AGENTS.md
What is AGENTS.md?
AGENTS.md is a tool-agnostic Markdown file that provides project context and instructions to AI coding agents, often scoped to a repository or directory.
Which Manning books explain AGENTS.md?
Vibe Engineering and Context Engineering.
What should I know before learning AGENTS.md?
Manning books that teach AGENTS.md usually introduce Cursor and Markdown first.
These guides are generated from the text of Manning books by Manning's knowledge graph and link to the sections they draw on. The full books are available on liveBook and at manning.com.

