AGENTS.md Guide

Overview

Provide a repeatable workflow and quality bar for writing or updating AGENTS.md files so agents receive concrete, repo-specific instructions.

Trigger examples

• "Create an AGENTS.md for this repo and include exact test commands."
• "Replace our agent init command with a proper AGENTS.md file."
• "Audit our existing AGENTS.md for missing boundaries and commands."
• "Update AGENTS.md to reflect the current build and lint commands."
• "Create CLAUDE.md as a symlink to AGENTS.md for Claude Code."

Core Principles (condensed)