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 15Worked for most · soon
mauriceboeReads credentialsCLAUDE.md

NOMAD

mauriceboe/NOMAD/CLAUDE.md

files, exports, types, deps may only shrink against scripts/ci/knip-baseline.json (CI gate; --update lowers it) ``` Tests: ```bash npm run test # all workspaces npm run test --workspace=server # vitest run (server); also

2 projects use a version of this

15k4mo agoReviewMountCreate a free account to mount
mauriceboeCLAUDE.md

NOMAD / client

mauriceboe/NOMAD/client/CLAUDE.md

count per rule above scripts/eslint-baseline.json and on any entry above its count (app code, tests and eslint-disable'd messages counted apart; a `/* eslint : ... */` config comment fails outright; --update lowers

2 projects use a version of this

15k4mo agoReviewMountCreate a free account to mount
mauriceboeCLAUDE.md

NOMAD / plugin-sdk

mauriceboe/NOMAD/plugin-sdk/CLAUDE.md

build + tsc CJS build + scripts/finish-cjs.mjs npm run typecheck # tsc --noEmit (CI) npm test # vitest run npm run test:coverage # what CI runs (feeds the Sonar new-code coverage gate

2 projects use a version of this

15k4mo agoReviewMountCreate a free account to mount
mauriceboeReads credentialsCLAUDE.md

NOMAD / server

mauriceboe/NOMAD/server/CLAUDE.md

below) npm run typecheck # tsc --noEmit — the real type gate npm run typecheck:tests # tsc over tests/ — CI runs this too; vitest green does NOT mean typed mocks compile

2 projects use a version of this

15k4mo agoReviewMountCreate a free account to mount
mauriceboeCLAUDE.md

NOMAD / shared

mauriceboe/NOMAD/shared/CLAUDE.md

lint:format # Prettier outside scripts/format-baseline.json, which only shrinks (lint-prettier.yml) npm run test # vitest run — co-located *.spec.ts files npm run i18n:parity # audit locale drift, exits 0 npm run i18n

2 projects use a version of this

15k4mo agoReviewMountCreate a free account to mount
Bash-itCLAUDE.md

bash-it

Bash-it/bash-it/CLAUDE.md

THEME is set) 5. Custom files from BASH_IT_CUSTOM directory ## Development Commands ### Testing ```bash # Run all tests using BATS (Bash Automated Testing System) test/run # Run specific test suites test/run

No other project uses it yet

15k13mo agoReviewMountCreate a free account to mount
apexchartsCLAUDE.md

apexcharts.js

apexcharts/apexcharts.js/CLAUDE.md

truth is `src/` and `samples/source/`. - Pipe noisy command output through `tail`, `head` or `grep` (test runs, builds, `git log`). Report failures, not full passing logs. - Screenshots: crop or downscale before

Steady13 mentions in 2 weeks

No other project uses it yet

15k3y agoReviewMountCreate a free account to mount
grokabilityReads credentialsCLAUDE.md

snipe-it

grokability/snipe-it/CLAUDE.md

writing a new one. ## Verification Scripts - Do not create verification scripts or tinker when tests cover that functionality and prove they work. Unit and feature tests are more important. ## Application

Steady2 mentions in 2 weeks

No other project uses it yet

15k14mo agoReviewMountCreate a free account to mount
yusufkaraaslanReads credentialsCLAUDE.md

Skill_Seekers

yusufkaraaslan/Skill_Seekers/CLAUDE.md

phases done; remaining cosmetic items listed there). ## Essential Commands ```bash # REQUIRED before running tests or CLI (src/ layout) pip install -e . # Run all tests (NEVER skip - all must pass before

No other project uses it yet

15k13mo agoReviewMountCreate a free account to mount
MicrosoftCLAUDE.md

playwright-cli

microsoft/playwright-cli/CLAUDE.md

Build and test The CLI source lives in `microsoft/playwright`, in `packages/playwright-core/src/tools/`. This repo ships `@playwright/cli`: `playwright-cli.js` runs the CLI of the `playwright-core` alpha that `package.json` pins, and adds

