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

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

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.