agentleFS

CLAUDE.md examples from real projects

How real projects brief Claude Code: the commands, conventions and warnings they put in CLAUDE.md.

Worked for most · soon
SupabaseCLAUDE.md

tanstack-db

supabase/tanstack-db/.claude/CLAUDE.md

This project uses Ultracite, a zero-config preset that enforces strict code quality standards through automated formatting and linting. Biome (the underlying engine) provides robust linting and formatting. Most issues are automatically fixable. Write code that is accessible, performant, type-safe, and maintainable. Focus on clarity and explicit intent over brevity. Biome's linter will catch most issues automatically. Focus your

589mo agoReviewMountCreate a free account to mount
BlockCLAUDE.md

proto-fleet

block/proto-fleet/CLAUDE.md

See AGENTS.md for canonical guidance and task-specific references. Canonical repository skills live under .agents/skills/; Claude discovers them through the per-skill links in .claude/skills/. When addressing review feedback, re-check each finding against the current target code before treating it as already addressed. Complete scoped fixes and applicable validation under /pr-ready; avoid unrelated refactors.

5758d agoReviewMountCreate a free account to mount
SentryCLAUDE.md

dotnet-assembly-alias

getsentry/dotnet-assembly-alias/CLAUDE.md

Alias renames .NET assemblies on disk and rewrites all references to point at the new names, to avoid "first-loaded wins" dependency conflicts when assemblies are loaded into a shared AppDomain (Unity extensions, MSBuild tasks, SharePoint plugins). It is shipped two ways: a dotnet global tool (assemblyalias) and an MSBuild task that runs automatically during a build. This is a fork (getsentry/dotnet-assembly-alias) of Simon Cropp's original. Release notes live in GitHub Milestones, not a changelog. All commands run against the src…

575mo agoReviewMountCreate a free account to mount
SupabaseCLAUDE.md

sdk / postgrest-typegen

supabase/sdk/packages/postgrest-typegen/CLAUDE.md

Type generation for PostgREST from a PostgreSQL schema. Introspects a database into a normalized GeneratorMetadata shape, then renders language types (TypeScript, Go, Python) from it. This is the engine extracted from postgres-meta (the one behind supabase gen types), repackaged as a small, driver-agnostic library. IMPORTANT — scope, read before adding a language here. Introspection and the GeneratorMetadata/JSON contract are this package's permanent job. The three bundled generators (TypeScript/Go/Python) are a deliberate transition, not the pattern for new languages: they move…

525d agoReviewMountCreate a free account to mount
SupabaseCLAUDE.md

sdk / typegen

supabase/sdk/packages/typegen/CLAUDE.md

The language registry for supabase gen types --lang <language>. It exports languages, a list of TypegenLanguage entries mapping a --lang name to the generator that renders it, so new languages need a pull request here and a dependency bump in the CLI, never CLI code. See SDK-1955 for the decision and SDK-1956 for the CLI adapter that replaces the CLI's hardcoded switch. Introspection is NOT implemented here: the consumer calls introspect() and passes the GeneratorMetadata in. introspect, Queryable, IntrospectOptions, GeneratorMetadata…

525d agoReviewMountCreate a free account to mount
MicrosoftCLAUDE.md

winml-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…

5126d agoReviewMountCreate a free account to mount
MicrosoftCLAUDE.md

winml-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/…

5126d agoReviewMountCreate a free account to mount
Hugging FaceCLAUDE.md

physics-intern-v0

huggingface/physics-intern-v0/CLAUDE.md

This is a multi-agent scaffolding system for autonomous scientific research in mathematics and theoretical physics. See README.md for overview, motivation, and design principles. GitHub Actions (.github/workflows/testing.yml) runs three commands on…

496mo agoReviewMountCreate a free account to mount
MicrosoftCLAUDE.md

monosize

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…

483mo agoReviewMountCreate a free account to mount
NVIDIACLAUDE.md

nvrc

NVIDIA/nvrc/CLAUDE.md

Read ARCHITECTURE.md first to understand the security model, threat landscape, and design rationale before making changes. NVRC is a minimal init process (PID 1) for ephemeral confidential VMs with NVIDIA GPUs. It configures GPU resources, starts required daemons (nvidia-persistenced, nv-hostengine, etc.), and hands off to kata-agent. The goal is to eventually run NVRC as no_std. We are slowly transitioning by building hardened_std as our security-hardened std replacement. This enables: **no_std Transition Roadmap:** Runtime-writable config pattern: The rootfs image is read-only.…

4732d agoReviewMountCreate a free account to mount
MicrosoftCLAUDE.md

