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 2Worked for most · soon

AnthropicCLAUDE.md

claude-cookbooks

anthropics/claude-cookbooks/CLAUDE.md

formatting and notebook structure. ## Slash Commands These commands are available in Claude Code and CI: - `/notebook-review` - Review notebook quality - `/model-check` - Validate Claude model references - `/link-review` - Check links in changed files

53k8mo agoReads credentialsDiscuss

CherryHQCLAUDE.md

cherry-studio

CherryHQ/cherry-studio/CLAUDE.md

patches. ## GitHub ### Pull Requests Use the `gh-create-pr` skill. Fallback: read `.agents/skills/gh-create-pr/SKILL.md` directly. ### Code Review When reviewing a GitHub PR, do NOT run `pnpm lint` / `pnpm test` / `pnpm format

52k42d agoDiscuss

Imbad0202CLAUDE.md

academic-research-skills

Imbad0202/academic-research-skills/.claude/CLAUDE.md

Academic Research Skills A suite of Claude Code skills for rigorous academic research, paper writing, peer review, and pipeline orchestration. ## Skills Overview | Skill | Purpose | Key Modes | |-------|---------|-----------| | `deep-research` v2.12.1

50k7d agoDiscuss

QuantumNousCLAUDE.md

new-api

QuantumNous/new-api/CLAUDE.md

AGENTS.md` as loaded. Claude Code does not reliably inline that import. Before any planning, coding, reviewing, or answering a project question, you MUST call the Read tool on the repo

49k13d agoDiscuss

danny-avilaCLAUDE.md

LibreChat

danny-avila/LibreChat/CLAUDE.md

state the change actually carries. Describe the code as it stands: do not narrate what earlier commits tried or what a review round changed. Naming the merged pull request that

45k49d agoDiscuss

MadsLorentzenCLAUDE.md

ai-job-search

MadsLorentzen/ai-job-search/CLAUDE.md

Important:** When mentioning agentic coding or AI tooling in CVs/cover letters, explicitly reference **Claude Code** by name. ## Verification Checklist After creating or updating a CV or cover letter, re-read

44k3d agoDiscuss

agno-agiCLAUDE.md

agno

agno-agi/agno/CLAUDE.md

code (ruff check, mypy) ./scripts/validate.sh ``` Both scripts must pass with no errors before code review. **PR Title Format:** PR titles must follow one of these formats: - `type: description` — e.g., `feat

42k16mo agoDiscuss

mindsdbCLAUDE.md

mindshub

mindsdb/mindshub/CLAUDE.md

push ``` > The parent repo stores a commit SHA pointer to each submodule, not the code itself. Always push from inside the submodule first, then update the pointer in the parent

40k4y agoReads credentialsDiscuss

Yeachan-HeoCLAUDE.md

oh-my-claudecode

Yeachan-Heo/oh-my-claudecode/CLAUDE.md

later in a separate lane. Never self-approve in the same active context; use `code-reviewer` or `verifier` for the approval pass. Before concluding: zero pending tasks, tests passing, verifier

39k27d agoDiscuss

davila7CLAUDE.md

claude-code-templates

davila7/claude-code-templates/CLAUDE.md

setting read-only-mode # Interactive mode npx claude-code-templates@latest ``` ### Component Development #### Adding New Components **CRITICAL: Use the component-reviewer agent for ALL component changes** When adding or modifying

32k3mo agoReads credentialsDiscuss

tirth8205CLAUDE.md

code-review-graph

tirth8205/code-review-graph/CLAUDE.md

CLAUDE.md - Project Context for Claude Code ## Project Overview code-review-graph is a local-first knowledge graph for code review. It parses a repository with Tree-sitter (plus targeted fallbacks

32k4mo agoDiscuss

topoteretesCLAUDE.md

cognee

topoteretes/cognee/CLAUDE.md

# CLAUDE.md This file provides guidance to Claude Code (claude.ai/code) when working with code

31k13d agoReads credentialsDiscuss

decoluaCLAUDE.md

9router

decolua/9router/CLAUDE.md

trusting forwarding headers only from a loopback reverse proxy. Preserve this when touching request/IP/rate-limit code. - Security-sensitive env: `JWT_SECRET` (session cookie), `INITIAL_PASSWORD` (default `123456` — must override

30k9d agoReads credentialsDiscuss

manaflow-aiCLAUDE.md

cmux

manaflow-ai/cmux/CLAUDE.md

scripts/cmux-debug-cli.sh`, never `/tmp/cmux-cli`. Never report raw `.app` paths or `file://` URLs. - App-linked code (`Sources/`, `CLI/`, `TunnelExtension/` and their packages) must remain [Swift 6.0 compatible](skills/cmux-architecture/references/swift-6-0-compatibility.md). ## Area instructions Read these

27k3d agoDiscuss

phurynCLAUDE.md

pm-skills

phuryn/pm-skills/CLAUDE.md

metrics, naming, positioning | | `pm-toolkit` | Resume review, NDA drafting, privacy policy, grammar/flow checking | | `pm-ai-shipping` | AI Shipping Kit: document a vibe-coded app, map test coverage, audit security/performance against

26k3mo agoDiscuss

DonchitosCLAUDE.md

Claude-Code-Game-Studios / CCGS Skill Testing Framework

Donchitos/Claude-Code-Game-Studios/CCGS Skill Testing Framework/CLAUDE.md

propagate-design-change, map-systems, vertical-slice analysis → consistency-check, balance-check, content-audit, code-review, tech-debt, scope-check, estimate, perf-profile, asset-audit, security-audit, test-evidence-review

25k8d agoDiscuss

alirezarezvaniCLAUDE.md

claude-skills / agents

alirezarezvani/claude-skills/agents/CLAUDE.md

25k5mo agoDiscuss

alirezarezvaniCLAUDE.md

claude-skills

alirezarezvani/claude-skills/CLAUDE.md

deviations from upstream (6 cosmetic, 17 safety/hardening)**, found across ten rounds of adversarial code review rather than assumed safe from the surface docs. The **numbered list in `engineering/skillopt-sleep/README.md`'s "Deviations

25k5mo agoReads credentialsDiscuss

alirezarezvaniCLAUDE.md

claude-skills / c-level-advisor

alirezarezvani/claude-skills/c-level-advisor/CLAUDE.md

Level Advisory Skills — Claude Code Guidance A complete virtual board of directors: 28 skills covering 10 executive roles, orchestration, cross-cutting capabilities, and culture & collaboration frameworks — plus

25k5mo agoDiscuss

alirezarezvaniCLAUDE.md

claude-skills / engineering-team

alirezarezvani/claude-skills/engineering-team/CLAUDE.md

senior-architect, senior-frontend, senior-backend, senior-fullstack - senior-qa, senior-devops, senior-secops - code-reviewer, senior-security - aws-solution-architect, ms365-tenant-manager, google-workspace-cli, tdd-guide, tech

25k5mo 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.