CLAUDE.md examples from real projects

How real projects brief Claude Code: the commands, conventions and warnings they put in CLAUDE.md.

Your trail

Files you open will collect here, so you can find them again.

Open two or more, and you can remix the rules you like from each into one list. Kept in this browser only.

Worked for most · soon

MoizIbnYousaf

MoizIbnYousafReads credentialsCLAUDE.md

marketing-cli

MoizIbnYousaf/marketing-cli/CLAUDE.md

[!IMPORTANT] For runtime CLI usage (commands, flags, output formats), read CONTEXT.md first. For /cmo runtime indexes, read skills/cmo/rules/cli-runtime-index.md, skills/cmo/rules/publish-index.md, and skills/cmo/rules/studio-api-index.md. For /axi (AXI catalog router), read skills/axi/SKILL.md and skills/axi/rules/. For agent/skill contributor guidance, read AGENTS.md. This file is the project's development contract: architecture, standards, and rules. A TypeScript/Bun agent-native marketing playbook CLI. 76 marketing skills (74 playbook + /cmo + /axi), 7 agents (4 research + 3 review), 24 commands, 2 upstream catalogs (postiz, openseo). The Studio dashboard (Next.js…

336mo agoReviewMount

MoizIbnYousafReads credentialsCLAUDE.md

marketing-cli / studio

MoizIbnYousaf/marketing-cli/studio/CLAUDE.md

Build the visual studio layer for the mktg marketing CLI. The studio is a local-first Next.js dashboard driven by /cmo running in the user's Claude Code session. /cmo invokes studio HTTP endpoints to log activity, navigate tabs, refresh data, and fire toasts. The studio itself has no chat UI and no LLM integration - it's a dashboard + HTTP API. There is no Vercel AI SDK (ai, @ai-sdk/react), no in-app chat panel, and the studio never calls the Anthropic API…

336mo agoReviewMount

MoizIbnYousafCLAUDE.md

claude-dhikr

MoizIbnYousaf/claude-dhikr/CLAUDE.md

Dhikr spinner + prayer times statusline for Claude Code.

178mo agoReviewMount

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.