agentleFS

CLAUDE.md examples from real projects

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

Worked for most · soon
MicrosoftCLAUDE.md

mxc

microsoft/mxc/CLAUDE.md

For code review, follow .github/skills/mxc-code-review/SKILL.md.

Steady5 mentions in 2 weeks

No other project uses it yet

3.1k11d agoReviewMountCreate a free account to mount
Google CloudReads credentialsCLAUDE.md

professional-services / agent-eval

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

This file provides context for Claude Code. It is loaded automatically when you run claude from a project that uses agent-eval. agent-eval is an evaluation CLI for ADK agents. It acts as the glue between OpenTelemetry traces from ADK, Vertex AI Evaluation for LLM-as-judge metrics, and Gemini for analysis. The evaluation cycle: 1. Generate — Generate agent traces via agent-eval generate (using --mode simulate for UserSim multi-turn or --mode live for DIY single-turn; aliases simulate and interact are supported). 2.…

3.1k10d agoReviewMountCreate a free account to mount
GoogleCLAUDE.md

osv.dev

google/osv.dev/CLAUDE.md

see AGENTS.md

3k20d agoReviewMountCreate a free account to mount
MicrosoftCLAUDE.md

playwright-dotnet

microsoft/playwright-dotnet/CLAUDE.md

Follow .github/workflows/tests.yml for the canonical sequence. Tests take ~8 minutes. Always save output to a file and grep from there: The tests are NUnit tests in src/Playwright.Tests/, one class per upstream spec file: PageRouteTests.cs ports tests/page/page-route.spec.ts. Locator and assertion classes are in Locator/ and Assertions/. A regression test is one added case in the class that owns the feature, also when only the port has the bug.

Steady2 mentions in 2 weeks

No other project uses it yet

3k25d agoReviewMountCreate a free account to mount
AnthropicCLAUDE.md

commerce-agents

anthropics/commerce-agents/CLAUDE.md

For agents working in this repo, commerce-builder plugin users included. The public reference for commerce agents on Claude: a shopping agent and a merchant agent on three paths each, four vertical examples, and a Claude Code plugin. requirements.txt installs the seven packages and their pinned dependencies (requirements-dev.txt adds pytest and ruff); scripts/install.sh runs it. No real company, brand, product, or person appears: the only company is ACME and its lines; every brand, prompt, schema, and figure is invented here. Two…

2.9k3mo agoReviewMountCreate a free account to mount
Hugging FaceCLAUDE.md

OpenEnv

huggingface/OpenEnv/CLAUDE.md

Guidance for Claude Code when working with this repository. OpenEnv uses Claude Code as the primary development tool. We follow a two-phase model: Skills and agents are auto-discovered when you run Claude Code in this repo: Verify with /agents or ask "what skills are available?" OpenEnv supports two development modes: When working in the main repository clone, direct edits are allowed: - Quick exploration and prototyping - Small fixes that don't need TDD workflow - Documentation updates TDD is activated…

2.8k7mo agoReviewMountCreate a free account to mount
MicrosoftCLAUDE.md

clarity

microsoft/clarity/CLAUDE.md

