AGENTS.md Authoring

Conventions for writing AGENTS.md files. Omissions are intentional.

Core Concept

AGENTS.md is a "README for agents": a dedicated, predictable place for AI coding agent context. Supported by OpenAI Codex, Google Jules, Cursor, VS Code, GitHub Copilot, Devin, Windsurf, OpenCode, Aider, and others.

Writing Style

When writing AGENTS.md content, prefer dense prose over multi-header structures. Collapse related constraints into single paragraphs. Use bullet lists only for genuine enumeration, not as a structural default. The screenshot test: if removing a header and merging its content into the preceding section loses nothing, the header was unnecessary.

Essential Sections