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

ClawBioCLAUDE.md

ClawBio

ClawBio/ClawBio/CLAUDE.md

File | Purpose | |---|---| | `CLAUDE.md` | Routing rules, CLI reference, demo data, and safety instructions for Claude Code | | `commands/` | Slash commands for analysis, skill scaffolding, skill listing, and demos | | `skills/catalog.json` | Machine-readable index

1.1k7mo agoDiscuss

AltanSCLAUDE.md

collie

AltanS/collie/CLAUDE.md

left with it; CI covers it through `scripts/check-mux-names.test.ts`. - **A finding is fixed in the code, never suppressed and never cleared by downgrading a rule.** There are zero `oxlint-disable` comments

1.1k44d agoDiscuss

withkynamCLAUDE.md

vibecode-pro-max-kit

withkynam/vibecode-pro-max-kit/CLAUDE.md

orchestrator/execute-agent): `vc-tester` (diff-aware test verification), `vc-debugger` (evidence-first root cause), `vc-code-reviewer` (production-readiness), `vc-code-simplifier` (clarity refactor, no behavior change), `vc-quick-fix-agent

1.1k3mo agoDiscuss

K9i-0CLAUDE.md

ccpocket

K9i-0/ccpocket/CLAUDE.md

claude/skills/shorebird-patch/SKILL.md](.claude/skills/shorebird-patch/SKILL.md)。既定はstaging。stable昇格はユーザーが行う。 - ストア素材・説明文: [.claude/skills/update-store/SKILL.md](.claude/skills/update-store/SKILL.md) - ブランチのマージ: [.claude/skills/merge/SKILL.md](.claude/skills/merge/SKILL.md) ## ローカル補助 `.claude/agents/` に `code-reviewer` と `e2e-verifier` がある。利用できる環境で、独立したレビュー・検証が有効な場合に使う。 Claude用のhookは `.claude/settings.json` と `.claude/hooks/` を参照する。`post-edit

1.1k8mo agoDiscuss

weieskyCLAUDE.md

cc-viewer

weiesky/cc-viewer/CLAUDE.md

frontend) or `packages/app/server/i18n.js` (server/CLI) — adding them to the wrong file is prohibited. After any code change, `pnpm run build` must be run. Never commit `package-lock.json`. Any new dependency that ships

1.1k12d agoDiscuss

asklokeshCLAUDE.md

loki-mode

asklokesh/loki-mode/CLAUDE.md

sight. SKILL.md stays under 500 lines with header AND footer version bumped together. - Harness code invariants (see `docs/dev/architecture-reference.md`): new always-on prompt text goes in the cache-stable prefix; `goal_score.ts

1.1k4mo agoDeletes or force-pushesDiscuss

jarrodwattsCLAUDE.md

claude-code-config

jarrodwatts/claude-code-config/CLAUDE.md

1.1k8mo agoDiscuss

nateherkaiCLAUDE.md

hyperframes-student-kit

nateherkai/hyperframes-student-kit/CLAUDE.md

breathe. The project brief controls pacing, palette, and typography. Framework skill contracts override historical code recipes in the style guide. ## Workspace Create a project with `npm run new-video

1.1k5d agoDiscuss

jonwigginsCLAUDE.md

optio

jonwiggins/optio/CLAUDE.md

watcher tracks CI checks, review status, and merge state 7. Auto-triggers code review agent on CI pass or PR open (if enabled) 8. Auto-resumes agent when reviewer requests

1.1k7mo agoReads credentialsDiscuss

AgriciDanielCLAUDE.md

banana-claude

AgriciDaniel/banana-claude/CLAUDE.md

drift and replay controls, not proof of human review. Mark paid MCP tools with `anthropic/requiresUserInteraction`; Claude Code 2.1.199+ forces an interactive host decision even under allow, Auto, or Bypass modes

1k32d agoDiscuss

beizhu-1209CLAUDE.md

AIHelms

beizhu-1209/AIHelms/CLAUDE.md

examples → `ui/CLAUDE.md` - General behavior rules → `.claude/rules/core-rules.md` - Project conventions (API format, database, auth, etc.) → `.claude/rules/project-rules.md` - Code review checklist → `.claude/commands/code-review.md` ## Progress Tracking - Project progress and task planning in `dev/roadmap/` folder - Update `dev/roadmap

1k5mo agoReads credentialsDiscuss

jezwebCLAUDE.md

claude-skills

jezweb/claude-skills/CLAUDE.md

proven implementation patterns in `references/` for Claude to adapt. - Follows the official Claude Code plugin spec ## Directory Structure ``` claude-skills/ ├── plugins/ # one folder per plugin; the folders are the truth

1k7mo agoDiscuss

hoangsonwwCLAUDE.md

Claude-Code-Agent-Monitor

hoangsonww/Claude-Code-Agent-Monitor/CLAUDE.md

audit script: `.claude/skills/file-headers/` (verify with `bash .claude/skills/file-headers/scripts/check-headers.sh`). This binds every coding agent (Claude Code, Codex, or others). ## Commands you should know - Setup: `npm run setup` - Dev: `npm run dev` - Prod

1k57d agoDiscuss

chamiloCLAUDE.md

chamilo-lms

chamilo/chamilo-lms/CLAUDE.md

code, read exports, immediate callers, shared utilities. "Looks orthogonal" is dangerous. If unsure why code is structured a way, ask. ### Rule 9 — Tests verify intent, not just behavior Tests must

1k42d agoReads credentialsDiscuss

NVIDIACLAUDE.md

cudf-spark

NVIDIA/cudf-spark/.claude/CLAUDE.md

Claude Code Instructions @../AGENTS.md Follow the imported agent-specific repository policy for all code, review, commit, and pull request work. Consult the linked human process documents on demand only when

1k35d agoDiscuss

bytechefhqCLAUDE.md

bytechef

bytechefhq/bytechef/CLAUDE.md

code ./gradlew check # Run all checks # Client-side cd client npm run format # Format code npm run check # Run lint, typecheck, and tests ``` ### Creating Custom Components via CLI ByteChef includes

1k11mo agoDiscuss

MadAppGangCLAUDE.md

claudish

MadAppGang/claudish/CLAUDE.md

tries on a provider | **Harness and runtime** | Use | Never write | Means | |---|---|---| | harness | host | Claude Code driving the session; "host" is the MCP host that spawns the server | | foreign model | external

1k58d agoReads credentialsDiscuss

autonomous-aiCLAUDE.md

autonomous-harness / desktop

autonomous-ai/autonomous-harness/desktop/CLAUDE.md

rewriting it from memory. The harness CLI (`autonomous-harness`) still carries its own grid code (`gridLaunch.ts`, `gridWebMcp.ts`, `agent_retarget`, `harness grid login`); nothing here calls it. ## Toolchain and commands `pubspec.yaml

99520d agoReads credentialsDiscuss

jarrodwattsCLAUDE.md

claude-delegator

jarrodwatts/claude-delegator/CLAUDE.md

subagents. Five domain experts that can advise OR implement: Architect, Plan Reviewer, Scope Analyst, Code Reviewer, and Security Analyst. ## Development Commands ```bash # Test plugin locally (loads from working directory) claude

9957mo agoDiscuss

AlmanacCodeCLAUDE.md

codealmanac

AlmanacCode/codealmanac/CLAUDE.md

dispatch multiple subagents in parallel. Don't serialize work that doesn't need serializing. ### Code review When the user asks for a code review or reviewer, read `.claude/agents/review.md` first

9934mo 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.