Skip to main content

AGENTS.md

AGENTS.md is an open standard for project context for AI tools that helps the agent understand the domain, repository structure, and working rules.

It typically includes:

  • a brief product and domain description;
  • key modules and entry points;
  • rules for working with code and tests;
  • constraints (for example, do not touch critical files without confirmation).

AGENTS.md complements Rules and Skills and helps the agent gather context for tasks faster.

Where the file lives​

The file should be located at the root of the project. You can commit it to VCS to share a single context with the team.

How to create AGENTS.md​

Create AGENTS.md in the project root and put only the context the agent needs in most tasks. Start with a short description of the product, the main modules, the verification commands, and the constraints on changes.

If you have just opened an unfamiliar or not yet configured project, use /init: Explyt studies the repository and creates or extends AGENTS.md with basic information about the structure, build and test commands, code style, and VCS conventions.

  1. Open a new chat with the Code agent.
  2. Send the /init command.
  3. Review the generated file and remove anything inaccurate or likely to go stale quickly.

If you want to agree on the contents first, ask the agent to study the project and propose a draft AGENTS.md without saving the file.