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

jnMetaCodeCLAUDE.md

agency-orchestrator

jnMetaCode/agency-orchestrator/CLAUDE.md

repo `ai-shortfilm-prompts` (MIT, same author). The upstream `SKILL.md` is an **interactive** Claude Code skill (it asks via AskUserQuestion, `Read`s template files); AO steps have no tools

2.3k6mo agoReads credentialsDiscuss

muxy-appCLAUDE.md

demo extension at ~/.config/muxy/extensions to the user. - Prefix the demo extensions with `demo-*` ## Code Review - Review changes against the stated PR, issue, or task. Start with the diff, directly affected

2.3k6mo agoDiscuss

tractorjuiceCLAUDE.md

arc-kit

tractorjuice/arc-kit/CLAUDE.md

plugins/arckit-claude/hooks/README.md).** [`plugins/arckit-claude/docs/ENFORCEMENT.md`](plugins/arckit-claude/docs/ENFORCEMENT.md) is the three-tier statement of what the hooks enforce in code, what is only asked of the model, and what the deploying organisation owns — a change

2.2k5mo agoReads credentialsDiscuss

oh-my-mermaidCLAUDE.md

oh-my-mermaid

oh-my-mermaid/oh-my-mermaid/CLAUDE.md

translations in the same commit - Translations can be machine-generated but should be reviewed for obvious errors ## Versioning - Follow [Semantic Versioning](https://semver.org/) - Sync version across: `package.json`, `.claude-plugin

2.2k6mo agoDiscuss

jhlee0409CLAUDE.md

claude-code-history-viewer

jhlee0409/claude-code-history-viewer/CLAUDE.md

CLAUDE.md This file provides guidance to Claude Code (claude.ai/code) when working with code in this repository. If the user's prompt starts with “EP:”, then the user wants

2.2k3mo agoDeletes or force-pushesDiscuss

777geniusCLAUDE.md

agent-teams-ai

777genius/agent-teams-ai/CLAUDE.md

work autonomously in parallel, communicate with each other, create and manage their own tasks, review code, and collaborate across teams. You manage everything through a kanban board — like

2.2k4mo agoDeletes or force-pushesDiscuss

wondelaiCLAUDE.md

skills

wondelai/skills/CLAUDE.md

grow-business, grow-website, grow-app, improve-code-quality, remove-technical-debt, design-code-architecture, conversion-optimization, architecture-optimization | | **UX/Design** | refactoring-ui, ios-hig-design, ux-heuristics, hooked-ux, improve

2.2k3mo agoDiscuss

AgriciDanielCLAUDE.md

claude-blog

AgriciDaniel/claude-blog/CLAUDE.md

Creation & Optimization Skill ## Project Overview This repository contains **Claude Blog**, a Tier 4 Claude Code skill for blog content creation, optimization, and management. It follows the Agent Skills open standard

2.1k2mo agoDiscuss

LumiwealthCLAUDE.md

lumibot

Lumiwealth/lumibot/CLAUDE.md

rules live in `docs/BACKTESTING_ARCHITECTURE.md` under "RULE #1". Read it before touching any data-fetching code. ## Quick Start **First, read these files:** 1. `docs/BACKTESTING_ARCHITECTURE.md` - Understand the backtesting data flow

2.1k18d agoReads credentialsDiscuss

digitalsambaCLAUDE.md

claude-code-video-toolkit

digitalsamba/claude-code-video-toolkit/CLAUDE.md

FFmpeg ## Directory Structure ``` claude-code-video-toolkit/ ├── .claude/ │ ├── skills/ # Domain knowledge for Claude │ └── commands/ # Guided workflows ├── tools/ # Python CLI automation ├── templates/ # Video templates │ ├── sprint-review/ # Sprint review video template │ └── product

2.1k21d agoReads credentialsDiscuss

agentset-aiCLAUDE.md

agentset

agentset-ai/agentset/docs/CLAUDE.md

