MicrosoftCLAUDE.mdpower-cat-skills / powercat-overpage
microsoft/power-cat-skills/plugins/powercat-overpage/CLAUDE.md
See AGENTS.md
CLAUDE.md examples from real projects
How real projects brief Claude Code: the commands, conventions and warnings they put in CLAUDE.md.
Your trail
Files you open will collect here, so you can find them again.
Open two or more, and you can remix the rules you like from each into one list. Kept in this browser only.
Worked for most · soon
MicrosoftCLAUDE.mdMicrosoftCLAUDE.mdteams.py
microsoft/teams.py/CLAUDE.md
Microsoft Teams Python SDK — a UV workspace with multiple packages providing APIs, common utilities, and integrations for Microsoft Teams. Imports - ALL imports MUST be at the top of the file — no imports inside functions, classes, or conditional blocks - Avoid TYPE_CHECKING blocks unless absolutely necessary (genuine circular imports that can't be restructured) - Avoid dynamic/deferred imports unless absolutely necessary - Relative imports within the same package, absolute for external packages Models - Pydantic with ConfigDict(alias_generator=to_camel) — snake_case…
MicrosoftCLAUDE.mddynwinrt
microsoft/dynwinrt/CLAUDE.md
dynwinrt is a Rust-based runtime library that enables dynamic invocation of Windows Runtime (WinRT) APIs. Unlike static projections (PyWinRT, C++/WinRT), this library uses runtime metadata (.winmd files) and FFI (libffi) to call arbitrary WinRT methods without native code generation. It provides JavaScript (napi-rs) and Python (PyO3) bindings, plus a code generation tool (dynwinrt-codegen) that produces typed wrappers from .winmd files. Classic COM and flat Win32 have separate JavaScript/TypeScript projections and runtime subpaths. Flat Win32 DLL exports use an independent native…
MicrosoftCLAUDE.mdAgent365-devTools
microsoft/Agent365-devTools/CLAUDE.md
Microsoft Agent 365 DevTools CLI (a365) - A .NET CLI tool built on .NET 8.0 with support for running on .NET 8.0 or higher (e.g., .NET 9, 10). Used for deploying and managing Microsoft Agent 365 applications on Azure. Supports .NET, Node.js, and Python applications with auto-detection. Test Framework: xUnit with FluentAssertions and NSubstitute Test Location: src/Tests/Microsoft.Agents.A365.DevTools.Cli.Tests/ Parallel Test Execution: Tests modifying environment variables or shared resources must disable parallelization:
MicrosoftCLAUDE.mdwinml-cli
microsoft/winml-cli/CLAUDE.md
Never hardcode model architecture names, node/operator names, input/output tensor names, layer naming patterns, or any model-specific logic. All solutions must be universal and architecture-agnostic. All testing uses pytest with code-generated results. Never create standalone test scripts, use LLM-generated expectations, or generate test data manually. Run the necessary pytest scope after every implementation or test revision (for example, affected test files/modules/cases). Run full suite uv run pytest tests/ only when explicitly requested, before merge/release, or when impact is broad/unclear. Never assume…
MicrosoftCLAUDE.mdwinml-cli / tests
microsoft/winml-cli/tests/CLAUDE.md
Inherits all rules from /CLAUDE.md. Additional test-specific rules below. Reference: /docs/pytest-best-practices.md - Place unit tests under tests/unit/<module>/ mirroring src/winml/modelkit/<module>/ - Place integration tests under tests/integration/, e2e under tests/e2e/ - Place cross-cutting CLI-surface tests (startup, import budget, arg parsing, command discovery, version/help output) under tests/cli/ — these don't mirror any single src/ module, so they don't fit under tests/unit/<module>/ - Put shared fixtures in the narrowest conftest.py that covers all consumers - Place tests that mirror a src/winml/modelkit/<module>/ directly under tests/…
MicrosoftCLAUDE.mdmonosize
microsoft/monosize/CLAUDE.md
monosize is a CLI tool that measures bundle sizes for packages and monorepos and compares them against a stored baseline (typically main). This repo is itself a Yarn 4 + Nx monorepo of the CLI plus first-party adapter packages. The packages/ directory has three roles: Adapters are wired up by users in their own monosize.config.mjs; this repo does not consume itself end-to-end. When changing the BundlerAdapter / StorageAdapter shape, every adapter package must be updated in lockstep. Per-package and full-graph…
MicrosoftCLAUDE.mdDataFactory.MCP
microsoft/DataFactory.MCP/CLAUDE.md
.NET MCP server for Microsoft Fabric Data Factory operations.
MicrosoftCLAUDE.mdAgent365-python
microsoft/Agent365-python/CLAUDE.md
Microsoft Agent 365 SDK for Python - Enterprise-grade extensions for building production-ready AI agents for M365, Teams, Copilot Studio, and Webchat. This is a uv workspace with eight packages for Notifications, Runtime, and Tooling. Observability is retired from this repository. Do not reintroduce its packages, sources, imports, or release dependencies. Use the separately maintained microsoft-opentelemetry distro; see migration and owner actions. Python Version: 3.11+ (3.11 and 3.12 tested in CI) For detailed architecture and design documentation, see docs/design.md, which includes:…
MicrosoftCLAUDE.mdpreflate-rs
microsoft/preflate-rs/CLAUDE.md
Important: This file (and all sub-project CLAUDE.md files) are checked into the repository. Only include information that is valid for any developer or machine: project conventions, architecture, commands, constraints. Do not add machine-specific paths, personal tool preferences, local environment settings, or anything that would not apply to every contributor. The CI runs on windows-latest and builds for multiple targets: wasm32-wasip1, aarch64-unknown-linux-musl, x86_64-pc-windows-msvc, x86_64-unknown-linux-gnu. The release build uses Spectre mitigations (/Qspectre /sdl) and produces preflate_rs_0_8.dll and preflate_util.exe. preflate-rs analyzes DEFLATE-compressed streams,…
MicrosoftCLAUDE.mdpreflate-rs / container
microsoft/preflate-rs/container/CLAUDE.md
Scans binary files (ZIP, PNG, JPEG) for DEFLATE streams, orchestrates the preflate + Zstd pipeline, and reassembles the output. Only format version 3 is supported. Versions 1 and 2 are rejected; version 3 uses the incompatible 0.8 corrections format. PreflateContainerConfig holds knobs: min_chunk_size, max_chunk_size, total_plain_text_limit, chunk_plain_text_limit, validate_compression, max_chain_length. All framing bytes (type, varint) are written directly to the output stream — they are never inside the Zstd encoder. Each block type byte encodes two fields: Mask constants (defined in container_processor.rs):
MicrosoftCLAUDE.mdpreflate-rs / dll
microsoft/preflate-rs/dll/CLAUDE.md
C-compatible DLL for .NET interop. Exposes a streaming compress/decompress API as extern "C" functions. The version number is baked into the crate name (preflate_rs_0_8) for binary compatibility. flags encoding: - bits 0–4: Zstd compression level - bit 5: test_baseline - bit 6: verify Return value of compress_buffer: 0 = more output available, 1 = done, <0 = error. Magic numbers are validated on every call to catch dangling/wrong pointer bugs. - Uses #[unsafe(no_mangle)] on exported functions — the only place…
MicrosoftCLAUDE.mdpreflate-rs / fuzz
microsoft/preflate-rs/fuzz/CLAUDE.md
libfuzzer harnesses for fuzzing the core and container APIs. Not published; requires the fuzzing cargo feature. Feeds arbitrary bytes to preflate_whole_deflate_stream() as a raw DEFLATE stream, then attempts recreate_whole_deflate_stream() on the result. Verifies no crash or panic. Feeds arbitrary bytes (minimum 1 byte) to preflate_whole_into_container(), then recreate_whole_from_container(), and asserts the output matches the original input.
MicrosoftCLAUDE.mdpreflate-rs / preflate
microsoft/preflate-rs/preflate/CLAUDE.md
Core DEFLATE analysis and reconstruction. Analyzes a DEFLATE bitstream, extracts the uncompressed plaintext plus a compact set of reconstruction parameters, and later recreates the bit-exact original bitstream. PreflateConfig controls max_chain_length, plain_text_limit, and verify_compression. Reconstruction runs the same pipeline in reverse.
MicrosoftCLAUDE.mdpreflate-rs / tests
microsoft/preflate-rs/tests/CLAUDE.md
End-to-end round-trip tests against real sample files in samples/. - Core round-trip: decompress a .deflate file with preflate_whole_deflate_stream, recompress with recreate_whole_deflate_stream, assert bitwise identical output. - Container round-trip: compress a ZIP / PNG / DOCX / PDF through PreflateContainerProcessor, decompress with RecreateContainerProcessor, assert the output matches the original file byte-for-byte. The samples/ directory contains real-world compressed files used as test fixtures: deflate streams, zlib streams, PNGs, ZIPs, PDFs, DOCX, JPEG, WebP, and binary blobs from various compressors (zlib, zlib-ng, libdeflate,…
MicrosoftCLAUDE.mdpreflate-rs / util
microsoft/preflate-rs/util/CLAUDE.md
CLI tool for manually testing preflate compression on files and directories. <PATH> may be a single file or a directory (scanned recursively). Single file: src/main.rs (~193 lines). Helper assert_eq_array<T>() provides detailed positional diff output for debugging mismatches during verification.
MicrosoftCLAUDE.mdopen-kosmos
microsoft/open-kosmos/CLAUDE.md
Tech Stack: Electron 35 + React 18 + TypeScript 5, Webpack 5, TailwindCSS 4, lucide-react icons, Vercel AI SDK 5.x (streaming), @modelcontextprotocol/sdk, better-sqlite3 (local persistence), Monaco Editor, Playwright (browser automation). Architecture: Electron multi-process model — main process (Node.js: auth, chat engine, MCP runtime, data persistence, voice) + renderer process (React SPA: chat UI, agent editor, settings) + preload scripts (type-safe IPC bridge). The app is built as OpenKosmos-only. A list of useful package.json scripts: After entering a module directory, check…
MicrosoftCLAUDE.mdrecipe-tool
microsoft/recipe-tool/CLAUDE.md
This section outlines the core implementation philosophy and guidelines for software development projects. It serves as a central reference for decision-making and development approach throughout the project. Embodies a Zen-like minimalism that values simplicity and clarity above all. This approach reflects: This development philosophy values clear documentation, readable code, and belief that good architecture emerges from simplicity rather than being imposed through complexity.
MicrosoftCLAUDE.mdShadowFrog
microsoft/ShadowFrog/claude.md
ShadowFrog is a suite of AI coding agent skills that build and maintain shadow knowledge bases for any codebase. It consists of 7 skills (shadow-frog, shadow-frog-init, shadow-frog-update, shadow-frog-dream, shadow-frog-nap, shadow-frog-meditate, shadow-frog-viewer) and associated hooks. Nap's proposals remain separate from .shadow/ discoveries. This is a distributable skills package — users install it into their own projects via install.sh or install.ps1.
MicrosoftCLAUDE.mdAgent365-dotnet
microsoft/Agent365-dotnet/CLAUDE.md
Exceptions: - Auto-generated files (.g.cs, .designer.cs, files with <auto-generated> markers) - Files in bin/, obj/ directories - Third-party or vendored code Observability is maintained in the Microsoft OpenTelemetry .NET distro, not this repository. Do not reintroduce Microsoft.Agents.A365.Observability.* projects or package output. See migration guidance for application onboarding with Microsoft.OpenTelemetry and package-owner release actions. This SDK extends the Microsoft 365 Agents SDK with three main areas: 1. Runtime (Microsoft.Agents.A365.Runtime) - Multi-tenant context extraction via TenantContextHelper (claims, headers, items) - Standardized result…
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.