CLAUDE.md examples from real projects

How real projects brief Claude Code: the commands, conventions and warnings they put in CLAUDE.md.

Best matches · from page 9Worked for most · soon

xu-xiangCLAUDE.md

everything-claude-code-zh

xu-xiang/everything-claude-code-zh/CLAUDE.md

node tests/lib/package-manager.test.js node tests/hooks/hooks.test.js ``` ## 架构设计 (Architecture) 项目由以下核心组件组成： - **agents/** - 用于委派 (Delegation) 的专业子智能体 (Subagents)（如 planner、code-reviewer、tdd-guide 等） - **skills/** - 工作流 (Workflow) 定义与领域知识（如编码标准、模式、测试） - **commands/** - 用户调用的斜杠命令 (Slash Commands

1.9k7mo agoDiscuss

severity1CLAUDE.md

claude-code-prompt-improver

severity1/claude-code-prompt-improver/CLAUDE.md

module named `nudge_builtins` (not `builtins`) because the stdlib `builtins` is loaded before user code and would permanently shadow a local `builtins.py`; handlers/matchers referenced by allowlisted string name only

1.9k8mo agoDiscuss

eneskircaCLAUDE.md

nodeterm

eneskirca/nodeterm/CLAUDE.md

each exists, and the measurements behind them. It is loaded automatically by Claude Code. **Contributors: start with `CONTRIBUTING.md`** — the short version (setup, boundaries, house rules, testing habits). This file

1.9k8d agoReads credentialsDiscuss

yoanbernabeuCLAUDE.md

grepai

yoanbernabeu/grepai/CLAUDE.md

description" --body "Closes # " ``` 4. **Before merging**, ensure: - CI pipeline passes (all checks green) - Code has been reviewed if required - No merge conflicts with `main` **IMPORTANT:** Never push directly to `main

1.9k9mo agoDiscuss

zzetCLAUDE.md

gortex

zzet/gortex/CLAUDE.md

PATH` (signed in once); optional `llm.claudecli.model` (`sonnet`/`opus`/…). Reuses the user's Claude Code subscription. | | `codex` | OpenAI `codex` CLI subprocess | `codex` on `$PATH` (signed in once); optional `llm.codex.model`. Runs `codex

1.8k6mo agoReads credentialsDiscuss

nimbalystCLAUDE.md

nimbalyst

nimbalyst/nimbalyst/CLAUDE.md

that take required parameters or handle workspace state. | | [NAMING_CONVENTIONS.md](./docs/NAMING_CONVENTIONS.md) | Designing wire protocols, sync code, or SQL schemas. | | [AI_PROVIDER_TYPES.md](./docs/AI_PROVIDER_TYPES.md) | Working on AI integration, adding providers, or modifying model selection

1.8k5mo agoReads credentialsDiscuss

a5c-aiCLAUDE.md

babysitter

a5c-ai/babysitter/CLAUDE.md

Code Local Notes - `.claude/settings.json` blocks direct edits to lockfiles; use npm or pnpm commands instead. - `.claude/settings.json` also auto-runs SDK lint autofix after TypeScript file edits. - If you need reviewer

1.8k3mo agoDiscuss

xiufengsunCLAUDE.md

TokenTracker

xiufengsun/TokenTracker/CLAUDE.md

