agentleFS

AGENTS.md examples from real projects

How real projects brief Codex, Cursor and every other agent that reads AGENTS.md.

Worked for most · soon
VercelAGENTS.md

zero-native

vercel-labs/zero-native/AGENTS.md

Guidance for agents (and humans) working on this repository. Native SDK itself is implemented in Zig, but Native SDK apps are authored in TypeScript + Native markup by default. Do not infer the app-authoring language from this repository's implementation language or from older Zig-core examples. Run scripts/gate.sh fast before finishing any change; it maps your diff to the suites that cover it. The docs site checks with pnpm --dir docs check (the gate runs it only when docs/ changed). This…

1 project uses a version of this

7.8k3mo agoReviewMountCreate a free account to mount
VercelAGENTS.md

zero-native

vercel-labs/zero-native/docs/AGENTS.md

Always use HTML <table> syntax in MDX pages, never markdown pipe tables. This ensures consistent styling and avoids MDX parsing edge cases. The site uses the public @vercel/geistdocs package with Labs branding. Write pages in content/docs with a frontmatter title and no duplicate H1. Order pages and groups with content/docs/meta.json and folder metadata. Keep /docs/<slug> URLs and the permanent legacy redirects in next.config.mjs stable. Shared navigation, search, page actions, Markdown routes, MDX rendering, and theme behavior belong to Geistdocs. Local…

1 project uses a version of this

7.8k3mo agoReviewMountCreate a free account to mount
OpenAIAGENTS.md

plugins / react-best-practices

openai/plugins/plugins/build-web-apps/skills/react-best-practices/AGENTS.md

Version 1.0.0 Vercel Engineering January 2026 Note: This document is mainly for agents and LLMs to follow when maintaining, generating, or refactoring React and Next.js codebases. Humans may also find…

7.8k6mo agoReviewMountCreate a free account to mount
OpenAIAGENTS.md

plugins / supabase-best-practices

openai/plugins/plugins/build-web-apps/skills/supabase-best-practices/AGENTS.md

Comprehensive performance optimization guide for Postgres, maintained by Supabase. Contains rules across 8 categories, prioritized by impact to guide automated query optimization and schema design. Reference these guidelines when: -…

7.8k6mo agoReviewMountCreate a free account to mount
OpenAIAGENTS.md

plugins / data-analytics

openai/plugins/plugins/data-analytics/AGENTS.md

This plugin contains a complex fullscreen analytics artifact workspace, a shared read-only portable artifact reader, and compact inline chart and table widgets. Preserve that architecture when iterating: MCP and portable…

7.8k6mo agoReviewMountCreate a free account to mount
OpenAIAGENTS.md

plugins / mobile-app

openai/plugins/plugins/product-design/templates/mobile-app/AGENTS.md

In ChatGPT Work Mode, run sites-preview start "$PWD", open http://terminal.local:4173/ in the cloud browser, and verify the rendered app and its primary interactions. Keep that preview open and tell the…

7.8k6mo agoReviewMountCreate a free account to mount
OpenAIAGENTS.md

plugins / prototype

openai/plugins/plugins/product-design/templates/prototype/AGENTS.md

Run the local server yourself and open the preview in the browser available to this environment. Do not give the user server-start instructions when you can run it. Before making…

7.8k6mo agoReviewMountCreate a free account to mount
OpenAIAGENTS.md

plugins / react-best-practices

openai/plugins/plugins/vercel/skills/react-best-practices/AGENTS.md

Version 1.0.0 Vercel Engineering January 2026 Note: This document is mainly for agents and LLMs to follow when maintaining, generating, or refactoring React and Next.js codebases. Humans may also find…

7.8k6mo agoReviewMountCreate a free account to mount
OpenAIAGENTS.md

plugins / zoom

openai/plugins/plugins/zoom/AGENTS.md

This repository contains the Zoom plugin for Codex. Its purpose is to help users and engineers:

7.8k6mo agoReviewMountCreate a free account to mount
AWSAGENTS.md

karpenter-provider-aws / upgrading

aws/karpenter-provider-aws/website/content/en/docs/upgrading/AGENTS.md

