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

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

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

deepcoldyCLAUDE.md

botmux

deepcoldy/botmux/CLAUDE.md

botmux 飞书话题群 ↔ AI 编程 CLI 桥接。Daemon 监听飞书消息，每个新话题自动 spawn 一个独立 CLI 进程（Claude Code / Codex / Gemini 等 20+ 种，完整列表见 README）。 ## 构建 & 运行 ```bash bun run build # tsc 编译

1.5k3mo agoDiscuss

krusemediallcCLAUDE.md

arcads-claude-code / shared

krusemediallc/arcads-claude-code/shared/CLAUDE.md

Code Ad Agent and the GenAI system in Airtable - **Meta Masterclass** — the systems behind scaling Meta ads to 8 figures ($1.2k value) - **Custom GPTs** — ad copywriting, compliance review

1.5k6mo agoReads credentialsDiscuss

fim-aiCLAUDE.md

fim-one

fim-ai/fim-one/CLAUDE.md

alembic upgrade head` (shared SQLite dev DB desyncs). Write migration files + ORM + code only; apply after merge-back. - **Worktree merge-back**: orchestrator (main conversation) MUST `git merge ` when agent finishes

1.5k15d agoReads credentialsDiscuss

fynnflueggeCLAUDE.md

agtx

fynnfluegge/agtx/CLAUDE.md

Coding Agents A terminal-native kanban board for managing multiple coding agent sessions (Claude Code, Codex, Gemini, Copilot, OpenCode, Cursor, Grok, Antigravity) with isolated git worktrees. ## Quick Start ```bash # Build

1.5k5mo agoDiscuss

silversteinCLAUDE.md

minutes

silverstein/minutes/CLAUDE.md

items in Geist Mono) is the primary product demo. - In QA or design review: flag any code that introduces fonts, colors, or radius values not defined in DESIGN.md. ## GitHub Discussions

1.5k28d agoDiscuss

NeoLabHQCLAUDE.md

context-engineering-kit

NeoLabHQ/context-engineering-kit/CLAUDE.md

engineering-kit/ ├── .claude-plugin/ │ └── marketplace.json # Main marketplace manifest with all plugins ├── plugins/ # Plugin source code │ └── / │ ├── .claude-plugin/ │ │ └── plugin.json # Plugin manifest │ ├── README.md │ ├── commands/ # Slash commands (*.md) │ └── skills/ # Skills (*.md) ├── docs/ # Documentation

1.5k6mo agoDiscuss

hyhmrrightCLAUDE.md

brooks-lint

hyhmrright/brooks-lint/CLAUDE.md

simplify` + `agent-skills:review` steps still run before commit; only the optional PR-only `code-review:code-review` step is skipped. - **Doc sources of truth:** `package.json` is canonical for version

1.5k11d agoReads credentialsDiscuss

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.