Those of you who have done vibe coding in the past know the importance of providing your favorite AI with the right set of instructions. READMe.md is a file you put at the root of your project folder. It describes what the project is all about. AGENTS.md is designed for AI agents. It helps you give agents instructions at a predictable place. You will be able to use one AGENTS.md file across many agents, including Jules, Cursor, RooCode, and Codex. This approach reduces the confusion of using different config files.
This is madness. What are we doing! pic.twitter.com/UrDTgH73yT
— shadcn (@shadcn) August 12, 2025
To use AGENTS.md, simply create the file at the root of your repository, add project overview, code style guidelines and testing instructions. You have the option to use nested files for subprojects. If you have multiple files, the nearest one takes a precedence.
[HT]
