Skip to content
Arara Code

Guides and comparisons

AGENTS.md: how to guide AI coding agents

AGENTS.md is an open Markdown standard placed at the repository root to give coding agents predictable project instructions. It acts like a README for AI, unifying build commands, test suites, style rules, and guardrails in one cross-tool file.

Arara Code

Published by the Arara Code project based on the official documentation cited.

Why AGENTS.md was created

Before AGENTS.md, every assistant demanded its own proprietary config file—such as .cursorrules, CLAUDE.md, or custom extension settings—creating duplication and drift for teams using multiple tools.

With the open standard hosted at agents.md, one file describes how your codebase works and is natively read by tools including OpenAI Codex, Claude Code, Gemini, GitHub Copilot, and Cursor.

AGENTS.md: official open standard specification

What to include in AGENTS.md

Because it has no rigid schema, the file uses plain Markdown headings: setup and dev commands, required typecheck and test scripts, architecture conventions, and explicit guardrails on files agents should never edit.

In large monorepos, you can also place nested AGENTS.md files inside subdirectories to scope package-specific rules without bloating global context.

GitHub: official agentsmd/agents.md repository

Fewer hallucinations and lower token waste

Giving agents exact verification commands and module paths upfront prevents expensive discovery loops where assistants guess package scripts.

That cuts command failures, keeps pull requests consistent, and makes automated edits far more predictable.

AGENTS.md: official open standard specification

AGENTS.md inside Arara Code

Arara Code respects your workspace AGENTS.md and applies your project rules consistently whether you run Claude Code, Codex, Kiro, or Antigravity.

Every teammate keeps the same quality bar even when developers pick different models or agents inside the IDE.

Arara Code: public IDE repository

Sources and further reading

Read as Markdown

Keep exploring

Make room for your next idea.

Get to know Arara Code in your own project. Start with the installer and review the changes your assistant makes.