CLAUDE.md examples from real projects

How real projects brief Claude Code: the commands, conventions and warnings they put in CLAUDE.md.

Best matchesWorked for most · soon

affaan-mCLAUDE.md

ECC

affaan-m/ECC/CLAUDE.md

persistence, pre/post-tool hooks) - **rules/** - Always-follow guidelines (security, coding style, testing requirements) - **mcp-configs/** - MCP server configurations for external integrations - **scripts/** - Cross-platform Node.js utilities for hooks and setup - **tests

246k30d agoDiscuss

garrytanCLAUDE.md

gstack

garrytan/gstack/CLAUDE.md

renderer at a site. NEVER use `mcp__claude-in-chrome__*` tools — they are slow, unreliable, and not what this project uses. **Server / sidebar / extension internals:** before editing `browse/src/server.ts`, `extension

134k6d agoReads credentialsDiscuss

browser-useCLAUDE.md

browser-use

browser-use/browser-use/CLAUDE.md

ruff format` - Pre-commit hooks: `uv run pre-commit run --all-files` **MCP Server Mode:** The library can run as an MCP server for integration with Claude Desktop: ```bash

117k4mo agoDiscuss

JuliusBrusseeCLAUDE.md

caveman

JuliusBrussee/caveman/CLAUDE.md

here) │ ├── rules/ # Auto-activation rule body (single source) │ ├── tools/ # caveman-init.js (per-repo rule writer) │ └── mcp-servers/ # caveman-shrink npm-published MCP middleware │ ├── packages/ # Current public packages │ ├── agent/ # historical copy; source

108k6mo agoPipes a download into a shellDiscuss

JuliusBrusseeCLAUDE.md

caveman / mcp

JuliusBrussee/caveman/mcp/CLAUDE.md

mcp — the Caveman MCP server (commercial Go core + MIT launcher) A thin **stdio JSON-RPC** adapter exposing the compression [engine](../engine/CLAUDE.md) as five MCP tools to any host (Claude Code

108k6mo agoDiscuss

JuliusBrusseeCLAUDE.md

caveman / mem

JuliusBrussee/caveman/mem/CLAUDE.md

bm25.go` — deterministic tokenizer + BM25 scorer (non-negative scores, so the threshold is meaningful). - `cmd/cavemem/` — MCP server + `remember`/`recall`/`supersede`/`history`/`forget` CLI subcommands (JSON). - `js/` + `py/` — thin TS and Python

108k6mo agoDiscuss

JuliusBrusseeCLAUDE.md

caveman / proxy

JuliusBrussee/caveman/proxy/CLAUDE.md

silent no-op. `CAVE_SSRF_ALLOWLIST` opts loopback/private hosts back in (local model servers like Ollama; `localhost` as an entry covers 127.0.0.0/8 + ::1); metadata/link-local stay blocked in every mode

108k6mo agoDiscuss

MicrosoftCLAUDE.md

playwright

microsoft/playwright/CLAUDE.md

fixtures | Test runner: reporters, config, annotations, retries | | `tests/mcp/` | `import { test, expect } from './fixtures'` | `client`, `server` | MCP tools via `client.callTool()` | **Decision rule**: Does the test need `browser`/`browserType`/`context` → `tests/library/`. Just

97k20d agoDiscuss

ruvnetCLAUDE.md

RuView

ruvnet/RuView/CLAUDE.md

95k7mo agoReads credentialsDiscuss

Model Context ProtocolCLAUDE.md

servers

modelcontextprotocol/servers/CLAUDE.md

modelcontextprotocol/server-memory (knowledge graph persistence) sequentialthinking/ TS @modelcontextprotocol/server-sequential-thinking (step-by-step reasoning) fetch/ Py mcp-server-fetch (web content fetching) git/ Py mcp-server-git (git repository operations) time/ Py mcp

91k6mo agoDiscuss

PanniantongCLAUDE.md

Agent-Reach

Panniantong/Agent-Reach/CLAUDE.md

youtube.py, etc.) - `agent_reach/channels/base.py` — Base channel class (all channels inherit from this) - `agent_reach/integrations/mcp_server.py` — MCP server integration - `agent_reach/skill/` — OpenClaw skill files - `agent_reach/guides/` — Usage guides - `tests/` — pytest tests - `config/mcporter.json

84k55d agoDiscuss

ruvnetCLAUDE.md

ruflo

ruvnet/ruflo/CLAUDE.md

73k21d agoReads credentialsDiscuss

shanraisshanCLAUDE.md

claude-code-best-practice

shanraisshan/claude-code-best-practice/CLAUDE.md

subagent stops - `skills`: List of skill names to preload into agent context - `mcpServers`: MCP servers for this subagent (server names or inline configs) - `hooks`: Lifecycle hooks scoped to this subagent

66k5mo agoDiscuss

danny-avilaCLAUDE.md

LibreChat

danny-avila/LibreChat/CLAUDE.md

instance. Test actual queries and schema validation, not mocked DB calls. - **MCP**: use real `@modelcontextprotocol/sdk` exports for servers, transports, and tool definitions. Mirror real scenarios, don't stub SDK internals

45k49d agoDiscuss

davila7CLAUDE.md

claude-code-templates

davila7/claude-code-templates/CLAUDE.md

Supabase service role key DISCORD_BOT_TOKEN # Discord bot token DISCORD_GUILD_ID # Discord server ID TRIGGER_SECRET # For manual /trigger endpoint GA_PROPERTY_ID # GA4 property ID (optional

32k3mo agoReads credentialsDiscuss

davila7CLAUDE.md

claude-code-templates

davila7/claude-code-templates/docs/CLAUDE.md

Serve locally with any static file server python -m http.server 8000 # or npx http-server # Open browser to http://localhost:8000 ``` ### Component Data Generation ```bash # From project root - regenerate components.json

32k3mo agoDiscuss

tirth8205CLAUDE.md

code-review-graph

tirth8205/code-review-graph/CLAUDE.md

graph forget PATH # drop files from the graph uv run code-review-graph serve # MCP server (stdio; --http for localhost) uv run code-review-graph wiki # Markdown wiki

32k4mo agoDiscuss

topoteretesCLAUDE.md

cognee

topoteretes/cognee/CLAUDE.md

reaches improve only through `remember`'s `self_improvement` — `improve` is deliberately not an advertised MCP tool; the tool set is pinned to remember/recall/forget/cognify_status) (an improve failure after a successful cognify

31k13d agoReads credentialsDiscuss

nanocoaiCLAUDE.md

nanoclaw

nanocoai/nanoclaw/CLAUDE.md

What it is | |----------|-------|------------| | groups | list, get, create, update, delete, restart, config get/update, config add-mcp-server/remove-mcp-server, config add-package/remove-package | Agent groups (workspace, personality, container config) | | messaging-groups | list

31k3d agoReads credentialsDiscuss

nanocoaiCLAUDE.md

nanoclaw / container

nanocoai/nanoclaw/container/CLAUDE.md

external account. Connecting GitHub or another app does not itself require a new MCP server. Use an existing HTTP client or the user's requested CLI, such as `gh`. Install

31k3d 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.