AGENTS.md, Hands-On: Build One Step by Step (and Watch an Agent Use It)

Short summary

AGENTS.md is a markdown file that instructs AI coding agents on project setup, conventions, and guardrails. This tutorial builds a real example for a Python FastAPI service, then demonstrates how an agent uses the file to complete tasks independently. The payoff: agents that ship correct code without requiring manual verification.

• •AGENTS.md tells AI agents how to build, test, and contribute to your repo
• •Includes eight sections: overview, setup, run, test, structure, conventions, commits, and guardrails
• •Agent performance improves dramatically with clear, specific rules instead of vague guidance

Generated with AI, which can make mistakes.