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

DonchitosCLAUDE.md

Claude-Code-Game-Studios / src

Donchitos/Claude-Code-Game-Studios/src/CLAUDE.md

decision log carries them) - Commits must reference the relevant story ID or design document ## File Routing Match the engine-specialist agent to the file type being written. See `CLAUDE.md` → Technical

25k8d agoDiscuss

alirezarezvaniCLAUDE.md

claude-skills / agents

alirezarezvani/claude-skills/agents/CLAUDE.md

Metrics** (how to measure effectiveness) 6. **Related Agents** (cross-references) 7. **References** (links to documentation) ## Relative Path Resolution ### Path Pattern All skill references use the `../../` pattern: ```markdown **Skill Location

25k5mo agoDiscuss

alirezarezvaniCLAUDE.md

claude-skills

alirezarezvani/claude-skills/CLAUDE.md

excluded from the public GitHub tree so cloners only see production skill packages: - `documentation/` — sprint plans, strategy, implementation roadmaps - `eval-workspace/` — Tessl evaluation outputs - `megaprompts/` — pre-skill draft specs (Path

25k5mo agoReads credentialsDiscuss

alirezarezvaniCLAUDE.md

claude-skills / engineering-team

alirezarezvani/claude-skills/engineering-team/CLAUDE.md

quality analysis and metrics **Features:** - Security vulnerability scanning - Performance issue detection - Test coverage assessment - Documentation quality - Dependency analysis - Actionable recommendations **Usage:** ```bash # Analyze project python senior-fullstack/scripts/code_quality_analyzer.py /path/to/project # JSON

25k5mo agoDiscuss

alirezarezvaniCLAUDE.md

claude-skills / markdown-html

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

25k5mo agoDiscuss

alirezarezvaniCLAUDE.md

claude-skills / product-team

alirezarezvani/claude-skills/product-team/CLAUDE.md

compliance and design (1 tool: hig_checker) 16. **spec-to-repo/** - Convert a spec document into a scaffolded repository **Total Tools:** 22 Python automation tools **Agents:** 6 (cs-product-orchestrator

25k5mo agoDiscuss

alirezarezvaniCLAUDE.md

claude-skills / project-management

alirezarezvani/claude-skills/project-management/CLAUDE.md

five reusable PM loops (sprint-flow, health, retro-action, RAID-hygiene, comms) are documented in `skills/pm-skills/references/pm_loop_playbook.md`. ## Atlassian MCP Integration **Purpose:** Direct integration with Jira and Confluence via Model Context Protocol

25k5mo agoDiscuss

alirezarezvaniCLAUDE.md

claude-skills / ra-qm-team

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

compliance, process management - capa-officer - CAPA system management, root cause analysis - quality-documentation-manager - DHF, DMR, DHR management **Risk & Security (2 skills):** - risk-management-specialist - ISO 14971 compliance, risk analysis

25k5mo agoDiscuss

alirezarezvaniCLAUDE.md

claude-skills / standards

alirezarezvani/claude-skills/standards/CLAUDE.md

quality, testing, and validation standards 3. **git/** - Git workflow, conventional commits, branching strategy 4. **documentation/** - Markdown quality, structure consistency, living docs 5. **security/** - Secret detection, dependency security, input validation ## When

25k5mo agoDiscuss

alirezarezvaniCLAUDE.md

claude-skills / templates

alirezarezvani/claude-skills/templates/CLAUDE.md

point for creating new cs-* agents **Contains:** - YAML frontmatter structure - Required markdown sections - Workflow documentation format - Integration examples pattern **When to Use:** Creating any new agent in `agents/` directory ### Command

25k5mo agoDiscuss

VoltAgentCLAUDE.md

awesome-claude-code-subagents

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

code review 05-data-ai/ # ML, data engineering, AI specialists 06-developer-experience/ # Tooling, documentation, DX optimization 07-specialized-domains/ # Blockchain, IoT, fintech, gaming 08-business-product/ # Product management, business

25k7mo agoDiscuss

SuperClaude-OrgCLAUDE.md

SuperClaude_Framework

SuperClaude-Org/SuperClaude_Framework/CLAUDE.md

tests) ├── unit/ # Unit tests (auto-marked @pytest.mark.unit) └── integration/ # Integration tests (auto-marked @pytest.mark.integration) docs/ # Documentation scripts/ # Analysis tools (workflow metrics, A/B testing) plugins/ # Exported plugin artefacts for distribution PLANNING.md # Architecture

24k11mo agoDiscuss

microCLAUDE.md

go-micro

micro/go-micro/CLAUDE.md

Common MCP issues and solutions - **Error Handling Guide** - Patterns for agent-friendly error responses - **Documentation Guides** - Six guides: AI-native services, MCP security, tool descriptions, agent patterns, error handling, troubleshooting

23k3mo agoDiscuss

czlonkowskiCLAUDE.md

n8n-mcp

czlonkowski/n8n-mcp/CLAUDE.md

Model Context Protocol) server that gives AI assistants access to n8n node documentation, workflow validation, and workflow management. Documentation and validation tools work offline against a bundled SQLite database

23k33d agoDiscuss

steipeteCLAUDE.md

CodexBar

steipete/CodexBar/docs/claude.md

cookie-header accounts stay in manual cookie mode. The exact edge-routing rules are documented in [docs/refactor/claude-current-baseline.md](refactor/claude-current-baseline.md). - Cookie source order: 1) Safari: `~/Library/Cookies/Cookies.binarycookies` 2) Chrome/Chromium forks: `~/Library/Application Support/Google/Chrome/*/Cookies

22k4mo agoReads credentialsDiscuss

teng-linCLAUDE.md

notebooklm-py

teng-lin/notebooklm-py/CLAUDE.md

pytest tests/integration/ -v`. - **E2E:** `tests/e2e/` (real API, `@pytest.mark.e2e`, requires auth). - Details: [docs/development.md](docs/development.md). ## Documentation Map Key references in `docs/`: [installation](docs/installation.md), [cli-reference](docs/cli-reference.md), [python-api](docs/python-api.md), [architecture](docs/architecture.md

20k29d agoDiscuss

getpaseoCLAUDE.md

paseo

getpaseo/paseo/CLAUDE.md

pile of paragraphs in discovery order. `docs/custom-providers.md` is what that looks like. - **Don't document logic.** Prose that restates code drifts from the code and loses. Write down what

19k54d agoDiscuss

muratcankoylanCLAUDE.md

Agent-Skills-for-Context-Engineering

muratcankoylan/Agent-Skills-for-Context-Engineering/CLAUDE.md

curating everything that enters a model's context window (system prompts, tool definitions, retrieved documents, message history, tool outputs) to maximize signal within limited attention budget. ## Repository Structure - `skills/` - published

18k52d agoDiscuss

AgriciDanielCLAUDE.md

claude-seo

AgriciDaniel/claude-seo/CLAUDE.md

install scripts seranking/ # SE Ranking MCP install scripts unlighthouse/ # Unlighthouse install scripts docs/ # Extended documentation ``` ## Commands | Command | Use Case | |---------|----------| | `/seo audit ` | Full website audit with parallel subagents | | `/seo page ` | Single

18k4mo agoReads credentialsDiscuss

CannerCLAUDE.md

WrenAI

Canner/WrenAI/.claude/CLAUDE.md

wren` command, profile/context/memory management (PyPI: wrenai) └── wren-mdl/ MDL JSON schema definition docs/core/ Module documentation examples/ Example projects (placeholder — to be populated) skills/ CLI-based agent skills (wren-generate

18k21mo 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.