everything `anthropic`. That `anthropic` bucket includes mimo-named models the user ran *inside* Claude Code (e.g. `model=mimo-v2.5-pro`, logged in `~/.claude

1.8k2mo agoReads credentialsDiscuss

happier-devCLAUDE.md

happier

happier-dev/happier/.claude/CLAUDE.md

interface-details` skills before writing surface code, reuse existing components, themed tokens, and text primitives, and treat duplicate animation/UI primitives as a review finding. ## Delegation shape (what worked) - **Corridor-sized

1.8k8d agoDiscuss

relaticleCLAUDE.md

relaticle

relaticle/relaticle/CLAUDE.md

impact revenue and user trust. Treat every change like it's going through senior code review: - No lazy shortcuts or placeholder code - Handle errors and edge cases properly - Write code

1.7k7d agoReads credentialsDiscuss

BayramAnnakovCLAUDE.md

claude-reflect

BayramAnnakov/claude-reflect/CLAUDE.md

when working with code in this repository. ## Project Overview claude-reflect is a Claude Code plugin that implements a two-stage self-learning system: 1. **Capture Stage** (automatic): Hooks detect

1.7k9mo agoDiscuss

lahfirCLAUDE.md

agent-desktop

lahfir/agent-desktop/CLAUDE.md

AdapterError::not_supported())` No existing files are modified beyond the registration points. Enforce via code review. ## JSON Output Contract Every command produces a response envelope: ```json { "version": "2.4", "ok": true

1.7k3mo agoDiscuss

LynpointCLAUDE.md

CyberVerse

Lynpoint/CyberVerse/claude.md

agreement before correction. Bad: “Yes, you’re right, but…” Good: “No. The issue is…” Code Review Rules When reviewing or modifying code: - Do not assume the user’s diagnosis

1.6k4mo agoDiscuss

ddalcuCLAUDE.md

mlx-serve

ddalcu/mlx-serve/CLAUDE.md

Never: bug history, measurements, audit trails, review item numbers, dates, "PR #NNN", what an older commit did, or a restatement of the code. That belongs in the commit message

1.6k3d agoDeletes or force-pushesDiscuss

e2b-devCLAUDE.md

infra

e2b-dev/infra/CLAUDE.md

CLAUDE.md This development guide applies to Codex, Claude Code, and OpenCode. Repository and review rules are shared through: @AGENTS.md ## Project Overview E2B Infrastructure is the backend infrastructure powering E2B (e2b.dev

1.6k17d agoReads credentialsDiscuss

pedrohcgsCLAUDE.md

claude-code-my-workflow

pedrohcgs/claude-code-my-workflow/CLAUDE.md

checker* to the external oracle, and how the review loop converges. - [`external-oracle-process.md`](.claude/references/external-oracle-process.md) — running an independent frontier-model referee (Claude Code → another vendor's model via the Oracle CLI; current

1.6k4d agoDiscuss

actionbookCLAUDE.md

actionbook

actionbook/actionbook/CLAUDE.md

Weekly engineering retrospective - `/investigate` - Debug and investigate errors - `/document-release` - Post-ship documentation - `/codex` - Adversarial code review - `/careful` - Production/live systems safety mode - `/freeze` - Scope edits to one module/directory - `/guard` - Maximum safety

1.6k2mo agoReads credentialsDiscuss

ShpigfordCLAUDE.md

chops

Shpigford/chops/CLAUDE.md

SchemaMigrationPlan` (see `SchemaVersions.swift`). Each schema version must declare its own nested `@Model` snapshots; app code reaches the current version through top-level `typealias`es like `Skill = SchemaV1.Skill`. When adding

1.6k6mo agoDiscuss

rivet-devCLAUDE.md

sandbox-agent / foundry

rivet-dev/sandbox-agent/foundry/CLAUDE.md

JSON.stringify(value ?? []);` then depend on `key` - Memoize: `const stable = useMemo(() => value ?? [], [value]);` - When reviewing code, treat any `?? []`, `?? {}`, or inline `.map()/.filter()` in a dependency array as a bug. ## UI System

1.6k7mo agoReads credentialsDiscuss

GWUDCAPCLAUDE.md

cc-sessions

GWUDCAP/cc-sessions/CLAUDE.md

work logs - `cc_sessions/agents/code-review.md` - Reviews implementations - `cc_sessions/agents/context-refinement.md` - Updates context with discoveries - `cc_sessions/agents/service-documentation.md` - Maintains service docs ### Supporting Infrastructure - `cc_sessions/python/statusline.py` or `javascript/statusline.js` - Claude Code statusline with git info

1.6k12mo agoDiscuss

CLAUDE.md vs AGENTS.md

About CLAUDE.md

What is CLAUDE.md?

A file Claude Code reads at the start of every session. It holds the commands, conventions and warnings the agent needs for this project.

Where does it go?

At the repository root. Claude Code also reads CLAUDE.md files in subdirectories when it works there.

What should it contain?

Build and test commands, the project's layout, conventions that aren't obvious from the code, and mistakes to avoid. Short files tend to work better than long ones.

CLAUDE.md or AGENTS.md?

Claude Code reads CLAUDE.md; most other agents read AGENTS.md. Many projects keep one and point the other at it.