agentleFS
Sign inStart free

CLAUDE.md examples from real projects

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

Popular:code reviewtestingpdfMCP serverfrontendsecuritydocumentation
Worked for most · soon
Known publishers remove filterHiding risky files remove filter
BlockCLAUDE.md

bergr

block/bergr/CLAUDE.md

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

512mo agoReviewMountCreate a free account to mount
BlockCLAUDE.md

canopy

block/canopy/CLAUDE.md

This project follows the BossUI standard: refined minimalism with subtle depth. Clean surfaces, purposeful shadows, smooth transitions. Not sterile, not flashy. Use CSS variables and Tailwind design tokens exclusively: NEVER use bg-white, bg-gray-100, text-gray-500, border-gray-200, or any other hardcoded color. Always use tokens that respect dark/light mode. Exception: the SVG canvas uses raw hex values for geometry (stroke colors, fill) because SVG doesn't support Tailwind classes — this is acceptable. Always include dark mode variants: Glassmorphism for overlays: bg-card/80 backdrop-blur-sm…

57mo agoReviewMountCreate a free account to mount
ElasticCLAUDE.md

mastra-elasticsearch-example

elastic/mastra-elasticsearch-example/CLAUDE.md

This is a Mastra project - an AI framework for building agents, workflows, and tools. The project structure follows Mastra conventions with agents, tools, and workflows organized in the src/mastra/ directory. For complete setup and usage instructions, see AGENTS.md, which includes:

58mo agoReviewMountCreate a free account to mount
SentryCLAUDE.md

replay-debugger

getsentry/replay-debugger/CLAUDE.md

This file contains guidelines and rules for AI assistants working on this codebase. SentryReplayDebugger is a macOS application for debugging and inspecting Sentry Session Replay data. It's built with SwiftUI and uses the Sentry Cocoa SDK. You are an expert macOS developer specializing in building apps with clean, unobtrusive design. Use modern frameworks for building delightful user experiences and implement best practices for safe and performant code. Omit unnecessary code comments. The project has two test suites: 1. Unit Tests…

56mo agoReviewMountCreate a free account to mount
MicrosoftCLAUDE.md

amplifier-app-nanoclaw / container

microsoft/amplifier-app-nanoclaw/container/CLAUDE.md

You are a NanoClaw agent. Your name, destinations, and message-sending rules are provided in the runtime system prompt at the top of each turn. Be concise — every message costs the reader's attention. Prefer outcomes over play-by-play; when the work is done, the final message should be about the result, not a transcript of what you did. Files you create are saved in /workspace/agent/. Use this for notes, research, or anything that should persist across turns in this group. The…

55mo agoReviewMountCreate a free account to mount
PostHogCLAUDE.md

claude-code-share-plugin

PostHog/claude-code-share-plugin/CLAUDE.md

