A curated list of resources, examples, and tools for AGENTS.md — a simple, open format for guiding coding agents.
AGENTS.md is used by over 20,000 open-source projects. Think of it as a README for agents: a dedicated, predictable place to provide context and instructions to help AI coding agents work on your project.
- OpenAI/agents.md - The official spec of the
AGENTS.mdformat. - agentmd/agent.md - The singular variant
AGENT.mdand universal config file concept.
Real-world projects implementing AGENTS.md, AGENT.md, or CLAUDE.md for AI agent configuration.
- supermemory/CLAUDE.md - Memory engine and app that is extremely fast, scalable. The Memory API for the AI era. (source)
- fastmcp/AGENTS.md - The fast, Pythonic way to build MCP servers and clients. (source)
- mcp-go/AGENTS.md - A Go implementation of the Model Context Protocol (MCP), enabling seamless integration between LLM applications and external data sources and tools. (source)
- openai-agents-python/AGENTS.md - A lightweight, powerful framework for multi-agent workflows. (source)
- giselle/AGENTS.md - Giselle: AI App Builder. Open Source. (source)
- Archon/AGENTS.md - Beta release of Archon OS - the knowledge and task management backbone for AI coding assistants. (source)
- openai/codex/AGENTS.md - OpenAI Codex: AI system that translates natural language to code. (source)
- apache/airflow/AGENTS.md - Apache Airflow: Platform to programmatically author, schedule and monitor workflows. (source)
- temporalio/sdk-java/AGENTS.md - Temporal Java SDK: Build reliable applications with Temporal's Java SDK for workflow orchestration. (source)
- PlutoLang/Pluto/AGENTS.md - Pluto: A lightweight, reactive programming language for building web applications. (source)
- AI Ethics Advisor - AI ethics and responsible AI development specialist.
- Hackathon AI Strategist - Expert hackathon strategist and judge.
- Llms Maintainer - LLMs.txt roadmap file generator and maintainer.
- Model Evaluator - AI model evaluation and benchmarking specialist.
- Prompt Engineer - Expert prompt optimization for LLMs and AI systems.
- Search Specialist - Expert web researcher using advanced search techniques and synthesis. Masters search operators, result filtering, and multi-source verification. Handles competitive analysis and fact-checking.
- Task Decomposition Expert - Complex goal breakdown specialist.
- GraphQL Architect - GraphQL schema design and API architecture specialist.
- GraphQL Performance Optimizer - GraphQL performance analysis and optimization specialist.
- GraphQL Security Specialist - GraphQL API security and authorization specialist.
- Smart Contract Auditor - Conducting security audits of smart contracts. Specializes in vulnerability detection, attack vector analysis, and comprehensive security assessments.
- Smart Contract Specialist - Developing production-level smart contracts. Specializes in Solidity development, Hardhat/Foundry toolchains, gas optimization, and secure contract patterns.
- Web3 Integration Specialist - Building Web3 frontend applications and wallet integrations. Specializes in Blockchain connectivity, wallet interactions (RainbowKit, Reown, WalletConnect), ethers.js/viem, and dApp development.
- Business Analyst - Business metrics analysis and reporting specialist.
- Content Marketer - Content marketing and SEO optimization specialist.
- Customer Support - Support documentation and user assistance specialist.
- Legal Advisor - Legal documentation and compliance specialist.
- Marketing Attribution Analyst - Marketing attribution and performance analysis specialist.
- Payment Integration - Payment systems integration specialist.
- Product Strategist - Product strategy and roadmap planning specialist.
- Risk Manager - Risk management and portfolio analysis specialist.
- Sales Automator - Sales automation and outreach specialist.
- AI Engineer - LLM application and RAG system specialist.
- Computer Vision Engineer - Computer vision and image processing specialist.
- Data Engineer - Data pipeline and analytics infrastructure specialist.
- Data Scientist - Data analysis and statistical modeling specialist.
- Ml Engineer - ML production systems and model deployment specialist.
- Mlops Engineer - ML infrastructure and operations specialist.
- Nlp Engineer - Natural Language Processing and text analytics specialist.
- Quant Analyst - Quantitative finance and algorithmic trading specialist.
- Database Admin - Database administration specialist for operations, backups, replication, and monitoring.
- Database Architect - Database architecture and design specialist.
- Database Optimization - Database performance optimization and query tuning specialist.
- Database Optimizer - SQL query optimization and database schema design specialist.
- Neon Auth Specialist - Neon Auth implementation specialist.
- Neon Database Architect - Neon database architecture specialist.
- Neon Expert - General Neon Serverless PostgreSQL consultant.
- NoSQL Specialist - NoSQL database specialist for MongoDB, Redis, Cassandra, and document/key-value stores.
- Supabase Schema Architect - Supabase database schema design specialist.
- Academic Researcher - Academic research specialist for scholarly sources, peer-reviewed papers, and academic literature.
- Competitive Intelligence Analyst - Competitive intelligence and market research specialist.
- Data Analyst - Quantitative analysis, statistical insights, and data-driven research specialist.
- Fact Checker - Fact verification and source validation specialist.
- Query Clarifier - Analyzes research queries for clarity and determines if user clarification is needed before proceeding with research.
- Report Generator - Transforms synthesized research findings into comprehensive, well-structured final reports.
- Research Brief Generator - Transforms user research queries into structured, actionable research briefs.
- Research Coordinator - Strategically plans and coordinates complex research tasks across multiple specialist researchers.
- Research Orchestrator - Coordinates comprehensive research projects requiring multiple specialized agents working in sequence.
- Research Synthesizer - Consolidates and synthesizes findings from multiple research sources into unified, comprehensive analyses.
- Technical Researcher - Analyzes code repositories, technical documentation, implementation details, and evaluates technical solutions.
- Backend Architect - Backend system architecture and API design specialist.
- Cli Ui Designer - CLI interface design specialist.
- Devops Engineer - DevOps and infrastructure specialist for CI/CD, deployment automation, and cloud operations.
- Frontend Developer - Frontend development specialist for React applications and responsive design.
- Fullstack Developer - Full-stack development specialist covering frontend, backend, and database technologies.
- iOS Developer - Native iOS development specialist with Swift and SwiftUI.
- Mobile Developer - Cross-platform mobile development specialist for React Native and Flutter.
- Ui Ux Designer - UI/UX design specialist for user-centered design and interface systems.
- Code Reviewer - Expert code review specialist for quality, security, and maintainability.
- Command Expert - CLI command development specialist for the claude-code-templates system.
- Context Manager - Context management specialist for multi-agent workflows and long-running tasks.
- Debugger - Debugging specialist for errors, test failures, and unexpected behavior.
- Dx Optimizer - Developer Experience specialist for tooling, setup, and workflow optimization.
- Error Detective - Log analysis and error pattern detection specialist.
- Flutter Go Reviewer - Code review specialist for Flutter and Go applications.
- MCP Expert - Model Context Protocol (MCP) integration specialist for the cli-tool components system.
- Performance Profiler - Performance analysis and optimization specialist.
- Test Engineer - Test automation and quality assurance specialist.
- Unused Code Cleaner - Detects and removes unused code (imports, functions, classes) across multiple languages.
- Cloud Architect - Cloud infrastructure design and optimization specialist for AWS/Azure/GCP.
- Deployment Engineer - CI/CD and deployment automation specialist.
- Devops Troubleshooter - Production troubleshooting and incident response specialist.
- Monitoring Specialist - Monitoring and observability infrastructure specialist.
- Network Engineer - Network connectivity and infrastructure specialist.
- Security Engineer - Security infrastructure and compliance specialist.
- Terraform Specialist - Terraform and Infrastructure as Code specialist.
- Vercel Deployment Specialist - Expert in Vercel platform features, edge functions, middleware, and deployment strategies.
- Api Documenter - Create OpenAPI/Swagger specs, generate SDKs, and write developer documentation. Handles versioning, examples, and interactive docs.
- Changelog Generator - Changelog and release notes specialist.
- Docusaurus Expert - Docusaurus documentation specialist.
- Technical Writer - Technical writing and content creation specialist.
- Agent Expert - AI agent architecture and implementation specialist.
- Architect Review - Use this agent to review code for architectural consistency and patterns. Specializes in SOLID principles, proper layering, and maintainability.
- Dependency Manager - Use this agent to manage project dependencies. Specializes in dependency analysis, vulnerability scanning, and license compliance.
- Documentation Expert - Use this agent to create, improve, and maintain project documentation. Specializes in technical writing, documentation standards, and generating documentation from code.
- Audio Mixer - Multi-track audio mixing and mastering specialist.
- Audio Quality Controller - Audio quality enhancement and analysis specialist.
- Podcast Content Analyzer - Podcast content analysis specialist.
- Podcast Metadata Specialist - Podcast metadata and show notes specialist.
- Podcast Transcriber - Audio transcription specialist.
- Social Media Clip Creator - Social media video clip optimization specialist.
- Timestamp Precision Specialist - Frame-accurate timestamp extraction specialist.
- Video Editor - Video editing and production specialist.
- 3D Artist - 3D art and asset creation specialist for game development.
- Game Designer - Game design specialist focusing on mechanics, balancing, player psychology, and system design.
- Unity Game Developer - Expert Unity game developer specializing in C# scripting, 3D graphics, mobile optimization, and complete game development workflows. Handles Unity physics, UI systems, asset optimization, and cross-platform deployment.
- Unreal Engine Developer - Expert Unreal Engine developer specializing in C++ programming, Blueprint visual scripting, and AAA game development. Handles Unreals rendering pipeline, multiplayer systems, and performance optimization.
- Git Flow Manager - Git Flow workflow manager.
- MCP Deployment Orchestrator - MCP server deployment and operations specialist.
- MCP Integration Engineer - MCP server integration and orchestration specialist.
- MCP Protocol Specialist - MCP protocol specification and standards specialist.
- MCP Registry Navigator - MCP registry discovery and integration specialist.
- MCP Security Auditor - MCP server security specialist.
- MCP Server Architect - MCP server architecture and implementation specialist.
- MCP Testing Engineer - MCP server testing and quality assurance specialist.
- Architecture Modernizer - Software architecture modernization specialist.
- Cloud Migration Specialist - Cloud migration and infrastructure modernization specialist.
- Legacy Modernizer - Refactor legacy codebases, migrate outdated frameworks, and implement gradual modernization. Handles technical debt, dependency updates, and backward compatibility.
- Connection Agent - Obsidian vault connection specialist.
- Content Curator - Obsidian content curation and quality specialist.
- Metadata Agent - Obsidian metadata management specialist.
- Moc Agent - Obsidian Map of Content specialist.
- Review Agent - Obsidian vault quality assurance specialist.
- Tag Agent - Obsidian tag taxonomy specialist.
- Vault Optimizer - Obsidian vault performance optimization specialist.
- Document Structure Analyzer - Document structure analysis specialist.
- Markdown Syntax Formatter - Markdown formatting specialist.
- Ocr Grammar Fixer - OCR text correction specialist.
- Ocr Preprocessing Optimizer - OCR preprocessing and image optimization specialist.
- Ocr Quality Assurance - OCR pipeline validation specialist.
- Text Comparison Validator - Text comparison and validation specialist.
- Visual Analysis Ocr - Visual analysis and OCR specialist.
- Load Testing Specialist - Load testing and stress testing specialist.
- Performance Engineer - Profile applications, optimize bottlenecks, and implement caching strategies. Handles load testing, CDN setup, and query optimization.
- React Performance Optimization - Specialist in optimizing React application performance and speed.
- Test Automator - Create comprehensive test suites with unit, integration, and e2e tests. Sets up CI pipelines, mocking strategies, and test data.
- Web Vitals Optimizer - Core Web Vitals optimization specialist.
- Academic Research Synthesizer - Academic research synthesis specialist.
- Comprehensive Researcher - Comprehensive research specialist.
- Episode Orchestrator - Episode workflow orchestrator.
- Guest Outreach Coordinator - Podcast guest outreach and coordination specialist.
- Market Research Analyst - Market research and competitive analysis specialist.
- Podcast Editor - Podcast editing and post-production specialist.
- Podcast Trend Scout - Podcast trend analysis specialist.
- Project Supervisor Orchestrator - Project workflow orchestrator.
- Seo Podcast Optimizer - SEO podcast optimization specialist.
- Social Media Copywriter - Social media content creation specialist.
- Twitter AI Influencer Manager - Twitter AI influencer engagement specialist.
- C Pro - Write efficient C code with proper memory management, pointer arithmetic, and system calls. Handles embedded systems, kernel modules, and performance-critical code.
- C Sharp Pro - Write idiomatic C# code with modern language features, async patterns, and LINQ. Masters .NET ecosystem, Entity Framework Core, and ASP.NET Core.
- CPP Pro - Write idiomatic C++ code with modern features, RAII, smart pointers, and STL algorithms. Handles templates, move semantics, and performance optimization.
- Golang Pro - Write idiomatic Go code with goroutines, channels, and interfaces. Optimizes concurrency, implements Go patterns, and ensures proper error handling.
- JavaScript Pro - Master modern JavaScript with ES6+, async patterns, and Node.js APIs. Handles promises, event loops, and browser/Node compatibility.
- PHP Pro - Write idiomatic PHP code with generators, iterators, SPL data structures, and modern OOP features.
- Python Pro - Write idiomatic Python code with advanced features like decorators, generators, and async/await. Optimizes performance, implements design patterns, and ensures comprehensive testing.
- Rust Pro - Write idiomatic Rust with ownership patterns, lifetimes, and trait implementations. Masters async/await, safe concurrency, and zero-cost abstractions.
- Shell Scripting Pro - Write robust shell scripts with proper error handling, POSIX compliance, and automation patterns. Masters bash/zsh features, process management, and system integration.
- SQL Pro - Write complex SQL queries, optimize execution plans, and design normalized schemas. Masters CTEs, window functions, and stored procedures.
- TypeScript Pro - Write idiomatic TypeScript with advanced type system features, strict typing, and modern patterns. Masters generic constraints, conditional types, and type inference.
- Supabase Realtime Optimizer - Supabase realtime performance specialist.
- Api Security Audit - Specialist in auditing API security and identifying vulnerabilities.
- Compliance Specialist - Security compliance and regulatory framework specialist.
- Incident Responder - Handles production incidents with urgency and precision.
- Penetration Tester - Penetration testing and ethical hacking specialist.
- Security Auditor - Review code for vulnerabilities, implement secure authentication, and ensure OWASP compliance. Handles JWT, OAuth2, CORS, CSP, and encryption.
- Next.js Architecture Expert - Master of Next.js best practices, App Router, Server Components, and performance optimization.
- React Performance Optimizer - Specialist in React performance patterns, bundle optimization, and Core Web Vitals.
- Seo Analyzer - SEO analysis and optimization specialist.
- Url Context Validator - URL validation and contextual analysis specialist.
- Url Link Extractor - URL and link extraction specialist.
- Web Accessibility Checker - Web accessibility compliance specialist.
- Ethereum Developer - Smart contract development.
- Senior Frontend Developer - Frontend development expertise.
- Fullstack Software Developer - Full-stack development.
- Machine Learning Engineer - ML systems and models.
- DevOps Engineer - Infrastructure and automation.
- Code Reviewer - Code quality and review.
- Software Quality Assurance Tester - QA and testing.
- Linux Script Developer - Bash and shell scripting.
- GitHub Expert - Git and GitHub workflows.
- Cyber Security Specialist - Security analysis.
- IT Architect - IT architecture design.
- IT Expert - Technical support.
- Large Language Models Security Specialist - LLM security.
- Data Scientist - Data analysis and insights.
- Scientific Data Visualizer - Data visualization.
- LLM Researcher - Language model research.
- Product Manager - Product strategy.
- Project Manager - Project coordination.
- Chief Executive Officer - Executive leadership.
- Startup Idea Generator - Business ideation.
- Career Counselor - Career guidance.
- UX/UI Developer - User experience design.
- Web Design Consultant - Web design.
- SVG Designer - Vector graphics.
- Interior Decorator - Interior design.
- Tech Writer - Technical documentation.
- Essay Writer - Essay composition.
- Screenwriter - Script writing.
- Cover Letter - Professional application letters.
- Commit Message Generator - Git commit messages.
- Instructor in a School - Teaching and instruction.
- Career Coach - Career development.
- Study Planner - Study organization.
- Knowledgeable Software Development Mentor - Mentorship.
- Regex Generator - Regular expressions.
- SQL Terminal - SQL queries.
- Python Interpreter - Python code execution.
- Linux Terminal - Command line.
- JavaScript Console - JS debugging.
- OpenAI/openai-agents-python - Official agents SDK from OpenAI.
- OpenBMB/RepoAgent - Repository-level agent for documentation & repo understanding.
- mitmedialab/MDAgents - Multi-agent system for medical reasoning and tasks.
- langchain-ai/agents-from-scratch - Tutorial for building ambient agents (email assistant etc.).
- drivly/agentic.md - Define and visualize agents and workflows in Markdown/Mermaid.
- attogram/agents - Contains
AGENTS.md, plus human-persona and platform files; layered architecture. - ChatTeach/Awesome-AI-Agents - A curated list of open-source AI agents; includes an
AGENTS.md. - hfblog/hfblog - A blog repo demonstrating usage of
agents.md. - sst/opencode - Issue/discussion on
AGENT.mdvsAGENTS.md, showing ecosystem early-stage. - anthropics/claude-code - Discussion of adding support for
AGENTS.md. - davila7/claude-code-templates - CLI tool with 160+ ready-to-use AI agents, custom commands, MCPs, and complete project templates for Claude Code. Browse templates
Contributions welcome! Read the contribution guidelines first.
