How real projects brief Claude Code: the commands, conventions and warnings they put in CLAUDE.md.
Files you open will collect here, so you can find them again.
Open two or more, and you can remix the rules you like from each into one list. Kept in this browser only.
browser-useCLAUDE.mdbrowser-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
Steady5 mentions in 2 weeks
1 project uses a version of this
JuliusBrusseeCLAUDE.mdJuliusBrussee/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
Steady22 mentions in 2 weeks
2 projects use a version of this
JuliusBrusseeCLAUDE.mdJuliusBrussee/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
Steady22 mentions in 2 weeks
No other project uses it yet
JuliusBrusseeCLAUDE.mdJuliusBrussee/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
Steady22 mentions in 2 weeks
No other project uses it yet
JuliusBrusseeCLAUDE.mdJuliusBrussee/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
Steady22 mentions in 2 weeks
No other project uses it yet
JuliusBrusseeCLAUDE.mdJuliusBrussee/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
Steady22 mentions in 2 weeks
No other project uses it yet
JuliusBrusseeCLAUDE.mdJuliusBrussee/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
Steady22 mentions in 2 weeks
No other project uses it yet
JuliusBrusseeCLAUDE.mdJuliusBrussee/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
Steady22 mentions in 2 weeks
No other project uses it yet
addyosmaniCLAUDE.mdaddyosmani/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
denolandCLAUDE.mddenoland/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
pytorchCLAUDE.mdpytorch/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
debpalashCLAUDE.mddebpalash/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
oven-shCLAUDE.mdoven-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
No other project uses it yet
oven-shCLAUDE.mdoven-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
No other project uses it yet
oven-shCLAUDE.mdoven-sh/bun/test/CLAUDE.md
tests: ```sh bun bd test <...test file> ``` To run a command with your debug build of Bun: ```sh bun bd <...cmd> ``` Note that compiling Bun may take
No other project uses it yet
rtk-aiCLAUDE.mdrtk-ai/rtk/CLAUDE.md
build --release # release build (optimized) cargo run -- # run directly cargo install --path . # install locally ``` ### Testing ```bash cargo test # all tests rtk cargo test # preferred (token-optimized) cargo test # specific test
Steady10 mentions in 2 weeks
No other project uses it yet
cheaper-inferenceCLAUDE.mdcheaper-inference/OmniRoute/CLAUDE.md
AGENTS.md`](AGENTS.md)** — the single source of truth for every AI assistant (architecture, conventions, testing, quality gates, git workflow, the 23 Hard Rules, PII learnings). Read it in full
Steady35 mentions in 2 weeks
1 project uses a version of this
lobehubCLAUDE.mdlobehub/lobe-chat/e2e/CLAUDE.md
Testing Guide for Claude 本文档记录了在 LobeHub E2E 测试开发中的经验和最佳实践。 Related: [LOBE-2417](https://linear.app/lobehub/issue/LOBE-2417/建立核心产品功能-e2e-测试体验基准线) ## 测试策略：体验驱动的 E2E 测试 ### 核心理念 建立完整的**用户体验链路 E2E 测试**，作为未来变更和重构的**体验基准线**。 **目的**： - 确保核心用户体验在代码变更后不会退化
1 project uses a version of this
gothinksterCLAUDE.mdgothinkster/realworld/CLAUDE.md
defines the contract that every RealWorld frontend and backend adheres to, and hosts the test suites used to validate them. Nothing here is a runnable app. - `specs/api/` — the API contract
1 project uses a version of this
opendatalabCLAUDE.mdopendatalab/MinerU/CLAUDE.md
bash # 在项目根目录中创建虚拟环境 uv venv .venv # 激活虚拟环境 source .venv/bin/activate # 安装依赖 uv pip install -e ".[dev,test]" ``` 运行 Python 代码须在项目根目录 `MinerU` 中执行： ```bash .venv/bin/python -m mineru.path.to.submodule ``` ## GitHub Issue / PR 处理规范 处理 GitHub
No other project uses it yet
A file Claude Code reads at the start of every session. It holds the commands, conventions and warnings the agent needs for this project.
At the repository root. Claude Code also reads CLAUDE.md files in subdirectories when it works there.
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 Code reads CLAUDE.md; most other agents read AGENTS.md. Many projects keep one and point the other at it.
