agentleFS

AGENTS.md examples from real projects

How real projects brief Codex, Cursor and every other agent that reads AGENTS.md.

Best matches · from page 8Worked for most · soon
heygen-comAGENTS.md

hyperframes

heygen-com/hyperframes/docs/AGENTS.md

page, read its complete body and verify product behavior in the current source, tests, CLI help, or shipped skills. - Write for a smart general user first. Do not assume they

Steady34 mentions in 2 weeks

No other project uses it yet

81k24d agoReviewMountCreate a free account to mount
chopratejasAGENTS.md

headroom

chopratejas/headroom/AGENTS.md

needs a "Real behavior proof" section (setup, exact commands, observed output, what was not tested). Bug fixes need a test that fails before the fix. - One docs site: `docs/`, deployed

1 project uses a version of this

79k2mo agoReviewMountCreate a free account to mount
caddyserverAGENTS.md

caddy

caddyserver/caddy/AGENTS.md

modules/standard/imports.go` | Standard module registry | | `caddyconfig/httpcaddyfile/` | Caddyfile → JSON adapter for HTTP | | `caddytest/` | Test utilities and integration tests | | `cmd/caddy/` | CLI entry point with module imports | ### Critical Packages `caddyhttp` and `caddytls` require **extra

No other project uses it yet

79k15mo agoReviewMountCreate a free account to mount
ElasticAGENTS.md

elasticsearch

elastic/elasticsearch/AGENTS.md

project. Examples: `logging`, `x-content` (JSON/CBOR/YAML/SMILE parsing abstraction). * `client`: The official Java REST client. * `test`: Test infrastructure used by the rest of the repo. `framework` holds `ESTestCase`/`ESIntegTestCase`/`ESSingleNodeTestCase`; also

No other project uses it yet

79k7mo agoReviewMountCreate a free account to mount
ElasticAGENTS.md

elasticsearch / benchmarks

elastic/elasticsearch/benchmarks/AGENTS.md

stage=delta -p pattern=MONOTONIC_TIMESTAMPS" ``` ## Self-test Never skip the self-test. Do not pass `-DskipSelfTest=true` or `--test` to `run.sh`. The self-test validates correctness across all impl/operation/data

No other project uses it yet

79k7mo agoReviewMountCreate a free account to mount
calesthioAGENTS.md

OpenMontage / flux-best-practices

calesthio/OpenMontage/.agents/skills/flux-best-practices/AGENTS.md

costs at different resolutions. **Creative Exploration / Ideation:** **Recommended: FLUX.2 [klein]** - Fast iterations - Quick concept testing - Mood board generation - Exploring prompt variations **Production Marketing Assets:** **Recommended: FLUX.2 [pro]** - Consistent quality - Reasonable

Steady2 mentions in 2 weeks

2 projects use a version of this

78k7d agoReviewMountCreate a free account to mount
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

78k35d agoReviewMountCreate a free account to mount
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

Steady31 mentions in 2 weeks

No other project uses it yet

78k8d agoReviewMountCreate a free account to mount
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

78k17d agoReviewMountCreate a free account to mount
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

77k4mo agoReviewMountCreate a free account to mount
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

75k14mo agoReviewMountCreate a free account to mount
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

Steady10 mentions in 2 weeks

No other project uses it yet

75k7mo agoReviewMountCreate a free account to mount
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

1 project uses a version of this

74k15d agoReviewMountCreate a free account to mount
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

73k50d agoReviewMountCreate a free account to mount
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

73k50d agoReviewMountCreate a free account to mount
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

72k3mo agoReviewMountCreate a free account to mount
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

72k4mo agoReviewMountCreate a free account to mount
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

Steady8 mentions in 2 weeks

No other project uses it yet

72k7d agoReviewMountCreate a free account to mount
ClineAGENTS.md

cline / sdk

cline/cline/sdk/AGENTS.md

Development reference for the Cline SDK workspace.

No other project uses it yet

71k6mo agoReviewMountCreate a free account to mount
ClineAGENTS.md

cline / llms

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

Development guidance for the @cline/llms package.

No other project uses it yet

71k6mo agoReviewMountCreate a free account to mount
CLAUDE.md vs AGENTS.md

About AGENTS.md

What is AGENTS.md?

An open format for instructions to coding agents, read by Codex, Cursor and others. Think of it as a README written for agents.

Where does it go?

At the repository root, with more specific files in subdirectories. Agents read the one closest to the file they're editing.

What should it contain?

Setup and test commands, code style, and the rules a new contributor would need to know.

Does Claude Code read it?

Claude Code reads CLAUDE.md. A one-line CLAUDE.md that points at AGENTS.md covers both.