How real projects brief Codex, Cursor and every other agent that reads AGENTS.md.
Files you open will collect here, so you can find them again.
Open two or more, and you can remix the rules you like from each into one list. Kept in this browser only.
AstralAGENTS.mdastral-sh/uv/AGENTS.md
Read CONTRIBUTING.md for guidelines on how to run tools - ALWAYS ensure that new tests use the same style as existing tests for all parts of the test - ALWAYS check whether
Steady2 mentions in 2 weeks
No other project uses it yet
storybookjsAGENTS.mdstorybookjs/storybook/AGENTS.md
repository root unless stated otherwise. - After editing, format with `cd code && yarn fmt:write`. - Test React components with stories and `play` functions, never `*.test.tsx`. - Log through `storybook/internal/node-logger` or `storybook/internal/client-logger
No other project uses it yet
gohugoioAGENTS.mdgohugoio/hugo/AGENTS.md
been solved before, look hard for helper functions before creating new ones. * In tests, almost always write end-to-end integration tests using `hugolib.Test` or one of its siblings. Write
No other project uses it yet
koala73AGENTS.mdkoala73/worldmonitor/AGENTS.md
from `.nvmrc`. Run `npm run --silent agent:preflight -- --mode review` for source inspection, `--mode tests` before tests, or `--mode repair` before implementation. Add `--pr ` or `--issue ` when applicable. 3. Read
Steady18 mentions in 2 weeks
No other project uses it yet
koala73AGENTS.mdkoala73/worldmonitor/public/agents.md
Machine interfaces, authentication, request policy, and rate limits.
Steady18 mentions in 2 weeks
No other project uses it yet
sveltejsAGENTS.mdsveltejs/svelte/AGENTS.md
monorepo. **Important:** Read and follow [`CONTRIBUTING.md`](./CONTRIBUTING.md) as well - it contains essential information about testing, code structure, and contribution guidelines that applies here. When submitting a PR, you **MUST** read
No other project uses it yet
cheaper-inferenceReads credentialsAGENTS.mdcheaper-inference/OmniRoute/AGENTS.md
clean) npm run typecheck:noimplicit:core # Strict check (no implicit any) npm run test:coverage # Unit tests + coverage gate (67.33 / 67.33 / 72.02 / 65.08 — statements/lines/functions/branches, enforced by the blocking ratchet
Steady35 mentions in 2 weeks
1 project uses a version of this
bytedanceReads credentialsAGENTS.mdbytedance/deer-flow/AGENTS.md
harness/app split, agent & middleware chain, sandbox, MCP, skills, memory, IM channels, persistence/migrations, config system, test layout. - **[frontend/AGENTS.md](frontend/AGENTS.md)** — frontend depth: Next.js App Router layout, thread/streaming data flow, code style, commands
Steady14 mentions in 2 weeks
No other project uses it yet
bytedanceAGENTS.mdbytedance/deer-flow/backend/AGENTS.md
other errors. `get_extensions_config()` revalidates reads by file signature; see [config caching](packages/harness/deerflow/config/AGENTS.md). Tests: `tests/test_compose_extensions_config_writable.py`, `tests/test_extensions_config_atomic_write.py`, `tests/test_helm_extensions_config_writable.py`. - MCP cache reset scope and discovery fencing: [MCP guide](packages/harness/deerflow/mcp/AGENTS.md). **Layout:** [Repository
Steady14 mentions in 2 weeks
No other project uses it yet
bytedanceReads credentialsAGENTS.mdbytedance/deer-flow/frontend/AGENTS.md
Remove each override after its upstream fix; refresh the lockfile and test docs builds after changes. ## Commands Run from `frontend/`; host pnpm calls use `../scripts/pnpm.py`. - `pnpm dev`: development; `pnpm build
Steady14 mentions in 2 weeks
No other project uses it yet
bytedanceReads credentialsAGENTS.mdbytedance/deer-flow/scripts/AGENTS.md
HOME` when collecting a bundle and ensure the checkout `.env` does not override it. Tests clear all three runtime path variables and compare storage defaults with the launcher's actual
Steady14 mentions in 2 weeks
No other project uses it yet
bytedanceAGENTS.mdbytedance/deer-flow/skills/public/data-analysis/AGENTS.md
published generation without loading the source again. Regressions live under the repository's root tests directory. They use real DuckDB. Excel and CLI integration additionally run with an already installed
Steady14 mentions in 2 weeks
No other project uses it yet
bytedanceAGENTS.mdbytedance/deer-flow/skills/public/video-generation/AGENTS.md
checks model-specific resolution and duration combinations. Clear both override variables in offline video test fixtures
Steady14 mentions in 2 weeks
No other project uses it yet
lobehubReads credentialsAGENTS.mdlobehub/lobe-chat/AGENTS.md
data fetching; TRPC for type-safe backend - Drizzle ORM with PostgreSQL; Vitest for testing ## Agent Skills `AGENTS.md` owns repository-wide architecture and workflow. Keep detailed implementation rules in skills
1 project uses a version of this
jesseduffieldAGENTS.mdjesseduffield/lazygit/AGENTS.md
Windows box has only `just`). - `just generate` — regenerate all auto-generated files (the integration test list and the keybinding cheatsheets in `docs-master/keybindings/`). Run this whenever you add/remove/rename
Steady4 mentions in 2 weeks
No other project uses it yet
netdataReads credentialsAGENTS.mdnetdata/netdata/AGENTS.md
decisions, design forks, risk acceptance, destructive approvals, final product judgment. - **Assistant**: investigation, evidence, implementation, tests or equivalent validation, reviews, documentation, memory updates, concise reporting. The assistant proposes and investigates
Steady4 mentions in 2 weeks
No other project uses it yet
santiferReads credentialsAGENTS.mdsantifer/career-ops/AGENTS.md
filter`; optional `domain_filter` gates whole boards on industry relevance before any title is tested (opt-in, #3105); checkpoints every 500 companies, `--resume` continues an interrupted sweep | | `scan-interamt.mjs` | Playwright browser
1 project uses a version of this
santiferAGENTS.mdsantifer/career-ops/web/AGENTS.md
matches tailored CVs and canonicalises statuses: call it, or mirror it behind a parity test. A second implementation of the same rule is how the two halves start disagreeing
1 project uses a version of this
heygen-comAGENTS.mdheygen-com/hyperframes/AGENTS.md
changes only within the task's authorization and verify the resulting GitHub state. ## Build & Test ```bash bun install # Install dependencies (NOT pnpm — do not create pnpm-lock.yaml) bun run build # Build
Steady34 mentions in 2 weeks
No other project uses it yet
heygen-comAGENTS.mdheygen-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
An open format for instructions to coding agents, read by Codex, Cursor and others. Think of it as a README written for agents.
At the repository root, with more specific files in subdirectories. Agents read the one closest to the file they're editing.
Setup and test commands, code style, and the rules a new contributor would need to know.
Claude Code reads CLAUDE.md. A one-line CLAUDE.md that points at AGENTS.md covers both.