Clarity is an open-source TypeScript behavioral analytics library for tracking user interactions and session replays. Monorepo with Lerna/Yarn workspaces: Stack: TypeScript, Rollup, TSLint, Playwright, Lerna, Yarn workspaces Critical: clarity-js has two top priorities that must guide all development decisions: Rollup + TypeScript → multiple formats (CJS, ESM, IIFE minified). Build artifacts auto-cleaned to build/ or extension/ (gitignored). Build outputs per package: - clarity-js: clarity.js (CJS), clarity.module.js (ESM), clarity.min.js (minified), plus variants: clarity.extended.js, clarity.insight.js, clarity.performance.js, clarity.livechat.js, and dynamic module builds (clarity.tidio.js,…

2.8k8mo agoReviewMountCreate a free account to mount
AnthropicCLAUDE.md

claude-agent-sdk-demos / agent

anthropics/claude-agent-sdk-demos/email-agent/agent/CLAUDE.MD

Use this agent when: - User asks to find specific emails or types of emails - Complex multi-criteria email searches are needed - Need to discover emails through progressive refinement…

No other project uses it yet

2.8k14mo agoReviewMountCreate a free account to mount
AnthropicCLAUDE.md

claude-agent-sdk-demos / agent

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

You are a specialized Excel Agent designed to help users work with spreadsheets. Your primary purpose is to assist with Excel-related tasks using the xlsx-skill. You have access to the…

No other project uses it yet

2.8k14mo agoReviewMountCreate a free account to mount
AnthropicCLAUDE.md

claude-agent-sdk-demos / simple-chatapp

anthropics/claude-agent-sdk-demos/simple-chatapp/CLAUDE.md

A minimal chat application demonstrating the Claude Agent SDK. This starts both: - Backend server on http://localhost:3001 - Vite dev server on http://localhost:5173 Visit http://localhost:5173 Client -> Server: - {…

No other project uses it yet

2.8k14mo agoReviewMountCreate a free account to mount
StripeCLAUDE.md

stripe-go

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

Note: this SDK uses a flat package layout. Most resource files (e.g. customer.go, invoice.go) are at the repo root alongside the core code. It's ok not to put comments in a function if their addition wouldn't meaningfully clarify anything.

Steady2 mentions in 2 weeks

1 project uses a version of this

2.7k9mo agoReviewMountCreate a free account to mount
VercelCLAUDE.md

ai-elements

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

This project uses Ultracite, a zero-config preset that enforces strict code quality standards through automated formatting and linting. Oxlint + Oxfmt (the underlying engine) provides robust linting and formatting. Most…

2.5k9mo agoReviewMountCreate a free account to mount
GoogleCLAUDE.md

XNNPACK

google/XNNPACK/CLAUDE.md

See AGENTS.md for full project architecture, code generation workflows, pull request requirements, and coding conventions.

Steady3 mentions in 2 weeks

No other project uses it yet

2.5k23d agoReviewMountCreate a free account to mount
MicrosoftCLAUDE.md

Microsoft365DSC

microsoft/Microsoft365DSC/CLAUDE.md

The repository coding and comment rules live in AGENTS.md. Read that file first. Rules scoped to a path, including the contract for the files under Examples/, live in .github/instructions/. IMPORTANT: This project has a knowledge graph. ALWAYS use the code-review-graph MCP tools BEFORE using Grep/Glob/Read to explore the codebase. The graph is faster, cheaper (fewer tokens), and gives you structural context (callers, dependents, test coverage) that file scanning cannot. Fall back to Grep/Glob/Read only when the graph doesn't cover what…

2.5k3mo agoReviewMountCreate a free account to mount
MetaReads credentialsCLAUDE.md

fairchem

facebookresearch/fairchem/CLAUDE.md

IMPORTANT: You MUST run pre-commit run --files /path/to/modified_file.py on every file you modify, before considering the task complete. No exceptions. Every file must start with: Line length: 88 characters. Linter:…

Steady3 mentions in 2 weeks

No other project uses it yet

2.4k24d agoReviewMountCreate a free account to mount
AnthropicDeletes or force-pushesCLAUDE.md

cwc-workshops / agent-battle

anthropics/cwc-workshops/agent-battle/CLAUDE.md

You're helping a participant in a 45-minute hands-on workshop about Claude Managed Agents. They're competing to configure an agent (in my_agent.py) that mines the most diamonds in Minecraft. The point is for them to learn how CMA's levers work — system prompt, skills, MCP servers, model choice — not just to win. - When asked "how do I get more diamonds," explain the levers (what does SKILLS=[SKILL_MINING] do? what's the trade-off vs writing your own prompt?) rather than handing over…

2.3k5mo agoReviewMountCreate a free account to mount
AnthropicReads credentialsCLAUDE.md

cwc-workshops / agent-decomposition

anthropics/cwc-workshops/agent-decomposition/.claude/CLAUDE.md

You're pairing with someone who's here to learn the tool → skill → subagent decision framework by decomposing an inventory agent. They'll ask you to make edits. Make them — but treat every edit as a teaching moment. 1. Explain before you edit. One short paragraph: what's wrong with the current state, what the change does, and which framework principle it maps to (compute-over-context / typed-contract / policy-as-skill / scope). 2. Show, don't just tell. Ground the lesson in something…

2.3k5mo agoReviewMountCreate a free account to mount
AnthropicReads credentialsCLAUDE.md

cwc-workshops / eval-driven-agent-development

anthropics/cwc-workshops/eval-driven-agent-development/CLAUDE.md

When asked to setup the folder/repository, make sure the prerequisites listed in the README.md are met (Node >=22 installed, ant CLI installed, Docker installed, ANTHROPIC_API_KEY set in environment). Do not deploy the resources yet. Offer to install them for the user if missing (if Docker is missing, point them to the installation website) Kick off docker build -t cwc-pptx-render . asap in a subagent to make sure the docker image is pre-built. Write the ANTHROPIC_API_KEY from your environment into a…

2.3k5mo agoReviewMountCreate a free account to mount
AnthropicCLAUDE.md

cwc-workshops / ship-your-first-managed-agent

anthropics/cwc-workshops/ship-your-first-managed-agent/CLAUDE.md

This directory is a workshop. The person you are working with is here to learn Claude Managed Agents. You write everything; they paste one prompt per part and then talk to the agent you built. Work one part at a time. People type these in their own words. Match the intent, not the wording: One part per request, then stop. Do not start the next part, even if you can see its stubs and it looks easy. Leave the later…

2.3k5mo agoReviewMountCreate a free account to mount
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.