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

MicrosoftCLAUDE.md

Power-Fx / src

microsoft/Power-Fx/src/CLAUDE.md

files ├── Directory.Build.props # Common MSBuild properties ├── PowerFx.ruleset # StyleCop configuration └── nuget.config # NuGet feed configuration docs/ # Language documentation ├── overview.md # Language design principles ├── data-types.md # Type system documentation ├── expression-grammar.md # Formal grammar └── operators.md # Operator reference

3.4k4mo agoDiscuss

himself65CLAUDE.md

finance-skills

himself65/finance-skills/CLAUDE.md

listing near-synonymous phrasings, and keep behavioral instructions in the body. ### Reference files Markdown documents in `references/` containing detailed API references, code templates, formulas, or schema docs. The SKILL.md instructions

3.3k56d agoDiscuss

samberCLAUDE.md

cc-skills-golang

samber/cc-skills-golang/CLAUDE.md

Project Structure ``` skills/ # Claude Code skill definitions / SKILL.md # Required: metadata + instructions references/ # Optional: detailed documentation loaded on demand scripts/ # Optional: executable code assets/ # Optional: templates, resources, linter configs (.golangci.yml

3.3k42d agoPipes a download into a shellDiscuss

taishi-iCLAUDE.md

awesome-ChatGPT-repositories

taishi-i/awesome-ChatGPT-repositories/CLAUDE.md

verbose format) plugins/awesome-chatgpt-search/ ← one plugin directory for both Claude Code and Codex README.md ← plugin documentation build_data.py ← regenerates data/ from the main JSON .claude-plugin/plugin.json ← Claude Code plugin manifest .codex

3.3k12d agoDiscuss

punitaraniCLAUDE.md

fli

punitarani/fli/CLAUDE.md

server on STDIO fli-mcp-http # Run MCP server over HTTP # Documentation make docs # Build MkDocs documentation uv run mkdocs serve # Serve docs locally uv run mkdocs build # Build static

3.2k11d agoDiscuss

TanStackCLAUDE.md

ai

TanStack/ai/CLAUDE.md

under `docs/`, load `.claude/skills/docs/SKILL.md` and follow it. Do not write docs without it. See **Documentation** below for TanStack-specific rules that also apply. **PR description skill (mandatory).** Before

3.1k13d agoReads credentialsDiscuss

stravuCLAUDE.md

crystal

stravu/crystal/CLAUDE.md

panels.ts # Panel type definitions ├── tests/ # E2E tests (Playwright) ├── scripts/ # Build and utility scripts ├── docs/ # Documentation │ ├── troubleshooting/ # Troubleshooting guides │ ├── ADDING_NEW_CLI_TOOLS.md │ └── IMPLEMENTING_NEW_CLI_AGENTS.md ├── dist-electron/ # Packaged Electron app (generated during build) ├── package.json # Root

3.1k12mo agoDiscuss

Chachamaru127CLAUDE.md

claude-code-harness

Chachamaru127/claude-code-harness/CLAUDE.md

Hooks / `scripts/` Shell scripts / `src/` TypeScript implementation / `app/` App layer / `frontend/` Frontend implementation / `docs/` Documentation / `templates/` Templates / `tests/` Validation / `go/` Harness v4 Go native engine ([SPEC.md](go/SPEC.md), [DESIGN.md](go/DESIGN.md

3.1k48d agoDeletes or force-pushesDiscuss

MaxMiksaCLAUDE.md

Auto-Company

MaxMiksa/Auto-Company/CLAUDE.md

Auto Company - Autonomous AI Company [English](CLAUDE.md) | [中文](i18n/zh-CN/CLAUDE.md) · [Documentation and language settings](i18n/README.md) ## Mission **Make money legally.** Find real demand, build valuable products, deploy, and generate revenue. This

3.1k13mo agoReads credentialsDiscuss

blazickjpCLAUDE.md

arxiv-mcp-server

blazickjp/arxiv-mcp-server/CLAUDE.md

semantic_search`, `reindex` Keep tool schemas, package exports, server registration, dispatch, tests, and README documentation synchronized when changing the tool surface. ## Constraints - Treat abstracts, paper text, LaTeX, archive metadata

