AGENTS.md examples from real projects

apacheAGENTS.md

superset

apache/superset/AGENTS.md

styles** - Follow antd best practices and avoid styling and custom CSS whenever possible ### Testing Strategy Migration - **Prefer unit tests** over integration tests - **Prefer integration tests** over end-to-end tests

tw93Deletes or force-pushesAGENTS.md

Mole

tw93/Mole/AGENTS.md

keeps its invariant, scope and why, plus the failure mechanism, measured numbers, counterexamples, locked test names and rejected alternatives; incident stories live in `.claude/skills/bugs/references/` and `.claude/skills/release-flow/SKILL.md`. An area rule goes

Fission-AIAGENTS.md

OpenSpec / test

Fission-AI/OpenSpec/test/AGENTS.md

OpenSpec Test Guidance Applies to tests under `test/`. ## Running Tests - Focused file: `pnpm exec vitest run test/path/to/file.test.ts` - Focused case: `pnpm exec vitest run test/path/to/file.test.ts -t "case name"` - Full suite: `pnpm

strapiAGENTS.md

strapi

strapi/strapi/AGENTS.md

production fixes docs/ # Contributor docs site (contributor.strapi.io); package docs mirror packages/ under docs/docs/packages/ tests/ # Integration, E2E, and CLI test infrastructure tests-next/ # New test suites being built (Test Infrastructure Overhaul

No other project uses it yet

strapiAGENTS.md

strapi

strapi/strapi/docs/AGENTS.md

page. Use the [`contributor-docs` skill](../.ai/skills/contributor-docs/SKILL.md) for the procedure. ## Layout ``` docs/docs/contributing/ # how-to: testing, conventions, writing docs docs/docs/architecture/ # explanations that cross packages docs/docs/packages/ # one folder per package, mirrors packages

No other project uses it yet

remotion-devAGENTS.md

remotion

remotion-dev/remotion/AGENTS.md

Install dependencies (uses Bun) bun install # Build all packages bunx turbo run make # Run tests and linting bunx turbo run lint test # Clean build artifacts bun run clean # Build

nektosReads credentialsAGENTS.md

act

nektos/act/AGENTS.md

line in `go.mod` (currently 1.26.0). ## Commands - `make build` — build the binary to `dist/local/act` - `make test` — `go test ./...`, then run the act CLI against a sample workflow (needs a Docker daemon

No other project uses it yet

ZhuLinsenReads credentialsAGENTS.md

daily_stock_analysis

ZhuLinsen/daily_stock_analysis/AGENTS.md

类型>: <修改内容>` 作为 PR 标题，例如 `fix: 修复大盘分析历史记录丢失`，优先类型为 `fix`/`feat`/`refactor`/`docs`/`chore`/`test`/`ci`。 - 标题应描述实际变更内容，建议不添加 `[codex]`、`codex`、`autocode`、`copilot` 或其他工具/agent 来源前缀。 - 该规范仅用于协作可读性与一致性提示，不应单独作为 review process blocker

No other project uses it yet

hakimelAGENTS.md

reveal.js / react

hakimel/reveal.js/react/AGENTS.md

react/src/index.ts`. - Shared types live in `react/src/types.ts`. - The Reveal instance context lives in `react/src/reveal-context.ts`. - Component tests are colocated with their components as `*.test.tsx`. - Test setup remains in `react/src/__tests__/setup.ts`. - The demo

No other project uses it yet

mobyAGENTS.md

moby

moby/moby/AGENTS.md

opening pull requests. It is the source of truth for contribution scope, coding style, testing, commits, DCO sign-off, review, AI usage, and release notes. # Pull requests When opening

No other project uses it yet

protocolbuffersAGENTS.md

protobuf

protocolbuffers/protobuf/AGENTS.md

must explain *what* changes and *why* ([Writing good PR descriptions](https://google.github.io/eng-practices/review/developer/cl-descriptions.html)). - **Meaningful tests**: Behavior changes need tests that would fail if the change were broken, including edge cases

ClineReads credentialsAGENTS.md

cline

cline/cline/AGENTS.md

ANTHROPIC_API_KEY`, `CLINE_API_KEY`, `OPENROUTER_API_KEY`); see `apps/cli/README.md`. ### Build / Lint / test - SDK packages (`@cline/shared|llms|agents|core|sdk`) resolve each other through compiled `dist/` (their `exports` point

No other project uses it yet

ClineAGENTS.md

cline / sdk

cline/cline/sdk/AGENTS.md

Development reference for the Cline SDK workspace.

No other project uses it yet

ClineAGENTS.md

cline / llms

cline/cline/sdk/packages/llms/AGENTS.md

Development guidance for the @cline/llms package.

No other project uses it yet

ansibleAGENTS.md

ansible

ansible/ansible/AGENTS.md

project. ## General Principles When reviewing code, don't flag issues that `ansible-test sanity` already catches. Focus review effort on things automated checks can't verify. ## Attribution Agents should disclose

No other project uses it yet

code-yeongyuAGENTS.md

oh-my-openagent

code-yeongyu/oh-my-openagent/.agents/AGENTS.md

isolated `CODEX_HOME` + local mock model, hook-fired assertions; helper scripts each ship `--self-test` | | `opencode-qa/` | no | opencode CLI/TUI/event-stream QA: hook-fired assertions via SSE, session DB inspection, tmux

code-yeongyuReads credentialsAGENTS.md

oh-my-openagent

code-yeongyu/oh-my-openagent/AGENTS.md

SKIP". THERE IS NO "IT OBVIOUSLY WORKS".** **"It typechecks" is NOT QA. "`bun test` is green" is NOT QA.** YOU MUST DRIVE THE REAL HARNESS, and then **YOU MUST WRITE

code-yeongyuAGENTS.md

oh-my-openagent / assets

code-yeongyu/oh-my-openagent/assets/AGENTS.md

bash bun run build:schema bun run build:omo-schema bun run script/build-help-schemas.ts bun test tests/omo-schema-freshness.test.ts ``` ## CONVENTIONS - Regenerate after changing the corresponding source schema or help definition. - Commit generated output

code-yeongyuAGENTS.md

oh-my-openagent / bin

code-yeongyu/oh-my-openagent/bin/AGENTS.md

selector | | Version mismatch output | `version-mismatch.js` | User-facing installed-wrapper/platform-package mismatch diagnostics | | Behavior tests | `*.test.ts` | Bun tests for invocation routing, platform selection, and diagnostics | ## RUNTIME FLOW `oh-my-opencode.js` derives the invocation

code-yeongyuAGENTS.md

oh-my-openagent / packages

code-yeongyu/oh-my-openagent/packages/AGENTS.md

PACKAGES | Package | Layout | Purpose | |---------|--------|---------| | `lsp-tools-mcp/` | Vendored standalone project (`.github/`, `CHANGELOG.md`, `LICENSE`, `src/`, `test/`, `biome.json`, `vitest.config.ts`) | Serves the 8 aliases `lsp_status`, `lsp_diagnostics`, `lsp_goto_definition`, `lsp_find