AGENTS.md examples from real projects

addyosmaniAGENTS.md

agent-skills

addyosmani/agent-skills/docs/agents.md

axis review before merge | | [security-auditor](../agents/security-auditor.md) | Security Engineer | Vulnerability detection, OWASP-style audit | | [test-engineer](../agents/test-engineer.md) | QA Engineer | Test strategy, coverage analysis, Prove-It pattern | | [web-performance-auditor](../agents/web-performance-auditor.md

papers-we-loveAGENTS.md

papers-we-love

papers-we-love/papers-we-love/AGENTS.md

This is not an application project: there is no package manager, build, or unit-test suite. ## Layout - The root `README.md` explains the collection and points contributors to the project policies

No other project uses it yet

fatedierAGENTS.md

frp

fatedier/frp/AGENTS.md

binary only - `make frpc` - Build client binary only - `make all` - Build everything with formatting ### Testing - `make test` - Run unit tests - `make e2e` - Run end-to-end tests - `make e2e-trace

No other project uses it yet

axiosAGENTS.md

axios

axios/axios/AGENTS.md

bundles). - Lint source only: `npm run lint`; focused lint: `npx eslint lib/path/to/file.js`. - Unit tests: `npm run test:vitest:unit`; focused unit test: `npm run test:vitest:unit -- tests/unit/path.test.js`. - Browser tests

No other project uses it yet

MicrosoftAGENTS.md

terminal

microsoft/terminal/AGENTS.md

contributor must personally read and understand the complete change, run and inspect the relevant tests and/or test the application itself. For UI- and larger changes, it is typically required

No other project uses it yet

debpalashAGENTS.md

OmniVoice-Studio

debpalash/OmniVoice-Studio/AGENTS.md

shared by Electron; they are not a runnable app. New UI, IPC, setup instructions, tests, and browser assets belong in Electron; validate Electron on macOS, Windows and Linux. ## Mobile: native

angularAGENTS.md

angular

angular/angular/AGENTS.md

agents working in this repository. ## Environment - Use `pnpm` for package management. - Use `pnpm bazel test //target` to run tests. ## Key Documentation - [Building and Testing](contributing-docs/building-and-testing-angular.md): definitive guide

No other project uses it yet

ant-designAGENTS.md

ant-design

ant-design/ant-design/AGENTS.md

component-name/ # 单个组件目录 │ │ ├── ComponentName.tsx # 主组件实现 │ │ ├── demo/ # 演示代码（*.tsx 和 *.md） │ │ ├── style/ # 样式系统（index.ts / token.ts） │ │ ├── __tests__/ # 单元测试 │ │ ├── index.en-US.md # 英文文档 │ │ ├── index.zh-CN.md # 中文文档 │ │ └── index.tsx # 导出入口 │ ├── _util/ # 共享工具函数库 │ ├── theme/ # 主题系统 │ └── locale/ # 国际化文本 ├── tests/ # 测试工具和共享测试

No other project uses it yet

MicrosoftAGENTS.md

playwright

microsoft/playwright/AGENTS.md

Purpose | |---------|----------|---------| | `playwright-core` | `playwright-core` | Browser automation engine: client, server, dispatchers, protocol | | `playwright` | `playwright` | Test runner + browser automation (public package) | | `playwright-test` | `@playwright/test` | Test runner entry point | | `playwright-client` | `@playwright/client

No other project uses it yet

muiAGENTS.md

material-ui

mui/material-ui/AGENTS.md

pnpm release:build # Build all packages (except docs) pnpm docs:build # Build documentation site ``` ### Testing ```bash pnpm test:unit # Run all unit tests (jsdom) pnpm test:unit ComponentName # Run tests

No other project uses it yet

localsendAGENTS.md

localsend

localsend/localsend/AGENTS.md

lower layers. Use `dart:io.Platform` for OS-specific native APIs: with the `FLUTTER_TEST` environment variable and assertions enabled, `defaultTargetPlatform` is set to Android regardless of the actual OS (unless

No other project uses it yet

vllm-projectPipes a download into a shellAGENTS.md

vllm

vllm-project/vllm/AGENTS.md

submitting human must review every changed line and run relevant tests. - PR descriptions for AI-assisted work **must** include: - Why this is not duplicating an existing PR. - Test commands

vllm-projectAGENTS.md

vllm / rust

vllm-project/vllm/rust/AGENTS.md

official chat templates and real generation produce. Handcrafted malformed inputs are fine for robustness tests but are not regressions without a real trigger. - When writing parsers with `winnow`: - Prefer

vllm-projectAGENTS.md

vllm / tests

vllm-project/vllm/tests/AGENTS.md

tests - **Test real objects on the lightest real path.** Construct vLLM objects with their real constructors; do not stand them in with `SimpleNamespace` or `MagicMock`, set private attributes, or patch

nexu-ioAGENTS.md

open-design / apps

nexu-io/open-design/apps/AGENTS.md

behavior to `apps/desktop`. ## Daemon layout - `apps/daemon/src/` contains only daemon app source. - `apps/daemon/tests/` contains daemon tests. - `apps/daemon/src/sidecar/` contains the daemon sidecar entry. - CLI/agent argument definition changes belong in `apps/daemon/src/runtimes/defs/`; stdout parser

No other project uses it yet

nexu-ioAGENTS.md

open-design

nexu-io/open-design/.github/AGENTS.md

fork PR approval behavior If the change affects cross-workflow behavior, update the topology tests instead of relying only on workflow YAML review. ## Architecture GitHub automation uses two layers. Business

No other project uses it yet

nexu-ioAGENTS.md

open-design / packages

nexu-io/open-design/packages/AGENTS.md

runtime code goes in `sidecar`; generic OS/process code goes in `platform`. ## Boundary checklist - Package tests live in each package's `tests/` directory, sibling to `src/`; keep `src/` source-only

No other project uses it yet

nexu-ioAGENTS.md

open-design / shells

nexu-io/open-design/shells/AGENTS.md

Shell-specific environment variables, workflow contexts, and storage credentials must not enter package contracts. - Tests live in `shells/ /tests`, sibling

No other project uses it yet

nexu-ioAGENTS.md

open-design / tools

nexu-io/open-design/tools/AGENTS.md

source packages and `pnpm tools-pack ...` for packaged artifact build/install/release flows. ## Orchestration boundary - Tool tests live in each tool's `tests/` directory, sibling to `src/`; keep `src/` source-only

No other project uses it yet

nvm-shAGENTS.md

nvm

nvm-sh/nvm/AGENTS.md

with specific Node.js versions - **Bash completion**: `bash_completion` - Provides tab completion for bash users - **Tests**: Comprehensive test suite in `test/` directory using the [urchin](https://www.npmjs.com/package/urchin) test framework

No other project uses it yet