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

mnemox-aiCLAUDE.md

idea-reality-mcp / templates

mnemox-ai/idea-reality-mcp/templates/CLAUDE.md

check proactively. > > Requires: [idea-reality-mcp](https://github.com/mnemox-ai/idea-reality-mcp) configured as an MCP server

8217mo agoDiscuss

H-mmerCLAUDE.md

distributable product: - Keep Claude Code source assets, non-Claude provider renderers, scaffolded workspace behavior, MCP servers, tests, and docs in sync. - Treat `providers/` as generated output. Do not edit provider

8155mo agoDiscuss

AVIDS2CLAUDE.md

memorix

AVIDS2/memorix/CLAUDE.md

skip project memory just because the initial MCP status says `pending` Claude Code starts MCP servers asynchronously. An initial `pending` MCP status is not a failure by itself; the tools

8097mo agoDiscuss

MicrosoftCLAUDE.md

CopilotStudioSamples

microsoft/CopilotStudioSamples/CLAUDE.md

authoring/ # Importable solutions and topic snippets ├── contact-center/ # ServiceNow, Salesforce, Genesys, skill handoff ├── extensibility/ # MCP servers, A2A protocol, M365 Agents SDK ├── guides/ # Implementation guide, workshop, playbook ├── infrastructure/ # VNet and deployment

7947mo agoDiscuss

dark-hxxCLAUDE.md

CLI-Manager

dark-hxx/CLI-Manager/CLAUDE.md

none/running/attention/done/failed）。改动状态逻辑时要同时考虑两个来源。 ### CLI Hook 桥接（Claude / Codex） - `src-tauri/src/claude_hook.rs` 在启动时绑定 `127.0.0.1` 随机端口起一个 TCP server，用一次性 token 校验，接收 Claude/Codex 的 hook 上报（SessionStart/UserPromptSubmit/Notification/Stop/StopFailure/PermissionRequest），转成 `claude-hook-notification` 事件发给前端。 - `hook_settings.rs

7843mo agoDiscuss

LangChainCLAUDE.md

deep_research_from_scratch

langchain-ai/deep_research_from_scratch/CLAUDE.md

clarification and brief generation │ ├── 2_research_agent.ipynb # Research agent with custom tools │ ├── 3_research_agent_mcp.ipynb # Research agent with MCP servers │ ├── 4_research_supervisor.ipynb # Multi-agent supervisor coordination │ ├── 5_full_agent.ipynb # Complete end-to-end system │ └── utils.py # Shared utilities

78214mo agoDiscuss

CodeBendKitCLAUDE.md

codeseek

CodeBendKit/codeseek/CLAUDE.md

success: bool` and `data: T`. ## Configuration Config file at `~/.codeseek/config/config.toml`. Key sections: - `[http]` — `server_port`, `codebase_port` (default 12800) - `[codebase]` — `enable_embedding`, `embedding_db_uri`, `graph_db_uri` - `[codebase.embedding]` — `model

7644mo agoDiscuss

MicrosoftCLAUDE.md

TypeAgent / planValidationDemo

microsoft/TypeAgent/ts/examples/planValidationDemo/CLAUDE.md

Plan-Validated Agent Execution This project is governed by a plan-validation MCP server. **Every file access and shell call you make must go through the `validated_*` tools.** The built

7433mo agoDiscuss

symgraphCLAUDE.md

GhidrAssistMCP

symgraph/GhidrAssistMCP/CLAUDE.md

Context Protocol support - Jetty 11.0.20 for embedded HTTP server - Jackson 2.17.0 for JSON processing ### MCP Server The extension includes an embedded MCP (Model Context Protocol) server that: - Runs on port

7323mo agoDiscuss

tbxarkCLAUDE.md

mcp-proxy

tbxark/mcp-proxy/CLAUDE.md

MCP proxy server (Go, single `main` package, flat layout) that aggregates multiple downstream MCP servers behind one HTTP entrypoint. Each configured downstream server is exposed at its own route

72813mo agoDiscuss

GarethManningCLAUDE.md

education-agent-skills

GarethManning/education-agent-skills/CLAUDE.md

Claude Code, Claude.ai (via MCP), OpenAI Codex, and Hermes Agent. Includes a live MCP server at mcp-server-sigma-sooty.vercel.app/mcp, a CoWork plugin (.claude-plugin/), a Codex plugin (.codex-plugin/), and Hermes

7254mo agoDiscuss

kgoedeckeCLAUDE.md

doop

kgoedecke/doop/CLAUDE.md

sandboxed iframes. People edit in the browser; AI agents edit through the built-in MCP server, streaming designs in live. Everyone sees cursors, presence, frame edits, agent status

72321d agoDiscuss

ronak-createCLAUDE.md

FableCut

ronak-create/FableCut/CLAUDE.md

drive the editor. ## MCP connection (preferred — works from any session, any directory) Register the MCP server (`mcp-server.js`) once at user scope as `fablecut`: `claude mcp add -s user fablecut -- node

6953mo agoDiscuss

codewithmukeshCLAUDE.md

dotnet-claude-kit

codewithmukesh/dotnet-claude-kit/CLAUDE.md

companion for .NET developers. It provides skills, agents, templates, knowledge documents, and a Roslyn MCP server that make Claude Code dramatically more effective for .NET development. ## Philosophy - **Guided over prescriptive

6912mo agoDiscuss

ruvnetCLAUDE.md

metaharness / kimi-k3-harness

ruvnet/metaharness/kimi-k3-harness/CLAUDE.md

level implementation plan before any code. ## Commands - `doctor` — Health-check the harness: kernel load, MCP wiring, memory backend, host adapter. - `review-diff` — Review the current working diff for correctness, security

6774d agoDiscuss

JuliusBrusseeCLAUDE.md

cavemem

JuliusBrussee/cavemem/CLAUDE.md

local SQLite + vector index, and exposes them to agents through a Model Context Protocol (MCP) server and a local web viewer. The signature property of the project is that **memory

6743mo agoDiscuss

ktnytCLAUDE.md

cclsp

ktnyt/cclsp/CLAUDE.md

test # Full pre-publish check npm run prepublishOnly # build + test + typecheck ``` ## Architecture ### Core Components **MCP Server Layer** (`index.ts`) - Entry point that implements MCP protocol - Exposes `find_definition`, `find_references

6737mo agoDiscuss

CannerCLAUDE.md

wren-engine

Canner/wren-engine/.claude/CLAUDE.md

strict SQL policy mode, and optional LanceDB-backed memory layer for semantic schema/query retrieval. - **mcp-server/** — MCP server exposing Wren Engine to AI agents (Claude, Cline, Cursor). Supporting modules: `wren

6632y agoDiscuss

joaoh82CLAUDE.md

rustunnel

joaoh82/rustunnel/CLAUDE.md

This crate (`rustunnel/`) is the **core tunnel server + CLI client + MCP server**. Siblings in the parent meta-repo: | Sibling | Stack | Dev port | Role | |---------|-------|----------|------| | `rustunnel-web/` | Rust (Axum) + Next.js

6557mo agoDiscuss

samvallad33CLAUDE.md

vestige

samvallad33/vestige/CLAUDE.md

operating notes, or mandatory background hooks. ## Project Shape Vestige is a local-first MCP memory server written in Rust, with a SvelteKit dashboard embedded into the release binary. The core

6386mo 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.