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

deepcoldyCLAUDE.md

botmux

deepcoldy/botmux/CLAUDE.md

botmux 飞书话题群 ↔ AI 编程 CLI 桥接。Daemon 监听飞书消息，每个新话题自动 spawn 一个独立 CLI 进程（Claude Code / Codex / Gemini 等 20+ 种，完整列表见 README）。 ## 构建 & 运行 ```bash bun run build # tsc 编译

1.5k3mo agoDiscuss

krusemediallcCLAUDE.md

arcads-claude-code / shared

krusemediallc/arcads-claude-code/shared/CLAUDE.md

Code Ad Agent and the GenAI system in Airtable - **Meta Masterclass** — the systems behind scaling Meta ads to 8 figures ($1.2k value) - **Custom GPTs** — ad copywriting, compliance review

1.5k6mo agoReads credentialsDiscuss

fim-aiCLAUDE.md

alembic upgrade head` (shared SQLite dev DB desyncs). Write migration files + ORM + code only; apply after merge-back. - **Worktree merge-back**: orchestrator (main conversation) MUST `git merge ` when agent finishes

1.5k15d agoReads credentialsDiscuss

fynnflueggeCLAUDE.md

agtx

fynnfluegge/agtx/CLAUDE.md

Coding Agents A terminal-native kanban board for managing multiple coding agent sessions (Claude Code, Codex, Gemini, Copilot, OpenCode, Cursor, Grok, Antigravity) with isolated git worktrees. ## Quick Start ```bash # Build

1.5k5mo agoDiscuss

silversteinCLAUDE.md

minutes

silverstein/minutes/CLAUDE.md

items in Geist Mono) is the primary product demo. - In QA or design review: flag any code that introduces fonts, colors, or radius values not defined in DESIGN.md. ## GitHub Discussions

1.5k28d agoDiscuss

NeoLabHQCLAUDE.md

context-engineering-kit

NeoLabHQ/context-engineering-kit/CLAUDE.md

engineering-kit/ ├── .claude-plugin/ │ └── marketplace.json # Main marketplace manifest with all plugins ├── plugins/ # Plugin source code │ └── / │ ├── .claude-plugin/ │ │ └── plugin.json # Plugin manifest │ ├── README.md │ ├── commands/ # Slash commands (*.md) │ └── skills/ # Skills (*.md) ├── docs/ # Documentation

1.5k6mo agoDiscuss

hyhmrrightCLAUDE.md

brooks-lint

hyhmrright/brooks-lint/CLAUDE.md

simplify` + `agent-skills:review` steps still run before commit; only the optional PR-only `code-review:code-review` step is skipped. - **Doc sources of truth:** `package.json` is canonical for version

1.5k11d agoReads credentialsDiscuss

ZhangHanDongCLAUDE.md

harness-engineering-from-cc-to-ai-coding

ZhangHanDong/harness-engineering-from-cc-to-ai-coding/CLAUDE.md

specs/writing-plan.md` — 写作执行计划，含依赖图和批次安排编写任何章节前，先读对应的 spec 文件。大纲在 `docs/book-outline.md`。 ## 项目结构 ``` restored-src/src/ # Claude Code v2.1.88 还原的 TypeScript 源码（只读，不修改） book/ # mdbook 书籍项目 book.toml # mdbook 配置 src/ SUMMARY.md # 目录结构

1.5k6mo agoDiscuss

Open-Source-LegalCLAUDE.md

OpenContracts

Open-Source-Legal/OpenContracts/CLAUDE.md

utility files: - **Before writing new utilities**: Check existing utility files first (`frontend/src/utils/`, `opencontractserver/utils/`) - **When reviewing code**: If you find utility functions defined inline in components/views, check if they already exist

1.5k12mo agoDiscuss

umputunCLAUDE.md

ralphex

umputun/ralphex/CLAUDE.md