3.1k2mo agoReads credentialsDiscuss

SynkraAICLAUDE.md

aiox-core

SynkraAI/aiox-core/.claude/CLAUDE.md

Inclua contexto do erro em mensagens ao usuário - Sugira procedimentos de rollback quando apropriado - Documente quaisquer correções manuais necessárias --- ## Comandos Frequentes ### Desenvolvimento ```bash npm run dev # Iniciar desenvolvimento npm test

3.1k4mo agoDiscuss

Google CloudCLAUDE.md

professional-services / agent-eval

GoogleCloudPlatform/professional-services/tools/agent-eval/CLAUDE.md

Senior Agent Architect and QA Analyst. Objective: Update the OPTIMIZATION_LOG.md to document whether the applied strategy worked. Inputs: 1. Strategy Applied: [e.g., "Iteration 1: Tool Hardening"] 2. New Evaluation Data

3.1k31d agoReads credentialsDiscuss

jakubkrehelCLAUDE.md

make-interfaces-feel-better

jakubkrehel/make-interfaces-feel-better/CLAUDE.md

improving interface polish, published for installation via `npx skills add jakubkrehel/make-interfaces-feel-better`. It is documentation-only; there is no build, lint, or test tooling. ## Structure The skill lives in `skills/make-interfaces-feel-better/`: - `SKILL.md

3.1k2mo agoDiscuss

coderCLAUDE.md

claudecode.nvim

coder/claudecode.nvim/CLAUDE.md

Code-compatible `tabs` structure - `openDiff` - Opens native Neovim diff views - `checkDocumentDirty` - Checks if document has unsaved changes - `saveDocument` - Saves document with detailed success/failure reporting - `getWorkspaceFolders` - Gets workspace folder information - `closeAllDiffTabs

3k4mo agoDiscuss

allenpeng0705CLAUDE.md

EnvoyMesh

allenpeng0705/EnvoyMesh/CLAUDE.md

Data Transfer Vouchers, Human Profiles. ### Mandates & Tasks A **mandate** is an owner-signed authorization document that grants a device permission to perform a task within defined bounds: - `taskIntent` — what task

3k4mo agoReads credentialsDiscuss

michaelshimelesCLAUDE.md

ralphy

michaelshimeles/ralphy/CLAUDE.md

format: `type: brief description` - `feat:` new feature - `fix:` bug fix - `refactor:` code restructuring - `docs:` documentation - `test:` test additions/changes - `chore:` maintenance tasks

3k8mo agoDiscuss

ax-llmCLAUDE.md

ax

ax-llm/ax/docs/CLAUDE.md

provider (`@ax-llm/ax-ai-sdk-provider`) - `src/examples/` - Example implementations (`@ax-llm/ax-examples`) - `website/` - Hugo documentation site (deployed to axllm.dev via GitHub Pages) Each sub-repository under `src/` has its own `package.json

2.9k6d agoReads credentialsDiscuss

VRSENCLAUDE.md

OpenSwarm

VRSEN/OpenSwarm/CLAUDE.md

Agency( ceo, communication_flows=[ (ceo, developer), (ceo, designer), (developer, designer), ], shared_instructions="agency_manifesto.md", ) ``` See documentation for more details. ## Available Sub-Agents - **api-researcher**: Researches MCP servers and APIs, saves docs

2.9k6mo agoReads credentialsDiscuss

aaron-he-zhuCLAUDE.md

aaron-marketing-skills

aaron-he-zhu/aaron-marketing-skills/CLAUDE.md

strict [`Agent Plugins v1 Portable Lite`](docs/agent-plugins-v1.md) projection Do not preload every linked document. Start with this map, select the smallest route, then load the chosen Skill and only

2.8k21d agoDiscuss

kaitrannttCLAUDE.md

ccs

kaitranntt/ccs/CLAUDE.md

with isolated `CLAUDE_CONFIG_DIR`. All env values written into settings must be strings. ## Documentation Truth Use the narrowest authoritative source: 1. Source, tests, package scripts, and workflows define implemented

2.8k10mo 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.