agentleFS
Sign inSign up

CLAUDE.md examples from real projects

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

Most stars firstWorked for most · soon
VercelCLAUDE.md

next.js

vercel/next.js/.github/CLAUDE.md

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

143k5mo agoDiscuss
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.…

5.7k14mo agoDiscuss
VercelCLAUDE.md

ai-elements

vercel/ai-elements/.claude/CLAUDE.md

This project uses Ultracite, a zero-config preset that enforces strict code quality standards through automated formatting and linting. Oxlint + Oxfmt (the underlying engine) provides robust linting and formatting. Most…

2.4k8mo agoDiscuss
VercelCLAUDE.md

next-devtools-mcp

vercel/next-devtools-mcp/CLAUDE.md

This is an MCP (Model Context Protocol) server that acts as a thin connector between AI coding assistants and a running Next.js dev server. It discovers running Next.js 16+ dev…

82312mo agoDiscuss
VercelCLAUDE.md

flags / vercel-flags-core

vercel/flags/packages/vercel-flags-core/CLAUDE.md

Core feature flag evaluation engine for Vercel. Handles flag evaluation, real-time updates via streaming, and usage tracking. Main interface for interacting with flags:

62436d agoDiscuss
VercelCLAUDE.md

vercel-plugin

vercel/vercel-plugin/CLAUDE.md

Run bun run build:hooks after editing any .mts file. A pre-commit hook auto-compiles when .mts files are staged. Run bun run build:from-skills after editing any skill referenced by a .md.tmpl…

29049d agoDiscuss
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…

465mo agoDiscuss
VercelCLAUDE.md

acp-handler

vercel/acp-handler/CLAUDE.md

This is acp-handler, a TypeScript SDK for implementing the Agentic Commerce Protocol (ACP). It enables web applications to handle checkout requests from AI agents like ChatGPT with built-in idempotency, signature verification, and OpenTelemetry tracing support. Package Manager: pnpm (v10.16.1) src/checkout/handlers.ts - Core business logic - Implements 5 ACP endpoints: create, update, complete, cancel, get - Orchestrates Products, Payments, and Webhooks handlers (user-provided) - All POST operations wrapped with withIdempotency() to prevent double-charging - Optional signature verification via checkSignature() - OpenTelemetry…

2912mo agoDiscuss

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.