This is a Claude Code plugin that converts JSONL session logs into readable markdown and publishes them to GitHub repositories. The plugin provides a /share slash command that executes a Python script to handle the conversion and upload process. The plugin follows the standard Claude Code plugin architecture: Session Log Discovery (find_latest_session_log() in scripts/share_session.py:31-56): - Converts current working directory to Claude project directory format (e.g., /Users/foo/project → -Users-foo-project) - Searches ~/.claude/projects/{project_dir_name}/*.jsonl for session files - Falls back to searching all…

54mo agoReviewMountCreate a free account to mount
PostHogCLAUDE.md

wizard-workbench / fizzy

PostHog/wizard-workbench/apps/basic-integration/rails/fizzy/.claude/CLAUDE.md

@../AGENTS.md

100 projects use a version of this

57mo agoReviewMountCreate a free account to mount
ShopifyCLAUDE.md

trending-products

Shopify/trending-products/CLAUDE.md

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

53mo agoReviewMountCreate a free account to mount
VercelCLAUDE.md

sitecore-skills

vercel-labs/sitecore-skills/CLAUDE.md

This is a Claude Code skills repository for building Sitecore Marketplace apps. It contains 7 skills in .claude/skills/ that guide developers through scaffolding, building, and deploying Marketplace apps using the…

59mo agoReviewMountCreate a free account to mount
ElasticCLAUDE.md

claude-plugin

elastic/claude-plugin/.claude/CLAUDE.md

Elastic's official Claude Code plugin (elastic/claude-plugin). It bundles skills, hooks, and agents for the Elastic stack (Elasticsearch, Kibana, Observability, Security, Cloud) into a single .claude-plugin/plugin.json manifest consumed by claude --plugin-dir. Do not edit files under skills/. Skills are authored in elastic/agent-skills-sandbox, promoted to elastic/agent-skills, and synced here automatically. Any local edits will be overwritten on the next sync. Hooks and agents (future) are authored directly in this repo. Use Assisted-by: trailers (not Co-Authored-By:) for AI-assisted commits, following the Linux kernel…

447d agoReviewMountCreate a free account to mount
Model Context ProtocolCLAUDE.md

experimental-ext-filesystems

modelcontextprotocol/experimental-ext-filesystems/CLAUDE.md

The line above is a Claude Code import: it expands AGENTS.md into context at session start. https://code.claude.com/docs/en/memory#agents-md -->

411d agoReviewMountCreate a free account to mount
PostHogCLAUDE.md

hogtyped

PostHog/hogtyped/CLAUDE.md

HogTyped is a code generation tool that creates type-safe PostHog analytics wrappers with embedded JSON schemas. It's organized as a monorepo with TypeScript and Python implementations.

414mo agoReviewMountCreate a free account to mount
PydanticCLAUDE.md

thrust

pydantic/thrust/CLAUDE.md

A canvas rocket-lander game (TypeScript + Vite, no runtime deps) that streams its state each physics tick over a WebSocket to a FastAPI server, which replies with a move. By…

42mo agoReviewMountCreate a free account to mount
NVIDIACLAUDE.md

storage-scale-test

NVIDIA/storage-scale-test/CLAUDE.md

Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with the License. You may obtain a copy of the License at http://www.apache.org/licenses/LICENSE-2.0 Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the specific language governing permissions and limitations under the License. --> The…

315d agoReviewMountCreate a free account to mount
Microsoft AzureCLAUDE.md

azure-cleanroom

Azure/azure-cleanroom/CLAUDE.md

Read .github/copilot-instructions.md for repo conventions, architecture, and development patterns.

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

operation-cache-controller

Azure/operation-cache-controller/CLAUDE.md

The Operation Cache Controller is a Kubernetes operator built with kubebuilder v4 framework that manages operations and caches the outcome of those operations. It provisions resources, pre-provisions resources for future use (caching), and manages the lifecycle of resources and cache. The controller manages four main Custom Resource Definitions (CRDs) in the controller.azure.github.com API group: The project follows a handler-based reconciliation pattern with clear separation of concerns: The main reconcilers are located in internal/controller/: - RequirementReconciler - Creates Cache and Operation…

25mo agoReviewMountCreate a free account to mount
SentryCLAUDE.md

ctrl-alt-defeat

getsentry/ctrl-alt-defeat/CLAUDE.md

Always run them through run_tests.sh. A raw godot ... gut_cmdln.gd command skips the checks at the bottom of that script, and those catch the two ways a suite goes green…

23mo agoReviewMountCreate a free account to mount
SentryCLAUDE.md

mobilebuildmcp.com

getsentry/mobilebuildmcp.com/CLAUDE.md

Public docs cover the public API only: MCP spec features MobileBuildMCP implements (structured content, resources, notifications, tool annotations, and so on), tools and what they do, MCP resources, configuration, session…

253d agoReviewMountCreate a free account to mount
MicrosoftCLAUDE.md

Dev-Trio

microsoft/Dev-Trio/CLAUDE.md

This workspace uses the Dev-Trio three-agent methodology. - dt-planner — orchestrates all tasks, delegates to implementer and critic subagents - dt-implementer — applies changes, runs gates - dt-critic — audits changes, issues verdict

25mo 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.