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 first · from page 19Worked for most · soon
ShopifyCLAUDE.md

hydrogen

Shopify/hydrogen/CLAUDE.md

Changesets track what packages need new releases and at what version bump level. They can be added via pnpm changeset add or by manually creating a markdown file with proper YAML frontmatter (either method is fine). If changes affect packages//src/* or packages/*/package.json, a changeset is required. These changesets go into Hydrogen's changelog, and are also used to generate upgrade instructions. Write the changeset as if the audience is a merchant building with Hydrogen. Any change to templates/skeleton must include a…

2.1k6mo agoDiscuss
ShopifyCLAUDE.md

hydrogen / cookbook

Shopify/hydrogen/cookbook/CLAUDE.md

The Hydrogen Cookbook transforms the skeleton template into specific scenarios through reproducible recipes. IMPORTANT: This file provides quick reference and common patterns. For comprehensive command documentation, implementation details, and additional context, read cookbook/README.md. YOU MUST validate before committing: Recipe requirements: - Step values are quoted strings: step: "1" not step: 1 (YAML coerces unquoted integers to numbers, but the Zod schema expects strings) - Every step has a description (non-null, non-empty) - Step names are unique within the same step…

2.1k6mo agoDiscuss
ShopifyCLAUDE.md

hydrogen / e2e

Shopify/hydrogen/e2e/CLAUDE.md

❌ page.waitForTimeout(1000) - Arbitrary waits (flaky) ❌ page.waitForLoadState('networkidle') - Unreliable ❌ page.waitForResponse(...) - Implementation detail ❌ page.locator('.css-class') - Fragile selectors ❌ Adding test IDs when accessibility markup would work ❌ Hardcoding dynamic store data names (e.g., collection titles from sortKey: UPDATED_AT queries) When testing homepage sections that query dynamic store data (e.g., "most recently updated collection"), assert structure rather than specific names: Only assert specific entity names when navigating to a known entity by handle (a stable identifier), e.g., /products/${KNOWN_PRODUCT.handle}.

2.1k6mo agoDiscuss
CloudflareCLAUDE.md

templates

cloudflare/templates/CLAUDE.md

This is the Cloudflare Workers Templates repository containing a collection of starter templates for building full-stack applications on the Cloudflare Workers platform. The repository is structured as a monorepo with: Each template follows a consistent structure: The repository includes a sophisticated CLI tool that: Key CLI commands used internally: Uses Turbo for coordinated builds across templates: Templates are high-quality, tangible use-case driven examples of applications built using Cloudflare Workers. They should be practical applications demonstrating technology, not sandboxed environments. Templates…

2.1k9mo agoDiscuss
AnthropicCLAUDE.md

anthropic-sdk-typescript

anthropics/anthropic-sdk-typescript/CLAUDE.md

Bundlers follow every statically-resolvable import — including lazy import('./relative/path') — and fail browser builds on node: builtins in the resulting chunks.

2.1k4mo agoDiscuss
alpic-aiCLAUDE.md

skybridge / landing

alpic-ai/skybridge/landing/CLAUDE.md

This version has breaking changes — APIs, conventions, and file structure may all differ from your training data. Read the relevant guide in node_modules/next/dist/docs/ before writing any code. Heed deprecation notices.

2.1k28d agoDiscuss
gregghCLAUDE.md

claude-code.nvim

greggh/claude-code.nvim/CLAUDE.md

Claude Code Plugin provides seamless integration between the Claude Code AI assistant and Neovim. It enables direct communication with the Claude Code CLI from within the editor, context-aware interactions, and various utilities to enhance AI-assisted development within Neovim. The plugin supports running multiple Claude Code instances, one per git repository root: Example configuration to disable multi-instance mode:

2.1k17mo agoDiscuss
arcsin1CLAUDE.md

oh-my-ppt

arcsin1/oh-my-ppt/CLAUDE.md

Oh My PPT — 本地优先的 AI 幻灯片生成与编辑工具。Electron + React + TypeScript。 不要跑 npm run lint / npm run build。

2.1k3mo agoDiscuss
agentset-aiCLAUDE.md

agentset

agentset-ai/agentset/docs/CLAUDE.md

Before writing, identify which content type you're creating: Each piece of content should target one specific user persona:

2.1k8mo agoDiscuss
LetsFGCLAUDE.md

LetsFG

LetsFG/LetsFG/CLAUDE.md

General platform context for AI agents working on this repository. LetsFG is an agent-native flight search & booking platform. This public repository contains the Python SDK, JS/TS SDK, MCP server,…

2.1k20d agoDiscuss
superglue-aiCLAUDE.md

superglue

superglue-ai/superglue/CLAUDE.md

Ports: 3000 (GraphQL), 3001 (Web), 3002 (REST API) This is the Enterprise Edition. OSS at ../superglue. EE-only code lives in ee/ subdirs: - packages/core/scheduler/ - cron scheduling - packages/core/notifications/ -…

