MicrosoftCLAUDE.mdPowerToys
microsoft/PowerToys/.claude/CLAUDE.md
../.github/copilot-instructions.md
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.mdMicrosoftCLAUDE.mdterminal
microsoft/terminal/CLAUDE.md
No summary in the file. Open it to read it.
MicrosoftCLAUDE.mdplaywright
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/.
MicrosoftCLAUDE.mdplaywright-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.
MicrosoftCLAUDE.mdfluentui
microsoft/fluentui/CLAUDE.md
No summary in the file. Open it to read it.
MicrosoftCLAUDE.mdplaywright-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.…
MicrosoftCLAUDE.mdplaywright-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>
MicrosoftCLAUDE.mdpoml
microsoft/poml/CLAUDE.md
POML (Prompt Orchestration Markup Language) is a structured markup language for advanced prompt engineering with LLMs. It provides an HTML-like syntax with semantic components, comprehensive data handling, and a CSS-like styling system. The project consists of: The core POML processor is built with TypeScript and React:
MicrosoftCLAUDE.mdpoml / poml-browser
microsoft/poml/packages/poml-browser/CLAUDE.md
This file provides guidance to Claude Code when working with the POML browser extension package. The POML Browser Extension (packages/poml-browser/) provides POML support in web browsers through a Chrome extension. It enables users to extract content from web pages, manage it as cards, and convert it to POML format. Important notes on building and testing for Claude: As developers usually run a long-running watch process, please do not emit build commands by yourself. Do not run tests on your own.…
MicrosoftCLAUDE.mdFluidFramework
microsoft/FluidFramework/.claude/CLAUDE.md
This file is mirrored in .github/copilot-instructions.md. Changes here should be duplicated there, and vice versa. Follow the Coding Guidelines when writing / modifying code. Follow the Documentation Guidelines when writing or modifying code or documentation. Read and follow the linked guides relevant to the task, including the language-specific guides for source-code documentation. These requirements apply to source-code comments and API documentation as well as standalone documentation. Add a changeset for user-facing changes only if the affected release group uses changesets.…
MicrosoftCLAUDE.mdFluidFramework / gitrest
microsoft/FluidFramework/server/gitrest/CLAUDE.md
GitRest provides a REST API to Git repositories, modeled after GitHub's REST APIs. It is part of the Fluid Framework server infrastructure. Endpoints follow the GitHub API pattern:
MicrosoftCLAUDE.mdFluidFramework / historian
microsoft/FluidFramework/server/historian/CLAUDE.md
Historian is a service that tracks the historical record for a Fluid document. It acts as a proxy to the underlying git repository that maintains versioned snapshots. This is a release group root with two packages: Runtime config is in packages/historian/config.json and loaded via nconf.
MicrosoftCLAUDE.mdapm / s01_claude_md_only
microsoft/apm/tests/integration/fixtures/target_resolution/s01_claude_md_only/CLAUDE.md
No summary in the file. Open it to read it.
MicrosoftCLAUDE.mdPower-Fx
microsoft/Power-Fx/CLAUDE.md
Power Fx is a low-code general-purpose programming language based on spreadsheet-like formulas. This is the open-source C# implementation used across Microsoft Power Platform. The codebase contains a complete compiler and interpreter. Build configurations: Debug/Release (single-target), Debug462/Release462 (net462 only), Debug70/Release70 (net7.0 only), DebugAll/ReleaseAll (multi-target, used by local build scripts). Separation of Compilation and Execution: Core compiles to IR with zero evaluation code. Multiple backends (JavaScript, SQL, etc.) can consume the same IR independently. Symbol Table Composition: Layered symbol tables (Config ->…
MicrosoftCLAUDE.mdPower-Fx / src
microsoft/Power-Fx/src/CLAUDE.md
Power Fx is a low-code general-purpose programming language based on spreadsheet-like formulas. This is the open-source implementation of the language used across Microsoft Power Platform. The codebase contains a complete compiler and interpreter infrastructure written in C#. Note: The runLocalTests.cmd script runs tests for both .NET Framework 4.6.2 and .NET 7.0 configurations using VSTest. The Power Fx implementation follows a classic multi-phase compiler architecture: Expression Text → [Lexer] → Tokens → [Parser] → AST → [Binder] → Typed AST →…
MicrosoftCLAUDE.mdplaywright-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: Before committing, run dotnet format ./src/ -v:diag and fix style issues. Semantic commit messages: label(scope): description Labels: fix, feat, chore, docs, test, devops Never add Co-Authored-By agents in commit message. Never add "Generated with" in commit message. Never add test plan to PR description. Keep PR description short — a few bullet points at most. Branch naming for issue fixes:…
MicrosoftCLAUDE.mdclarity
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,…
MicrosoftCLAUDE.mdkernel-memory / v2
microsoft/kernel-memory/archived/v2/CLAUDE.md
No summary in the file. Open it to read it.
MicrosoftCLAUDE.mdPowerApps-Samples
microsoft/PowerApps-Samples/CLAUDE.md
This repository contains sample code for Power Apps across multiple technology stacks: - component-framework/: Power Apps Component Framework (PCF) controls (~29 TypeScript/React controls) - dataverse/: Dataverse SDK samples (C#, .NET Core, Web API, Plugins) - ai-builder/: AI Builder sample data and model packages - model-driven-apps/: Model-driven app samples - portals/: Power Apps Portals samples (OAuth, Web API) - powershell/ & build-tools/: Deployment automation Each PCF control is a self-contained project with TypeScript/React frontend and MSBuild packaging. Basic Commands: Creating a…
MicrosoftCLAUDE.mdvscode-mssql
microsoft/vscode-mssql/CLAUDE.md
See 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.