agentleFS

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 2Worked for most · soon
excalidrawCLAUDE.md

excalidraw

excalidraw/excalidraw/CLAUDE.md

editor features 2. **App Development**: Work in `excalidraw-app/` for app-specific features 3. **Testing**: Always run `yarn test:update` before committing 4. **Type Safety**: Use `yarn test:typecheck

1 project uses a version of this

135k3y agoReviewMountCreate a free account to mount
electronCLAUDE.md

electron

electron/electron/CLAUDE.md

patches to Chromium │ ├── node/ # ~48 patches to Node.js │ └── ... # Other targets (v8, boringssl, etc.) ├── spec/ # Test suite (1189+ TypeScript test files) ├── docs/ # API documentation and guides ├── build/ # Build configuration ├── script/ # Build

No other project uses it yet

124k11d agoReviewMountCreate a free account to mount
electronCLAUDE.md

electron / spec

electron/electron/spec/CLAUDE.md

listener (`'data'`, `'message'`, `'exit'`). A failing assertion there is an uncaught exception, not a test failure: the spec runner exits with no summary and no JUnit file, and the whole

No other project uses it yet

124k11d agoReviewMountCreate a free account to mount
browser-useCLAUDE.md

browser-use

browser-use/browser-use/CLAUDE.md

wrong. ## Development Commands **Setup:** ```bash uv venv --python 3.11 source .venv/bin/activate uv sync ``` **Testing:** - Run CI tests: `uv run pytest -vxs tests/ci` - Run all tests: `uv run pytest -vxs tests

Steady7 mentions in 2 weeks

1 project uses a version of this

120k5mo agoReviewMountCreate a free account to mount
JuliusBrusseeCLAUDE.md

caveman / browse

JuliusBrussee/caveman/browse/CLAUDE.md

stdio MCP binary. ## Gotchas - This package may import CDP/network/browser dependencies. `public/mcp` may not. - `go test ./public/browse/...` is setup-free. `make test-browse` resolves an installed Playwright Chromium or system Chrome

Steady7 mentions in 2 weeks

1 project uses a version of this

115k7mo agoReviewMountCreate a free account to mount
JuliusBrusseePipes a download into a shellCLAUDE.md

caveman

JuliusBrussee/caveman/CLAUDE.md

agents/ # ← from agents/ │ ├── dist/ # Build artifacts (gitignored) │ └── caveman.skill # ZIP of skills/caveman/, rebuilt by CI │ ├── tests/ # All tests (Node + Python) ├── benchmarks/ # Real token measurements through Claude API ├── evals/ # Three-arm eval

Steady7 mentions in 2 weeks

1 project uses a version of this

115k7mo agoReviewMountCreate a free account to mount
JuliusBrusseeCLAUDE.md

caveman / engine

JuliusBrussee/caveman/engine/CLAUDE.md

through. - `result.go` — `Result`/`Options`/`Mode`; unknown mode fails closed to `record`. - `detect.go` — content router (`test-report`/`json`/`diff`/`code`/`log`/`search-result`/`html`/`tabular`/`config`/`terminal`/`text`); low confidence → `text

Steady7 mentions in 2 weeks

No other project uses it yet

115k7mo agoReviewMountCreate a free account to mount
JuliusBrusseeCLAUDE.md

caveman / extension

JuliusBrussee/caveman/extension/CLAUDE.md

buildReminder`/`isPrefixed`/`normMode`. No chrome/DOM/network. Loaded first (exposes `self.CavemanDirective`) and required directly by the test suite. - `src/caveman.js` — content script: per-site composer adapter + capture-phase send interception. Prepends the directive

Steady7 mentions in 2 weeks

No other project uses it yet

115k7mo agoReviewMountCreate a free account to mount
JuliusBrusseeCLAUDE.md

caveman / mcp

JuliusBrussee/caveman/mcp/CLAUDE.md

every wrapped agent. ## Conventions - Build/test: `make product-build PRODUCT=mcp` / `make product-test PRODUCT=mcp`. - **stdout is the protocol channel** — logs go to stderr only (a dedicated test guards this

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

