AGENTS.md examples from real projects

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

stablyaiAGENTS.md

orca / tests

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

papers-we-loveAGENTS.md

papers-we-love

papers-we-love/papers-we-love/AGENTS.md

This is not an application project: there is no package manager, build, or unit-test suite. ## Layout - The root `README.md` explains the collection and points contributors to the project policies

No other project uses it yet

fatedierAGENTS.md

frp

fatedier/frp/AGENTS.md

binary only - `make frpc` - Build client binary only - `make all` - Build everything with formatting ### Testing - `make test` - Run unit tests - `make e2e` - Run end-to-end tests - `make e2e-trace

No other project uses it yet

paperclipaiDeletes or force-pushesAGENTS.md

paperclip

paperclipai/paperclip/AGENTS.md

canonical connection authoring runbook for provider research, supported transport/auth patterns, credential handling, branding, implementation, testing, live proof, and PR submission. ### Scoped repository rules Before editing or reviewing files, read

axiosAGENTS.md

axios

axios/axios/AGENTS.md

bundles). - Lint source only: `npm run lint`; focused lint: `npx eslint lib/path/to/file.js`. - Unit tests: `npm run test:vitest:unit`; focused unit test: `npm run test:vitest:unit -- tests/unit/path.test.js`. - Browser tests