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.
rust-langAGENTS.mdrust-lang/rust/AGENTS.md
gate fails When a rule identifies banned work, **STOP** that work. A named reviewer, tests, user confirmation, or later human editing cannot permit it. Do not ask for prerequisites, promise
1 project uses a version of this
badlogicDeletes or force-pushesAGENTS.mdbadlogic/pi-mono/AGENTS.md
history. ## Chord v2 Code Style Binding for Chord v2 (`packages/chord/src/`) and its tests, when writing and when reviewing. The model is pi-durable's source. - Files: one concept per file
1 project uses a version of this
browser-useReads credentialsAGENTS.mdbrowser-use/browser-use/AGENTS.md
show off that feature -> the code just gets messy. If you do anything to test it out, just use inline code inside the terminal (if you want). - always default
Steady6 mentions in 2 weeks
No other project uses it yet
stablyaiAGENTS.mdstablyai/orca/AGENTS.md
Useful Commands - **Typecheck**: `pnpm tc` (or `tc:node` / `tc:cli` / `tc:web`) - **Test**: `pnpm test [path/to/file.test.ts] --maxWorkers=2`; incremental: `pnpm test:changed [path] --maxWorkers=2` ([details](.github/CONTRIBUTING.md#targeting-local-tests
Steady14 mentions in 2 weeks
No other project uses it yet
stablyaiAGENTS.mdstablyai/orca/tests/AGENTS.md
Automated App Launches - Set `ORCA_BACKGROUND_LAUNCH=1` for all tests and agent-launched apps. Use [`orca-app.ts`](e2e/helpers/orca-app.ts) / [`orca-restart.ts`](e2e/helpers/orca-restart.ts); raw `electron.launch()` calls must pass the env explicitly. - Keep windows
Steady14 mentions in 2 weeks
No other project uses it yet
immich-appAGENTS.mdimmich-app/immich/AGENTS.md
mobile/` (Flutter), `native/` (Rust core for mobile), `machine-learning/` (FastAPI + ONNX), `e2e/` (API + Playwright tests), `packages/` (`@immich/sdk`, `@immich/cli`, plugin SDK/core, release scripts), `open-api/`, `i18n/`, `docs/`. Before changing code
Steady5 mentions in 2 weeks
No other project uses it yet
immich-appAGENTS.mdimmich-app/immich/e2e/AGENTS.md
e2e/AGENTS.md End-to-end tests against a real Immich stack from `docker-compose.yml` (server on port 2285): API specs with vitest, browser specs with Playwright. ## Rules - `test-assets
Steady5 mentions in 2 weeks
No other project uses it yet
immich-appAGENTS.mdimmich-app/immich/machine-learning/AGENTS.md
eviction. Execution backends (ONNX Runtime, RKNN, Arm NN) are in `immich_ml/sessions/`. - **Run tests**: everything is in `test_main.py`. One class with `uv run pytest test_main.py -k TestCache`, one test with
Steady5 mentions in 2 weeks
No other project uses it yet
immich-appAGENTS.mdimmich-app/immich/mobile/AGENTS.md
freezed classes; `mise //mobile:codegen:watch` keeps build_runner running. CI job "Unit Test Mobile" regenerates and fails if the code does not compile. - **Change the local database**: edit tables
Steady5 mentions in 2 weeks
No other project uses it yet
immich-appAGENTS.mdimmich-app/immich/native/AGENTS.md
abort"`. - When a crate dependency changes, update `native_core/NOTICES` with its license. ## Skills - **Build, test and lint**: `mise //native:build`, `mise //native:test`, `mise //native:lint`, `mise //native
Steady5 mentions in 2 weeks
No other project uses it yet
immich-appAGENTS.mdimmich-app/immich/server/AGENTS.md
docs/docs/developer/architecture.mdx`. ## Rules - ESM with no relative imports (lint-enforced). Import as `src/...js` and `test/...js`. - Every route has `@Authenticated(...)` and `@Endpoint({ summary, description, history })`; the global `AuthGuard` throws otherwise
Steady5 mentions in 2 weeks
No other project uses it yet
immich-appAGENTS.mdimmich-app/immich/web/AGENTS.md
explicit `.ts` extension: `import { authManager } from '#lib/managers/auth-manager.svelte.ts'`. Never `$lib`. Other aliases: `#i18n/*`, `#test/*` (the `test/` directory). - Build URLs with the typed `Route` object in `src/lib/route.ts`. `continue`/`previousRoute` query params must
Steady5 mentions in 2 weeks
No other project uses it yet
JuliusBrusseeAGENTS.mdJuliusBrussee/caveman/engine/AGENTS.md
converter; both directions fail closed. ## Conventions - Build/test: `make product-build PRODUCT=engine` / `make product-test PRODUCT=engine`. - A new compressor is a self-contained file in `compressors/` + tests, registered
Steady9 mentions in 2 weeks
2 projects use a version of this
JuliusBrusseeAGENTS.mdJuliusBrussee/caveman/extension/AGENTS.md
buildReminder`/`isPrefixed`/`normMode`. No chrome/DOM/network. Loaded first (exposes `self.CavemanDirective`) and required directly by the test suite. - `src/caveman.js` — content script: per-site composer adapter + capture-phase send interception. Prepends the directive
Steady9 mentions in 2 weeks
No other project uses it yet
JuliusBrusseeAGENTS.mdJuliusBrussee/caveman/mcp/AGENTS.md
never raw input as JSON. ## Conventions - Build/test: `make product-build PRODUCT=mcp` / `make product-test PRODUCT=mcp`. - **stdout is the protocol channel** — logs go to stderr only (a dedicated test
Steady9 mentions in 2 weeks
No other project uses it yet
JuliusBrusseeAGENTS.mdJuliusBrussee/caveman/mem/AGENTS.md
framing matches caveman-mcp exactly. ## Conventions - Build/test: `make product-build PRODUCT=mem` / `make product-test PRODUCT=mem` for the Go core; root `make test` also runs mirrored JS/Python wrapper tests
Steady9 mentions in 2 weeks
No other project uses it yet
JuliusBrusseeAGENTS.mdJuliusBrussee/caveman/proxy/AGENTS.md
read as available. ## Conventions - Build/test: `make product-build PRODUCT=proxy` / `make product-test PRODUCT=proxy`. - Tests inject a plain `*http.Client` to reach loopback stubs; the binary uses the SSRF-guarded
Steady9 mentions in 2 weeks
No other project uses it yet
JuliusBrusseeAGENTS.mdJuliusBrussee/caveman/shrink/AGENTS.md
sentence (must/cannot/required/bounds/format/ ISO/RFC/absolute/etc.). `default`, `const`, and internal `$ref` targets survive. Golden and adversarial conformance tests lock these construction surfaces; over-keep is safer than a retry. ## Conventions - Build/test: `make product
Steady9 mentions in 2 weeks
No other project uses it yet
thedotmackAGENTS.mdthedotmack/claude-mem/AGENTS.md
alone is not a checkpoint. - Integration and community fixes must obey the same rules. Tests proving that a queue drains are insufficient; test that an outage cannot create later, unrequested
Steady19 mentions in 2 weeks
No other project uses it yet
SupabaseAGENTS.mdsupabase/supabase/AGENTS.md
introspection (`SafeSqlFragment`) | | `packages/shared-data` | Static data: pricing, plans, regions, error codes | | `e2e/studio`, `e2e/docs` | Playwright E2E tests | | `supabase/` | Local Supabase project: edge functions, migrations, config.toml | ## Common Commands ```bash pnpm dev:studio
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.