framing matches caveman-mcp exactly. ## Conventions - Build/test: `make product-build PRODUCT=mem` / `make product-test PRODUCT=mem` for the Go core; root `make test` also runs mirrored JS/Python wrapper tests

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

named pipe, and persistent listener lifetime. - `internal/repointel/` — deterministic local repository map, task evidence, conservative test impact, and optional-Scout recommendation. No model/network. - `internal/nativepack/` — embedded compiled Core/skill policy; generated from `public/skills

Steady7 mentions in 2 weeks

No other project uses it yet

115k7mo agoReviewMountCreate a free account to mount
JuliusBrusseeCLAUDE.md

caveman / shrink

JuliusBrussee/caveman/shrink/CLAUDE.md

rules would produce invalid calls the structural profile cannot see; the call-validity conformance test (`engine/compressors`, golden fixture + reproduced under-keep cases) locks recognised constraint tokens in place. Over-keep

Steady7 mentions in 2 weeks

No other project uses it yet

115k7mo agoReviewMountCreate a free account to mount
addyosmaniCLAUDE.md

agent-skills

addyosmani/agent-skills/CLAUDE.md

Project Structure ``` skills/ → Core skills (SKILL.md per directory) agents/ → Reusable agent personas (code-reviewer, test-engineer, security-auditor, web-performance-auditor) hooks/ → Session lifecycle hooks .claude/commands/ → Slash commands (/spec, /plan

Steady37 mentions in 2 weeks

1 project uses a version of this

112k2d agoReviewMountCreate a free account to mount
denolandCLAUDE.md

deno

denoland/deno/CLAUDE.md

workflow) - [High Level Overview](#high-level-overview) - [Quick Start](#quick-start) - [Commands](#commands) - [Testing](#testing) - [Development Workflows](#development-workflows) - [Debugging](#debugging) - [Codebase Navigation](#codebase-navigation) - [Troubleshooting](#troubleshooting) ## Git workflow Deno

No other project uses it yet

109k6mo agoReviewMountCreate a free account to mount
pytorchCLAUDE.md

pytorch

pytorch/pytorch/CLAUDE.md

build-isolation`. You should NEVER run any other command to build PyTorch. # Testing Use our test class and test runner: ``` from torch.testing._internal.common_utils import run_tests, TestCase class TestFeature

No other project uses it yet

105k1d agoReviewMountCreate a free account to mount
ruvnetReads credentialsCLAUDE.md

wifi-densepose

ruvnet/wifi-densepose/CLAUDE.md

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

1 project uses a version of this

102k8mo agoReviewMountCreate a free account to mount
pbakausReads credentialsCLAUDE.md

impeccable

pbakaus/impeccable/CLAUDE.md

past the 25 MB Cloudflare Pages file cap that `impeccable install` downloads through. - **Tests get a binary** from `IMPECCABLE_BIN`, then `skill/scripts/bin/ /` (`bun run fetch:engine`; `IMPECCABLE

Risinginterest up 36% this month

99k1d agoReviewMountCreate a free account to mount
debpalashCLAUDE.md

VoiceStudio

debpalash/VoiceStudio/CLAUDE.md

shared by Electron; they are not a runnable app. New UI, IPC, setup instructions, tests, and browser assets belong in Electron; validate Electron on macOS, Windows and Linux. ## Mobile: native

97k2mo agoReviewMountCreate a free account to mount
oven-shCLAUDE.md

bun

oven-sh/bun/CLAUDE.md

repository - an all-in-one JavaScript runtime & toolkit designed for speed, with a bundler, test runner, and Node.js-compatible package manager. It's written primarily in Rust with

96k5d agoReviewMountCreate a free account to mount
oven-shCLAUDE.md

bun / workflows

oven-sh/bun/.github/workflows/CLAUDE.md

add/remove file exclusions: 1. Edit the exclusion patterns in `scripts/run-clang-format.sh` (lines 34-39) 2. Test locally to ensure the right files are being formatted ### Performance Optimizations 1. **Parallel execution

96k5d 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.