AGENTS.md Generator

What Is AGENTS.md?

AGENTS.md is a markdown file placed in your project root that provides instructions to AI coding assistants. It tells AI tools how to work with your codebase — coding conventions, architectural decisions, testing requirements, and workflow preferences. Unlike Cursor-specific rules, AGENTS.md is designed to be portable across multiple AI tools including Cursor, Codex, GitHub Copilot, and Windsurf.

Why Use AGENTS.md?

A well-crafted AGENTS.md file eliminates repetitive prompting. Instead of explaining your project conventions in every AI session, encode them once in AGENTS.md and let the AI reference them automatically. This is especially valuable for teams — everyone gets consistent AI behavior without manual coordination.

AGENTS.md vs. Cursor Rules

While Cursor rules (.cursor/rules/) are Cursor-specific, AGENTS.md works across multiple tools. Many projects use both: AGENTS.md for portable, high-level instructions and Cursor rules for Cursor-specific behaviors like per-file glob matching.

What to Include in AGENTS.md

• Project overview and tech stack
• Coding conventions and style guides
• Architecture patterns and design decisions
• Testing framework and expectations
• Build and deployment instructions
• File naming and directory structure conventions
• External dependencies and API documentation references

Related Tools

Generate complete rule sets with the Cursor Rules Generator. Learn about the project rules format or browse templates for pre-built configurations. Also check out the .cursorrules generator for the legacy format.