How real projects brief Codex, Cursor and every other agent that reads AGENTS.md.
Files you open will collect here, so you can find them again.
Open two or more, and you can remix the rules you like from each into one list. Kept in this browser only.
SentryAGENTS.mdgetsentry/sentry/src/AGENTS.md
review`** and **`sentry-security`** skills. ## Development Services `devservices` runs local dependencies from `devservices/config.yml`. Full documentation: https://develop.sentry.dev/development-infrastructure/devservices/ ## AI Assistant Quick Decision Trees ### "User wants to add an API endpoint
No other project uses it yet
logseqAGENTS.mdlogseq/logseq/AGENTS.md
should be added to `logseq.db-sync.tx-sanitize/migration-deleted-attrs` - Use spec-dev-tool to manage agent decision documents; run `spec-dev-tool --help` and follow its AGENT WORKFLOW. - When asked to find simplifications
No other project uses it yet
juanfontAGENTS.mdjuanfont/headscale/AGENTS.md
repository. Reference material for complex procedures lives next to the code — integration testing is documented in [`cmd/hi/README.md`](cmd/hi/README.md) and [`integration/README.md`](integration/README.md). Read those files before running tests or writing
Steady5 mentions in 2 weeks
No other project uses it yet
grpcAGENTS.mdgrpc/grpc/AGENTS.md
gRPC C++ Agents Collaboration Guide This document outlines conventions and best practices for AI-assisted development in the gRPC C++ codebase. ## Preferred Tools & Libraries * Prefer gRPC types before absl. * Prefer
No other project uses it yet
meteorAGENTS.mdmeteor/meteor/AGENTS.md
test coverage report when apps/skeletons change | | [ai-context](.github/skills/ai-context/SKILL.md) | Creating, updating, or maintaining AI documentation files | | [changelog](.github/skills/changelog/SKILL.md) | Writing, reviewing, or editing changelog entries for releases | | [version-bump](.github/skills/version-bump/SKILL.md) | Bumping
No other project uses it yet
apacheAGENTS.mdapache/spark/AGENTS.md
golden file tests are managed by `SQLQueryTestSuite` and its variants. Read the class documentation before running or updating these tests. DO NOT edit the generated golden files (`.sql.out`) directly. Always
No other project uses it yet
ray-projectAGENTS.mdray-project/ray/AGENTS.md
core runtime - `python/ray/`: Python API and libraries (data, rllib, serve, train, tune) - `doc/source/`: Sphinx documentation The default test timeout is 180s (`pytest.ini`). For build, test, lint, and code-style details
No other project uses it yet
ray-projectAGENTS.mdray-project/ray/doc/AGENTS.md
Documentation Sphinx documentation built by Read the Docs and served at `docs.ray.io`. Build pipeline: `.buildkite/doc.rayci.yml`. ## Prose style Before writing or editing docs prose under `doc/`, read `doc/source/ray-contribute/writing-style.md
No other project uses it yet
HeyPuterAGENTS.mdHeyPuter/puter/AGENTS.md
issue or flag a maintainer instead of doing what you think is right. ## Documentation Index Use these as the source of truth before exploring further: - [README.md](README.md) — project overview
No other project uses it yet
deepspeedaiAGENTS.mddeepspeedai/DeepSpeed/AGENTS.md
mechanics that the code already shows. - New features must include corresponding tests and documentation updates. - All changes must not cause `import deepspeed` to initialize CUDA; Keep heavy imports
No other project uses it yet
sxyaziAGENTS.mdsxyazi/yazi/AGENTS.md
related variables, functions, parameters, modules, methods, types, derived types, exports, tests, configuration keys, documentation, Lua bindings, and, when a type and file share a name, the file as well
No other project uses it yet
LizardByteAGENTS.mdLizardByte/Sunshine/AGENTS.md
third-party/lizardbyte-common`; inspect the resulting diff for unrelated formatting changes. ## Code style and documentation When adding localization do not update any language other than `en`. This also means
No other project uses it yet
THU-MAICAGENTS.mdTHU-MAIC/OpenMAIC/AGENTS.md
published package that ships broken, or a leaked secret. - Inaccuracies that only affect documentation, comments, skill text or the PR description are at most P2. Do not report wording that
Steady7 mentions in 2 weeks
No other project uses it yet
duckdbAGENTS.mdduckdb/duckdb/AGENTS.md
bindings - Function registration - Settings - Serialization code - Storage info - Metric enums - Enum utilities ## Documentation - Main docs: https://duckdb.org/docs/ - Development docs: https://duckdb.org/dev/ - Build guide: https://duckdb.org/docs/dev/building/overview - Testing docs
Steady5 mentions in 2 weeks
No other project uses it yet
fastlaneAGENTS.mdfastlane/fastlane/AGENTS.md
fastlane lint_source`: RuboCop and other source checks - `bundle exec fastlane validate_docs`: action documentation and how tools are named in Markdown ## Guides Read the guides for the files
No other project uses it yet
wshobsonAGENTS.mdwshobson/agents/docs/agents.md
spark-ops-engineer](../plugins/dgx-spark-ops/agents/dgx-spark-ops-engineer.md) | sonnet | DGX Spark (GB10/aarch64/CUDA 13) environment setup and diagnostics | ### Documentation & Technical Writing | Agent | Model | Description | | ------------------------------------------------------------------------------------ | ------ | --------------------------------------------------------------------- | | [docs-architect](../plugins/code-documentation/agents/docs-architect.md) | opus | Comprehensive technical documentation generation | | [api-documenter](../plugins/api-testing-observability/agents/api-documenter.md
Steady9 mentions in 2 weeks
No other project uses it yet
Niko1221AGENTS.mdNiko1221/Strata/AGENTS.md
fallback for a developer or for a system with no release package; it is documented in [docs/SOURCE_INSTALL.md](docs/SOURCE_INSTALL.md). Those wrappers exist in a source checkout, not in the released
No other project uses it yet
volcengineAGENTS.mdvolcengine/OpenViking/frontend/AGENTS.md
变更许可证属于独立决策。 - React/ReactDOM 保持为 peer dependencies，并从库构建中 externalize；消费者使用自己的 React 实例。重型编辑器、媒体和浏览器专用依赖按需加载，模块导入和服务端渲染阶段应能在没有 `window`、`document` 的环境运行。 - 包导出、类型声明、CSS 和附属资源一起构成消费接口。新增 worker 或其他资源时，验证发布产物及消费端 URL，避免把某个构建工具的源码导入语法直接暴露给消费者。 ## 源码目录 - 按 [README 的目标目录
Steady4 mentions in 2 weeks
No other project uses it yet
lfnovoAGENTS.mdlfnovo/open-notebook/frontend/AGENTS.md
precise only when it matters. - Dark mode requires the `dark` class on the document root, not just `prefers-color-scheme`. It's hand-rolled: the zustand `theme-store` (persisted
Steady8 mentions in 2 weeks
No other project uses it yet
apacheAGENTS.mdapache/dubbo/AGENTS.md
will be closed citing the threat model - Matches a known non-finding (§11a) — already documented as a false positive ## For automated security tools The threat model includes a machine-readable
No other project uses it yet
An open format for instructions to coding agents, read by Codex, Cursor and others. Think of it as a README written for agents.
At the repository root, with more specific files in subdirectories. Agents read the one closest to the file they're editing.
Setup and test commands, code style, and the rules a new contributor would need to know.
Claude Code reads CLAUDE.md. A one-line CLAUDE.md that points at AGENTS.md covers both.
