AGENTS.md examples from real projects

BlockAGENTS.md

goose

block/goose/AGENTS.md

goose is an AI agent framework in Rust with CLI and Electron desktop interfaces. The issue is the source of truth for work intended for an upstream pull request. Track issue status on the Goose Issues board. Maintainer-directed work, urgent security fixes, release automation, and local or exploratory changes do not require a Ready issue. goose is retiring its project-specific MCP server directory in favor of the official MCP Registry and its server.json format. See Discussion #10830 for the decision…

BlockAGENTS.md

goose / documentation

block/goose/documentation/AGENTS.md

IMPORTANT: The product name "goose" should ALWAYS be written in lowercase "g" in all documentation, blog posts, and any content within this documentation directory. This is a brand guideline that must be strictly followed. This rule applies to: - All markdown files in /docs/ - All blog posts in /blog/ - README files - Configuration files with user-facing text - Any other documentation content When editing or creating content in this documentation directory, always ensure "goose" uses a lowercase "g".

JetBrainsAGENTS.md

kotlin

JetBrains/kotlin/AGENTS.md

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

No other project uses it yet

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…

No other project uses it yet

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.

No other project uses it yet

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 (ruff_python_parser) and AST definitions (ruff_python_ast). 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…

No other project uses it yet

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. Use the technical-writer skill (.agents/skills/technical-writer/SKILL.md) when you write or edit prose for this repo, including docs pages, READMEs, changelog entries, commit messages, PR descriptions, and issues.

No other project uses it yet

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/.

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…

No other project uses it yet

SentryAGENTS.md

sentry / src

getsentry/sentry/src/AGENTS.md

For setup, lint, and test 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…

No other project uses it yet

SentryAGENTS.md

sentry / action_log

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

Action log entries are kept effectively forever and are never migrated. Read the GroupAction docstring in types.py before adding or changing a GroupAction subclass.

No other project uses it yet

SentryAGENTS.md

sentry / derived

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

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

No other project uses it yet

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. - Routes defined in static/app/router/routes.tsx - Builds, tests, and typechecks use React…

No other project uses it yet

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),…

No other project uses it yet

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:

No other project uses it yet

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: Frontmatter must be valid YAML and meet the metadata…

No other project uses it yet

GitHubAGENTS.md

awesome-copilot / improve-history

github/awesome-copilot/skills/foundry-agentic-loop/evals/fixtures/improve-history/AGENTS.md

This workspace is built with spec-driven development. For build requests and the short commands below, load the foundry-agentic-loop skill and follow its references/sdd.md; it checks the live run first and resumes a running or paused run instead of starting a second one. - The spec and contract live in docs/spec.md, lessons in docs/LOOP.md and Azure settings only in .azure/deployment-plan.md, never here. - This section locks the build mode. Change it only when the user explicitly confirms a switch. <!-- foundry-agentic-loop:end…

No other project uses it yet

GitHubAGENTS.md

awesome-copilot / rapid-locked

github/awesome-copilot/skills/foundry-agentic-loop/evals/fixtures/rapid-locked/AGENTS.md

Team conventions: Python formatted with ruff, TypeScript with prettier. This workspace is a rapid prototype in an existing Foundry project. For build requests, load the foundry-agentic-loop skill and follow its references/rapid.md. Short commands: - The contract lives in the root README.md, lessons in docs/LOOP.md and Azure settings only in .azure/deployment-plan.md, never here. - This section locks the build mode. Change it only when the user explicitly confirms a switch. <!-- foundry-agentic-loop:end -->

No other project uses it yet

GitHubAGENTS.md

awesome-copilot / team-conventions

github/awesome-copilot/skills/foundry-agentic-loop/evals/fixtures/team-conventions/AGENTS.md

No summary in the file. Open it to read it.

No other project uses it yet

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.