Adding an AGENTS.md File to Your Repos for AI Coding Agents

Melvin Vivas · X post · 2026-08-15 · Open on X

Topics: AI Dev Tools & Productivity, AI Agents, Tool Use & MCP · Level: beginner

Summary

The creator praises open-source projects that include an AGENTS.md file in their repos. These projects accept that people now write code with AI, and the file gives coding agents instructions for working in the project.

Key points

• AGENTS.md is a file in the repo that tells AI coding agents how to work with the project.
• Shipping one shows a project expects AI-assisted contributions.
• Good things to include: build/test commands, code conventions and project structure.

Resources mentioned

• AGENTS.md · docs · agents.md · free
  Instruction file format that gives coding agents project context such as the tech stack, skills and MCP servers.
  Also in: Claude Code Now Reads AGENTS.md When CLAUDE.md Is Missing (Melvin Vivas on X · notes), Subagents with mixed models: a strong planner and a fast executor (Melvin Vivas on X · notes), Updating Skills and AGENTS.md for Astra with OpenAI's Guidance (Melvin Vivas on X · notes), How to Prompt GPT-6 Astra in Codex: Simpler Instructions, Leaner AGENTS.md (Melvin Vivas on X · notes) and 5 more

Try this

• Add an AGENTS.md file to your own repositories.