CLAUDE.md examples from real projects

firecrawlCLAUDE.md

pdf-inspector

firecrawl/pdf-inspector/CLAUDE.md

text extraction to structured Markdown. CLI binary: `pdf2md`. Detection binary: `detect-pdf`. ## Build & Test ```bash cargo fmt # format cargo clippy -- -D warnings # lint (enforced, zero warnings) cargo test # unit + integration

No other project uses it yet

elysiajsCLAUDE.md

elysia

elysiajs/elysia/CLAUDE.md

Nothing speculative. No features beyond what was asked. No abstractions for single-use code. Test: would a senior engineer say this is overcomplicated? If yes, simplify. ## Rule 3 — Surgical Changes

No other project uses it yet

AnthropicReads credentialsCLAUDE.md

claude-quickstarts

anthropics/claude-quickstarts/CLAUDE.md

computer-use-demo:local` ### Testing & Code Quality - **Lint**: `ruff check .` - **Format**: `ruff format .` - **Typecheck**: `pyright` - **Run tests**: `pytest` - **Run single test**: `pytest tests/path_to_test.py::test_name -v` ### Code Style - **Python**: snake

No other project uses it yet

AnthropicReads credentialsCLAUDE.md

claude-quickstarts / assistant-ui

anthropics/claude-quickstarts/managed-agents/assistant-ui/CLAUDE.md

noEmit` - `npm run lint` — eslint (the copy-in `components/` are ignored on purpose) - `npm test` — the reducer's golden-turn test; run it whenever the event mapping changes ## Conventions - Name

AnthropicReads credentialsCLAUDE.md

claude-quickstarts / copilot-kit-ag-ui

anthropics/claude-quickstarts/managed-agents/copilot-kit-ag-ui/CLAUDE.md

serves `web/dist` if present. - `npm run typecheck` covers both workspaces. There are no tests. Verify changes by running the app. ## Design notes - `package.json` pins one `rxjs` version via `overrides

AnthropicReads credentialsCLAUDE.md

claude-quickstarts / daily-brief

anthropics/claude-quickstarts/managed-agents/daily-brief/CLAUDE.md

environment.yaml`'s allowlist does not apply to them. 5. **Keep the deployment paused while testing** (`agents/setup.sh` pauses it on creation; manual runs work while paused). `scripts/reset-state.sh` empties the state store

AnthropicReads credentialsCLAUDE.md

claude-quickstarts / self-hosted-sandboxes

anthropics/claude-quickstarts/managed-agents/self-hosted-sandboxes/CLAUDE.md

runbook: setup, deploy, register the `session.status_run_started` webhook in the Console, test. Their environment key and webhook secret go in the provider's own secret store, never

AnthropicReads credentialsCLAUDE.md

claude-quickstarts / sentry-autofix

anthropics/claude-quickstarts/managed-agents/sentry-autofix/CLAUDE.md

which the user wants. - **Outcomes**: kick off with `user.define_outcome` and a rubric (new test fails before the fix, whole suite passes after, diff touches only what the root cause

storytoldCLAUDE.md

pdfcraft

storytold/pdfcraft/CLAUDE.md

carry a status line and a revision history). - "Shipped" in `parity/` means "exists and tested", not "as good as Acrobat". Don't mark a feature shipped on a generic test

ahmedkhaleel2004Reads credentialsCLAUDE.md

gitdiagram

ahmedkhaleel2004/gitdiagram/CLAUDE.md

gate (below) first. Pushes that touch only root `*.md`, `docs/**`, `experiments/**` and a few test tools do not deploy to Cloudflare (`paths-ignore` in that workflow). - **Commit to `main

teambitCLAUDE.md

bit

teambit/bit/CLAUDE.md

Compilation - `bit compile` - Compile all components - `bit watch` - Watch for changes and compile automatically ### Testing **IMPORTANT — prefer unit tests (`.spec.ts`) over e2e tests.** E2e tests are extremely expensive: they dominate

No other project uses it yet

genlayerlabsCLAUDE.md

genlayer-project-boilerplate

genlayerlabs/genlayer-project-boilerplate/CLAUDE.md

this repository. ## Quick Commands ```bash # Linting genvm-lint check contracts/football_bets.py # Lint a contract # Testing pytest tests/direct/ -v # Direct mode tests (fast, no Studio) gltest tests/integration/ -v -s # Integration tests (requires

No other project uses it yet

gfx-rsCLAUDE.md

wgpu

gfx-rs/wgpu/CLAUDE.md

that supplies the affected behavior. Repository documentation exists in `docs/`. For info on where tests live, read `docs/testing.md`. For info about cargo dependencies, read `docs/managing-cargo-dependencies.md`. One of the best ways

No other project uses it yet

sqlc-devDeletes or force-pushesCLAUDE.md

sqlc

sqlc-dev/sqlc/CLAUDE.md

sqlc This document provides essential information for working with the sqlc codebase, including testing, development workflow, and code structure. ## Quick Start ### Prerequisites - **Go 1.26.4+** - Required for building and testing - **Docker

No other project uses it yet

emcie-coCLAUDE.md

parlant

emcie-co/parlant/CLAUDE.md

using 3rd party tools - api: REST API layer using FastAPI. Uses modules from core/ - tests: all tests for the project. Structure strives to mirror that which is under src/parlant. General

No other project uses it yet

gnachmanCLAUDE.md

iTerm2

gnachman/iTerm2/CLAUDE.md

iTermBrowserTemplateLoader.swift - Don't create dependency cycles. Use delegates or closures instead. - To run unit tests in ModernTests, use tools/run_tests.expect. It takes an argument naming the test or tests, such

gnachmanCLAUDE.md

iTerm2 / WebExtensionsFramework

gnachman/iTerm2/WebExtensionsFramework/CLAUDE.md

field at a time until we have done everything. ## Practices * Use TDD. Write tests, ensure they fail, then write code, then ensure tests pass. * Use async/await when appropriate. Avoid completion

No other project uses it yet

RightNow-AIReads credentialsCLAUDE.md

openfang

RightNow-AI/openfang/CLAUDE.md

bash cargo build --workspace --lib # Must compile (use --lib if exe is locked) cargo test --workspace # All tests must pass (currently 1744+) cargo clippy --workspace --all-targets -- -D warnings # Zero

No other project uses it yet

muratcankoylanCLAUDE.md

Agent-Skills-for-Context-Engineering

muratcankoylan/Agent-Skills-for-Context-Engineering/CLAUDE.md

Code marketplace manifest (single bundled plugin, v2.6.0) - `.plugin/plugin.json` - Open Plugins format manifest (v2.6.0) ## Build & Test Commands No top-level build system. Repo-level gates and per-project tooling below

No other project uses it yet

transitive-bullshitCLAUDE.md

agentic

transitive-bullshit/agentic/CLAUDE.md

services - **Website** (`apps/web/`) - Next.js site for both the marketing site and authenticated webapp - **E2E Tests** (`apps/e2e/`) - End-to-end test suite for HTTP and MCP gateway requests - **Shared Packages** (`packages