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

pedrohcgsCLAUDE.md

claude-code-my-workflow

pedrohcgs/claude-code-my-workflow/CLAUDE.md

software: message and silent-resolution censuses, frozen feature matrices for ports, hash-claimed inherited tests, and downstream consumers pinned by commit SHA. **How we write** — [`writing-with-ai.md`](.claude/rules/writing-with-ai.md): internal vs external

1.6k4d agoDiscuss

AminForouCLAUDE.md

mcp-gsc

AminForou/mcp-gsc/CLAUDE.md

return _site_not_found_error(site_url) return f"Error: {str(e)}" ``` ## Running tests ```bash pytest test_gsc_server.py -v ``` No credentials needed — all Google API calls are mocked with `unittest.mock`. ## Docker

1.6k6mo agoDiscuss

actionbookCLAUDE.md

actionbook

actionbook/actionbook/CLAUDE.md

mode (all packages) pnpm dev # Build all (with caching via Turborepo) pnpm build # Run tests pnpm test # Lint all packages pnpm lint # Clean all build outputs pnpm clean ``` ### Turborepo Commands

1.6k2mo agoReads credentialsDiscuss

DockerCLAUDE.md

mcp-gateway

docker/mcp-gateway/CLAUDE.md

plugin locally make docker-mcp # Cross-compile for all platforms make docker-mcp-cross ``` ### Testing ```bash # Run all tests make test # Run integration tests specifically make integration # Run long-lived

1.6k9mo agoDiscuss

agentlas-aiCLAUDE.md

Agentlas-OS

agentlas-ai/Agentlas-OS/CLAUDE.md

user install/runtime files and public README/LICENSE/CHANGELOG material. Never stage internal docs, research, benchmarks, tests or fixtures, logs/results, signing or credential material, environment files, private paths/memory, or unrelated local work. Verify

1.6k35d agoDiscuss

shinshin86CLAUDE.md

oh-my-logo

shinshin86/oh-my-logo/CLAUDE.md

TypeScript to JavaScript in `dist/` - `npm run start` - Run with ts-node (ESM mode) ### Testing - `npm test` - Run all tests with Vitest - `npm run test:ui` - Run tests with interactive

1.6k14mo agoDiscuss

svnschaCLAUDE.md

mcp-windbg

svnscha/mcp-windbg/CLAUDE.md

entry point is `mcp-windbg`, which speaks MCP over stdio or streamable-http. ## Build / test / run Python 3.10+ with the `uv` package manager. CDB must be installed for the live

1.6k4mo agoReads credentialsDiscuss

ShpigfordCLAUDE.md

chops

Shpigford/chops/CLAUDE.md

Sparkle (>= 2.6.0) is the only external dependency (auto-updates via GitHub Releases). No test suite exists. Validate manually by building and running. ## Development Rules **Always manually test.** After every change

1.6k6mo agoDiscuss

rivet-devCLAUDE.md

sandbox-agent

rivet-dev/sandbox-agent/CLAUDE.md

JSON resource files should list all known models regardless of subscription tier. ## Docker Test Image - Docker-backed Rust and TypeScript tests build `docker/test-agent/Dockerfile` directly in-process and cache the image

1.6k7mo agoDiscuss

rivet-devCLAUDE.md

sandbox-agent / examples

rivet-dev/sandbox-agent/examples/CLAUDE.md

example needs tools, skills, or MCP servers, install them inside the container during setup. ## Testing Examples (ACP v2) Examples should be validated against v2 endpoints: 1. Start the example: `SANDBOX

1.6k7mo agoDiscuss

rivet-devCLAUDE.md

sandbox-agent / foundry

rivet-dev/sandbox-agent/foundry/CLAUDE.md

JavaScript source files (`.js`, `.mjs`, `.cjs`). - Prefer `.ts`/`.tsx` for runtime code, scripts, tests, and tooling. - If touching old JavaScript, migrate it to TypeScript instead of extending it. ## Monorepo + Tooling

