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.

Most stars firstWorked for most · soon
MicrosoftCLAUDE.md

PowerToys

microsoft/PowerToys/.claude/CLAUDE.md

../.github/copilot-instructions.md

139k8mo agoDiscuss
MicrosoftCLAUDE.md

terminal

microsoft/terminal/CLAUDE.md

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

105k20d 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
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
MicrosoftCLAUDE.md

fluentui

microsoft/fluentui/CLAUDE.md

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

20k42d agoDiscuss
MicrosoftCLAUDE.md

playwright-python

microsoft/playwright-python/CLAUDE.md

Guidance for Claude when working in this repository. Python bindings for Playwright. The Python client talks JSON over a pipe to the Node-based driver bundled in playwright/driver/. The pipe protocol is defined upstream in packages/protocol/src/protocol.yml. CONTRIBUTING.md has the full sequence. The short version (needs Node.js and npm for the driver build): If the system lacks python3-venv, uv venv env is an acceptable substitute (then uv pip install --python env/bin/python --upgrade pip). When changing public API, edit impl/, then run ./scripts/updateapi.sh.…

15k3mo agoDiscuss
MicrosoftCLAUDE.md

playwright-cli

microsoft/playwright-cli/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>

14k6mo 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.