CLAUDE.md examples from real projects

fathahCLAUDE.md

hermes-desktop

fathah/hermes-desktop/CLAUDE.md

responding to the user: - [ ] Update `lat.md/` if you added or changed any functionality, architecture, tests, or behavior - [ ] Run `lat check` — all wiki links and code refs must pass

jackcReads credentialsCLAUDE.md

pgx

jackc/pgx/CLAUDE.md

database/sql` compatible driver. Requires Go 1.25+ and supports PostgreSQL 14+ and CockroachDB. ## Build & Test Commands Every checkout has its own PostgreSQL 14-18 and CockroachDB instances, supervised by process-compose

No other project uses it yet

semaphoreuiCLAUDE.md

semaphore

semaphoreui/semaphore/.claude/CLAUDE.md

research Use MCP server `research` if your asks you to research something. ## Writing Tests Use `github.com/stretchr/testify/assert` (and `require` when a failure should stop the test immediately). ### Run tests ```bash

No other project uses it yet

GoogleCLAUDE.md

elephant-goldfish-model / claude

google/elephant-goldfish-model/distributions/claude/docs/claude.md

keep unrelated history, logs, and memory out of the review task. For local testing, load a uniquely named copy with `claude --plugin-dir ` to avoid confusion with an already installed

No other project uses it yet

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

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

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

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

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

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

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

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

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

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

EverMind-AICLAUDE.md

EverMemOS

EverMind-AI/EverMemOS/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

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