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 9Worked for most · soon
srbhrCLAUDE.md

Resume-Matcher

srbhr/Resume-Matcher/.claude/CLAUDE.md

Backend (from repo root) cd apps/backend uv sync --extra dev # Install Python deps (incl. test deps) uv run uvicorn app.main:app --reload --port 8000 # FastAPI on :8000 uv run pytest

No other project uses it yet

29k10d agoReviewMountCreate a free account to mount
manaflow-aiCLAUDE.md

cmux

manaflow-ai/cmux/CLAUDE.md

regression before its fix; record the same focused command's red and green results ([testing policy](skills/cmux-testing/SKILL.md#reproduce-and-repair)). A bug-fix PR body names that command, its failure

Steady3 mentions in 2 weeks

No other project uses it yet

29k35d agoReviewMountCreate a free account to mount
mlflowCLAUDE.md

mlflow

mlflow/mlflow/CLAUDE.md

level imports (only use lazy imports when necessary) - Only add docstrings in tests when they provide additional context - Only add comments that explain non-obvious logic or provide additional context

29k50d agoReviewMountCreate a free account to mount
BudibaseReads credentialsCLAUDE.md

budibase

Budibase/budibase/CLAUDE.md

Build/Test Commands - Build: `yarn build` - Lint: `yarn lint` (check) or `yarn lint:fix` (fix) - Test: `yarn test ` run inside of a packages/\* directory - Type check: `yarn check:types` - packages/server tests

No other project uses it yet

28k6mo agoReviewMountCreate a free account to mount
eyaltoledanoCLAUDE.md

claude-task-master

eyaltoledano/claude-task-master/CLAUDE.md

commands and guidelines, treat as if import is in the main CLAUDE.md file.** @./.taskmaster/CLAUDE.md ## Test Guidelines ### Test File Placement - **Package & tests**: Place in `packages/ /src/ / .spec.ts` or `apps/ /src/ / ` alongside

Coolinginterest down 74% this month

No other project uses it yet

28k11mo agoReviewMountCreate a free account to mount
eyaltoledanoReads credentialsCLAUDE.md

claude-task-master

eyaltoledano/claude-task-master/.taskmaster/CLAUDE.md

multiple Claude Code sessions: ```bash # Terminal 1: Main implementation cd project && claude # Terminal 2: Testing and validation cd project-test-worktree && claude # Terminal 3: Documentation updates cd project-docs-worktree

Coolinginterest down 74% this month

No other project uses it yet

28k11mo agoReviewMountCreate a free account to mount
phurynCLAUDE.md

pm-skills

phuryn/pm-skills/CLAUDE.md

Claude agents) ├── CONTRIBUTING.md <- contributor guidelines ├── README.md <- public documentation (GitHub) ├── LICENSE <- MIT ├── validate_plugins.py <- plugin validator ├── tests/ <- unit + docs-consistency tests (unittest) └── pm-{name}/ <- 9 plugin directories ├── .claude-plugin/plugin.json <- per-plugin

28k4mo agoReviewMountCreate a free account to mount
DonchitosCLAUDE.md

Claude-Code-Game-Studios / src

Donchitos/Claude-Code-Game-Studios/src/CLAUDE.md

specialists` block of `project.yaml`. When in doubt, use `specialists.code` from `project.yaml`. ## Tests Tests live in `tests/` — not in `src/`. Run `/test-setup` to scaffold the test framework if it doesn

Steady5 mentions in 2 weeks

1 project uses a version of this

27k14d agoReviewMountCreate a free account to mount
DonchitosCLAUDE.md

Claude-Code-Game-Studios / studio-tests

Donchitos/Claude-Code-Game-Studios/studio-tests/CLAUDE.md

Studio Tests — Claude Instructions This folder is the quality assurance layer for the Claude Code Game Studios skill/agent framework. It is self-contained and separate from any game project

Steady5 mentions in 2 weeks

No other project uses it yet

27k14d agoReviewMountCreate a free account to mount
OpenZeppelinCLAUDE.md

openzeppelin-contracts

OpenZeppelin/openzeppelin-contracts/CLAUDE.md

source. Subdirectory layout (`token/ERC20/`, `access/`, `utils/`, …) mirrors the public API. | | `contracts/mocks/` | Mocks used by tests. Mirrors `contracts/`. Manual mocks only — see the `testing` skill. | | `contracts/interfaces/` | ERC interfaces in their pristine

1 project uses a version of this

27k44d agoReviewMountCreate a free account to mount
OI-wikiReads credentialsCLAUDE.md

