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

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

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

alirezarezvaniCLAUDE.md

claude-skills / markdown-html

alirezarezvani/claude-skills/markdown-html/CLAUDE.md

25k5mo agoDiscuss

alirezarezvaniCLAUDE.md

claude-skills / ra-qm-team

alirezarezvani/claude-skills/ra-qm-team/CLAUDE.md

Regulatory Affairs & Quality Management Skills - Claude Code Guidance This guide covers the 14 production-ready RA/QM compliance skills for HealthTech/MedTech companies. ## RA/QM Skills Overview **Strategic Leadership (2 skills):** - regulatory-affairs

25k5mo agoDiscuss

alirezarezvaniCLAUDE.md

claude-skills / standards

alirezarezvani/claude-skills/standards/CLAUDE.md

Checklist ### Before Committing Code - [ ] Communication: Documentation is clear and actionable - [ ] Quality: All tests passing, code reviewed - [ ] Git: Conventional commit message format - [ ] Documentation: Living docs updated if needed - [ ] Security: No secrets

25k5mo agoDiscuss

VoltAgentCLAUDE.md

awesome-claude-code-subagents

VoltAgent/awesome-claude-code-subagents/CLAUDE.md

Python, etc.) 03-infrastructure/ # DevOps, cloud, Kubernetes, etc. 04-quality-security/ # Testing, security auditing, code review 05-data-ai/ # ML, data engineering, AI specialists 06-developer-experience/ # Tooling, documentation

25k7mo agoDiscuss

activepiecesCLAUDE.md

activepieces

activepieces/activepieces/CLAUDE.md

surface needs the placeholder. ## Key Utilities (`@activepieces/shared`) `apId()`, `tryCatch()`, `tryCatchSync()`, `isNil()`, `spreadIfDefined()`, `spreadIfNotUndefined()`, `ActivepiecesError({ code, params })`, `SeekPage `, `formErrors`, `BaseModelSchema`, `chunk()`, `partition()`, `unique()`, `omit()`, `sanitizeObjectForPostgresql()` ## Testing ```bash npm run test-unit

25k4mo agoDeletes or force-pushesDiscuss

microCLAUDE.md

go-micro

micro/go-micro/CLAUDE.md

gets orphaned (this happened — the #3007 fixes had to be re-landed). If the code you need isn't merged yet, wait for it, then branch off `master`. To improve

23k3mo agoDiscuss

czlonkowskiCLAUDE.md

n8n-mcp

czlonkowski/n8n-mcp/CLAUDE.md

user to reload the MCP server before testing - Run `npm run typecheck` after every code change - Never commit directly to main — use feature branches and PRs - Add to every commit

23k33d agoDiscuss

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.