AGENTS.md examples from real projects

HomebrewAGENTS.md

brew

Homebrew/brew/docs/AGENTS.md

exec rake lint` - `HOMEBREW_NO_AUTO_UPDATE=1 brew bundle exec bundle exec rake test` Also run these from the repository root when docs content changes: - `rg --files docs

No other project uses it yet

mudlerAGENTS.md

LocalAI

mudler/LocalAI/AGENTS.md

AGENT_NAME:MODEL_VERSION [TOOL1] [TOOL2]`. - **The human submitter is responsible** for reviewing, testing, and understanding every line of generated code. ## Topics | File | When to read | |------|-------------| | [.agents/ai-coding-assistants.md](.agents/ai-coding-assistants.md) | Policy

No other project uses it yet

metabaseAGENTS.md

metabase

metabase/metabase/AGENTS.md

clojure-mcp tools - **[clojure-eval](.claude/skills/clojure-eval/SKILL.md)** - Always use this to evaluate Clojure code, **run tests**, and verify edits/compile. Prefer this over shell commands. - **[clojure-write](.claude/skills/clojure-write/SKILL.md)** - Clojure/ClojureScript development with REPL

No other project uses it yet

metabaseAGENTS.md

metabase / frontend

metabase/metabase/frontend/AGENTS.md

Enterprise embedding code: `enterprise/frontend/src/embedding`, `enterprise/frontend/src/embedding-sdk-ee`, and `enterprise/frontend/src/embedding-sdk-package` - Custom visualization enterprise code: `enterprise/frontend/src/custom-viz` - Jest unit tests: colocated next to the files they test - Jest test support and mocks: `frontend/test` - Cypress

No other project uses it yet

HKUDSAGENTS.md

nanobot

HKUDS/nanobot/AGENTS.md

clients. ## Task-specific guidance | When working on | Read | | --- | --- | | Finding the owning code and focused tests | [`.agent/navigation.md`](.agent/navigation.md) | | Core boundaries, extensions, or internal types | [`.agent/design.md`](.agent/design.md) | | Refactoring, fallbacks, or test selection

No other project uses it yet

alibabaAGENTS.md

open-code-review

alibaba/open-code-review/AGENTS.md

generated files with the registry change; do not edit them by hand: - `extensions/frontend/src/shared/providers.generated.ts` - `extensions/idea/src/main/kotlin/com/alibaba/opencodereview/idea/services/ProviderNames.generated.kt` ## Testing - Run unit tests with `make test`, not `go test` directly. - `make test` sets

No other project uses it yet

JuliaLangAGENTS.md

julia

JuliaLang/julia/AGENTS.md

Clang static analysis checks — see the `c-static-analysis` skill ([`doc/src/devdocs/agents/skills/c-static-analysis/`](doc/src/devdocs/agents/skills/c-static-analysis/SKILL.md)). ### Testing LLVM-related changes When making changes to LLVM passes or codegen, add `LLVM_ASSERTIONS=1` to `Make.user

No other project uses it yet

exo-exploreAGENTS.md

exo

exo-explore/exo/AGENTS.md

with verbose logging uv run exo -v # or -vv for more verbose # Run tests (excludes slow and cluster tests by default) uv run pytest # Run the fast cluster scenarios (real

No other project uses it yet

discourseAGENTS.md

discourse / migrations

discourse/discourse/migrations/AGENTS.md

layout and namespaces, the `disco` CLI, converters, the schema DSL, and the install / test / lint workflow. This file is reserved for **agent-specific** guidance that does not belong

No other project uses it yet

gogsAGENTS.md

gogs

gogs/gogs/AGENTS.md

Coding guidelines - Use `github.com/cockroachdb/errors` for error handling. - Use `github.com/stretchr/testify` for assertions in tests. Be mindful about the choice of `require` and `assert`, the former should be used when

No other project uses it yet

momentAGENTS.md

moment

moment/moment/AGENTS.md

under `src/`. Core behavior is split across `src/lib`, while locale definitions live in `src/locale`. Tests mirror that distinction under `src/test/moment` and `src/test/locale`. Add regression coverage near the behavior being changed

No other project uses it yet

prismaAGENTS.md

orm

prisma/orm/AGENTS.md

organized and what to read next - [Architecture Overview](docs/Architecture%20Overview.md) — High-level design principles - [Testing Guide](docs/Testing%20Guide.md) — Philosophy, patterns, and commands - [Rules Index](.agents/rules/README.md) — All agent rules organized

apacheAGENTS.md

airflow

apache/airflow/AGENTS.md

identifiers like `dag_id`, `dag`, `my_dag`. - CLI: `airflow dags list`, `airflow dags test`, etc. - Paths and config keys: `dag_processing/`, `dagprocessor`, `get_dag`, etc. - Anti-pattern quotes that show

No other project uses it yet

apacheAGENTS.md

airflow

apache/airflow/.github/AGENTS.md

minutes they take. The numbers live in `dev/breeze/src/airflow_breeze/utils/ci_minutes_estimate.py` and are medians measured on recent `Tests (AMD)` PR runs on public runners. After you change the CI workflows

No other project uses it yet

apacheAGENTS.md

airflow / providers

apache/airflow/providers/AGENTS.md

Providers — Agent Instructions Each provider is an independent package with its own `pyproject.toml`, tests, and documentation. ## Structure - `provider.yaml` — metadata, dependencies, and configuration for the provider. - Building blocks: Hooks, Operators, Sensors

No other project uses it yet

apacheAGENTS.md

airflow / registry

apache/airflow/registry/AGENTS.md

semantic CSS** using cascade pattern 3. **Add light/dark mode styles** for all elements 4. **Test responsiveness** across different screen sizes 5. **Verify consistency** with existing design system ### Common Issues - **Colors

ogulcancelikAGENTS.md

herdr

ogulcancelik/herdr/AGENTS.md

both background-workspace and active-pane cardinality when applicable. Prefer deterministic operation or architecture tests to wall-clock CI limits. Performance benchmarks are supporting evidence, not substitutes for behavioral coverage

VercelAGENTS.md

agent-browser

vercel-labs/agent-browser/AGENTS.md

tool, add one or document why it is intentionally omitted. Add or update tests that prove the CLI and MCP surfaces remain aligned. In the `docs/content/docs/` MDX files, always

No other project uses it yet

siyuan-noteAGENTS.md

siyuan

siyuan-note/siyuan/AGENTS.md

checks, ESLint automatic fixes, and CSS, menu, and startup-language checks, but not behavioral tests. Review the resulting diff and keep fixes within the task scope without overwriting existing work

No other project uses it yet

cliAGENTS.md

cli

cli/cli/AGENTS.md

helpers and existing API, Git, configuration, and I/O abstractions before adding new ones. - Ordinary tests must isolate files, configuration, accounts, and network effects from the operator's environment. **Acceptance tests

No other project uses it yet