DataFactory.MCP

microsoft/DataFactory.MCP/CLAUDE.md

.NET MCP server for Microsoft Fabric Data Factory operations.

456mo agoReviewMountCreate a free account to mount
NVIDIACLAUDE.md

DALI_extra

NVIDIA/DALI_extra/CLAUDE.md

DALI_extra is a data-only repository containing sample datasets used by NVIDIA DALI's test suite. It has no build system or runnable code. Large binary files (.mp4, .avi, .mkv, .tar, LMDB files, TFRecord files, etc.) are stored via Git LFS. Git LFS must be installed before cloning or the large files will be stubs. Set the DALI_EXTRA_PATH environment variable to point to this repository's root before running DALI tests: Before adding new files: - Verify no existing dataset can be used…

457mo agoReviewMountCreate a free account to mount
VercelCLAUDE.md

microfrontends

vercel/microfrontends/CLAUDE.md

This is a monorepo for @vercel/microfrontends, a library that enables splitting large applications into independently developed and deployed microfrontends on Vercel. The package provides generic platform support for microfrontends in multiple frameworks, such as Next.js, SvelteKit, React Router, Vite, and React. When running commands for a specific application, do not cd into the directory. Run commands from the root. The above commands can be run for a particular package by using a filter option: pnpm checks -F <package name>. Use…

457mo agoReviewMountCreate a free account to mount
JetBrainsCLAUDE.md

intellij-obsolete-plugins / aidebugger

JetBrains/intellij-obsolete-plugins/aidebugger/CLAUDE.md

Changelog is maintained manually in CHANGELOG.md. Add entries under ## [Unreleased] for notable user-visible changes. On release, rename [Unreleased] to the version with date. No tooling automation — update by hand. This plugin uses the monorepo Bazel/IML build infrastructure (not Gradle). IML files define module dependencies. Run ./build/jpsModelToBazel.cmd from the repo root after modifying IML files to regenerate BUILD.bazel files.

4445d agoReviewMountCreate a free account to mount
MicrosoftCLAUDE.md

Agent365-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:…

439mo agoReviewMountCreate a free account to mount
SentryCLAUDE.md

XcodeBuildMCP-iOS-Template / template

getsentry/XcodeBuildMCP-iOS-Template/template/CLAUDE.md

This is a native iOS application built with Swift 6.1+ and SwiftUI. The codebase targets iOS 18.0 and later, allowing full use of modern Swift and iOS APIs. All concurrency is handled with Swift Concurrency (async/await, actors, @MainActor isolation) ensuring thread-safe code. The project follows a workspace + SPM package architecture: Important: All development work should be done in the YourAppPackage Swift Package, not in the app project. The app project is merely a thin wrapper that imports and launches…

4217mo agoReviewMountCreate a free account to mount
DatabricksCLAUDE.md

databricks-jdbc

databricks/databricks-jdbc/CLAUDE.md

When adding or changing an error emitted by the JDBC driver: - Use DatabricksDriverErrorCode wherever a driver-owned error code applies. Reuse an existing code when its meaning matches; otherwise add a uniquely numbered enum value. - Add or update a test that verifies the emitted error name and numeric code. - Record whether the error is a driver, server, or user error in the maintainers' OSS JDBC telemetry dashboard and automation taxonomy. Link that update in the PR, or explicitly…

413mo agoReviewMountCreate a free account to mount
Microsoft AzureCLAUDE.md

aks-app-routing-operator

Azure/aks-app-routing-operator/CLAUDE.md

The AKS Web Application Routing Operator is a Kubernetes operator that manages resources for AKS Application Routing functionality. It's built using the Kubebuilder framework and manages several Custom Resource Definitions (CRDs) for routing, DNS, and certificate management. Some test packages (e.g. pkg/controller/dns/) use controller-runtime's envtest and require Kubernetes API server binaries. Use setup-envtest to install them and set KUBEBUILDER_ASSETS: If setup-envtest use -p path doesn't expand correctly in your shell, run setup-envtest use first to see the path, then set…

408mo agoReviewMountCreate a free account to mount
Microsoft AzureCLAUDE.md

aks-app-routing-operator / manifests

Azure/aks-app-routing-operator/pkg/manifests/CLAUDE.md

This package stores Kubernetes manifests that are served to customers. These manifests are used to deploy various components of the App Routing Operator. The test fixtures in this package are generated from the Helm charts. To regenerate the fixtures, run the tests with the GENERATE_FIXTURES environment variable set to true:

408mo agoReviewMountCreate a free account to mount
CLAUDE.md vs 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.