CLAUDE.md examples from real projects

MicrosoftCLAUDE.md

poml

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.md

poml / 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.md

FluidFramework / 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.md

FluidFramework / 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.

CloudflareCLAUDE.md

workers-sdk

cloudflare/workers-sdk/CLAUDE.md

See @AGENTS.md

JetBrainsCLAUDE.md

koog / a2a

JetBrains/koog/a2a/CLAUDE.md

The A2A (Agent-to-Agent) module is a meta-module within the larger Koog project that implements a comprehensive client and server library for the A2A protocol, a standardized communication protocol for AI agents based on the specification at https://a2a-protocol.org/latest/specification/. Important: Since this is a meta-module inside a bigger root project, the Gradle wrapper executable is located one directory up. All Gradle commands must use ../gradlew when running from the a2a directory.

No other project uses it yet

JetBrainsCLAUDE.md

koog / simple-examples

JetBrains/koog/examples/simple-examples/CLAUDE.md

This is the simple-examples project within the Koog Framework repository. It contains executable examples demonstrating various AI agent patterns and capabilities, from basic calculator agents to advanced features like persistence, streaming, and agent-to-agent communication. Examples require API keys for LLM providers. Configure them via: Each example has a dedicated Gradle task: All available tasks follow the pattern runExample*. See build.gradle.kts for the complete list. This project uses Gradle composite build to depend on the parent Koog framework (settings.gradle.kts:). Changes in…

No other project uses it yet

SupabaseDeletes or force-pushesCLAUDE.md

supabase-js

supabase/supabase-js/.claude/CLAUDE.md

You are assisting with development in a unified Nx monorepo that consolidates all Supabase JavaScript SDKs, built with Nx for optimal developer experience and maintainability. This strategic migration from 6 separate repositories addresses critical maintenance overhead, dependency duplication, and release coordination challenges while maintaining zero breaking changes for consumers. 📚 Essential Documentation: Always refer to these guides for detailed information: - CONTRIBUTING.md - Development guidelines, commit format, PR process - TESTING.md - Complete testing guide with Docker requirements - RELEASE.md…

StripeCLAUDE.md

stripe-node

stripe/stripe-node/.claude/CLAUDE.md

It's ok not to put comments on/in a function if their addition wouldn't meaningfully clarify anything.

PydanticCLAUDE.md

logfire

pydantic/logfire/CLAUDE.md

Pydantic Logfire is an observability platform built on OpenTelemetry. This repository contains the Python SDK for Logfire and documentation. The server application for recording and displaying data is closed source. Key aspects: - Opinionated wrapper around OpenTelemetry (traces, metrics, logs) - Extensive integrations with popular Python packages - SQL-based querying of telemetry data Pre-commit automatically runs ruff and pyright, but you can also run make format/lint/typecheck to run them explicitly, particularly to check files that haven't been changed. Docs are…

PydanticCLAUDE.md

logfire / agent-frameworks

pydantic/logfire/docs/integrations/agent-frameworks/CLAUDE.md

These guides must describe integrations that users can reproduce. Treat every code sample and support claim as product behavior, not illustrative pseudocode. - Use the framework's real agent abstraction and make it execute a real framework tool. A direct model call, prompt invocation, generation helper, chain, or query engine is not an agent example. - Do not add manual wrapper spans, synthetic agent spans, fake tool spans, or other telemetry solely to make the trace look complete. Show telemetry emitted…

MicrosoftCLAUDE.md

apm / 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.

No other project uses it yet

AnthropicCLAUDE.md

anthropic-sdk-python

anthropics/anthropic-sdk-python/CLAUDE.md

Context for contributors (human or AI) on how this SDK is put together, plus the things reviews most often come back to. Setup instructions live in CONTRIBUTING.md. The official Python SDK for the Claude API (anthropic on PyPI). This is the v1 line: it is built on httpx2 and needs Python 3.10 or later (requires-python in pyproject.toml). Most of it is generated from the OpenAPI spec. Hand-written helpers, tool runners, credentials, middleware, and platform clients sit on top.

StripeCLAUDE.md

stripe-php

stripe/stripe-php/.claude/CLAUDE.md

It's ok not to put comments on/in a function if their addition wouldn't meaningfully clarify anything.

No other project uses it yet

MicrosoftCLAUDE.md

verona

microsoft/verona/CLAUDE.md

Read AGENTS.md in this repository first. It contains all project-specific knowledge (build workflow, pass architecture, syntax, conventions, etc.). Everything below is Claude-specific for this project. (Add Claude-specific project instructions here as needed.)

NVIDIACLAUDE.md

TransformerEngine

NVIDIA/TransformerEngine/CLAUDE.md

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

JetBrainsCLAUDE.md

kotlinconf-app

JetBrains/kotlinconf-app/CLAUDE.md

The official KotlinConf app — a Kotlin Multiplatform project serving Android, iOS, JVM desktop, and WebAssembly clients, backed by a Ktor server. All client UI is shared via Compose Multiplatform. Android uses the app.androidApp run configuration in IDE; iOS uses KotlinConfAppScheme. Dependency Injection — Metro The app uses Metro (not Koin) for DI on the client. Key interfaces: ViewModels are registered into Metro's map multibinding: ConferenceService ConferenceService is the central app singleton. It: - Fetches AppConfig (current year) from the…

AWSCLAUDE.md

agentcore-samples / claude-code

awslabs/agentcore-samples/01-features/02-host-your-agent/01-runtime/04-coding-agents/03-code-agents-competition-e2e/coding_agents/claude-code/CLAUDE.md

You are a coding agent running on AWS Bedrock AgentCore. You fix bugs in GitHub repositories by reading issues, applying fixes, and submitting PRs. You have a gateway MCP server connected that provides GitHub tools (prefixed mcp__gateway__GitHubMCP___). Use them directly — no manual HTTP calls needed. When given a prompt, act immediately: 1. Extract the repository owner, repository name, and issue number from the user's message. 2. Use the MCP tools to read the issue, fix the code, and submit…

MicrosoftCLAUDE.md

Power-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.md

Power-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 →…