agentleFS
Sign inSign up

AGENTS.md examples from real projects

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

Popular:code reviewtestingpdfMCP serverfrontendsecuritydocumentation
Most stars first · from page 18Worked for most · soon
Known publishers remove filter10k+ stars remove filter
JetBrainsAGENTS.md

kotlin

JetBrains/kotlin/AGENTS.md

CRITICAL: guidelines.md MUST be followed at all times.

53k30d agoDiscuss
JetBrainsAGENTS.md

kotlin / analysis

JetBrains/kotlin/analysis/AGENTS.md

A library for analyzing Kotlin code at the semantic level, providing structured access to symbols, types, and semantic relationships. Entry point: Use analyze() to start an analysis session. See Analysis…

53k30d agoDiscuss
JetBrainsAGENTS.md

kotlin / compiler

JetBrains/kotlin/compiler/AGENTS.md

Consider reading fir-basics.md. FIR processes code through sequential phases (see FirResolvePhase.kt). Key invariant: In phase B following phase A, all FIR elements visible in B are resolved to phase A.

53k30d agoDiscuss
AstralAGENTS.md

ruff

astral-sh/ruff/AGENTS.md

This repository contains both Ruff (a Python linter and formatter) and ty (a Python type checker). The crates follow a naming convention: ruff* for Ruff-specific code and ty* for ty-specific code. ty reuses several Ruff crates, including the Python parser (ruffpythonparser) and AST definitions (ruffpythonast). Before starting work on an issue and again before opening a pull request, follow the guidance on avoiding duplicate work. If an open pull request already addresses the issue, do not submit a competing one…

50k4mo agoDiscuss
SentryAGENTS.md

sentry

getsentry/sentry/AGENTS.md

IMPORTANT: AGENTS.md files are the source of truth for AI agent instructions. Always update the relevant AGENTS.md file when adding or modifying agent guidance. Do not add to CLAUDE.md or…

45k3mo agoDiscuss
SentryAGENTS.md

sentry / src

getsentry/sentry/src/AGENTS.md

For critical commands, see the "Command Execution Guide" section in /AGENTS.md in the repository root. Multi-tenant queries MUST be scoped — never trust user-supplied IDs alone. - Always filter by…

45k3mo agoDiscuss
SentryAGENTS.md

sentry / derived

getsentry/sentry/src/sentry/issues/derived/AGENTS.md

Follow README.md in this directory when changing Features or aggregators here.

45k3mo agoDiscuss
SentryAGENTS.md

sentry / static

getsentry/sentry/static/AGENTS.md

For critical commands and testing rules, see the "Command Execution Guide" section in /AGENTS.md in the repository root. Use apiOptions with useQuery from TanStack Query; never use the deprecated useApiQuery/getApiQueryData/setApiQueryData.…

45k3mo agoDiscuss
SentryAGENTS.md

sentry / tests

getsentry/sentry/tests/AGENTS.md

For test commands (make test-selective, pytest), see the "Command Execution Guide" section in /AGENTS.md in the repository root. This guide covers Python tests. For frontend React/TypeScript tests (.spec.tsx, RTL, MockApiClient),…

45k3mo agoDiscuss
VercelAGENTS.md

agent-browser

vercel-labs/agent-browser/AGENTS.md

Instructions for AI coding agents working with this codebase. This project uses pnpm. Always use pnpm instead of npm or yarn for installing dependencies, running scripts, etc. (e.g., pnpm install, pnpm run build). Do not hard-wrap prose in documentation files such as Markdown, MDX, and READMEs; let the editor or renderer wrap text naturally. When adding or changing user-facing features (new flags, commands, behaviors, environment variables, etc.), update all of the following: This applies to changes that either human users…

43k15d agoDiscuss
VercelAGENTS.md

agent-browser / eve

vercel-labs/agent-browser/examples/eve/AGENTS.md

This project uses the eve framework. Before writing code, always read the relevant guide in node_modules/eve/docs/.

43k15d agoDiscuss
LangChainAGENTS.md

langgraph

langchain-ai/langgraph/AGENTS.md

This repository is a monorepo. Each library lives in a subdirectory under libs/. When Corridor's analyzePlan tool is available, create a plan and use the tool to analyze it before generating or modifying code. Apply the resulting security guidance before writing code. When you modify code in any library, run the following commands in that library's directory before creating a pull request: To run a particular test file or to pass additional pytest options you can specify the TEST variable:

42k38d agoDiscuss
PostHogAGENTS.md

posthog

PostHog/posthog/AGENTS.md

- Environment: - This is a full dev environment with node, pnpm, a package mirror and apt. A missing nodemodules, browser binary or flox means setup has not run yet…

40k6d agoDiscuss
PostHogAGENTS.md

posthog / common

PostHog/posthog/common/AGENTS.md

common/ is a transitional holding pen, not a destination. It holds shared code that predates a better home. Do not treat it as the default place for new shared code.

40k6d agoDiscuss
PostHogAGENTS.md

posthog / proto

PostHog/posthog/proto/AGENTS.md

When you add or modify an RPC or message type in personhog/ protos, you must update all downstream consumers before considering the change complete: Then update: Then update: No codegen…

40k6d agoDiscuss
PostHogAGENTS.md

posthog / rust

PostHog/posthog/rust/AGENTS.md

When emitting metrics via the metrics crate (histogram!, counter!, gauge!), dynamic label values (method names, client names, etc.) must use Arc<str>, never String or .to_string().

40k6d agoDiscuss
GitHubAGENTS.md

awesome-copilot

github/awesome-copilot/AGENTS.md

The Awesome GitHub Copilot repository is a community-driven collection of custom agents and instructions designed to enhance GitHub Copilot experiences across various domains, languages, and use cases. The project includes: All agent files (.agent.md) and instruction files (.instructions.md) must include proper markdown front matter. Agent Skills are folders containing a SKILL.md file with frontmatter and optional bundled assets. Hooks are folders containing a README.md with frontmatter and a hooks.json configuration file:

39k8d agoDiscuss
GitHubAGENTS.md

awesome-copilot / templates

github/awesome-copilot/skills/repo-standardizer/templates/AGENTS.md

Telegraph style. Root rules only. Guidance for AI coding agents (Claude Code, Cursor, Copilot, OpenClaw, etc.) working in this repository.

39k8d agoDiscuss
GitHubAGENTS.md

awesome-copilot / templates

github/awesome-copilot/skills/setup-my-iq/assets/templates/AGENTS.md

These pointers tell agents where the user's personal context files live. Read only the file(s) needed to answer a question; do not load all of them by default. Run the setup-my-iq skill to populate these context files (or fill them in manually). Once they exist, update each @<path> pointer below to reference the real location. - identityProfile — name, role, org, team, manager, what the user does, what people come to them for. @<CONTEXT_DIR>/identity.md - roleAndResponsibilities — responsibilities per team,…

39k8d agoDiscuss
DockerAGENTS.md

compose

docker/compose/AGENTS.md

- Build: make build - Test all: make test - Test unit: go test ./pkg/... — needs no Docker daemon; the e2e suite is gated behind the e2e build tag and is not picked up - Test single: go test ./pkg/compose/ -run TestFunctionName - E2E tests: go test -tags e2e ./pkg/e2e/ -run TestName — requires a Docker daemon and the locally built binary (make build) - New e2e tests use the declarative Scenario DSL (NewScenario in pkg/e2e/scenario.go): intent, inline compose…

38k35d agoDiscuss
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.