OI-wiki

OI-wiki/OI-wiki/CLAUDE.md

corresponding `images/` directories 3. Run format checking: `yarn run docs:format:check` 4. Test locally: `uv run mkdocs serve` 5. Build and verify: `uv run mkdocs build` ### Adding New Topics

No other project uses it yet

27k3y agoReviewMountCreate a free account to mount
onlook-devReads credentialsCLAUDE.md

onlook

onlook-dev/onlook/CLAUDE.md

large assets. - Propose minimal diffs aligned with existing conventions; avoid wide refactors. ### Notes - Unit tests can be run with `bun test` - Run type checking with `bun run typecheck` - Apply database

No other project uses it yet

27k2y agoReviewMountCreate a free account to mount
humanlayerCLAUDE.md

12-factor-agents

humanlayer/12-factor-agents/CLAUDE.md

This project uses: - **Language/Framework**: [Add your stack here] - **Build Tool**: [Add your build commands] - **Testing**: [Add your test commands] - **Architecture**: [Describe your project structure] ## Core Principles (All Personas) 1. **READ

Steady4 mentions in 2 weeks

No other project uses it yet

27k16mo agoReviewMountCreate a free account to mount
anomalycoCLAUDE.md

sst

anomalyco/sst/CLAUDE.md

build:cli` - **Run CLI locally**: `cd examples/ && go run ../../cmd/sst ` - **Go tests**: `bun run test:cli` - **Typecheck**: `bun run typecheck` - **Generate docs**: `bun run docs:generate` - **Run docs locally

Steady6 mentions in 2 weeks

1 project uses a version of this

26k6mo agoReviewMountCreate a free account to mount
apifyCLAUDE.md

crawlee

apify/crawlee/.claude/CLAUDE.md

PATH issues in this environment. ## Pre-Commit Checks Always run `pnpm tsc-check-tests` (or the project's type-check command) before committing any TypeScript changes. Never assume type safety

No other project uses it yet

26k27d agoReviewMountCreate a free account to mount
VoltAgentCLAUDE.md

awesome-claude-code-subagents

VoltAgent/awesome-claude-code-subagents/CLAUDE.md

Language/framework experts (TypeScript, Python, etc.) 03-infrastructure/ # DevOps, cloud, Kubernetes, etc. 04-quality-security/ # Testing, security auditing, code review 05-data-ai/ # ML, data engineering, AI specialists 06-developer-experience

Steady5 mentions in 2 weeks

1 project uses a version of this

26k9mo agoReviewMountCreate a free account to mount
homebridgeCLAUDE.md

homebridge

homebridge/homebridge/CLAUDE.md

/bin/homebridge.js -D -P example-plugins/` (expects an `example-plugins/` checkout next to plugins under test). - `npm run lint` / `npm run lint:fix` — ESLint via `@antfu/eslint-config` (flat config in `eslint.config.js

No other project uses it yet

26k4mo agoReviewMountCreate a free account to mount
activepiecesDeletes or force-pushesCLAUDE.md

activepieces

activepieces/activepieces/CLAUDE.md

isNil()`, `spreadIfDefined()`, `spreadIfNotUndefined()`, `ActivepiecesError({ code, params })`, `SeekPage `, `formErrors`, `BaseModelSchema`, `chunk()`, `partition()`, `unique()`, `omit()`, `sanitizeObjectForPostgresql()` ## Testing ```bash npm run test-unit # Vitest: engine + shared npm run test-api # API integration

Steady6 mentions in 2 weeks

No other project uses it yet

25k5mo agoReviewMountCreate a free account to mount
karpathyReads credentialsCLAUDE.md

llm-council

karpathy/llm-council/CLAUDE.md

ranking criteria (not just accuracy/insight) - Support for reasoning models (o1, etc.) with special handling ## Testing Notes Use `test_openrouter.py` to verify API connectivity and test different model identifiers before adding

No other project uses it yet

25k11mo agoReviewMountCreate a free account to mount
Dao-AILabCLAUDE.md

flash-attention

Dao-AILab/flash-attention/CLAUDE.md

Dependencies: `nvidia-cutlass-dsl>=4.6.2`, `torch`, `einops`, `apache-tvm-ffi`, `quack-kernels>=0.5.3`. ## Running Tests ```bash pytest tests/cute/test_flash_attn.py pytest tests/cute/test_flash_attn.py -k "test_flash_attn_output" -x # single test pytest tests/cute/test_flash_attn_mla.py

25k46d 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.