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.
iluwatarAGENTS.mdiluwatar/java-design-patterns/AGENTS.md
language used for pattern implementations. - **Maven**: Dependency management and build tool. - **JUnit 5**: The testing framework used to verify pattern behaviors. - **Mockito**: Used for mocking dependencies in unit tests. - **Lombok
No other project uses it yet
zed-industriesAGENTS.mdzed-industries/zed/docs/AGENTS.md
without behavioral changes - Performance optimizations (unless user-visible) - Bug fixes that restore documented behavior - Test changes - CI/CD changes ## Output Format ### Phase 4 Documentation Plan When generating a documentation plan
1 project uses a version of this
infiniflowAGENTS.mdinfiniflow/ragflow/AGENTS.md
implementations coexist, converge to one path unless an external contract forces compatibility. - Remove dead tests, commented-out code, stale docs, and "move later" notes instead of preserving them. - Reduce public
Steady5 mentions in 2 weeks
No other project uses it yet
All-Hands-AIAGENTS.mdAll-Hands-AI/OpenHands/AGENTS.md
delete the whole locale block from translation.json, then `make-i18n`, then remove any test-mock entries (tests inline a `translations` map in the `useTranslation` vi.mock). ## Commit messages - The persistent shell
1 project uses a version of this
louislamAGENTS.mdlouislam/uptime-kuma/AGENTS.md
assistant, but you must personally understand all changes, review the generated code, and manually test it before submitting a pull request. You will be BANNED immediately if you submit generated
Steady7 mentions in 2 weeks
No other project uses it yet
tt-a1iAGENTS.mdtt-a1i/archify/AGENTS.md
scoped [PR improvement check](CONTRIBUTING.md#pr-improvement-check) using the project Skills when applicable. ## Test selection Before running tests, read [Choose evidence by impact](CONTRIBUTING.md#choose-evidence-by-impact
Steady17 mentions in 2 weeks
No other project uses it yet
home-assistantPipes a download into a shellAGENTS.mdhome-assistant/core/AGENTS.md
python3" in current virtual environment to ensure the correct Python version is used for testing. - When entering a new environment or worktree, run `script/setup` to set up the virtual environment
No other project uses it yet
Model Context ProtocolAGENTS.mdmodelcontextprotocol/servers/src/everything/AGENTS.md
Everything" Server - Development Guidelines ## Build, Test & Run Commands - Build: `npm run build` - Compiles TypeScript to JavaScript - Watch mode: `npm run watch` - Watches for changes and rebuilds automatically - Run STDIO server
Steady3 mentions in 2 weeks
No other project uses it yet
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
Steady3 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
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
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
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
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
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.
