agentleFS
Sign inSign up

CLAUDE.md examples from real projects

How real projects brief Claude Code: the commands, conventions and warnings they put in CLAUDE.md.

Popular:code reviewtestingpdfMCP serverfrontendsecuritydocumentation
Most stars firstWorked for most · soon
Known publishers remove filter1k+ stars remove filter
Hugging FaceCLAUDE.md

transformers

huggingface/transformers/CLAUDE.md

.ai/AGENTS.md

167k23d agoDiscuss
MicrosoftCLAUDE.md

PowerToys

microsoft/PowerToys/.claude/CLAUDE.md

../.github/copilot-instructions.md

139k8mo agoDiscuss
MicrosoftCLAUDE.md

playwright

microsoft/playwright/CLAUDE.md

playwright-chromium, playwright-firefox, playwright-webkit — per-browser distributions. playwright-browser-chromium, playwright-browser-firefox, playwright-browser-webkit — binary packages. Assume watch is running and code is up to date. Generated files (types, channels, validators) are produced by watch automatically. Runs all lint checks in parallel: eslint, tsc, doclint, check-deps, generatechannels, generatetypes, lint-tests, test-types, lint-packages, code-snippet linting. Always run flint before committing. Do not use tsc --noEmit or individual lint commands separately. Decision rule: Does the test need browser/browserType/context → tests/library/. Just needs page + server → tests/page/.

97k20d agoDiscuss
Model Context ProtocolCLAUDE.md

servers

modelcontextprotocol/servers/CLAUDE.md

Official MCP reference server implementations. This is an npm workspaces monorepo containing 7 servers (4 TypeScript, 3 Python) under src/. Each server is a standalone package published to npm or…

91k6mo agoDiscuss
ElasticCLAUDE.md

elasticsearch

elastic/elasticsearch/CLAUDE.md

No summary in the file. Open it to read it.

78k5mo agoDiscuss
JetBrainsCLAUDE.md

kotlin

JetBrains/kotlin/CLAUDE.md

CRITICAL: @./.ai/guidelines.md guidelines MUST be followed at all times. Local Preferences: @./.claude/local.md When asked to update memory, you must update ./.claude/CLAUDE.md if it is not specified that another file should…

53k29d agoDiscuss
AnthropicCLAUDE.md

claude-cookbooks / chief_of_staff_agent

anthropics/claude-cookbooks/claude_agent_sdk/chief_of_staff_agent/CLAUDE.md

Output: JSON with monthlyburn, runwaymonths, totalrunwaydollars, quarterlyburn, and burnrate_daily Remember: As Chief of Staff, you have access to financial data in the financial_data/ directory and can delegate specialized analysis to your subagents (financial-analyst and recruiter).

53k8mo agoDiscuss
AnthropicCLAUDE.md

claude-cookbooks

anthropics/claude-cookbooks/CLAUDE.md

A collection of Jupyter notebooks and Python examples for building with the Claude API. Or directly with uv: Notebooks have relaxed rules for mid-file imports (E402), redefinitions (F811), and variable naming (N803, N806). Branch naming: <username>/<feature-description> Commit format (conventional commits): These commands are available in Claude Code and CI:

53k8mo agoReads credentialsDiscuss
AnthropicCLAUDE.md

claude-cookbooks / skills

anthropics/claude-cookbooks/skills/CLAUDE.md

This is a comprehensive Jupyter notebook cookbook demonstrating Claude's Skills feature for document generation (Excel, PowerPoint, PDF). It's designed for developers learning to integrate Skills into their applications. Beta API Requirements: - All Skills functionality uses client.beta.* namespace - Required beta headers: code-execution-2025-08-25, files-api-2025-04-14, skills-2025-10-02 - Must use client.beta.messages.create() with container parameter - Code execution tool (codeexecution20250825) is REQUIRED - Use pre-built Agent skills by referencing their skill_id or create and upload your own via the Skills API Files API…

53k8mo agoReads credentialsDiscuss
AnthropicCLAUDE.md

financial-services

anthropics/financial-services/CLAUDE.md

Cowork plugins and Claude Managed Agent templates for financial services. Each named agent ships two ways from one source. Run python3 scripts/check.py before committing — it lints every manifest, verifies all system.file / skills.path / callable_agents.manifest references resolve, fails if any agent-plugins/<slug>/skills/ copy has drifted from its vertical-plugins/ source, and rejects non-ASCII bytes in a .ps1 without a UTF-8 BOM. Keep .ps1 files pure ASCII. Windows PowerShell 5.1 — still the default shell on managed Windows — decodes a BOM-less…

38k2mo agoDiscuss
MicrosoftCLAUDE.md

playwright-mcp

microsoft/playwright-mcp/CLAUDE.md

Semantic commit messages: label(scope): description Labels: fix, feat, chore, docs, test, devops Never add Co-Authored-By agents in commit message. Branch naming for issue fixes: fix-<issue-number> See .claude/skills/release.md.

38k5mo agoDiscuss
AnthropicCLAUDE.md

knowledge-work-plugins / slack

anthropics/knowledge-work-plugins/partner-built/slack/CLAUDE.md

This plugin integrates Slack with Claude Code, providing tools to search, read, and send messages in Slack.

26k8mo agoDiscuss
ElasticCLAUDE.md

kibana

elastic/kibana/.claude/CLAUDE.md

../AGENTS.md

21k3mo agoDiscuss
GoogleCLAUDE.md

skills / refresh

google/skills/skills/cloud/firebase-basics/references/refresh/claude.md

Follow these steps to refresh Claude Code's local environment, ensuring that their agent skills and plugins are fully up-to-date. Use Claude Code's native plugin manager instead of npx. 1. Update the Plugin: Run the specific CLI command to update the Firebase plugin:

20k9d agoDiscuss

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.