CLAUDE.md examples from real projects

severity1CLAUDE.md

claude-code-prompt-improver

severity1/claude-code-prompt-improver/CLAUDE.md

module named `nudge_builtins` (not `builtins`) because the stdlib `builtins` is loaded before user code and would permanently shadow a local `builtins.py`; handlers/matchers referenced by allowlisted string name only

ShisatoYanoCLAUDE.md

AutonomousVehicleControlBeginnersGuide

ShisatoYano/AutonomousVehicleControlBeginnersGuide/CLAUDE.md

docstring, units in the names. Don't add type hints to unrelated existing code in the same change - Simulation scripts have a `show_plot` flag and keep their logic

PhilipKCLAUDE.md

BoilR

PhilipK/BoilR/CLAUDE.md

Steam-facing bug appears, check what Steam writes today before trusting the existing code. - Release tags have the form `v.1.9.6` (note the dot after `v`). Pushing one triggers `.github/workflows/release_on_v_tag.yml`, which

bcgitCLAUDE.md

bc-csharp

bcgit/bc-csharp/CLAUDE.md

acceptable, propose an inline comment recording the choice. In existing code that isn't the focus of review, follow the surrounding discipline — its patterns reflect deliberate choices

xu-xiangCLAUDE.md

everything-claude-code-zh

xu-xiang/everything-claude-code-zh/CLAUDE.md

node tests/lib/package-manager.test.js node tests/hooks/hooks.test.js ``` ## 架构设计 (Architecture) 项目由以下核心组件组成： - **agents/** - 用于委派 (Delegation) 的专业子智能体 (Subagents)（如 planner、code-reviewer、tdd-guide 等） - **skills/** - 工作流 (Workflow) 定义与领域知识（如编码标准、模式、测试） - **commands/** - 用户调用的斜杠命令 (Slash Commands

No other project uses it yet

trailofbitsCLAUDE.md

publications

trailofbits/publications/CLAUDE.md

ONLY the product/project name - Do NOT include document types like "Letter of Attestation", "Design Review", "Code Review", "Security Review", "Threat Model" - Just use the clean product name (e.g., "Discord DAVE

MadAppGangCLAUDE.md

dingo

MadAppGang/dingo/CLAUDE.md

work ## Agent Selection | Task | Agent | |------|-------| | Implementation | golang-developer | | Architecture | golang-architect | | Testing | golang-tester | | Code review | code-reviewer | | Codebase search | Explore | **Landing page** (`landingpage/` dir): Use astro-* agents instead. ## Agent

MadAppGangCLAUDE.md

dingo / langingpage

MadAppGang/dingo/langingpage/CLAUDE.md

astro-reviewer`, you cannot delegate to `astro-reviewer` - If you are `code-reviewer`, you cannot delegate to `code-reviewer` **Why:** You ARE the specialized agent. Delegating to yourself causes recursion

deepcoldyCLAUDE.md

botmux

deepcoldy/botmux/CLAUDE.md

botmux 飞书话题群 ↔ AI 编程 CLI 桥接。Daemon 监听飞书消息，每个新话题自动 spawn 一个独立 CLI 进程（Claude Code / Codex / Antigravity / Grok / Pi 等 20+ 种，完整列表见 README）。 ## 构建 & 运行 ```bash bun run build

Datus-aiCLAUDE.md

Datus-agent

Datus-ai/Datus-agent/CLAUDE.md

code (see **Bug-fix regression tests**) When using `gh pr create --body`, copy `.github/PULL_REQUEST_TEMPLATE.md` as the starting point. PRs with empty/missing sections must be revised before review. ## Commit Workflow

No other project uses it yet

meganzCLAUDE.md

android / jenkinsfile

meganz/android/jenkinsfile/CLAUDE.md

loaded as an object. ### Claude skills (`android-process-skills`) The Code Review and Ask AI stages prompt Claude with a `SKILL.md` that lives in `mobile/android/android-process-skills`, not in this repository. `common.checkoutProcessSkill

CactiCLAUDE.md

cacti

Cacti/cacti/CLAUDE.md

Cacti coding guide Read [AGENTS.md](AGENTS.md) and [.github/copilot-instructions.md](.github/copilot-instructions.md). The Copilot document contains the established application conventions; AGENTS adds test organization, path-depth and dependency rules. Keep shared guidance free

mercurjsCLAUDE.md

mercur

mercurjs/mercur/CLAUDE.md

Design → code (Figma)**: when the task is turning a Figma design into dashboard UI code — the user shares a `figma.com` URL, selects a Figma node, or asks to "convert / implement

bryanroscoeCLAUDE.md

shield_optimizer

bryanroscoe/shield_optimizer/CLAUDE.md

through once — preserved here because the roadmap doc that held them has been deleted. - **Code signing.** macOS means the Apple Developer Program ($99/yr) plus notarization; there is no shortcut. Windows

AnthropicCLAUDE.md

claude-agent-sdk-typescript

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

that the allowed tools do not cover then runs only if Claude Code's safety review passes it. Allow only the tools the job needs, and keep any `--disallowedTools` list

No other project uses it yet

kgoedeckeCLAUDE.md

doop

kgoedecke/doop/CLAUDE.md

which `.context/INDEX.md` links. Always use the `clean-code:typescript` skill when writing or reviewing TypeScript code in this repo. ## First-time setup after clone ```bash bun install

No other project uses it yet

NikolaySCLAUDE.md

pgque

NikolayS/pgque/CLAUDE.md

failure first (red/green TDD when the fix is code: reproduce in a failing test, make it green, then refactor). 2. **Review done.** Use REV (`https://gitlab.com/postgres-ai/rev/`) — it targets GitLab

OpenAdaptAICLAUDE.md

OpenAdapt

OpenAdaptAI/OpenAdapt/CLAUDE.md

Claude Code Guidelines for OpenAdapt ## Repository role This public repository is the launcher/meta-package and stable community entry point for OpenAdapt. It owns `pip install openadapt`, the unified `openadapt` CLI, release

No other project uses it yet

LibPDF-jsCLAUDE.md

core

LibPDF-js/core/CLAUDE.md

Check with Biome bun run lint:fix # Fix lint issues ``` ## Project Structure ``` src/ # Source code index.ts # Main entry point test-utils.ts # Shared test utilities (loadFixture, byte helpers) fixtures/ # PDF test files

No other project uses it yet

OpenAEV-PlatformCLAUDE.md

openaev

OpenAEV-Platform/openaev/CLAUDE.md

AGENTS.md`, then that `.agent.md` file, and follow it. For a full review, run the Code Reviewer first, then the specialists it lists, in parallel

No other project uses it yet