agentsmd/agents.md

AGENTS.md — a simple, open format for guiding coding agents

What it solves

It provides a standardized, open format for providing context and instructions specifically for AI coding agents. This prevents agents from having to guess or scan the entire codebase to understand project-specific development, testing, and pull request workflows.

How it works

Users create an AGENTS.md file in their project repository. This file acts as a "README for agents," containing predictable, structured instructions such as development environment tips, testing procedures, and PR guidelines that the AI agent can reference to work more accurately on the project.

Who it’s for

Developers who use AI coding agents to contribute to or maintain their software projects.

Highlights

  • Dedicated, predictable location for agent instructions.
  • Open format based on Markdown.
  • Simple, structured approach to guiding AI agents through project-specific workflows.

Related

  • Project
    agentskills/agentskills

    A standardized, open format for packaging specialized knowledge and workflows into portable folders that AI agents can load on demand to gain domain expertise.

  • Project
    agent0ai/dox

    A lightweight framework using a hierarchy of AGENTS.md files to give AI agents precise project context and prevent blind edits during coding.

  • Project
    anomalyco/opencode

    An open-source AI coding agent available as a CLI or desktop app that helps developers plan, explore, and build software.

  • Project
    kwakseongjae/oh-my-design

    A design workflow system for AI coding agents that uses a project-owned DESIGN.md file and a library of 440+ company references to ensure consistent, professional UI/UX.

  • Project
    davidondrej/skills

    A collection of reusable skill modules and instructions that AI agents can load to execute specific workflows like research, coding orchestration, and system operations.