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

monty / modules

pydantic/monty/crates/monty/src/modules/CLAUDE.md

Guidance for the Python stdlib modules implemented in this directory (re, json, math, datetime, unicodedata, …). The overriding goal is CPython parity: signatures, error messages, and error ordering must match CPython 3.14 byte-for-byte. Verify every message against CPython with the /python-playground skill before pinning it in a test. Any function beyond the trivial 0/1/2-positional shapes (covered by ArgValues::check_zero_args / get_one_arg / get_two_args / get_zero_one_arg / into_pos_only) MUST define its parameters with a #[derive(FromArgs)] struct. Never hand-roll args.into_parts() loops — they…

Steady2 mentions in 2 weeks

No other project uses it yet

8.9k2mo agoReviewMountCreate a free account to mount
AnthropicCLAUDE.md

claude-agent-sdk-python

anthropics/claude-agent-sdk-python/CLAUDE.md

Workflow jobs in this repository that call Claude run with three protections. Keep them when you add or edit a workflow. 1. Egress-firewall runner. The job has runs-on: ubuntu-24.04-firewall, a GitHub-hosted runner that filters the job's outbound network traffic. Do not move a job that calls Claude to another runner. 2. Network allow list. .github/egress-firewall.yaml lists the hosts those jobs may reach, besides any that GitHub's firewall allows by default. Keep mode: enforce, which is what makes the firewall block…

Steady8 mentions in 2 weeks

No other project uses it yet

8.5k4mo agoReviewMountCreate a free account to mount
VercelCLAUDE.md

deepsec

vercel-labs/deepsec/CLAUDE.md

Pointer file for Claude Code working in this repo. User-facing docs are in README.md; contributor docs in CONTRIBUTING.md. Read those first. Always use the technical-writer skill (.agents/skills/technical-writer/SKILL.md) when you write or edit prose for this repo, including docs, READMEs, commit messages, PR titles and descriptions, and issues. - Plugin contracts live in packages/core/src/plugin.ts. Internals route through getRegistry() from deepsec/config rather than calling organization-specific code directly. - The CLI auto-loads deepsec.config.{ts,mjs,js,cjs} from cwd upward (via packages/deepsec/src/load-config.ts, jiti). - New matchers go…

8.4k46d agoReviewMountCreate a free account to mount
NVIDIACLAUDE.md

Isaac-GR00T

NVIDIA/Isaac-GR00T/CLAUDE.md

Isaac GR00T N1.7 is an open vision-language-action (VLA) model for generalized humanoid robot skills. The repo contains the model, training pipeline, evaluation harness, and deployment tooling. Each Jetson/Spark platform ships an activate_*.sh helper (scripts/activate_orin.sh, scripts/activate_spark.sh, scripts/activate_thor.sh) that exports platform-specific library paths. For dGPU, the standard source .venv/bin/activate is sufficient.

8.3k30d agoReviewMountCreate a free account to mount
AnthropicCLAUDE.md

defending-code-reference-harness

anthropics/defending-code-reference-harness/CLAUDE.md

