AGENTS.md Generator
Generate an AGENTS.md file — the universal markdown spec read by OpenAI Codex, Cursor, Sourcegraph Amp, Aider, Jules, and other AI coding agents. Stack-aware defaults plus optional DESIGN.md cross-reference for UI consistency.
2 Stack Pick one for smart defaults
3 Setup Commands
4 Code Style
5 Testing
6 Security
7 PR & Commit Conventions
8 DESIGN.md Cross-Reference
Wire up your design system
Add an explicit instruction telling agents to read DESIGN.md for any UI work — colors, typography, spacing, components. Keeps generated UI on-brand without re-prompting.
9 Project Structure Optional
10 Custom Instructions Optional
Preview
Where to place AGENTS.md
your-project/
├── AGENTS.md ← root of repo (universal)
├── DESIGN.md ← optional, for UI work
├── package.json
└── src/Need a tool-specific variant?
.cursor/rules/*.mdcCursor Rules Generator →
.github/copilot-instructions.mdCopilot Instructions →
SKILL.mdClaude Skills Generator →
.windsurf/rules/*.mdWindsurf Rules →
Frequently asked questions
What AGENTS.md is, which agents read it, and how it relates to vendor-specific files.
What is AGENTS.md?
A universal markdown file that gives instructions to AI coding agents — like a README.md but written for the agent. Open spec at agents.md. Covers setup commands, code style, testing, security, and any project-specific rules an agent needs to follow.
Which AI coding agents read AGENTS.md?
OpenAI Codex, Cursor, Sourcegraph Amp, Aider, Jules, Claude Code, RooCode, and a growing list of others. Adoption is now broad enough that AGENTS.md is the de-facto standard.
Where does the file go?
Repository root, named exactly AGENTS.md. Agents read it before README.md. In monorepos you can also place additional AGENTS.md files inside subdirectories — the agent uses the closest one in the directory tree.
How is AGENTS.md different from vendor-specific files?
Files like .cursorrules, CLAUDE.md, and .github/copilot-instructions.md only work in one tool. AGENTS.md is the open standard read by all major agents, so you write it once. Most agents that have their own format will also read AGENTS.md as a fallback or supplement.
Can I have multiple AGENTS.md files in one repo?
Yes. Agents walk up the directory tree from the file they're editing and use the closest AGENTS.md. Useful for monorepos where the frontend, backend, and infra packages each have different conventions.
Why cross-reference DESIGN.md from AGENTS.md?
So coding agents stay visually consistent when they generate UI. Pointing them at ./DESIGN.md means they reuse your tokens (colors, typography, spacing) instead of repeating those tokens inline in AGENTS.md or — worse — inventing new ones.