Managing AGENTS.md

Overview

AGENTS.md is a README for AI agents. It tells any AI coding tool — Claude Code, Copilot, Cursor, Codex — how to navigate and work with your codebase. Keep it updated as the project evolves.

When to Create or Update

Create AGENTS.md when:

• Setting up a new project or monorepo
• Adding a significant new feature directory (5+ related files)
• Introducing an extensible or polymorphic system
• A codebase has no AGENTS.md and you're doing substantial work in it

Update AGENTS.md when:

• Changing architectural patterns or project structure
• Adding new build/test/deploy commands
• Modifying base classes, registries, or extension points
• Adding significant new directories