15k7mo agoReviewMountCreate a free account to mount
NVIDIACLAUDE.md

TensorRT-LLM / agent-flow

NVIDIA/TensorRT-LLM/agent-flow/CLAUDE.md

command to make sure that there are no style issue. * Always add tests when adding new features, and always make sure that all test cases can pass before committing

15k3mo agoReviewMountCreate a free account to mount
Usagi-orgReads credentialsCLAUDE.md

ai-goofish-monitor

Usagi-org/ai-goofish-monitor/CLAUDE.md

自定义配置文件 ``` ## 测试 ```bash pytest # 运行所有测试 pytest --cov=src # 覆盖率报告 pytest tests/unit/test_utils.py # 运行单个测试文件 pytest tests/unit/test_utils.py::test_safe_get # 运行单个测试函数 ``` 测试规范:文件 `tests/**/test_*.py`,函数 `test_*` ## 配置 环境变量 (`.env`): - AI 模型

No other project uses it yet

15k34d agoReviewMountCreate a free account to mount
xcanwinCLAUDE.md

KeepChatGPT

xcanwin/KeepChatGPT/CLAUDE.md

开发模式:HTTP 服务(8888) + Jest watch 同时运行 npm run dev # 单次运行测试(CI / 快速验证) npm test # 检查当前脚本版本号 rg "^// @version" KeepChatGPT.user.js # 更新多语言文本输出(产物写入 temp/lang.txt) python3 tools/kcg_i18n.py # 生成 CDN 图片链接版 README(产物写入 temp/README_CDN.md

15k5mo agoReviewMountCreate a free account to mount
mindfold-aiCLAUDE.md

Trellis

mindfold-ai/Trellis/CLAUDE.md

YOUR changes made unused. - Don't remove pre-existing dead code unless asked. The test: Every changed line should trace directly to the user's request. ## 4. Goal-Driven Execution

15k2mo agoReviewMountCreate a free account to mount
amir20CLAUDE.md

dozzle

amir20/dozzle/CLAUDE.md

labels, so a new page needs one slug there plus one label per locale. ## Testing Unreleased PRs When replying to a GitHub issue or discussion where the fix lives

15k46d agoReviewMountCreate a free account to mount
casdoorCLAUDE.md

casdoor

casdoor/casdoor/CLAUDE.md

Code style - Do not add Go tests (`_test.go`) unless explicitly asked. - Keep comments sparse: only for genuinely non-obvious mechanics, not one per block. # Frontend migration

No other project uses it yet

15k23d agoReviewMountCreate a free account to mount
d2phapCLAUDE.md

ImageGlass / source

d2phap/ImageGlass/source/CLAUDE.md

CsWin32 code generation. - Avoid reflection-based serialization; use custom JSON converters in `Common/Types/JsonTypeConverters/`. - Test AOT builds: `dotnet publish ImageGlass.Win32 -c Release` produces a self-contained, trimmed executable. ### 2. Thread-Safety

15k13mo agoReviewMountCreate a free account to mount
e2b-devReads credentialsCLAUDE.md

E2B

e2b-dev/E2B/CLAUDE.md

make codegen`, which re-fetches them before generating. Create or update tests covering affected codepaths and run them using `pnpm run test`. Generate a changeset with `pnpm changeset

Steady3 mentions in 2 weeks

No other project uses it yet

15k2mo agoReviewMountCreate a free account to mount
formatjsCLAUDE.md

formatjs

formatjs/formatjs/CLAUDE.md

Bazel as its build system. Never use `npm`, `yarn`, or `pnpm` for building or testing. ```bash bazel test //... # All tests bazel test //packages/intl-localematcher:unit_test # Specific package bazel build //packages/intl-localematcher

15k3mo agoReviewMountCreate a free account to mount
electron-userlandReads credentialsCLAUDE.md

electron-builder

electron-userland/electron-builder/CLAUDE.md

Development Commands Claude can run these directly to build, test, and lint the codebase: * **Build:** `pnpm compile` (add `--watch` flag to monitor) * **Test:** `TEST_FILES=<name of file(s), comma

15k8d 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.