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 4Worked for most · soon

fengshao1227CLAUDE.md

ccg-workflow

fengshao1227/ccg-workflow/CLAUDE.md

rule 用了错误的 skill 名（#148）**：`ccg-skills.md` 指示 AI 调用不带 `ccg:` 前缀的命令名，但实际注册的命令是 `/ccg:verify-security` 等。AI 按 rule 调用失败后跳过质量关卡。修复：所有引用改为带 `/ccg:` 前缀。 ### 2026-06-18 (v3.1.6) - ✨ **CodeGraph

5.9k7mo agoReads credentialsDiscuss

fengshao1227CLAUDE.md

ccg-workflow / templates

fengshao1227/ccg-workflow/templates/CLAUDE.md

5.9k7mo agoDiscuss

VercelCLAUDE.md

streamdown / website

vercel/streamdown/apps/website/.claude/CLAUDE.md

Prefer simple conditionals over nested ternary operators - Group related code together and separate concerns ### Security - Add `rel="noopener"` when using `target="_blank"` on links - Avoid `dangerouslySetInnerHTML` unless absolutely necessary

5.7k14mo agoDiscuss

breaking-brakeCLAUDE.md

cc-wf-studio

breaking-brake/cc-wf-studio/CLAUDE.md

effect refactors) is out of scope for agents. Maintenance is interrupt-only: red CI, security, human-reported bugs. - Two skills drive it: `next-idea` (ideation — files locked `idea` issues, never

5.4k3mo agoDiscuss

SenteLabsAICLAUDE.md

OpenExecutive

SenteLabsAI/OpenExecutive/CLAUDE.md

server/`, auth, `orchestrator/outbound_guard.py`, the cached prompt blocks or `.gitignore` gets a pass from the `security-reviewer` agent (or `/security-review`) before the PR opens. - Every non-draft PR also gets

5.3k5d agoReads credentialsDiscuss

GitHubCLAUDE.md

gh-aw / engines

github/gh-aw/docs/src/content/docs/engines/claude.md

Select and authenticate Claude Code as the AI engine for GitHub Agentic Workflows, understand its capabilities and limitations, and start from an example.

5.2k4mo agoReads credentialsDiscuss

awarexoneCLAUDE.md

Agentic-Bug-Hunter

awarexone/Agentic-Bug-Hunter/CLAUDE.md

surface ranking from recon output + memory - `token-auditor` — fast meme coin/token rug pull and security analysis - `credential-hunter` — orchestrates wordlist-gen + osint-employees + breach-check; HARD STOPS at spray

5.2k4mo agoDiscuss

SaladDayCLAUDE.md

cc-switch-cli

SaladDay/cc-switch-cli/CLAUDE.md

rounds. Ask the reviewer to independently inspect all current modifications and report correctness, regression, security, performance, UX, and test-coverage issues. - Validate every finding against the code. Make minimal fixes

5.1k18d agoReads credentialsDiscuss

entireioCLAUDE.md

cli

entireio/cli/CLAUDE.md

docs/architecture/agent-guide.md), [integration checklist](docs/architecture/agent-integration-checklist.md) | | External commands or agents | [External commands](docs/architecture/external-commands.md), [agent protocol](docs/architecture/external-agent-protocol.md) | | Security, privacy, scanners, OPF | [Security and privacy](docs/security-and-privacy.md), [implementation contracts](docs/development/checkpoint-implementation.md) | | Review command | [Review architecture](docs/architecture/review-command.md

5.1k3mo agoDiscuss

JetBrainsCLAUDE.md

koog / a2a

JetBrains/koog/a2a/CLAUDE.md

task updates - **Multiple Transport Protocols**: JSON-RPC, HTTP+JSON/REST with extensibility for gRPC - **Authentication & Security**: OpenAPI 3.0 compatible security schemes ### Submodules Architecture 1. **a2a-core**: Core abstractions, data models

4.6k5mo agoDiscuss

SupabaseCLAUDE.md

supabase-js

supabase/supabase-js/.claude/CLAUDE.md

cutting migration notes (one H2 per theme). Per-package migrations live at `packages/core/ /migrations/`. > - **[Security Policy](https://github.com/supabase/supabase-js/security/policy)** - Security policies and responsible disclosure ## Repository Architecture ### Monorepo Structure ```text supabase

4.6k6mo agoDeletes or force-pushesDiscuss

vijaythecoderCLAUDE.md

awesome-claude-agents

vijaythecoder/awesome-claude-agents/CLAUDE.md

clarification ### Tool Inheritance - Omitting `tools` field = inherit all tools (recommended) - Specify tools only for security restrictions - Includes WebFetch, MCP tools when available ## Development Guidelines 1. **Creating New Agents**: - Use templates/agent-template.md

4.4k14mo agoDiscuss

VercelCLAUDE.md

just-bash

vercel-labs/just-bash/CLAUDE.md

bash interpreter with an in-memory virtual filesystem. Designed for AI agents needing a secure, sandboxed bash environment. No WASM dependencies allowed. ## Commands ```bash # Build & Lint pnpm build # Build TypeScript

4.3k7mo agoDiscuss

txn2CLAUDE.md

kubefwd

txn2/kubefwd/CLAUDE.md

metrics events - `utils`: Root permission checks (OS-specific) ## Important Implementation Details ### Root Permissions and Security kubefwd requires superuser privileges for: - Adding IP aliases to loopback interface - Binding to low-numbered

4.2k9mo agoDiscuss

melgarafaelCLAUDE.md

DeskcommCRM

melgarafael/DeskcommCRM/CLAUDE.md

Extensions: `uuid-ossp`, `pgcrypto`, `vector` - **Auth:** Supabase Auth via `@supabase/ssr`. Cookie SameSite=Strict, HttpOnly, Secure - **Realtime:** Supabase Realtime (postgres_changes + broadcast) - **Storage:** Supabase Storage (bucket `whatsapp-media` privado, URLs assinadas

4.2k13d agoReads credentialsDiscuss

nyldnCLAUDE.md

claude-octopus

nyldn/claude-octopus/CLAUDE.md

mode ✅ Deliver Phase: Reviewing authentication implementation Providers: 🔴 Codex CLI - Code quality analysis 🧭 Antigravity CLI - Security and edge cases 🔵 Claude - Synthesis and recommendations ``` **Debate:** ``` 🐙 **CLAUDE OCTOPUS ACTIVATED** - AI Debate Hub 🐙 Debate

4.1k48d agoReads credentialsDiscuss

bethingtonCLAUDE.md

ghidra-mcp

bethington/ghidra-mcp/CLAUDE.md

anyone's issue/PR/comment text, never touch draft PRs, never merge around a contributor, and security reports / hostile threads / anything reputational default to "Ben posts personally" unless he explicitly chooses agent

4k7d agoReads credentialsDiscuss

matt1398CLAUDE.md

claude-devtools / src

matt1398/claude-devtools/src/CLAUDE.md

Structure Three-process Electron architecture: ## Processes - `main/` - Node.js runtime (file system, IPC, lifecycle) - `preload/` - Secure bridge (contextBridge API) - `renderer/` - React/Chromium (UI, state, visualization) - `shared/` - Cross-process types and utilities ## Import

4k8mo agoDiscuss

AnthropicCLAUDE.md

anthropic-sdk-python

anthropics/anthropic-sdk-python/CLAUDE.md

doesn't allow `None`. Drop the workaround. Where a wrong value would be a security problem, validate explicitly instead and reject anything unknown. - **Failing open on unknown values.** A permission

3.9k12d agoDiscuss

gadievronCLAUDE.md

raptor

gadievron/raptor/CLAUDE.md

target with `--help`. --- ## COMMANDS /project - Project management — `libexec/raptor-project-manager [args]` /scan /fuzz /web /codeql /analyze - Security testing — `python3 raptor.py ` /agentic - Scan → dedup → analysis pipeline — `libexec/raptor-agentic --repo ` /exploit /patch - Generate PoCs

3.8k7d 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.