2.1k12mo agoDiscuss
StripeCLAUDE.md

stripe-python

stripe/stripe-python/.claude/CLAUDE.md

It's ok not to put comments on/in a function if their addition wouldn't meaningfully clarify anything.

2.1k55d agoDiscuss
omnimind-aiCLAUDE.md

OmniBot

omnimind-ai/OmniBot/CLAUDE.md

OmnibotApp is an AI-powered intelligent robot assistant application for Android. It's a hybrid app combining native Android Kotlin code with Flutter UI, implementing a modular architecture with clear separation of…

2k6mo agoDiscuss
VercelCLAUDE.md

lat.md

vercel-labs/lat.md/CLAUDE.md

%% lat:begin %% # Before starting work After EVERY task, before responding to the user: This project uses lat.md to maintain a structured knowledge graph of its architecture, design decisions, and test specs in the lat.md/ directory. It is a set of cross-linked markdown files that describe what this project does and why — the domain concepts, key design decisions, business logic, and test specifications. Use it to ground your work in the actual architecture rather than guessing. Do not…

2k7d agoDiscuss
deusyuCLAUDE.md

translate-book

deusyu/translate-book/CLAUDE.md

translate-book is an agent skill for Codex, Claude Code, and OpenClaw that translates books (PDF/DOCX/EPUB) into any language using parallel subagents. Published on ClawHub as translate-book and on GitHub as deusyu/translate-book. - Python 3.12+ — the version CI runs. - Unit tests need nothing else. Every third-party import in scripts/ is guarded (try/except ImportError or function-local), so the suite runs on a bare stdlib. - The full pipeline additionally needs Calibre (ebook-convert) and Pandoc binaries, plus the pypandoc, beautifulsoup4, and…

2k26d agoDiscuss
MicrosoftCLAUDE.md

PowerApps-Samples

microsoft/PowerApps-Samples/CLAUDE.md

This repository contains sample code for Power Apps across multiple technology stacks: - component-framework/: Power Apps Component Framework (PCF) controls (~29 TypeScript/React controls) - dataverse/: Dataverse SDK samples (C#, .NET Core, Web API, Plugins) - ai-builder/: AI Builder sample data and model packages - model-driven-apps/: Model-driven app samples - portals/: Power Apps Portals samples (OAuth, Web API) - powershell/ & build-tools/: Deployment automation Each PCF control is a self-contained project with TypeScript/React frontend and MSBuild packaging. Basic Commands: Creating a…

2k9mo agoDiscuss
xu-xiangCLAUDE.md

everything-claude-code-zh

xu-xiang/everything-claude-code-zh/CLAUDE.md

本文件为 Claude Code (claude.ai/code) 在此仓库中处理代码提供指导。 这是一个 Claude Code 插件 (Plugin) —— 一个包含生产级智能体 (Agents)、技能 (Skills)、钩子 (Hooks)、命令 (Commands)、规则 (Rules) 及 MCP 配置 (MCP Configurations) 的集合。本项目为使用 Claude Code 进行软件开发提供了经受过实战检验的工作流 (Workflows)。 项目由以下核心组件组成: 请遵循 CONTRIBUTING.md 中的格式要求: - 智能体 (Agents):带有 Frontmatter (name, description, tools, model) 的 Markdown 文件 - 技能 (Skills):明确的章节划分(何时使用、工作原理、示例) - 命令 (Commands):带有描述性 Frontmatter 的 Markdown 文件 - 钩子 (Hooks):带有匹配器 (Matcher) 和钩子数组的 JSON 文件 文件命名:小写字母加连字符(例如:python-reviewer.md, tdd-workflow.md)

1.9k7mo agoDiscuss
severity1CLAUDE.md

claude-code-prompt-improver

severity1/claude-code-prompt-improver/CLAUDE.md

A declarative hook engine driven by a JSON nudge registry. One engine dispatches every hook event; each prompt-improvement capability is a data row in nudges/<EventName>/*.json, not a separate script. Adding an inject-context nudge is a single JSON file with zero Python changes. Core functionality: - One engine entry point (engine.py <EventName>) dispatched per hook event from hooks.json - Reads stdin once, runs the event's rules, merges injectcontext fragments by priority, emits one JSON object, exits 0 always - improve nudge…

1.9k8mo agoDiscuss
the-open-engineCLAUDE.md

zeroshot

the-open-engine/zeroshot/CLAUDE.md

AGENTS.md is authoritative. Follow it before this file. Do not restore the retired Node product, compatibility aliases, migration, legacy commands, dual release trains, semantic-release, or a dev branch workflow. Run the narrowest relevant checks, then the complete affected lanes:

1.9k13d agoDiscuss
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.