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
instructkrCLAUDE.md

claw-code / rust

instructkr/claw-code/rust/CLAUDE.md

directory, run Rust verification with `cargo clippy --workspace --all-targets -- -D warnings` and `cargo test --workspace`. ## Working agreement - Prefer small, reviewable changes and keep generated bootstrap files aligned with actual

3 projects use a version of this

195k8mo agoReviewMountCreate a free account to mount
Significant-GravitasReads credentialsCLAUDE.md

AutoGPT / classic

Significant-Gravitas/AutoGPT/classic/CLAUDE.md

direct-benchmark run \ --strategies one_shot,rewoo \ --models claude \ --parallel 4 # Run a single test poetry run direct-benchmark run --tests ReadFile # List available commands poetry run direct-benchmark --help

Steady5 mentions in 2 weeks

No other project uses it yet

188k8d agoReviewMountCreate a free account to mount
garrytanReads credentialsCLAUDE.md

gstack

garrytan/gstack/CLAUDE.md

typecheck # strict tsc over product code (zero errors required) bun run typecheck:test # test-code type-debt ratchet bun run build # gen docs + compile binaries bun run gen:skill-docs

Steady14 mentions in 2 weeks

No other project uses it yet

141k35d agoReviewMountCreate a free account to mount
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

Steady9 mentions in 2 weeks

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

124k21d 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

124k21d 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

Steady6 mentions in 2 weeks

1 project uses a version of this

120k6mo 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

Steady9 mentions in 2 weeks

2 projects use a version of this

118k7mo 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

Steady9 mentions in 2 weeks

No other project uses it yet

118k7mo 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

Steady9 mentions in 2 weeks

No other project uses it yet

118k7mo 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

Steady9 mentions in 2 weeks

No other project uses it yet

118k7mo 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

Steady9 mentions in 2 weeks

No other project uses it yet

118k7mo 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

Steady9 mentions in 2 weeks

No other project uses it yet

118k7mo 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

Steady9 mentions in 2 weeks

No other project uses it yet

118k7mo 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

Steady9 mentions in 2 weeks

No other project uses it yet

118k7mo 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

1 project uses a version of this

114k12d 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
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 41% this month

No other project uses it yet

106k5d 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

105k7d agoReviewMountCreate a free account to mount
debpalashCLAUDE.md

OmniVoice-Studio

debpalash/OmniVoice-Studio/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

1 project uses a version of this

105k3mo 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.