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

tradermontyCLAUDE.md

claude-trading-skills

tradermonty/claude-trading-skills/CLAUDE.md

scripts/`) are executable code for API calls, data fetching, report generation - References (`references/`) are documentation for Claude to read and apply - Scripts handle I/O; references handle knowledge **Output Generation:** - Skills

2.8k2mo agoReads credentialsDiscuss

compozyCLAUDE.md

compozy

compozy/compozy/CLAUDE.md

release after the replacement ships, warn with the replacement, then delete. Only surfaces documented `experimental` may break without that window. - **Internal code:** Go packages, `web/`, `@compozy/ui`, specs, RFCs, and `.compozy/tasks

2.8k6d agoDiscuss

fuergaosi233CLAUDE.md

claude-code-proxy

fuergaosi233/claude-code-proxy/CLAUDE.md

Claude Code: Best Practices for Effective Collaboration This document outlines best practices for working with Claude Code to ensure efficient and successful software development tasks. ## Task Management For complex

2.8k15mo agoDiscuss

AnthropicCLAUDE.md

claude-agent-sdk-demos / agent

anthropics/claude-agent-sdk-demos/excel-demo/agent/CLAUDE.MD

spreadsheets - Web scraping or API development (unless specifically for spreadsheet data import) - Non-spreadsheet document processing (use appropriate specialized agents) - General system administration tasks - Tasks that don't involve spreadsheet

2.8k13mo agoDiscuss

marketcallsCLAUDE.md

openalgo

marketcalls/openalgo/CLAUDE.md

capital, exchange-aligned auto square-off) and support Telegram alerts. Repository: https://github.com/marketcalls/openalgo Documentation: https://docs.openalgo.in ## Documentation Map All project documentation lives under `docs/` as markdown (the single source

2.7k9d agoReads credentialsDiscuss

stellarlinkcoCLAUDE.md

myclaude / memorys

stellarlinkco/myclaude/memorys/CLAUDE.md

executed via skill(`codeagent`). 3. Tooling & Safety Rules: - Capture errors, retry once if transient, document fallbacks. 4. Context Blocks & Persistence: honor ` `, ` `, ` `, ` `, ` `, ` `, and ` ` exactly as written below. 5. Quality Rubrics: follow

2.7k8mo agoDiscuss

jeremylongshoreCLAUDE.md

tons-of-skills-marketplace

jeremylongshore/tons-of-skills-marketplace/CLAUDE.md

plugin/plugin.json` is an added file in the diff) must ship the tiered submission documents per the matrix in `templates/skill-docs/README.md` (micro → `docs/PRD.md`; standard → + `docs/ADR.md`; pack, 2+ skills → + `docs/ONE-PAGER.md`; `CFO-ONE-PAGER.md` stays

2.7k29d agoReads credentialsDiscuss

cocoindex-ioCLAUDE.md

cocoindex-code

cocoindex-io/cocoindex-code/CLAUDE.md

context keys so asymmetric models (Cohere, Voyage, nomic-embed) can use different kwargs for document vs. query embedding. Two install flavors: `[full]` bundles `sentence-transformers` (local inference); slim uses only

2.7k6mo agoDiscuss

jgravelleCLAUDE.md

jcodemunch-mcp

jgravelle/jcodemunch-mcp/CLAUDE.md

through. ⚠ Two full runs contend on the same `~/.code-index` process-lock scopes, the documented cause of .261's 47m outlier, so the 3.13 reproduce runs AFTER the local suite, never

2.7k27d agoReads credentialsDiscuss

centminmodCLAUDE.md

my-claude-code-setup

centminmod/my-claude-code-setup/CLAUDE.md

/memory` to inspect loaded files. Root CLAUDE.md survives `/compact`. ## Claude Code Official Documentation When working on Claude Code features (hooks, skills, subagents, MCP servers), use the `claude-code-guide` subagent

2.6k4mo agoDiscuss

BytePioneer-AICLAUDE.md

codex-host

BytePioneer-AI/codex-host/CLAUDE.md

Model, Provider, Account, or Billing Source. ## Implementation Principles - Inspect related implementations, tests, contracts, and documentation before making changes. Prefer established repository patterns and public APIs over parallel implementations. - Reuse code

2.6k8d agoDiscuss

StripeCLAUDE.md

stripe-go

stripe/stripe-go/.claude/CLAUDE.md

test section of @.github/workflows/ci.yml) ### Comments - Comments MUST only be used to: 1. Document a function 2. Explain the WHY of a piece of code 3. Explain a particularly complicated piece

2.6k7mo agoDiscuss

Hugging FaceCLAUDE.md

OpenEnv

huggingface/OpenEnv/CLAUDE.md

allowed: - Quick exploration and prototyping - Small fixes that don't need TDD workflow - Documentation updates ### TDD Mode (Opt-In) TDD is activated by `/work-on-issue`, which writes a `.tdd-session.json` marker. When

2.6k6mo agoDiscuss

chrisryugjCLAUDE.md

korean-law-mcp

chrisryugj/korean-law-mcp/CLAUDE.md

HTTP 모드는 부팅 시점 fail-fast 검증). **적용 task는 `legal_research` 8종 중 `document_review` 를 뺀 7종** (v4.14.1: `law_system`·`amendment_track`·`ordinance_compare`·`procedure_detail` 추가, 공용 `withChainDeadline

2.6k23d agoReads credentialsDiscuss

Natively-AI-assistantCLAUDE.md

natively-cluely-ai-assistant

Natively-AI-assistant/natively-cluely-ai-assistant/CLAUDE.md

cannot be executed from Windows. When uncertain, make the smallest isolated change and explicitly document what still requires physical verification. --- ## Filesystem and paths Never hardcode operating-system-specific paths

2.6k7mo agoDiscuss

kayba-aiCLAUDE.md

agentic-context-engine

kayba-ai/agentic-context-engine/CLAUDE.md

before** making any edits. 4. Wait for the user to explicitly accept before proceeding. ### Documentation Maintenance Before working on code in `ace/`, read `docs/design/ACE_ARCHITECTURE.md` to understand the current architecture. Before

2.6k6mo agoDiscuss

liangdabiaoCLAUDE.md

Seedance2-Storyboard-Generator

liangdabiao/Seedance2-Storyboard-Generator/CLAUDE.md

episode chaining ## Project Structure ``` 写剧本和分镜/ ├── .claude/skills/seedance-storyboard-generator/ # Custom skill for video script generation ├── docs/ # Documentation and reference materials │ ├── 剧本和分镜.md # Main workflow documentation │ ├── 流程.md # Process overview │ ├── structured-prompt.md # Seedance 2.0 prompt

2.5k3mo agoDiscuss

VercelCLAUDE.md

ai-elements

vercel/ai-elements/.claude/CLAUDE.md

boundary conditions and error states 5. **User experience** - Accessibility, performance, and usability considerations 6. **Documentation** - Add comments for complex logic, but prefer self-documenting code --- Most formatting and common issues

2.4k8mo agoDiscuss

0xMassiCLAUDE.md

webclaw

0xMassi/webclaw/CLAUDE.md

Crawler. Sitemap discovery. Batch ops. # + proxy pool rotation (per-request) # + PDF content-type detection # + document parsing (DOCX, XLSX, CSV) # + layered URL discovery (map) + Serper web search (BYO key) webclaw

2.4k24d agoReads credentialsDiscuss

redhat-etCLAUDE.md

ripwire

redhat-et/ripwire/CLAUDE.md

binary's own flag table and is always current. When `--help` and a document disagree, `--help` wins and the document is a bug. ## Build ```bash cmake -S . -B build && cmake

2.4k21d 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.