These rules apply when you add or edit the per-version notes in upgrade-guide.md (the ### Upgrading to <version>+ sections). Rank notes within each group by impact as well. For metrics, that means how much observability breaks, e.g. how widely the metric is used and how many queries the change breaks. - This file isn't published: website/hugo.yaml lists AGENTS.md in ignoreFiles.

No other project uses it yet

7.7k36d agoReviewMountCreate a free account to mount
SupabaseAGENTS.md

realtime

supabase/realtime/AGENTS.md

Entry point for AI/LLM agents working in or with this repository. Other documentation files are listed in README.md Regenerate tenant schema whenever tenant migrations changes, see mise.toml. The PR title becomes the squash commit that semantic-release reads. It follows Conventional Commits. Follow the repository security policy.

7.7k18d agoReviewMountCreate a free account to mount
NVIDIAAGENTS.md

warp

NVIDIA/warp/AGENTS.md

Run uvx pre-commit run --files <files> to format changed files, or -a for all files. Rebuild native libraries only after changes to warp/native/ C++/CUDA code: Build docs (~1 min) with uv run --extra docs build_docs.py 2>&1 | tee /tmp/build_docs.log so you can inspect warnings without re-running. - If opening a pull request on GitHub, use the template in .github/PULL_REQUEST_TEMPLATE.md. - If opening a merge request on GitLab, use the template in .gitlab/merge_request_templates/Default.md. If a GitHub issue exists for the change,…

Steady2 mentions in 2 weeks

No other project uses it yet

7.3k14d agoReviewMountCreate a free account to mount
MongoDBAGENTS.md

laravel-mongodb

mongodb/laravel-mongodb/AGENTS.md

Guidance for agents working on the development of this library. For assisting end users who use the package in their own applications, see the laravel-mongodb skill. The package mirrors Eloquent and the Laravel database layer, so that an application can move a model to MongoDB without rewriting its code. illuminate/database is the reference: when a behaviour differs, align with Laravel instead of inventing a MongoDB-specific API. The scope covers the Eloquent ORM (models, query builder, relations, casts), the aggregation builder…

Steady9 mentions in 2 weeks

No other project uses it yet

7.1k15d agoReviewMountCreate a free account to mount
GoogleAGENTS.md

perfetto

google/perfetto/docs/AGENTS.md

This document provides essential instructions and best practices for developing in the Perfetto codebase. Adhere to these guidelines to ensure consistency and quality. All Perfetto changes must be landed in the upstream repository at https://github.com/google/perfetto. Note for Google folks: Pull requests or changelists raised against third_party/perfetto/ in google3, or against external/perfetto in the internal Android repository, will NOT be accepted. To upstream your changes, follow the instructions at go/perfetto-github-instructions, or contact perfetto-team@google.com for help. The perfetto repo contains several projects.…

No other project uses it yet

6.8k12d agoReviewMountCreate a free account to mount
MicrosoftAGENTS.md

vscode-docs / concepts

microsoft/vscode-docs/docs/agents/concepts/agents.md

An agent is an AI system that uses a language model and tools to complete a goal on your behalf. A language model generates responses based on the information in…

6.7k9mo agoReviewMountCreate a free account to mount
MicrosoftAGENTS.md

agent-governance-toolkit / agent-governance-claude-code

microsoft/agent-governance-toolkit/agent-governance-claude-code/AGENTS.md

The agent-governance-claude-code/ directory contains the first-party Claude Code plugin package for Agent Governance Toolkit. It wires AGT policy evaluation into Claude-native hooks, markdown commands, and a bundled MCP server.

6.5k58d agoReviewMountCreate a free account to mount
MicrosoftAGENTS.md

agent-governance-toolkit / agent-governance-dotnet

microsoft/agent-governance-toolkit/agent-governance-dotnet/AGENTS.md

agent-governance-dotnet/ contains the .NET SDK for Agent Governance Toolkit: policy enforcement, execution rings, trust, SRE controls, MCP security, lifecycle management, and auditability for .NET applications.

6.5k58d agoReviewMountCreate a free account to mount
MicrosoftAGENTS.md

agent-governance-toolkit / agent-governance-opencode

microsoft/agent-governance-toolkit/agent-governance-opencode/AGENTS.md

Scope: this folder publishes @microsoft/agent-governance-opencode, the AGT governance plugin for OpenCode. OpenCode loads plugins in-process as async JS/TS functions. The plugin entry point is src/index.mjs, which: - caches a single loadPolicy() state per OpenCode process - maps AGT decisions (allow / review / deny) onto OpenCode's contract: - deny → throw new Error(...) from the hook - review → annotate output.args.__agt_review_reason - allow → return undefined - exposes agt_policy_status and agt_policy_check_text as both in-process custom tools and stdio MCP server…

6.5k58d agoReviewMountCreate a free account to mount
MicrosoftAGENTS.md

agent-governance-toolkit / agent-mesh

microsoft/agent-governance-toolkit/agent-governance-python/agent-mesh/AGENTS.md

AgentMesh is a trust-first communication layer for AI agents — providing cryptographic identity, multi-dimensional trust scoring, scope chains, and governance enforcement for multi-agent systems. Architecture: 4-layer trust stack - All data models use Pydantic BaseModel - Identity: AgentIdentity with .sign(data: bytes) -> str (base64 Ed25519 signatures) - Trust scores: 5 dimensions — competence, integrity, availability, predictability, transparency - DID format: did:mesh:{hex} — see the proof-of-possession note under Boundaries: registry/app.py derives DIDs from the public key, while AgentDID.generate mints a random…

6.5k58d agoReviewMountCreate a free account to mount
MicrosoftAGENTS.md

agent-governance-toolkit / sdks

microsoft/agent-governance-toolkit/agent-governance-python/agent-mesh/sdks/AGENTS.md

This directory contains cross-language AgentMesh SDKs: These SDKs should stay conceptually aligned with the trust, identity, governance, and MCP security surfaces provided elsewhere in the repo. This directory reflects the repo layout at this point in time. Some language implementations may eventually move into standalone top-level directories such as agent-governance-golang/, agent-governance-rust/, or agent-governance-python/. If that happens, treat the standalone top-level directory as the primary home for new work. This directory should then be treated as legacy/shared-layout guidance for the code…

6.5k58d agoReviewMountCreate a free account to mount
CLAUDE.md vs AGENTS.md

About AGENTS.md

What is AGENTS.md?

An open format for instructions to coding agents, read by Codex, Cursor and others. Think of it as a README written for agents.

Where does it go?

At the repository root, with more specific files in subdirectories. Agents read the one closest to the file they're editing.

What should it contain?

Setup and test commands, code style, and the rules a new contributor would need to know.

Does Claude Code read it?

Claude Code reads CLAUDE.md. A one-line CLAUDE.md that points at AGENTS.md covers both.