CLAUDE.md examples from real projects

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

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

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

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

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

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

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

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

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

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

No other project uses it yet

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

GoogleCLAUDE.md

elephant-goldfish-model / claude

google/elephant-goldfish-model/distributions/claude/docs/claude.md

prompts loaded by Antigravity and other harnesses. 2. `.claude-plugin/agents/`: Contains Claude Code adapters. Reviewer adapters use `omitClaudeMd: true` and `tools: [Read, Grep, Glob]`; the synthesizer and bootstrap orchestrator

chaos-meshCLAUDE.md

chaos-mesh

chaos-mesh/chaos-mesh/CLAUDE.md

generate` are not read-only: they can rewrite generated code, manifests, module files, formatted Go files, or test artifacts. Review the resulting diff and keep only task-related changes

UpsonicReads credentialsCLAUDE.md

Upsonic

Upsonic/Upsonic/CLAUDE.md

code in this repo is named, typed, structured, formatted, tested, and reviewed. Pure Python coding standard; framework-agnostic. - **`documents/ai/guides/serena.md`** — Always-on. When and how to use Serena MCP for symbol

midudevCLAUDE.md

preguntas-entrevista-react

midudev/preguntas-entrevista-react/CLAUDE.md

code quality. Use when asked to "apply best practices", "security audit", "modernize code", "code quality review", or "check for vulnerabilities". - `.claude/skills/best-practices/SKILL.md` ## Core Web Vitals optimization Optimize Core Web Vitals