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 20Worked for most · soon
nicklockwoodCLAUDE.md

SwiftFormat

nicklockwood/SwiftFormat/CLAUDE.md

consistent style conventions. ## Project Structure - `Sources/Rules/` - Individual formatting rules (one file per rule) - `Tests/Rules/` - Test cases for rules - `Sources/Formatter.swift` - Core formatter class with token manipulation APIs - `Sources/ParsingHelpers.swift` - Parsing helpers

No other project uses it yet

9k11d agoReviewMountCreate a free account to mount
fissionCLAUDE.md

fission

fission/fission/CLAUDE.md

that the executor manages; the user-facing CLI is `fission`. ## Common commands Build / lint / test (run from repo root): - `make build-fission-cli` — build the `fission` CLI via goreleaser (snapshot

8.9k31d agoReviewMountCreate a free account to mount
mattpocockCLAUDE.md

sandcastle

mattpocock/sandcastle/CLAUDE.md

typecheck` for type checking. Before you finish a change, run `npm test`, then the `verify` skill on the agent × sandbox combination it touches. `tsc` is TypeScript 7 (the `@typescript/native` alias

8.9k12d agoReviewMountCreate a free account to mount
PydanticCLAUDE.md

monty

pydantic/monty/CLAUDE.md

execution clock, which is Linux-only so that it needs no `unsafe`. - Tests in `crates/*/tests/` should be cross-platform; use helper functions for OS-specific APIs like symlink creation

Steady2 mentions in 2 weeks

No other project uses it yet

8.9k2mo agoReviewMountCreate a free account to mount
PydanticCLAUDE.md

monty / modules

pydantic/monty/crates/monty/src/modules/CLAUDE.md

Verify every message against CPython with the `/python-playground` skill before pinning it in a test. ## Always use `#[derive(FromArgs)]` for function parameters Any function beyond the trivial 0/1/2-positional shapes (covered

No other project uses it yet

8.9k2mo agoReviewMountCreate a free account to mount
redpanda-dataCLAUDE.md

connect

redpanda-data/connect/CLAUDE.md

Agents | Task | Skill / Agent | |---|---| | Writing or modifying Go code | `godev` agent | | Writing or modifying tests | `tester` agent | | Code review | `/review` skill | ## Plugin: Redpanda Connect YAML configuration, Bloblang authoring, and component

No other project uses it yet

8.8k45d agoReviewMountCreate a free account to mount
radix-uiCLAUDE.md

themes

radix-ui/themes/CLAUDE.md

playground for development │ ├── app/ │ │ ├── (themeable)/sink/ # Main component showcase (http://localhost:3000/sink) │ │ ├── (themeable)/test/ # Test pages for specific scenarios │ │ └── (themeable)/demo/ # Demo pages │ ├── tests/ # Playwright visual regression tests │ └── playwright.config.ts ├── .github

Steady5 mentions in 2 weeks

No other project uses it yet

8.8k10mo agoReviewMountCreate a free account to mount
jonobr1CLAUDE.md

two.js

jonobr1/two.js/CLAUDE.md

nested objects, vertices, and effects - Important for preventing memory leaks in long-running applications ## Testing ### Test Structure - Tests located in `tests/` directory - Test suites in `tests/suite/` organized by functionality - HTML

8.7k5y agoReviewMountCreate a free account to mount
openshiftCLAUDE.md

origin

openshift/origin/CLAUDE.md

them as unmanaged duplicates. ### Retry allowlist policy **`pkg/test/ginkgo/retry_allowed_tests.yaml`** is strictly shrink-only. Never add tests to it. Remove an entry only when its underlying flake is fixed. If a requested

8.7k4mo agoReviewMountCreate a free account to mount
WenyuChiouCLAUDE.md

awesome-agentic-ai-zh

WenyuChiou/awesome-agentic-ai-zh/CLAUDE.md

OpenAI-compatible default (Path A) - `starter_anthropic.py` = Anthropic SDK version (Path B) - `test.py` = mock-based tests for the Ollama starter (OpenAI-compat response shape) - `test_anthropic.py` = mock-based tests for the Anthropic

No other project uses it yet

8.7k44d agoReviewMountCreate a free account to mount
mattpocockCLAUDE.md

ts-reset

mattpocock/ts-reset/CLAUDE.md

always run `pnpm typecheck`. This runs against the entire repo, which is good for testing regressions

8.6k8mo agoReviewMountCreate a free account to mount
digoalCLAUDE.md

blog

digoal/blog/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

8.6k5mo agoReviewMountCreate a free account to mount
bytedanceCLAUDE.md

flowgram.ai

bytedance/flowgram.ai/CLAUDE.md

lint issues rush lint:fix # TypeScript type checking rush ts-check # Run unit tests rush test # Run tests with coverage rush test:cov # Build packages in watch mode (for development

8.6k11mo agoReviewMountCreate a free account to mount
reactiveuiCLAUDE.md

ReactiveUI

reactiveui/ReactiveUI/CLAUDE.md

root** - **Primary working directory for build/test:** `./src` - **Main solution:** `src/reactiveui.slnx` - **Benchmarks solution:** `Benchmarks/ReactiveUI.Benchmarks.sln` - **Integration tests:** `integrationtests/` (platform-specific solutions; not required for most tasks) ### Full Clone Required **CRITICAL

Steady5 mentions in 2 weeks

No other project uses it yet

8.6k5y agoReviewMountCreate a free account to mount
meshtasticCLAUDE.md

firmware

meshtastic/firmware/CLAUDE.md

Claude Code instructions > **TL;DR** > > | | | > | -------------- | ------------------------------------------------------------------------------------------------------------------------- | > | Local tests | `./bin/run-tests.sh` (exit 0 GREEN · 1 RED · 2 AMBER · 3 FILTERED · 4 BUSY · 5 ABORTED · 6 UNSUPPORTED); `--status` first | > | Hardware tests | [meshtastic/meshtastic-mcp](https://github.com

8.6k7mo agoReviewMountCreate a free account to mount
bitsandbytes-foundationCLAUDE.md

bitsandbytes

bitsandbytes-foundation/bitsandbytes/CLAUDE.md

check` and `ruff format` — those are just 2 of 10 hooks. Full details: `agents/linting_guide.md` # Testing: only run relevant tests Do NOT run the full test suite — it takes 10+ minutes

No other project uses it yet

8.5k3y agoReviewMountCreate a free account to mount
roadrunner-serverCLAUDE.md

roadrunner

roadrunner-server/roadrunner/.claude/CLAUDE.md

go.mod`, `tests/go.mod`, and `go.work`. The workspace contains two modules: the root module and `tests/`. Root `go test ./...` does not include the E2E module. - `container.Plugins()` in `container/plugins.go` defines the default plugin

Steady5 mentions in 2 weeks

No other project uses it yet

8.5k23mo agoReviewMountCreate a free account to mount
garmeehCLAUDE.md

next-seo

garmeeh/next-seo/CLAUDE.md

ESLint issues pnpm format # Format with Prettier pnpm typecheck # Type checking with TypeScript ``` ### Testing ```bash pnpm test # Run typecheck + lint only pnpm test:unit # Run unit tests with Vitest pnpm

8.5k16mo agoReviewMountCreate a free account to mount
NomicFoundationCLAUDE.md

hardhat

NomicFoundation/hardhat/CLAUDE.md

Commands Install - pnpm install Build - pnpm build Test - pnpm test For single-file work, run these from the repo root. They build upstream deps and run the tool

8.5k2mo agoReviewMountCreate a free account to mount
AnthropicCLAUDE.md

claude-agent-sdk-python

anthropics/claude-agent-sdk-python/CLAUDE.md

Lint and style # Check for issues and fix automatically python -m ruff check src/ tests/ scripts/ --fix python -m ruff format src/ tests/ scripts/ # Typecheck python -m mypy src/ scripts

Steady16 mentions in 2 weeks

No other project uses it yet

8.5k4mo 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.