buildPreviousContext()`, prompt assembly - `pkg/processor/phase/external_review.go` - tool selection and external review loop ### Alternative Providers for Claude Phases `claude_command`/`claude_args` replace Claude Code with any `stream-json`-compatible CLI. Included wrappers

1.5k41d agoReads credentialsDiscuss

HexmosTechCLAUDE.md

git-lrc

HexmosTech/git-lrc/CLAUDE.md

authenticated against `HexmosTech/git-lrc` for `make release-gh`. ## Sequence 1. **Land the code change first.** Stage, review (or skip), commit, and push *before* touching the version: ``` git add git lrc review

1.5k4mo agoReads credentialsDiscuss

win4rCLAUDE.md

ClawTeam-OpenClaw

win4r/ClawTeam-OpenClaw/CLAUDE.md

clawteam` is a Python CLI for orchestrating swarms of CLI coding agents (OpenClaw, Claude Code, Codex, Hermes, nanobot, Cursor, etc.). This repo is `win4r/ClawTeam-OpenClaw` — a fork of `HKUDS/ClawTeam` where

1.4k6mo agoDiscuss

daymadeCLAUDE.md

claude-code-skills

daymade/claude-code-skills/CLAUDE.md

Bundled resources** - Loaded as needed by Claude ## Development Commands ### Installation Scripts **In Claude Code (in-app):** ```text /plugin marketplace add daymade/claude-code-skills ``` Then: 1. Select **Browse and install plugins** 2. Select

1.4k6mo agoPipes a download into a shellDiscuss

daymadeCLAUDE.md

claude-code-skills / daymade-skill

daymade/claude-code-skills/daymade-skill/CLAUDE.md

This directory bundles skills related to Claude Code skill development, quality, and governance. ## Included Skills - `skill-creator` — Create and improve skills. - `skill-reviewer` — Review skill quality and trigger accuracy. - `skills

1.4k6mo agoDiscuss

plugin87CLAUDE.md

ux-ui-agent-skills

plugin87/ux-ui-agent-skills/CLAUDE.md

behind /critique .claude/skills/ ← Runnable skills (invoke via /name): design-tokens, design-component, design-code, design-review, a11y-audit, apply-aesthetic, redesign, data-dashboard, migrate-design-system, prototype, ux-writing, governance

1.4k38d agoDiscuss

yohey-wCLAUDE.md

multi-agent-shogun

yohey-w/multi-agent-shogun/CLAUDE.md

Claude Code + tmux multi-agent parallel dev platform with sengoku military hierarchy

1.4k4mo agoPipes a download into a shellDiscuss

CloudAI-XCLAUDE.md

claude-workflow-v2

CloudAI-X/claude-workflow-v2/CLAUDE.md

agents: | Task | Agent to Use | | ------------------ | ------------------ | | Multi-file changes | `orchestrator` | | Code quality check | `code-reviewer` | | Bug investigation | `debugger` | | Update docs | `docs-writer` | | Security review | `security-auditor` | | Clean up code | `refactorer

1.4k9mo agoDiscuss

tigerless-labsCLAUDE.md

agent-memory

tigerless-labs/agent-memory/CLAUDE.md

green-CI PR handed off for review — the owner merges, never the agent. ## Working rules - **English only in commits, PRs, issues, and code identifiers.** Design docs under `docs/design/` may stay

1.4k29d agoDeletes or force-pushesDiscuss

nrslibCLAUDE.md

takt

nrslib/takt/CLAUDE.md

this repository. > **This file is not user-facing documentation.** It exists for Claude Code to read while working in the repository — it does not substitute for the real docs under

1.4k16d agoReads credentialsDiscuss

m0n0x41dCLAUDE.md

haft

m0n0x41d/haft/CLAUDE.md

read orientation, not a universal first step or gate, and it does not replace code-graph preflight. `known_absent` is an identity result, not permission to persist. When current Work

1.4k51d 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.