existing pages - Include both basic and advanced use cases - Language tags on all code blocks - Alt text on all images - Relative paths for internal links ## Common mistakes to avoid - **Inconsistent

2.1k8mo agoDiscuss

doobidooCLAUDE.md

mcp-memory-service

doobidoo/mcp-memory-service/CLAUDE.md

browsing. - Read graphify-out/GRAPH_REPORT.md only for broad architecture review or when query/path/explain do not surface enough context. - After modifying code, run `graphify update .` to keep the graph current

2k5d agoReads credentialsDiscuss

WorldFlowAICLAUDE.md

everything-claude-code / examples

WorldFlowAI/everything-claude-code/examples/CLAUDE.md

DEBUG=false ``` ## Available Commands - `/tdd` - Test-driven development workflow - `/plan` - Create implementation plan - `/code-review` - Review code quality - `/build-fix` - Fix build errors ## Git Workflow - Conventional commits: `feat:`, `fix:`, `refactor:`, `docs:`, `test

2k9mo agoReads credentialsDiscuss

xu-xiangCLAUDE.md

everything-claude-code-zh

xu-xiang/everything-claude-code-zh/CLAUDE.md

node tests/lib/package-manager.test.js node tests/hooks/hooks.test.js ``` ## 架构设计 (Architecture) 项目由以下核心组件组成： - **agents/** - 用于委派 (Delegation) 的专业子智能体 (Subagents)（如 planner、code-reviewer、tdd-guide 等） - **skills/** - 工作流 (Workflow) 定义与领域知识（如编码标准、模式、测试） - **commands/** - 用户调用的斜杠命令 (Slash Commands

1.9k7mo agoDiscuss

severity1CLAUDE.md

claude-code-prompt-improver

severity1/claude-code-prompt-improver/CLAUDE.md

module named `nudge_builtins` (not `builtins`) because the stdlib `builtins` is loaded before user code and would permanently shadow a local `builtins.py`; handlers/matchers referenced by allowlisted string name only

1.9k8mo agoDiscuss

eneskircaCLAUDE.md

nodeterm

eneskirca/nodeterm/CLAUDE.md

each exists, and the measurements behind them. It is loaded automatically by Claude Code. **Contributors: start with `CONTRIBUTING.md`** — the short version (setup, boundaries, house rules, testing habits). This file

1.9k7d agoReads credentialsDiscuss

yoanbernabeuCLAUDE.md

grepai

yoanbernabeu/grepai/CLAUDE.md

description" --body "Closes # " ``` 4. **Before merging**, ensure: - CI pipeline passes (all checks green) - Code has been reviewed if required - No merge conflicts with `main` **IMPORTANT:** Never push directly to `main

1.9k9mo agoDiscuss

zzetCLAUDE.md

gortex

zzet/gortex/CLAUDE.md

PATH` (signed in once); optional `llm.claudecli.model` (`sonnet`/`opus`/…). Reuses the user's Claude Code subscription. | | `codex` | OpenAI `codex` CLI subprocess | `codex` on `$PATH` (signed in once); optional `llm.codex.model`. Runs `codex

1.8k6mo agoReads credentialsDiscuss

nimbalystCLAUDE.md

nimbalyst

nimbalyst/nimbalyst/CLAUDE.md

that take required parameters or handle workspace state. | | [NAMING_CONVENTIONS.md](./docs/NAMING_CONVENTIONS.md) | Designing wire protocols, sync code, or SQL schemas. | | [AI_PROVIDER_TYPES.md](./docs/AI_PROVIDER_TYPES.md) | Working on AI integration, adding providers, or modifying model selection

1.8k5mo agoReads credentialsDiscuss

a5c-aiCLAUDE.md

babysitter

a5c-ai/babysitter/CLAUDE.md

Code Local Notes - `.claude/settings.json` blocks direct edits to lockfiles; use npm or pnpm commands instead. - `.claude/settings.json` also auto-runs SDK lint autofix after TypeScript file edits. - If you need reviewer

1.8k3mo 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.