1.6k7mo agoReads credentialsDiscuss

rivet-devCLAUDE.md

sandbox-agent / sdks

rivet-dev/sandbox-agent/sdks/CLAUDE.md

document TypeScript APIs unless they are exported and implemented in those files. ## Tests - TypeScript SDK tests should run against a real running server/runtime over real `/v1` HTTP APIs, typically using

1.6k7mo agoDiscuss

rivet-devCLAUDE.md

sandbox-agent / server

rivet-dev/sandbox-agent/server/CLAUDE.md

specification (full LLM-readable reference): `https://agentclientprotocol.com/llms-full.txt` - `~/misc/acp-docs/schema/schema.json` - `~/misc/acp-docs/schema/meta.json` - `research/acp/spec.md` - `research/acp/v1-schema-to-acp-mapping.md` - `research/acp/friction.md` - `research/acp/todo.md` ## Tests Primary v1 integration coverage: - `server/packages/sandbox-agent/tests/v1_api.rs` - `server/packages/sandbox-agent/tests/v1_agent_process_matrix.rs` Run: ```bash cargo test -p sandbox-agent --test

1.6k7mo agoDiscuss

MicrosoftCLAUDE.md

playwright-java

microsoft/playwright-java/CLAUDE.md

GitHub. ## Commit Convention Semantic commit messages: `label(scope): description` Labels: `fix`, `feat`, `chore`, `docs`, `test`, `devops` ```bash git checkout -b fix-39562 # ... make changes ... git add git commit

1.6k16d agoDiscuss

deepcoldyCLAUDE.md

botmux

deepcoldy/botmux/CLAUDE.md

中文说明**：改了什么、为什么、影响面（涉及哪些模块/会话类型） - 附**实际测试验证**：贴出跑过的命令和关键结果（`bun run build`、`bun run test`、相关 e2e），不要只写「应该没问题」；需要 live 验证的先 `bun run switch:here && bun run daemon:restart

1.5k3mo agoDiscuss

krusemediallcCLAUDE.md

arcads-claude-code / shared

krusemediallc/arcads-claude-code/shared/CLAUDE.md

that go beyond what the skills answer — ROAS scaling, ad-account architecture, positioning, copy-testing systems, brand voice at scale, anything that needs human judgment + media-buying experience rather than

1.5k6mo agoReads credentialsDiscuss

StripeCLAUDE.md

stripe-dotnet

stripe/stripe-dotnet/.claude/CLAUDE.md

stripe-dotnet ## Testing - Run all tests: `just test` (auto-installs correct .NET version) - Run a specific test: `just test-one TestClassName` or `just test-one FullyQualifiedName` ## Formatting - Format: `just format

1.5k7mo agoDiscuss

fim-aiCLAUDE.md

fim-one

fim-ai/fim-one/CLAUDE.md

async, provider-agnostic, protocol-first. - **Package manager**: `uv` (not pip) · **Frontend**: Next.js + pnpm (`frontend/`) - **Tests**: `uv run pytest` · **Launcher**: `./start.sh [portal|api]` ``` src/fim_one/ ├── core/{agent,model,planner,memory,tools

1.5k15d agoReads credentialsDiscuss

fynnflueggeCLAUDE.md

agtx

fynnfluegge/agtx/CLAUDE.md

line editor: buffer + byte caret, motion, deletion │ ├── wizard.rs # Task create/edit wizard state │ └── *_tests.rs # Unit tests included via #[path] ├── db/{schema.rs (SQLite ops), models.rs (Task, Project, TaskStatus, PhaseStatus, ...)} ├── tmux/ │ ├── mod.rs # Tmux

1.5k5mo agoDiscuss

silversteinCLAUDE.md

minutes

silverstein/minutes/CLAUDE.md

memos from iPhone/iCloud ## Quick Start ```bash cd ~/Sites/minutes cargo build # Build Rust workspace cargo test -p minutes-core --no-default-features # Fast tests (no whisper model) cargo run --bin minutes

1.5k29d agoDiscuss

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.