CLAUDE.md examples from real projects

TelegramMessengerDeletes or force-pushesCLAUDE.md

Telegram-iOS

TelegramMessenger/Telegram-iOS/CLAUDE.md

mode accessors): `submodules/TelegramUIPreferences/CLAUDE.md`. - **Smaller ones**: links with a login part (`submodules/UrlWhitelist/`), the code-block highlighter's recursion bound (`third-party/libprisma/`), an Apple Metal binary-archive bug (`submodules/MetalEngine/`), wallpaper soft

No other project uses it yet

nhostCLAUDE.md

nhost

nhost/nhost/CLAUDE.md

claude/docs/`. Load the one that matches the file you are touching before writing or reviewing code: - **Go** — `.claude/docs/go-design-rules.md`. Covers placement, package invariants, local correctness, the mandatory `golines` / `golangci-lint

No other project uses it yet

keybaseCLAUDE.md

client

keybase/client/CLAUDE.md

that is handed the author's story checks the story instead of the code. The correctness reviewer must also do one adversarial pass: for each `await`, timer, deferred callback

mikro-ormCLAUDE.md

mikro-orm

mikro-orm/mikro-orm/.claude/CLAUDE.md

oxlint --type-check`. Never assume type safety — verify it. ## Code Editing Rules When reviewing or editing code, do NOT remove code (assertions, type casts, etc.) unless you have verified

No other project uses it yet

davidkimaiCLAUDE.md

Context-Engineering

davidkimai/Context-Engineering/CLAUDE.md

each change", review="Self-review each modification" }, /validate{ functionality="Verify preserved behavior", improvements="Confirm refactoring goals were met", documentation="Update documentation if needed" } ], output={ refactored_code="Improved implementation", verification="Evidence

firezoneCLAUDE.md

firezone

firezone/firezone/CLAUDE.md

directory. For example, for Rust code, check `rust/AGENT.md`; for Elixir code, check `elixir/AGENT.md`, etc. ## Code review guidelines - Assume that code compiles and is syntactically correct. - Focus on consistency and correctness

anyprotoReads credentialsCLAUDE.md

anytype-ts

anyproto/anytype-ts/CLAUDE.md

icons (SVG), and static assets - [`docs/src/json/README.md`](docs/src/json/README.md) - JSON data: translations, constants, colors, keyboard shortcuts ### Code Reviews - [`docs/REVIEW-v0.54.11-to-HEAD.md`](docs/REVIEW-v0.54.11-to-HEAD.md) - Review of changes since v0.54.11 stable release ## Web Mode Development

No other project uses it yet

CoreBunchDeletes or force-pushesCLAUDE.md

Instatic

CoreBunch/Instatic/CLAUDE.md

Instatic This file is the **agent rule book**. Read it before changing code. Detailed explanations live in `docs/` — start at [`docs/README.md`](docs/README.md) for orientation and follow the links from there

nicklockwoodCLAUDE.md

SwiftFormat

nicklockwood/SwiftFormat/CLAUDE.md

swift test` (or `swift test --enable-test-discovery` on Linux) 3. **[VERY IMPORTANT] Review your code** - ensure it follows all best practices above 4. **[VERY IMPORTANT] Simplify further** - look

No other project uses it yet

PydanticCLAUDE.md

monty

pydantic/monty/CLAUDE.md

without explicit user approval. Changes to this module require careful review of the safety invariants documented in the code comments. #### Core concepts - **`HeapReader<'a>`** — A scoped borrow created exclusively

iflytekCLAUDE.md

astron-agent

iflytek/astron-agent/CLAUDE.md

required: - General programming concepts such as closures, data structures, and design patterns. - Refactoring, code review, or debugging of the user's own business logic. - Writing scripts from scratch when

No other project uses it yet

redpanda-dataCLAUDE.md

connect

redpanda-data/connect/CLAUDE.md

Agent | |---|---| | Writing or modifying Go code | `godev` agent | | Writing or modifying tests | `tester` agent | | Code review | `/review` skill | ## Plugin: Redpanda Connect YAML configuration, Bloblang authoring, and component discovery are provided

No other project uses it yet

WenyuChiouCLAUDE.md

awesome-agentic-ai-zh

WenyuChiou/awesome-agentic-ai-zh/CLAUDE.md

Haiku | $1 input / $5 output | | **`claude-sonnet-5-5`** | Production default for new work; review the [Sonnet 5.5 migration guide](https://platform.claude.com/docs/en/models/sonnet-5-5/migration-guide) before changing existing tool-calling examples

AnthropicCLAUDE.md

claude-agent-sdk-python

anthropics/claude-agent-sdk-python/CLAUDE.md

that the allowed tools do not cover then runs only if Claude Code's safety review passes it. Allow only the tools the job needs, and keep any `--disallowedTools` list

jnMetaCodeCLAUDE.md

superpowers-zh

jnMetaCode/superpowers-zh/CLAUDE.md

jnMetaCode/superpowers-zh` 是上游 `obra/superpowers` 的**中文增强 fork**，定位为：完整翻译上游 skill + 叠加 4 个中国原创 skill（chinese-code-review / chinese-commit-conventions / chinese-documentation / chinese-git-workflow）+ 多工具适配（npx 一条命令支持 26 款 IDE/CLI

No other project uses it yet

bitsandbytes-foundationCLAUDE.md

bitsandbytes

bitsandbytes-foundation/bitsandbytes/CLAUDE.md

complete review workflow (classification, checklists, verdict format, and posting instructions). This is the primary guide; follow its steps sequentially. 2. `agents/architecture_guide.md` — Codebase architecture and patterns 3. `agents/code_standards.md` — Code quality expectations

No other project uses it yet

NomicFoundationCLAUDE.md

hardhat

NomicFoundation/hardhat/CLAUDE.md

Ordering in cached lazy getters" section in `docs/engineering-guidelines.md` (under GC3) for the rationale and code shape. Test files are free to use `await import` freely. ## Development workflow After modifying

samberCLAUDE.md

awesome-prometheus-alerts

samber/awesome-prometheus-alerts/CLAUDE.md

Review Pitfalls (learned from PR history) These are the most frequent issues raised during code review on this repo: ### Severity levels - `critical` = requires immediate human attention

samberCLAUDE.md

awesome-prometheus-alerts / site

samber/awesome-prometheus-alerts/site/CLAUDE.md

site/` TypeScript/Astro code. `../_data/rules.yml` — the file most contributions edit — has no linter or schema (its conventions live in the root `CLAUDE.md`), so those are enforced only by review

zumerlabCLAUDE.md

snapdom

zumerlab/snapdom/.claude/CLAUDE.md

reasons; don't "simplify" them without understanding what breaks. 3. **Minimal code** — no decorative code. No helpers for single callers, no speculative abstractions, no options for hypothetical future needs

No other project uses it yet