CLAUDE.md examples from real projects

idankReads credentialsCLAUDE.md

explainshell

idank/explainshell/CLAUDE.md

SQLite, bashlex, OpenAI SDK, Google Gemini SDK, LiteLLM (fallback) - Linting: ruff (Python), biome (JS) - Testing: pytest (unit + doctests), JS Playwright Test (e2e) - Dependencies: `requirements.txt` (web serving), `requirements-extraction.txt` (LLM SDKs, offline

phpstanCLAUDE.md

phpstan

phpstan/phpstan/CLAUDE.md

Overview PHPStan finds errors in PHP code without running it. It catches bugs before tests are written, moving PHP closer to compiled languages. This is the **distribution repository** — the compiled

phpstanCLAUDE.md

phpstan / website

phpstan/phpstan/website/CLAUDE.md

check` — TypeScript type-check + ESLint - `npm run fix` — ESLint auto-fix - `npm run test:visual` — Run Playwright visual regression tests - `npm run test:visual:update` — Update visual test snapshots ### Deployment

bitwardenCLAUDE.md

clients

bitwarden/clients/.claude/CLAUDE.md

lint:fix` — applies ESLint fixes - `npm run prettier` — formats with Prettier - `npm run test:types` — type-checks the workspace - `npm test` — runs Jest. Scope with `npm test -- ` when changes

567-labsCLAUDE.md

instructor

567-labs/instructor/CLAUDE.md

deps: `uv pip install -e ".[dev,anthropic]"` or `poetry install --with dev,anthropic` - Run tests: `uv run pytest tests/ -n auto` - Run specific test: `uv run pytest tests/path_to_test.py::test_name

No other project uses it yet

FujiwaraChokiReads credentialsCLAUDE.md

MoneyPrinter

FujiwaraChoki/MoneyPrinter/CLAUDE.md

python -m compileall Backend # syntax check curl http://localhost:8080/api/models # API smoke test ``` ### Tests No test suite exists yet. If added, use pytest: ```bash uv run pytest -q # all tests

Open-LLM-VTuberCLAUDE.md

Open-LLM-VTuber

Open-LLM-VTuber/Open-LLM-VTuber/CLAUDE.md

upgrade system for breaking changes - Validate configurations in respective config manager classes ## Testing and Quality Assurance The project uses: - **Ruff** for linting and formatting (configured in `pyproject.toml`) - **Pre-commit hooks

No other project uses it yet

OpenNHPReads credentialsCLAUDE.md

opennhp

OpenNHP/opennhp/CLAUDE.md

support (requires clang) make ebpf # Build plugins make plugins # Initialize/tidy modules make init ``` ## Running Tests ```bash # Run tests in the nhp module cd nhp && go test ./... # Run tests

formkitReads credentialsCLAUDE.md

auto-animate

formkit/auto-animate/.dmux-hooks/CLAUDE.md

with `#!/bin/bash` 4. **Use environment variables**: Access `$DMUX_ROOT`, `$DMUX_WORKTREE_PATH`, etc. 5. **Test it**: Set env vars manually and run the script ## Hook Execution Model - **Non-blocking**: Hooks

borgbackupCLAUDE.md

borg

borgbackup/borg/.claude/CLAUDE.md

Python), a pyinstaller-made binary is meant: - POSIX: `pyinstaller --clean --distpath=dist/binary/ scripts/borg.exe.spec` ## Writing tests Always write pytest-style tests unless unittest-style is explicitly required. ## Writing docstrings, comments, documentation

No other project uses it yet

glideappsDeletes or force-pushesCLAUDE.md

quicktype

glideapps/quicktype/CLAUDE.md

node dist/index.js --help ``` For live rebuild/re-run while developing renderer output, use: ```bash npm start -- " " ``` ## Testing ### Test strategy quicktype's primary testing method is end-to-end fixture tests driven

No other project uses it yet

browserlessReads credentialsCLAUDE.md

browserless

browserless/browserless/CLAUDE.md

then starts with .env config) npm run dev # Start without rebuilding npm start # Run tests (builds test artifacts first) npm run test # Run single test file npx mocha build/path/to/file.spec.js # Lint

No other project uses it yet

qazbnm456Reads credentialsCLAUDE.md

awesome-web-security

qazbnm456/awesome-web-security/CLAUDE.md

skills/awesome-web-security/` so AI agents can query the list at runtime. No build, no test suite, no application runtime. Every change is either YAML data, Python tooling, or Markdown docs. ## Files

No other project uses it yet

coleam00Pipes a download into a shellCLAUDE.md

context-engineering-intro / claude-code-full-guide

coleam00/context-engineering-intro/claude-code-full-guide/CLAUDE.md

pyproject.toml - **Use venv_linux** (the virtual environment) whenever executing Python commands, including for unit tests. ### Project Architecture Follow strict vertical slice architecture with tests living next to the code they

coleam00CLAUDE.md

context-engineering-intro

coleam00/context-engineering-intro/CLAUDE.md

PLANNING.md`. - **Use venv_linux** (the virtual environment) whenever executing Python commands, including for unit tests. ### 🧱 Code Structure & Modularity - **Never create a file longer than 500 lines of code

EverMind-AICLAUDE.md

EverOS

EverMind-AI/EverOS/CLAUDE.md

make lint # ruff (check + format-check) + import-linter make format # auto-fix formatting make test # pytest tests/unit make integration # pytest tests/integration make ci # full CI: lint + test + integration ``` ## Architecture

yichuan-wPipes a download into a shellCLAUDE.md

LEANN

yichuan-w/LEANN/CLAUDE.md

README) uv sync --extra diskann # Install lint tools uv sync --group lint # Install test tools uv sync --group test ``` ## Code Quality ```bash # Format code ruff format # Lint with auto

Model Context ProtocolCLAUDE.md

typescript-sdk

modelcontextprotocol/typescript-sdk/CLAUDE.md

words are true** — Changesets, docs and comments say what the code does. 7. **Test what users see** — Prefer tests that cover the end-to-end usage a user would actually

No other project uses it yet

Model Context ProtocolCLAUDE.md

typescript-sdk / e2e

modelcontextprotocol/typescript-sdk/test/e2e/CLAUDE.md

test suite Conformance-style tests for the SDK's public surface. `requirements.ts` is a pure-data manifest: every behavior the SDK must satisfy, with its spec/source link. Test files

No other project uses it yet

plasma-umassReads credentialsCLAUDE.md

scalene

plasma-umass/scalene/CLAUDE.md

native/C time **Platform support:** Linux, macOS, WSL 2 (full support); Windows (partial support) ## Build & Test Commands ```bash # Install in development mode pip install -e . # Run all tests python3 -m pytest

No other project uses it yet