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

AnthropicCLAUDE.md

defending-code-reference-harness

anthropics/defending-code-reference-harness/CLAUDE.md

real-world CVE demo targets — pinned to vulnerable commits, with per-target READMEs documenting the CVEs and expected find times. htslib is the harder of the set (CRAM container format

7.5k3mo agoDiscuss

plastic-labsCLAUDE.md

honcho

plastic-labs/honcho/CLAUDE.md

peers OR arbitrary data ingested by a peer to enhance its global representation - **Collections & Documents**: Internal vector storage for peer representations. Collections are keyed by `(observer, observed)` peer pairs. Collections/Documents

7.4k37d agoReads credentialsDiscuss

kyegomezCLAUDE.md

swarms

kyegomez/swarms/CLAUDE.md

agent AI systems.") ``` **When to use:** Independent subtasks that can run simultaneously. Analysing multiple documents. Querying multiple data sources. Generating multiple creative variants. --- ### AgentRearrange — Flow DSL Define execution flow

7.2k2y agoReads credentialsDiscuss

WenyuChiouCLAUDE.md

awesome-agentic-ai-zh

WenyuChiou/awesome-agentic-ai-zh/CLAUDE.md

paper / tool / framework) | Add it only when it has a clear teaching role, current documentation, a verified license or official source, and enough real adoption for the relevant section

7.2k32d agoDiscuss

enricorosCLAUDE.md

big-AGI

enricoros/big-AGI/CLAUDE.md

Never use emdashes (—).** Use normal dashes (-) instead, in all generated text, code comments, and documentation. - Register: sharp, terse, precise - in all prose (docs, UI copy, comments, commits, replies). No inflation

7.1k9d agoReads credentialsDiscuss

deanpetersCLAUDE.md

Product-Manager-Skills

deanpeters/Product-Manager-Skills/CLAUDE.md

every Component and Workflow skill ships `template.md` + two-domain worked examples. Three documented carve-outs: `finance-metrics-quickref` (definitionally SaaS, template only), `skill-authoring-workflow` (meta-skill, one example), `product

6.8k52d agoReads credentialsDiscuss

SentryCLAUDE.md

XcodeBuildMCP

getsentry/XcodeBuildMCP/CLAUDE.md

alternate path. Add a fallback only when explicitly requested or when it is a documented product requirement. - Review the complete merge-base diff and trace changed or reused helper contracts

6.4k7d agoDiscuss

czlonkowskiCLAUDE.md

n8n-skills

czlonkowski/n8n-skills/CLAUDE.md

hook) ├── hooks/ # Enforcement layer: hooks.json + SessionStart/PreToolUse/PostToolUse scripts ├── evaluations/ # Test scenarios for each skill ├── docs/ # Documentation ├── dist/ # Build output (gitignored — zips ship as GitHub Release assets, never committed; committed zips broke

6.3k33d agoDiscuss

builderz-labsCLAUDE.md

mission-control

builderz-labs/mission-control/CLAUDE.md

database, utilities .data/ SQLite database + runtime state (gitignored) scripts/ Install, deploy, diagnostics scripts docs/ Documentation and guides ``` Path alias: `@/*` maps to `./src/*` ## Data Directory Set `MISSION_CONTROL_DATA

6.3k3mo agoReads credentialsDiscuss

jacob-bdCLAUDE.md

gemini-notebook-mcp-cli

jacob-bd/gemini-notebook-mcp-cli/CLAUDE.md

exhausted window needs to wait for the reset time that `nlm usage` reports. ## Documentation ### API Reference **For detailed API documentation** (RPC IDs, parameter structures, response formats), see: **[docs/API_REFERENCE.md](./docs/API_REFERENCE.md)** This

6.2k14d agoDiscuss

UfoMiaoCLAUDE.md

zcf

UfoMiao/zcf/CLAUDE.md

bash # Run ESLint (uses @antfu/eslint-config) pnpm lint # Fix ESLint issues automatically pnpm lint:fix ``` ### Documentation ```bash # Start VitePress documentation development server pnpm docs:dev # Build documentation for production pnpm docs

6.1k13mo agoReads credentialsDiscuss

UfoMiaoCLAUDE.md

zcf / templates

UfoMiao/zcf/templates/CLAUDE.md

template consistency? - Use template validation tests - Follow naming conventions - Maintain parallel structure across locales - Document template variables and usage

6.1k13mo agoDiscuss

UfoMiaoCLAUDE.md

zcf / tests

UfoMiao/zcf/tests/CLAUDE.md

Integration tests: 10% - Edge tests: 10% - **Platform Coverage**: Windows/macOS/Linux/Termux ## Changelog ### 2025-08-20 - **Module Documentation Created**: Completed comprehensive documentation of tests module - **Test Architecture Analysis**: Detailed analysis of 60+ test

6.1k13mo agoDiscuss

FlorianBruniauxCLAUDE.md

claude-code-ultimate-guide

FlorianBruniaux/claude-code-ultimate-guide/CLAUDE.md

Claude Code Ultimate Guide - Project Context ## Purpose This repository is the **comprehensive documentation for Claude Code** (Anthropic's CLI tool). It teaches users how to use Claude Code effectively through

6k19d agoDiscuss

ZSeven-WCLAUDE.md

openpencil

ZSeven-W/openpencil/CLAUDE.md

Document/EditorCommand model, MCP layered-design workflow, design variables, and the run/debug recipe are all documented in **`crates/CLAUDE.md`**. ## Code Style - Single files must not exceed **800 lines** — split into smaller modules

6k2mo agoDiscuss

ZSeven-WCLAUDE.md

openpencil / crates

ZSeven-W/openpencil/crates/CLAUDE.md

openpencil-desktop` → **`op-host-desktop`**. `openpencil-shell-core` was > **split**, not just renamed: widgets / Document / `RenderBackend` → > **`op-editor-ui`**, the MCP wire layer → **`op-mcp`** (flat `op-mcp/src

6k2mo agoDiscuss

ZSeven-WCLAUDE.md

openpencil / packages

ZSeven-W/openpencil/packages/CLAUDE.md

path is **Download .op**, which converts the capture locally into a ready-to-open document. - **Account (optional).** The popup header can sign in to OP Hub through

6k2mo agoDiscuss

fengshao1227CLAUDE.md

ccg-workflow / dsh-ccg

fengshao1227/ccg-workflow/dsh-ccg/CLAUDE.md

third-width column the body ended up LARGER than the headings above it; the document is now rescaled as a whole; - its output is wrapped

5.9k7mo agoDiscuss

VercelCLAUDE.md

streamdown / website

vercel/streamdown/apps/website/.claude/CLAUDE.md

boundary conditions and error states 5. **User experience** - Accessibility, performance, and usability considerations 6. **Documentation** - Add comments for complex logic, but prefer self-documenting code --- Most formatting and common issues

5.7k14mo agoDiscuss

Galaxy-DawnCLAUDE.md

claude-scholar

Galaxy-Dawn/claude-scholar/CLAUDE.md

assumption briefly. --- ## Execution Priorities - Check facts before making claims. - Verify after changing files, code, documentation, or configuration. - Keep changes small, reversible, and easy to review. - Confirm before destructive or high

5.6k6mo 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.