AGENTS.md examples from real projects

traefikAGENTS.md

traefik

traefik/traefik/AGENTS.md

answer *why*, not *what*.** Comments that restate what the code already says are noise: they go stale and waste review time. Only add a comment when it records

No other project uses it yet

scrapyAGENTS.md

scrapy

scrapy/scrapy/AGENTS.md

only on what it has as well. - Review your own diff. Remove whatever the change does not need: unused parameters, dead code, leftover debugging, comments that restate the code. ## Code

No other project uses it yet

usememosAGENTS.md

memos

usememos/memos/AGENTS.md

response redaction. Black-box service tests live in `server/api/test/`, unit tests next to the code. ## Change Routing | Change | Update | Verify | | --- | --- | --- | | Go service or router behavior | Handlers under `server/`, rules under

gitAGENTS.md

git / po

git/git/po/AGENTS.md

Reviewing translation quality ## Background knowledge for localization workflows Essential background for the workflows below; understand these concepts before performing any housekeeping tasks in this document. ### Language code and notation

withastroAGENTS.md

astro

withastro/astro/AGENTS.md

narrate change history ("now", "previously", "no longer") and never address the reviewer ("this correctly handles..."). State how the code works, not how it came to be or why the change

No other project uses it yet

ultralyticsAGENTS.md

ultralytics

ultralytics/ultralytics/AGENTS.md

intentionally removes them with evidence. **Review gate:** for every addition, the reviewer decides whether deleting or changing existing code would have fixed the problem instead — if it would, that

No other project uses it yet

hugohe3AGENTS.md

ppt-master

hugohe3/ppt-master/AGENTS.md

slides untouched also use [`edit-native-pptx`](skills/ppt-master/workflows/edit-native-pptx.md); export must report `rebuilt=0`. - [`visual-review`](skills/ppt-master/workflows/stages/visual-review.md), [`customize-animations`](skills/ppt-master/workflows/stages/customize-animations.md), and [`generate-audio`](skills/ppt-master/workflows/stages/generate-audio.md) are supporting stages; their trigger rules remain

No other project uses it yet

tw93AGENTS.md

Pake

tw93/Pake/AGENTS.md

same source of truth. Local-only overrides (`CLAUDE.local.md`, `AGENTS.override.md`, `.claude/settings.local.json`) stay ignored. ## Code Conventions - No Chinese comments in any source (Rust / TypeScript / any file). Comments and identifiers in English; follow

BerriAIPipes a download into a shellAGENTS.md

litellm

BerriAI/litellm/AGENTS.md

requesting maintainer review, verify the current PR tip passes required CI and code coverage and has acceptable reviews from the review bots on the PR, such as Veria and Bugbot

penpotAGENTS.md

penpot

penpot/penpot/AGENTS.md

Writing rules, from Orwell, 1946. These govern prose: docs, PR text, messages. Never touch code or technical terms; swap in everyday words only where precision survives. 1. Never

rcloneAGENTS.md

rclone

rclone/rclone/AGENTS.md

elegant, smallest change you can. Do not refactor or re-order code unless necessary as this makes review more challenging. Re-use existing test scaffolding, existing or library routines

No other project uses it yet

spring-projectsAGENTS.md

spring-framework

spring-projects/spring-framework/AGENTS.md

usage. ## Docs - Reference docs are AsciiDoc in `framework-docs/modules/ROOT`; code snippets for `include-code::` live in `framework-docs/src/main/{java,kotlin}`. ## Commits and pull requests - Pull requests target `main

No other project uses it yet

ultralyticsAGENTS.md

yolov5

ultralytics/yolov5/AGENTS.md

intentionally removes them with evidence. **Review gate:** for every addition, the reviewer decides whether deleting or changing existing code would have fixed the problem instead — if it would, that

No other project uses it yet

chen08209AGENTS.md

FlClash

chen08209/FlClash/AGENTS.md

symlinks expose the same skills to Claude Code. Current skills cover localization, UI work, core/platform changes, and pre-commit structural quality review

No other project uses it yet

appwriteAGENTS.md

appwrite

appwrite/appwrite/AGENTS.md

autoloading. Avoid dependencies outside the `utopia-php` ecosystem. Never hardcode credentials — use env vars. Code changes may require a container restart; logs live on the relevant container

No other project uses it yet

ayghriAGENTS.md

i-have-adhd

ayghri/i-have-adhd/AGENTS.md

Authorship, labels, safety, review, and PR requirements. | ## Runtime entry points When debugging or changing one integration, begin with its entry point: | Runtime | Read first | | --- | --- | | Claude Code | `.claude-plugin/plugin.json`, `hooks/hooks.json

BlockAGENTS.md

goose

block/goose/AGENTS.md

discussion instead. - Read the agreed design, constraints, non-goals, and verification plan before changing code. - Keep the implementation within the issue's agreed scope. - If implementation reveals a material design

bmad-code-orgAGENTS.md

BMAD-METHOD

bmad-code-org/BMAD-METHOD/AGENTS.md

instructions for exotic cases — the model usually handles them from context, and the reviewing human can correct it when it does not. - Write template conditionals as block-level

No other project uses it yet

ggml-orgAGENTS.md

whisper.cpp

ggml-org/whisper.cpp/AGENTS.md

used responsibly for: - **Learning and exploration**: Understanding codebase structure, techniques, and documentation - **Code review assistance**: Obtaining suggestions on human-written code - **Mechanical tasks**: Formatting, generating repetitive patterns from established designs

No other project uses it yet

pingchesuAGENTS.md

gsd-hermes

pingchesu/gsd-hermes/docs/AGENTS.md

agents** detailed in this section. Twelve additional shipped agents (pattern-mapper, debug-session-manager, code-reviewer, code-fixer, ai-researcher, domain-researcher, eval-planner, eval-auditor, framework-selector, intel-updater