This repo has two halves: - Interactive skills (.claude/skills/) — read and write files in the repo (no target-code execution, except /dnr-hunt / /dnr-respond, which run the bundled demo app…

7.5k4mo agoReviewMountCreate a free account to mount
Model Context ProtocolCLAUDE.md

registry

modelcontextprotocol/registry/CLAUDE.md

Import @README.md Publishing an MCP server does NOT happen through a pull request to this repository. Do NOT create a PR that adds a server.json or a server directory anywhere…

7.5k3mo agoReviewMountCreate a free account to mount
ShopifyReads credentialsCLAUDE.md

flash-list

Shopify/flash-list/CLAUDE.md

High-performance replacement for React Native's FlatList, built on recycling principles. Used by thousands of React Native apps for smooth scrolling with large datasets. estimatedItemSize does NOT exist as a prop on FlashList. Do not use it, suggest it, or add it. Important: dist/ is NOT rebuilt on branch switch. Always run yarn build after checking out a different branch. Node 22.18.0 All agent-raised PRs MUST use SHOPIFY_GH_ACCESS_TOKEN for PR creation. PRs created without this token cannot be merged. Before finishing…

Steady4 mentions in 2 weeks

No other project uses it yet

7.2k8mo agoReviewMountCreate a free account to mount
SentryCLAUDE.md

MobileBuildMCP

getsentry/MobileBuildMCP/CLAUDE.md

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

6.5k52d agoReviewMountCreate a free account to mount
GoogleReads credentialsCLAUDE.md

agents-cli / references

google/agents-cli/extensions/claude/template/.agents/skills/agents-cli-claude/references/claude.md

This project carries agents-cli-extension.yaml at its root, which overrides the commands that assume ADK. Everything else (deploy, infra, eval grade) runs natively. The container serves A2A and exports traces as on Cloud Run. It also serves Agent Runtime's :query and :streamQuery methods (see Serving), so agents-cli run --mode adk works and an ingress Agent Gateway can govern the agent. publish gemini is refused, the Console playground cannot invoke the agent, and the Console's session and trace views stay empty; read…

Steady2 mentions in 2 weeks

No other project uses it yet

6.3k18d agoReviewMountCreate a free account to mount
Microsoft AzureCLAUDE.md

Azure-Sentinel

Azure/Azure-Sentinel/CLAUDE.md

For Microsoft Sentinel-to-Defender-XDR migration or authoring work, first read: Tools\SentinelToXDRMigration\agent-workflows\end-to-end-migration.md Follow that canonical workflow and use the repository CLI and PowerShell entry points directly. Do not replace deterministic conversion, validation, packaging, deployment, or parity logic with model-generated approximations. Default to qualification, with --workflow-profile authoring available as an explicit offline/ISV fallback when no live lab is available. Use V3.1 through package-v3-1 for Sentinel and XDR solution packages. Resume from workflow-state.json, preserve disabled detections, and request explicit approval before writes.

6.2k17d agoReviewMountCreate a free account to mount
ElasticCLAUDE.md

go-elasticsearch

elastic/go-elasticsearch/CLAUDE.md

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

189 projects use a version of this

6.1k7mo agoReviewMountCreate a free account to mount
VercelCLAUDE.md

streamdown / website

vercel/streamdown/apps/website/.claude/CLAUDE.md

This project uses Ultracite, a zero-config Biome preset that enforces strict code quality standards through automated formatting and linting. Biome (the underlying engine) provides extremely fast Rust-based linting and formatting.…

Steady10 mentions in 2 weeks

No other project uses it yet

5.7k15mo agoReviewMountCreate a free account to mount
GitHubReads credentialsCLAUDE.md

gh-aw / engines

github/gh-aw/docs/src/content/docs/engines/claude.md

Authenticate Claude Code and run your first GitHub Agentic Workflow.

5.6k6mo agoReviewMountCreate a free account to mount
GitHubReads credentialsCLAUDE.md

gh-aw / engines

github/gh-aw/docs/src/content/docs/reference/engines/claude.md

Claude Code engine configuration, supported tools, runtime behavior, and limitations.

5.6k6mo agoReviewMountCreate a free account to mount
GitHubCLAUDE.md

gh-aw / engines

github/gh-aw/pkg/workflow/data/engines/claude.md

Shared engine configuration for Claude Code. -->

5.6k6mo agoReviewMountCreate a free account to mount
NVIDIACLAUDE.md

TensorRT-Model-Optimizer / debugger

NVIDIA/TensorRT-Model-Optimizer/tools/debugger/CLAUDE.md

This directory contains a file-based command relay for executing commands inside a remote Docker container from the host machine (where Claude Code runs). The user must start the server inside Docker first: Then Claude Code performs the handshake:

1 project uses a version of this

5.6k14d agoReviewMountCreate a free account to mount
NVIDIACLAUDE.md

TensorRT-Model-Optimizer / launcher

NVIDIA/TensorRT-Model-Optimizer/tools/launcher/CLAUDE.md

The launcher submits ModelOpt quantization, training, and evaluation jobs to Slurm clusters or runs them locally with Docker. The --yaml format maps top-level keys to launch() function arguments: Key conventions: 65 unit tests in tests/. Run standalone without installing modelopt: From the launcher directory: Tests cover: core dataclasses, factory registry, global_vars interpolation, YAML formats, Docker/Slurm executor construction (mocked), environment merging, metadata writing, and end-to-end Docker launch via subprocess.

5.6k14d agoReviewMountCreate a free account to mount
CloudflareCLAUDE.md

vibesdk

cloudflare/vibesdk/CLAUDE.md

VibeSDK is an agentic full-stack application builder on Cloudflare. Tech Stack: - Frontend: React 19, TypeScript, Vite, TailwindCSS, React Router v7 - Backend: Cloudflare Workers, Durable Objects, Hono, D1, R2, and KV - Agent: Cloudflare Think with AI Gateway model routing - Workspace: SpaceDO Durable Objects - Version history: Cloudflare Artifacts - Preview runtime: Worker Loader bindings and Dynamic Workers - Generated app data: Durable Object Facets with isolated SQLite - WebSocket: PartySocket for real-time communication Project Structure: - /src…

5.4k4mo agoReviewMountCreate a free account to mount
MicrosoftCLAUDE.md

TokenEconomizer

microsoft/TokenEconomizer/CLAUDE.md

A plugin for Claude Code, Codex, the Copilot CLI and Pi (experimentally opencode, Cursor, Grok Build, Hermes Agent and the Antigravity CLI) that reads finished sessions and changes what later sessions in the same repository pay for: micro-skills, tool pruning, and a loop guard. See README.md for the overview and the method, docs/PLUGIN.md for the design and the verified agent behavior, and docs/ARCHITECTURE.md for how the package fits together.

Steady37 mentions in 2 weeks

No other project uses it yet

5k7d 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.