AGENTS.md examples from real projects

pythonAGENTS.md

cpython

python/cpython/AGENTS.md

change is necessary. - Make minimal, focused changes. - Follow existing coding style and patterns. - Write tests that exercise the change. - Keep backwards compatibility with prior releases in mind

No other project uses it yet

storytoldAGENTS.md

photocraft

storytold/photocraft/AGENTS.md

code, even when someone names a location. 4. **Keep fixes narrow and tested.** Fix what the issue describes, where the bug is. Add a test that fails without

No other project uses it yet

grafanaAGENTS.md

grafana

grafana/grafana/AGENTS.md

frontend) and Go workspaces (backend). ## Principles - Follow existing patterns in the surrounding code - Write tests for new functionality — for Go code, use `testing/synctest` over sleeps and time-based assertions

No other project uses it yet

rohitg00Deletes or force-pushesAGENTS.md

ai-engineering-from-scratch

rohitg00/ai-engineering-from-scratch/AGENTS.md

Repo layout ``` phases/ NN-phase-slug/ NN-lesson-slug/ docs/en.md # lesson explainer code/ # implementation + tests quiz.json # 6 questions outputs/ # reusable artifact (skill / prompt / agent / MCP server) README.md # public face; lesson

No other project uses it yet

colbymchenryDeletes or force-pushesAGENTS.md

codegraph

colbymchenry/codegraph/AGENTS.md

colbymchenry/codegraph` on npm; same binary serves as installer, indexer, and MCP server. ## Build, Test, Run ```bash npm run build # tsc + copy schema.sql and *.wasm + build the viewer into dist/; chmods

No other project uses it yet

OpenAIReads credentialsAGENTS.md

openai-cookbook

openai/openai-cookbook/AGENTS.md

datasets outside the repo; instead, document how to fetch them in the notebook. ## Build, Test, and Development Commands Use a virtual environment to isolate dependencies: - `python -m venv .venv && source

No other project uses it yet

OpenAIAGENTS.md

openai-cookbook / migration_agent

openai/openai-cookbook/examples/agents_sdk/sandboxed-code-migration/migration_agent/AGENTS.md

repo according to `repo/MIGRATION.md`. - Preserve the public function signatures and behavior. - Run the baseline test command before editing. - Edit the app code and its tests. - Run the check command named

No other project uses it yet

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

No other project uses it yet

hugohe3AGENTS.md

ppt-master

hugohe3/ppt-master/AGENTS.md

worktrees/`, CI, or mandatory branch setup unless the user explicitly requests them. The only test location is `skills/ppt-master/scripts/tests/` under the conditions in [`docs/rules/code-style.md`](docs/rules/code-style.md) §11. - On conflict with a generic

No other project uses it yet

usestrixPipes a download into a shellAGENTS.md

strix

usestrix/strix/AGENTS.md

agent skills for step-by-step workflows: ```bash npx skills add usestrix/strix ``` - `penetration-testing-with-strix` — run a headless pentest against code, URLs, domains, or IPs and read results (covers

No other project uses it yet

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

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

No other project uses it yet

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

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

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

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

No other project uses it yet

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