CLAUDE.md examples from real projects

MicrosoftCLAUDE.md

vscode-mssql

microsoft/vscode-mssql/CLAUDE.md

See AGENTS.md.

MicrosoftCLAUDE.md

fluentui-react-native

microsoft/fluentui-react-native/CLAUDE.md

See @AGENTS.md for guidance on working with code in this repository.

MicrosoftCLAUDE.md

fhir-server

microsoft/fhir-server/CLAUDE.md

Core project guidelines, coding conventions, and architectural principles are in AGENTS.md — read it first. This file adds Claude-specific skill activation instructions. Skills live in .github/skills/<skill-name>/SKILL.md. Claude cannot discover them automatically — use the Read tool to load the relevant skill before starting any architecture task. Example: Read(".github/skills/create-adr/SKILL.md") Happy coding!

MicrosoftCLAUDE.md

skills-for-fabric

microsoft/skills-for-fabric/CLAUDE.md

Updates: fabric-collection is a third-party marketplace, so enable auto-update once: run /plugin, open Marketplaces, select fabric-collection, and choose Enable auto-update. Administrators can instead set "autoUpdate": true on its extraKnownMarketplaces entry in managed settings. To update on demand, run claude plugin update <plugin>@fabric-collection. If these files were copied in loosely rather than installed as a plugin, compare the local package.json version against the remote (git fetch origin main --quiet && git show origin/main:package.json) and re-copy if it is newer. This project…

No other project uses it yet

MicrosoftCLAUDE.md

fabric-toolbox / MicrosoftFabricMgmt

microsoft/fabric-toolbox/tools/MicrosoftFabricMgmt/CLAUDE.md

This document provides comprehensive instructions for AI-assisted development of the MicrosoftFabricMgmt PowerShell module located in tools/MicrosoftFabricMgmt/. This module provides a robust interface for managing Microsoft Fabric resources via the Fabric API. Module Purpose: Enterprise-grade PowerShell module for Microsoft Fabric resource management with excellent error handling, comprehensive logging, and outstanding documentation. Build System: Sampler - Modern PowerShell module scaffolding and build framework Key Frameworks: - PSFramework: Configuration management and logging (Documentation) - Pester: Unit and integration testing - PlatyPS: Help documentation…

MicrosoftCLAUDE.md

fabric-toolbox / MicrosoftFabricMgmtMCPServer

microsoft/fabric-toolbox/tools/MicrosoftFabricMgmtMCPServer/CLAUDE.md

This directory contains a Python-based Model Context Protocol (MCP) server that wraps the MicrosoftFabricMgmt PowerShell module and exposes its capabilities to AI assistants (Claude, GitHub Copilot, etc.). DO NOT edit the PowerShell module source here. All PowerShell module development belongs in ../MicrosoftFabricMgmt/source/ and must follow the module's own CLAUDE.md. Key principle: Python is a thin protocol-translation layer only. All Fabric API logic lives in the PowerShell module. Python does not call Fabric REST APIs directly. Maintains a single long-lived pwsh…

MicrosoftCLAUDE.md

CopilotStudioSamples

microsoft/CopilotStudioSamples/CLAUDE.md

Microsoft Copilot Studio samples repo with a Just the Docs (Jekyll) site for navigation and search. Live site: https://microsoft.github.io/CopilotStudioSamples/ Solutions follow the PnP format: Front matter: README should include: - What the solution does and which Copilot Studio features it demonstrates - Screenshots in assets/ (reference as ) - Installation steps (import zip via make.powerapps.com > Solutions > Import) - Any connection references or environment variables to configure - Known issues or limitations Update authoring/solutions/README.md Contents table after adding. Add…

MicrosoftCLAUDE.md

TypeAgent / planValidationDemo

microsoft/TypeAgent/ts/examples/planValidationDemo/CLAUDE.md

This project is governed by a plan-validation MCP server. Every file access and shell call you make must go through the validated_* tools. The built-in Read, Write, Edit, Bash, Glob, Grep tools are NOT available in this session — only the MCP tools provided by the plan-validation server. A live dashboard is running at http://localhost:3100 — every tool call you make is visible there, including blocks. Call get_plan_schema. Read it carefully — the AgentPlan DSL has strict shape requirements and…

MicrosoftCLAUDE.md

TypeAgent / powershell

microsoft/TypeAgent/ts/packages/agents/powershell/CLAUDE.md

