Introduction
Awesome AI Conventions is a curated registry of file-based conventions and open protocols for AI-agent-ready projects.
The source of truth remains the repository root README.md. The Docusaurus site mirrors that registry into focused pages, explains how conventions are evaluated, and generates browsable pages for every file under examples/**.
What Belongs Here
- File-based conventions that agents can read directly from repositories or predictable web paths.
- Open protocols that standardize how agents connect to tools, resources, APIs, or each other.
- Patterns with public documentation, specs, canonical references, or clear production usage.
What Does Not Belong Here
- Frameworks, SaaS products, or libraries by themselves.
- Private team templates without external adoption.
- Useful file names that have not become a recognizable convention.
Start Here
- Read the full registry in README Mirror.
- Browse the conceptual map in Layers.
- Use the Decision Guide to choose a convention for a specific project need.
- Review the Methodology and Status Taxonomy before proposing new entries.
- Explore copyable files in Examples.