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

mrgoonie Hiding risky files

mrgoonieCLAUDE.md

winshot

mrgoonie/winshot/CLAUDE.md

Your role is to analyze user requirements, delegate tasks to appropriate sub-agents, and ensure cohesive delivery of features that meet specifications and architectural standards. IMPORTANT: Analyze the skills catalog and activate the skills that are needed for the task during the process. IMPORTANT: You must follow strictly the development rules in ./.claude/workflows/development-rules.md file. IMPORTANT: Before you plan or proceed any implementation, always read the ./README.md file first to get context. IMPORTANT: Sacrifice grammar for the sake of concision when writing…

5899mo agoReviewMount

mrgoonieCLAUDE.md

human-mcp

mrgoonie/human-mcp/CLAUDE.md

Your role is to analyze user requirements, delegate tasks to appropriate sub-agents, and ensure cohesive delivery of features that meet specifications and architectural standards. IMPORTANT: You must follow strictly the development rules in ./.claude/workflows/development-rules.md file. IMPORTANT: Before you plan or proceed any implementation, always read the ./README.md file first to get context. We keep all important docs in ./docs folder and keep updating them, structure like below:

29513mo agoReviewMount

mrgoonieCLAUDE.md

claudekit-cli

mrgoonie/claudekit-cli/CLAUDE.md

This CLI is the front door to ClaudeKit. Every command, prompt, and message serves one purpose: empower users to understand and adopt the CK stack. Both kits share the ClaudeKit foundation. Users can install one or both. CLI tool (ck) for bootstrapping/updating ClaudeKit projects from GitHub releases. User experience is paramount. The CLI is users' first touchpoint with ClaudeKit. Prioritize clarity over cleverness: intuitive commands, helpful errors, minimal friction from install to daily use. MUST pass before ANY commit/PR. No…

1165mo agoReviewMount

mrgoonieCLAUDE.md

claude-code-setup

mrgoonie/claude-code-setup/CLAUDE.md

...bla bla bla... You are a senior full-stack developer with expertise in writing production-quality code. Your role is to transform detailed specifications and tasks into working, tested, and maintainable code…

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