PowerShell captures and reuses PowerShell scripts from reasoning traces. Scripts persist in instance storage (~/.typeagent/profiles/<profile>/powershell/) across sessions. Grammar rules are registered dynamically at runtime — no build step needed for user-created flows. Initialize flow storage and seed samples only when the root powershell schema is enabled. Static namespaces can enable concurrently; they must not create competing store instances or revoke the root flow approvals on disable. Dynamic flows require trusted user authorization and the Windows execution broker, without execution feature…

MicrosoftCLAUDE.md

TypeAgent / taskflow

microsoft/TypeAgent/ts/packages/agents/taskflow/CLAUDE.md

TaskFlow runs user-taught multi-step macros over existing TypeAgent actions. Flows are pure JSON — no TypeScript logic. A deterministic compile script handles all boilerplate generation (TypeScript type, grammar rule, manifest entry). When asked to "compile pending recipes" or similar: That's it. scripts/compileRecipes.mjs reads pending/*.recipe.json and: If the build fails, fix the error in the generated files and re-run pnpm run build. When asked to write a recipe for a new flow (or if you notice a missing flow): Do NOT…

MicrosoftCLAUDE.md

semantic-link-labs

microsoft/semantic-link-labs/CLAUDE.md

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

MicrosoftCLAUDE.md

WindowsProtocolTestSuites

microsoft/WindowsProtocolTestSuites/CLAUDE.md

This is the Windows Protocol Test Suites repository — a .NET-based interoperability testing framework for Microsoft Open Specification protocols. Follow these steps before starting any task: Use kebab-case for the…

MicrosoftCLAUDE.md

playwright-vscode

microsoft/playwright-vscode/CLAUDE.md

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: fix-<issue-number> Never git push without an explicit instruction to push. Applies even when a PR is already open for the branch — additional commits are immediately visible to reviewers. Commit locally,…

MicrosoftCLAUDE.md

conductor

microsoft/conductor/CLAUDE.md

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

MicrosoftCLAUDE.md

conductor / providers

microsoft/conductor/docs/providers/claude.md

See Claude Provider Documentation. Moved to Startup Connection Validation.

MicrosoftCLAUDE.md

quicksand / quicksand-smb

microsoft/quicksand/packages/quicksand-smb/CLAUDE.md

Pure-Python SMB3 server for quicksand host-guest directory mounting. An SMB3 file server with two transports. On macOS and Linux it runs inetd-style, reading/writing on stdin/stdout — QEMU's guestfwd=cmd: spawns one instance per guest TCP connection, and no TCP port is opened on the host, eliminating the attack surface that Samba's smbd had. On Windows, quicksand-core serves it in-process via serve_socket on a persistent loopback-only (127.0.0.1) TCP listener, which avoids requiring Administrator rights. The Linux kernel CIFS client always performs a…

MicrosoftCLAUDE.md

semanticworkbench / knowledge-transfer-assistant

microsoft/semanticworkbench/assistants/knowledge-transfer-assistant/CLAUDE.md

A sophisticated dual-mode assistant that facilitates collaborative knowledge sharing between Coordinators (knowledge creators) and Team members (knowledge receivers) within the Semantic Workbench platform.

MicrosoftCLAUDE.md

semanticworkbench

microsoft/semanticworkbench/CLAUDE.md

Using AI Context for Development: * New developers: Read CONFIGURATION.md + PYTHON_LIBRARIES_CORE.md for project overview * Building assistants: - Start with ASSISTANTS_OVERVIEW.md for common patterns - Use specific assistant files (e.g., ASSISTANT_PROJECT.md) as implementation templates * Working on specific assistants: Load the relevant ASSISTANT_*.md file for focused context * Library development: Choose appropriate PYTHON_LIBRARIES_*.md file by functional area * Frontend work: Study component patterns in WORKBENCH_FRONTEND.md * API development: Follow service patterns from WORKBENCH_SERVICE.md * MCP servers: Use existing servers…

MicrosoftCLAUDE.md

semanticworkbench / chat-context-toolkit

microsoft/semanticworkbench/libraries/python/chat-context-toolkit/CLAUDE.md

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

MicrosoftCLAUDE.md

profile-explorer

microsoft/profile-explorer/CLAUDE.md

NEVER commit or git add without explicit user permission. When asked for a commit message, provide the message text only - do not execute git commit or git add. IMPORTANT: Always use Release configuration (-c Release). The user runs Release builds, not Debug. If running, ask the user to close it before building.