AGENTS.md examples from real projects

BerriAIAGENTS.md

litellm / litellm-rust

BerriAI/litellm/litellm-rust/AGENTS.md

only delegates, and spell each variant with explicit `#[strum(serialize = "...")]` instead of `serialize_all` ## Test placement - Never create a `tests.rs` (or `test.rs`) file under `src/`, and never `#[path = "tests.rs

No other project uses it yet

BerriAIAGENTS.md

litellm / tests

BerriAI/litellm/tests/AGENTS.md

Tests Nothing on the other side of the call: `tests/unit`. A proxy we start with an upstream we script: `tests/integration`. Someone else's service with real credentials: `tests/e2e`. Tests

No other project uses it yet

tw93AGENTS.md

Pake

tw93/Pake/AGENTS.md

pake skill) ├── llms.txt # Agent-facing contract summary (--json, --config, exit codes) ├── scripts/ # Utility scripts ├── tests/ # Unit, integration, and release-flow tests ├── .github/workflows/ # quality/test and release automation ├── default_app_list.json # Popular apps config

No other project uses it yet

penpotAGENTS.md

penpot

penpot/penpot/AGENTS.md

workflow/updating-changelog` (the `update-changelog` skill flow) or on explicit user request. - **Never pipe test output directly to filters** (`| head`, `| tail`, `| grep`, etc.). Always redirect to a file first: `command > /tmp/output.txt

No other project uses it yet

makeplaneReads credentialsAGENTS.md

plane

makeplane/plane/AGENTS.md

proper error types, log errors appropriately - **State Management**: MobX stores in `packages/shared-state`, reactive patterns - **Testing**: All features require unit tests, use existing test framework per package - **Components**: Primitives come from

No other project uses it yet

chen08209AGENTS.md

FlClash

chen08209/FlClash/AGENTS.md

agents/project.md): project overview, versions, and build dependencies. - [.agents/commands.md](.agents/commands.md): build, development, code generation, and test commands. - [.agents/rules.md](.agents/rules.md): lint, testing, generated-code, and workflow rules. Read these only when

No other project uses it yet

pi-holeAGENTS.md

pi-hole

pi-hole/pi-hole/AGENTS.md

assets installed onto the system - `gravity.sh` - builds `gravity.db` from configured blocklists - `manpages/` - man pages - `test/` - BATS test suite, run inside distro-specific Docker containers ## Dev environment tips - You need Docker

No other project uses it yet

rcloneAGENTS.md

rclone

rclone/rclone/AGENTS.md

that you, the human submitter, understand every line you propose and have compiled and tested it against real rclone code - not just generated it. See the "AI-assisted contributions" section

No other project uses it yet

crewAIIncAGENTS.md

crewAI

crewAIInc/crewAI/AGENTS.md

practices and idiomatic patterns. 2. Maintain existing code structure and organization. 3. Write unit tests for new functionality focusing on behaivor and not implementation. 4. Document public APIs and complex

No other project uses it yet

spring-projectsAGENTS.md

spring-framework

spring-projects/spring-framework/AGENTS.md

artifacts target Java 17+. - Scope builds to the modules you touched: `./gradlew :spring-webmvc:test`, a single test with `--tests `. - Run `./gradlew : :check` before finishing: it runs tests and Checkstyle

No other project uses it yet

coreyhaines31AGENTS.md

marketingskills

coreyhaines31/marketingskills/AGENTS.md

integration guides per tool │ └── REGISTRY.md # Tool index with capabilities ├── CONTRIBUTING.md ├── LICENSE └── README.md ``` ## Build / Lint / Test Commands **Skills** are content-only (no build step). Verify manually: - YAML frontmatter is valid - `name

No other project uses it yet

railsAGENTS.md

rails

rails/rails/AGENTS.md

them should not break others unless there's an explicit dependency. ## Testing Commands ### Running Tests in a Component From within the component directory (preferred method): ```bash cd actionview && bin/test

No other project uses it yet

go-giteaAGENTS.md

gitea

go-gitea/gitea/AGENTS.md

guidelines-backend.md` for Go, `guidelines-frontend.md` for TS, CSS and Vue, both for templates, `testing.md` for tests, `development.md` for config options and migrations, `guidelines-refactoring.md` for refactors - Before designing a feature or behavior

No other project uses it yet

ultralyticsAGENTS.md

yolov5

ultralytics/yolov5/AGENTS.md

solution. Avoid impossible-state handling, speculative flags, compatibility shims, policy scaffolding, and unrelated cleanup. Tests are out of scope by default — rely on existing coverage and focused validation; only

No other project uses it yet

router-for-meReads credentialsAGENTS.md

CLIProxyAPI

router-for-me/CLIProxyAPI/AGENTS.md

build -o cli-proxy-api ./cmd/server # Build go run ./cmd/server # Run dev server go test ./... # Run all tests go test -v -run TestName ./path/to/pkg # Run single test go build

appwriteAGENTS.md

appwrite

appwrite/appwrite/AGENTS.md

Start per-queue worker and scheduler containers instead | | `docker compose exec appwrite test tests/e2e/Services/[Service]` | Run E2E tests for a service | | `docker compose exec appwrite test tests/e2e/Services/[Service] --filter=[Method

No other project uses it yet

FuelLabsAGENTS.md

fuel-core

FuelLabs/fuel-core/AGENTS.md

enforces warnings as errors. ## Commands (matrix) | Step | Command | | :--- | :--- | | Setup | `cargo fetch` | | Build | `cargo build` | | Test | `cargo test` | | **Format (required)** | `cargo +nightly-2025-09-28 fmt --all` then `-- --check` | | Lint | `cargo

No other project uses it yet

ayghriAGENTS.md

i-have-adhd

ayghri/i-have-adhd/AGENTS.md

plugin metadata. | | Documentation | `README.md`, `INSTALL.md`, `.github/readme/`, `.github/install/` | User-facing overview, installation, and translations. | | Verification | `tests/`, `scripts/` | Unit tests, compatibility checks, and evaluation tooling. | | Contribution workflow | `CONTRIBUTING.md`, `.github/pull_request_template.md` | Authorship, labels, safety

remix-runDeletes or force-pushesAGENTS.md

react-router

remix-run/react-router/AGENTS.md

Guide ## Commands - **Build**: `pnpm build` (all packages) or `pnpm run --filter build` (single package) - **Test (Jest)**: `pnpm test` (all packages), `pnpm test packages/ /` (single package), `pnpm test packages/react-router/__tests__/router/fetchers-test.ts` (single file

No other project uses it yet

HKUDSReads credentialsAGENTS.md

DeepTutor

HKUDS/DeepTutor/AGENTS.md

encryption python scripts/install_extras.py math-animator # Manim; also needs system LaTeX/ffmpeg python scripts/install_extras.py dev # Test / lint tooling python scripts/install_extras.py all # Full + Manim + dev dependencies ``` Stop DeepTutor before module changes. Source supports

No other project uses it yet