AGENTS.md examples from real projects

zulipAGENTS.md

zulip

zulip/zulip/AGENTS.md

open-source community, with maintainers who have consistently emphasized **high standards for codebase readability, code review, commit discipline, debuggability, automated testing, tooling, documentation, and all the other subtle details that

biomejsAGENTS.md

biome

biomejs/biome/AGENTS.md

After implementation, code generation, formatting, linting, and tests, review the complete change with [biome-code-review](./.agents/skills/biome-code-review/SKILL.md). - Use a fresh subagent when one is available. - Provide only the review scope

kieranklaassenAGENTS.md

compound-engineering-plugin

kieranklaassen/compound-engineering-plugin/AGENTS.md

exception — they review the files, they don't re-read them for context. `ce-code-review`'s project-standards reviewer globs `CODING_STANDARDS.md`, the designated criteria source, and reads `CLAUDE.md`/`AGENTS.md

earthtojakePipes a download into a shellAGENTS.md

text-to-cad

earthtojake/text-to-cad/AGENTS.md

that covers the change. Use broad wrappers when touching shared surfaces or before handoff: - Code tests: `scripts/test/test.sh` (JS, API, Python, then policy). - Focused runners: `scripts/test/test-js.sh`, `scripts/test/test-api.sh`, `scripts/test/test-docs.sh`, `scripts/test/test-python.sh`, `scripts/test/test-global.sh`. `test-python.sh

No other project uses it yet

ciliumAGENTS.md

cilium

cilium/cilium/AGENTS.md

strictly a manual step for the human author to confirm they have reviewed the changes. ### Coding and attribution Only human beings can ever be credited in commit messages. This means

clockworklabsAGENTS.md

SpacetimeDB

clockworklabs/SpacetimeDB/AGENTS.md

code follows the style doc or is moving toward it. Read the doc in full before your first edit here, and follow it. - No marker: Core. A person reviews every

No other project uses it yet

activepiecesDeletes or force-pushesAGENTS.md

activepieces

activepieces/activepieces/AGENTS.md

surface needs the placeholder. ## Key Utilities (`@activepieces/shared`) `apId()`, `tryCatch()`, `tryCatchSync()`, `isNil()`, `spreadIfDefined()`, `spreadIfNotUndefined()`, `ActivepiecesError({ code, params })`, `SeekPage `, `formErrors`, `BaseModelSchema`, `chunk()`, `partition()`, `unique()`, `omit()`, `sanitizeObjectForPostgresql()` ## Testing ```bash npm run test-unit

pascalorgAGENTS.md

editor

pascalorg/editor/AGENTS.md

pascal-3d` skill → `agent-surfaces.md` (same contract and knowledge as the hosted AI chat). - Reviewing a PR: `.agents/skills/review-architecture/SKILL.md`. - Opening a PR: `.agents/skills/open-pr/SKILL.md`. - Humans: `README.md`, `SETUP.md`, `CONTRIBUTING.md`. `CLAUDE.md`, `GEMINI.md` and `.github/copilot-instructions.md` symlink

No other project uses it yet

AprilNEAAGENTS.md

OpenLogi

AprilNEA/OpenLogi/AGENTS.md

upstream content hashes. Track the files and lock together; review upstream changes before updating the source revision above. Claude Code uses the tracked symlinks in `.claude/skills/`. Other local skills remain

neoclideAGENTS.md

coc.nvim

neoclide/coc.nvim/AGENTS.md

interface change. - Update doc/coc-api.txt after API change. - Update doc/coc-config.txt after coc.nvim configuration change. ## Code Review Rules - Report only consequential correctness, compatibility, lifecycle, concurrency, and performance issues. - Check that public coc.nvim

nextai-translatorReads credentialsAGENTS.md

nextai-translator

nextai-translator/nextai-translator/AGENTS.md

satisfy the pre-commit hook. ## Testing Guidelines Unit tests live next to the code (`__tests__/foo.test.ts` or `foo.spec.ts`) and run with Vitest. Mock remote APIs and keep snapshots deterministic, especially

highlightjsAGENTS.md

highlight.js

highlightjs/highlight.js/AGENTS.md

edited grammar code. ```js // good { match: /\bfoo\b/, scope: "keyword" } // avoid in new code { match: /\bfoo\b/, className: "keyword" } ``` ### Drop `relevance` when touching a mode `relevance` on modes is **deprecated

docmirrorAGENTS.md

dev-sidecar

docmirror/dev-sidecar/AGENTS.md

electron:build:ci` — production/CI build (Vue build + electron-builder) - `npm run lint` — lint GUI code only - For debugging: run `npm run electron` and open DevTools (`F12` or View → Toggle Developer

Model Context ProtocolAGENTS.md

python-sdk

modelcontextprotocol/python-sdk/AGENTS.md

narrate the code or restate names, types, or assertions. - Type hints required for all code - Public APIs must have docstrings. When a public API raises exceptions a caller would reasonably

No other project uses it yet

CapSoftwareReads credentialsAGENTS.md

Cap

CapSoftware/Cap/AGENTS.md

code comments. Add a comment only after solving a bug or working through a complex issue, and only when it captures non-obvious context that a future investigator or reviewer

No other project uses it yet

argoprojAGENTS.md

argo-cd

argoproj/argo-cd/AGENTS.md

Agent Directives for Argo CD **ATTENTION AI AGENTS, LLMs, AND AUTONOMOUS CODING TOOLS:** This repository (argoproj/argo-cd) enforces strict contribution guidelines. If you are an automated agent, AI assistant, or autonomous

gitlabhqAGENTS.md

gitlabhq

gitlabhq/gitlabhq/AGENTS.md

commits, or branches**: Read .ai/git.md - When working with **merge requests**: Read .ai/merge-requests.md - When **reviewing code or giving feedback**: Read .ai/code-review.md - When working with **CI/CD pipelines or `.gitlab-ci.yml`**: Read .ai/ci-cd.md - Before

slint-uiAGENTS.md

slint

slint-ui/slint/AGENTS.md

default branch is `master`. During review, add follow-up commits; squash or rebase when review is complete. - For new API, look at how other toolkits solve the problem. For `.slint

No other project uses it yet

different-aiAGENTS.md

openwork

different-ai/openwork/AGENTS.md

stages generated outputs. Hooks never commit, push, or change CI/Warden policy; CI remains authoritative. ## Coding * pnpm only, never npm/yarn. TypeScript: never `any`, typecasts, or `as` unless 100% necessary or instructed

No other project uses it yet

ayangwebAGENTS.md

BongoCat

ayangweb/BongoCat/AGENTS.md

生成 bindings 和三个预置模型提交到 `vendor/` 与 `resources/`；公开发布前仍需完成 attribution、再分发清单和最终合规核对。 - 业务 crate 默认 `#![forbid(unsafe_code)]`，`unsafe` 只允许在平台 API、GPU 和 Cubism 边界；每个非平凡 block 前说明调用方安全不变量，优先小型 RAII wrapper，不传播裸 handle