agentleFS

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

Steady32 mentions in 2 weeks

2 projects use a version of this

246k2mo agoReviewMountCreate a free account to mount
garrytanReads credentialsCLAUDE.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

Steady23 mentions in 2 weeks

No other project uses it yet

138k24d agoReviewMountCreate a free account to mount
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

Steady7 mentions in 2 weeks

1 project uses a version of this

119k5mo agoReviewMountCreate a free account to mount
JuliusBrusseePipes a download into a shellCLAUDE.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 │ ├── cli/ # @caveman-ai/cli

Steady7 mentions in 2 weeks

1 project uses a version of this

115k7mo agoReviewMountCreate a free account to mount
JuliusBrusseeCLAUDE.md

caveman / mcp

JuliusBrussee/caveman/mcp/CLAUDE.md

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

Steady7 mentions in 2 weeks

No other project uses it yet

115k7mo agoReviewMountCreate a free account to mount
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

Steady7 mentions in 2 weeks

No other project uses it yet

115k7mo agoReviewMountCreate a free account to mount
JuliusBrusseeCLAUDE.md

caveman / proxy

JuliusBrussee/caveman/proxy/CLAUDE.md

accepted through the raw retry, and a compressed PAYG conversation without MCP recovery that streams (the server-side retrieve tool cannot ride a stream, so the conversation stays raw from

Steady7 mentions in 2 weeks

No other project uses it yet

115k7mo agoReviewMountCreate a free account to mount
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.