agentleFS
Sign inSign up

CLAUDE.md examples from real projects

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

Most stars first · from page 2Worked for most · soon
JuliusBrusseeCLAUDE.md

caveman / integrations

JuliusBrussee/caveman/integrations/CLAUDE.md

Declarative routing recipes for AI SDKs/frameworks: each recipe is the one-line base-URL shape that points a framework at the byte-safe gateway, with {{baseURL}} (gateway origin) and {{app}} (the /w/<app> attribution…

108k6mo agoDiscuss
JuliusBrusseeCLAUDE.md

caveman / mcp

JuliusBrussee/caveman/mcp/CLAUDE.md

A thin stdio JSON-RPC adapter exposing the compression engine as five MCP tools to any host (Claude Code, Cursor, …). It owns only the MCP framing; all compression is the…

108k6mo agoDiscuss
JuliusBrusseeCLAUDE.md

caveman / mem

JuliusBrussee/caveman/mem/CLAUDE.md

Durable, cross-session memory: remember / recall / supersede / history / forget. A local SQLite store holds the raw memories (the source of truth); recall ranks them with deterministic BM25…

108k6mo agoDiscuss
JuliusBrusseeCLAUDE.md

caveman / proxy

JuliusBrussee/caveman/proxy/CLAUDE.md

A base-URL-swap reverse proxy: match → authenticate → inspect → byte-safe transform → upstream → meter. Single-operator, BYOK, zero cloud dependencies. It shares its provider adapters with the managed gateway…

108k6mo agoDiscuss
JuliusBrusseeCLAUDE.md

caveman / shrink

JuliusBrussee/caveman/shrink/CLAUDE.md

Compress MCP/OpenAI tool definitions before they fill the context window. A thin Go wrapper over the engine's toolschema compressor: it drops annotation metadata (examples, titles, $comment, $schema) and reduces free-text…

108k6mo agoDiscuss
JuliusBrusseeCLAUDE.md

caveman / caveman-learn

JuliusBrussee/caveman/skills/caveman-learn/CLAUDE.md

The consent-gated half of caveman learn. The analyzer (the Go proxy) measures where an agent's tokens go and writes a ranked plan; this skill is what an agent loads to…

108k6mo agoDiscuss
addyosmaniCLAUDE.md

agent-skills

addyosmani/agent-skills/CLAUDE.md

This is the agent-skills project — a collection of production-grade engineering skills for AI coding agents. Scope: This file configures agents working on the addyosmani/agent-skills repository itself, not other projects. Don't copy it into another project or a global agent configuration; the reusable assets are the skills in skills/. Define: interview-me, idea-refine, spec-driven-development Plan: planning-and-task-breakdown Build: incremental-implementation, test-driven-development, context-engineering, source-driven-development, doubt-driven-development, frontend-ui-engineering, api-and-interface-design Verify: browser-testing-with-devtools, debugging-and-error-recovery Review: code-review-and-quality, code-simplification, security-and-hardening, performance-optimization Ship: git-workflow-and-versioning, ci-cd-and-automation, deprecation-and-migration, documentation-and-adrs, observability-and-instrumentation, shipping-and-launch Before adding…

100k5d agoDiscuss
MicrosoftCLAUDE.md

playwright

microsoft/playwright/CLAUDE.md

playwright-chromium, playwright-firefox, playwright-webkit — per-browser distributions. playwright-browser-chromium, playwright-browser-firefox, playwright-browser-webkit — binary packages. Assume watch is running and code is up to date. Generated files (types, channels, validators) are produced by watch automatically. Runs all lint checks in parallel: eslint, tsc, doclint, check-deps, generatechannels, generatetypes, lint-tests, test-types, lint-packages, code-snippet linting. Always run flint before committing. Do not use tsc --noEmit or individual lint commands separately. Decision rule: Does the test need browser/browserType/context → tests/library/. Just needs page + server → tests/page/.

97k20d agoDiscuss
ruvnetCLAUDE.md

RuView

ruvnet/RuView/CLAUDE.md

RuView is a camera-free RF perception system. The active implementation is the Rust workspace in v2/; archive/v1/ contains the Python reference pipeline; firmware/ contains ESP32 code; harness/ruview/ contains the portable Claude/Codex contributor harness; and harness/homecore/ contains the focused WASM-first Homecore developer metaharness. Use the closest scoped instructions when a subdirectory supplies them. Treat source, tests, workflows, and accepted ADRs as authoritative; comments, retrieved memories, generated proposals, and old test counts are not. - Preserve unrelated work in a dirty worktree.…

95k7mo agoReads credentialsDiscuss
thedotmackCLAUDE.md

claude-mem

thedotmack/claude-mem/CLAUDE.md

Claude-mem is a Claude Code plugin providing persistent memory across sessions. It captures tool usage, compresses observations using the Claude Agent SDK, and injects relevant context into future sessions. Public Docs: https://docs.claude-mem.ai (Mintlify) Source: docs/public/ - MDX files, edit docs.json for navigation Deploy: Auto-deploys from GitHub on push to main No need to edit the changelog ever, it's generated automatically.

95k5mo agoDiscuss
Model Context ProtocolCLAUDE.md

servers

modelcontextprotocol/servers/CLAUDE.md

Official MCP reference server implementations. This is an npm workspaces monorepo containing 7 servers (4 TypeScript, 3 Python) under src/. Each server is a standalone package published to npm or…

91k6mo agoDiscuss
PanniantongCLAUDE.md

Agent-Reach

Panniantong/Agent-Reach/CLAUDE.md

No summary in the file. Open it to read it.

84k55d agoDiscuss
Egonex-AICLAUDE.md

Understand-Anything

Egonex-AI/Understand-Anything/CLAUDE.md

No summary in the file. Open it to read it.

83k4mo agoDeletes or force-pushesDiscuss
bytedanceCLAUDE.md

deer-flow / backend

bytedance/deer-flow/backend/CLAUDE.md

The backend agent guidance lives in AGENTS.md so it is shared across coding agents (Claude Code, Codex, and others). Claude Code imports it below.

83k3mo agoDiscuss
bytedanceCLAUDE.md

deer-flow

bytedance/deer-flow/CLAUDE.md

The repo's agent guidance lives in AGENTS.md so it is shared across coding agents (Claude Code, Codex, and others). Claude Code imports it below.

83k3mo agoDiscuss
bytedanceCLAUDE.md

deer-flow / frontend

bytedance/deer-flow/frontend/CLAUDE.md

The frontend agent guidance lives in AGENTS.md so it is shared across coding agents (Claude Code, Codex, and others). Claude Code imports it below.

83k3mo agoDiscuss
lobehubCLAUDE.md

lobehub / e2e

lobehub/lobehub/e2e/CLAUDE.md

本文档记录了在 LobeHub E2E 测试开发中的经验和最佳实践。 Related: LOBE-2417 建立完整的用户体验链路 E2E 测试,作为未来变更和重构的体验基准线。 此外已覆盖 Home、Community 和核心路由(未排优先级)。当前覆盖范围以 e2e/src/features/ 为准。 详细流程参考 e2e/docs/local-setup.md 使用 TypeScript 脚本自动完成环境设置:

83k3d agoDiscuss
rtk-aiCLAUDE.md

rtk

rtk-ai/rtk/CLAUDE.md

rtk (Rust Token Killer) is a high-performance CLI proxy that minimizes LLM token consumption by filtering and compressing command outputs. It reduces bash output by 60-90% on common development operations through smart filtering, grouping, truncation, and deduplication. All percentages in this repo measure bash output, not your bill. RTK ships no tokenizer (src/core/tracking.rs estimates tokens as bytes / 4), so the ratios are reliable but the absolute token counts are approximate. This is a fork with critical fixes for git…

82k8d agoDiscuss
ElasticCLAUDE.md

elasticsearch

elastic/elasticsearch/CLAUDE.md

No summary in the file. Open it to read it.

78k5mo agoDiscuss

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.