AGENTS.md examples from real projects

badlogicDeletes or force-pushesAGENTS.md

pi-mono

badlogic/pi-mono/AGENTS.md

history. ## Chord v2 Code Style Binding for `packages/chord/src/next/` and its tests, when writing and when reviewing. The model is pi-durable's source. - Files: one concept per file, named after

immich-appAGENTS.md

immich

immich-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

immich-appAGENTS.md

immich / e2e

immich-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

immich-appAGENTS.md

immich / machine-learning

immich-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

immich-appAGENTS.md

immich / mobile

immich-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

immich-appAGENTS.md

immich / native

immich-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

immich-appAGENTS.md

immich / server

immich-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

immich-appAGENTS.md

immich / web

immich-app/immich/web/AGENTS.md

explicit `.ts` extension: `import { authManager } from '#lib/managers/auth-manager.svelte.ts'`. Never `$lib`. Other aliases: `#i18n/*`, `#test-data/*`, `#tests/*`. - Build URLs with the typed `Route` object in `src/lib/route.ts`. `continue`/`previousRoute` query params must

JuliusBrusseeAGENTS.md

caveman / engine

JuliusBrussee/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

JuliusBrusseeAGENTS.md

caveman / extension

JuliusBrussee/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

No other project uses it yet

JuliusBrusseeAGENTS.md

caveman / mcp

JuliusBrussee/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

No other project uses it yet

JuliusBrusseeAGENTS.md

caveman / mem

JuliusBrussee/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

No other project uses it yet

JuliusBrusseeAGENTS.md

caveman / proxy

JuliusBrussee/caveman/proxy/AGENTS.md

inferred`, verified dollars always zero. ## 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

No other project uses it yet

JuliusBrusseeAGENTS.md

caveman / shrink

JuliusBrussee/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

No other project uses it yet

SupabaseAGENTS.md

supabase

supabase/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

SupabaseAGENTS.md

supabase / apps

supabase/supabase/apps/docs/AGENTS.md

endpoint, search embeddings, federated docs, build pipeline), `ask-the-docs` has the reference notes. ## Test requirements Before running tests for `apps/docs`, ensure local Supabase is available

No other project uses it yet

SupabaseAGENTS.md

supabase / studio

supabase/supabase/apps/studio/AGENTS.md

fields, watch/formState, reset, number inputs | `react-hook-form` | | Displaying API errors | `studio-error-handling` | | Tests (deciding, writing, reviewing) | `studio-testing`, then `studio-mock-api-tests` (component/MSW) or `studio-e2e-tests

No other project uses it yet

addyosmaniAGENTS.md

agent-skills

addyosmani/agent-skills/AGENTS.md

user intent to skills: - Feature / new functionality → `spec-driven-development`, then `incremental-implementation`, `test-driven-development` - Planning / breakdown → `planning-and-task-breakdown` - Bug / failure / unexpected behavior → `debugging-and-error-recovery

addyosmaniAGENTS.md

agent-skills

addyosmani/agent-skills/docs/agents.md

axis review before merge | | [security-auditor](../agents/security-auditor.md) | Security Engineer | Vulnerability detection, OWASP-style audit | | [test-engineer](../agents/test-engineer.md) | QA Engineer | Test strategy, coverage analysis, Prove-It pattern | | [web-performance-auditor](../agents/web-performance-auditor.md

No other project uses it yet

stablyaiAGENTS.md

orca

stablyai/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