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 10Worked 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::checkzeroargs / getonearg / gettwoargs / getzeroonearg / intoposonly) MUST define its parameters with a #[derive(FromArgs)] struct. Never hand-roll args.intoparts() loops — they…

8.4k26d agoDiscuss
jnMetaCodeCLAUDE.md

superpowers-zh

jnMetaCode/superpowers-zh/CLAUDE.md

停下来。做任何事之前先读这一节。 本仓库的 PR 拒绝率是 94%。被拒的 PR 里几乎每一条都是没读或没遵守本指南的 agent 提交的。维护者会在数小时内关掉劣质 PR,并经常公开评论:"This pull request is slop that's made of lies."(这个 PR 是一堆谎言堆出来的劣质内容。) 你的职责是保护你的人类伙伴免受这种结局。 提交一个低质量 PR 帮不到他们 —— 浪费维护者的时间,砸他们的口碑,PR 也照样会被关闭。这不是帮忙,这是让他们丢人。 向本仓库提 PR 之前,你必须: 任何一项检查不过,不要开 PR。向你的人类伙伴解释为什么会被拒、需要改什么。他们会感谢你帮他们避免丢脸。 每个 PR 都必须完整填写 PR 模板。 不允许任何一节留空或填占位文字。跳过 section 的 PR 会被关掉,连 review 都不会做。 开 PR 之前,你必须搜索已有 PR —— open 和 closed 都要搜 —— 找处理同一问题或相关领域的 PR。在 "Existing PRs" 一节里写清楚你找到了什么。如果之前有 PR 被关闭,具体说明你的方法和它的差异,以及为什么你这次能成功。 没有人类参与痕迹的 PR 会被关闭。 提交前必须有真人 review 完整的 proposed diff。 凡是引入对第三方项目的可选或必选依赖的 PR,除非是为新 harness(新的 IDE 或 CLI 工具)添加支持,否则不会被接受。Superpowers 在设计上是零依赖 plugin。如果你的改动需要外部工具或服务,它应该作为独立 plugin 存在。

8.2k7mo agoDiscuss
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/activateorin.sh, scripts/activatespark.sh, scripts/activatethor.sh) that exports platform-specific library paths. For dGPU, the standard source .venv/bin/activate is sufficient.

8.1k6mo agoDiscuss
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. - 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 in packages/scanner/src/matchers/ and register in matchers/index.ts. Org-specific matchers belong in a separate plugin package, not in this tree. - The AI prompt template lives in packages/processor/src/index.ts.…

8k5mo agoDiscuss
genspark-aiCLAUDE.md

genoffice

genspark-ai/genoffice/CLAUDE.md

Guidance for AI agents and human contributors working in this repo. The suite supports light / dark / system UI themes. The switching mechanism is a data-theme attribute on <html> plus CSS custom properties defined once in packages/ui/src/tokens.css (light defaults in :root, overrides in [data-theme='dark'], and a prefers-color-scheme media-query fallback for system mode). 1. UI chrome colors must use semantic tokens. Never write raw #hex / rgb() in renderer CSS rules or chrome-related inline styles — reference var(--surface), var(--text), var(--hover),…

8k54d agoDiscuss
datahaven-xyzCLAUDE.md

datahaven

datahaven-xyz/datahaven/CLAUDE.md

DataHaven is an EVM-compatible Substrate blockchain secured by EigenLayer. It bridges Ethereum and Substrate ecosystems through: - EigenLayer AVS integration for security - Snowbridge for cross-chain communication - Frontier pallets…

7.9k10mo agoDiscuss
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.5k3mo agoDiscuss
Model Context ProtocolCLAUDE.md

registry

modelcontextprotocol/registry/CLAUDE.md

Import @README.md The data/seed.json file is seed data for local development only. Do NOT create pull requests or commits that add server entries to data/seed.json as a way to publish…

7.3k52d agoDiscuss
WenyuChiouCLAUDE.md

awesome-agentic-ai-zh

WenyuChiou/awesome-agentic-ai-zh/CLAUDE.md

Standing instructions for any AI agent (Claude, Codex, Gemini) working on this repo. Read this first before touching exercises or model recommendations. This repo's role: learning roadmap + curated resources + simple illustrative cases. Benchmark for "what we are NOT": datawhalechina/hello-agents is the canonical chapter-length zh-TW depth tutorial (16 production capabilities, chapter format). We don't compete with it; we route to it. Implications when contributing: One-line summary: route → depth, not reinvent. Every exercise folder includes a visible route back…

7.2k32d agoDiscuss
grabCLAUDE.md

cursor-talk-to-figma-mcp

grab/cursor-talk-to-figma-mcp/CLAUDE.md

MCP (Model Context Protocol) server that bridges Cursor AI IDE with Figma. Three components communicate in a pipeline: There is no test suite or linter configured. The MCP config written by bun setup uses the published package: You can also add it manually for Claude Code via the CLI:

7k7mo agoDiscuss
open-multi-agentCLAUDE.md

open-multi-agent

open-multi-agent/open-multi-agent/CLAUDE.md

AGENTS.md is the canonical source for shared project instructions. Keep this file limited to Claude Code-specific compatibility notes.

7k26d agoDiscuss
BlockRunAICLAUDE.md

ClawRouter

BlockRunAI/ClawRouter/CLAUDE.md

Smart LLM router for autonomous agents. <!-- br:models.chatVisible -->79<!-- /br:models.chatVisible --> models. Two ways to pay:

6.6k28d agoDiscuss
op7418CLAUDE.md

CodePilot

op7418/CodePilot/CLAUDE.md

CodePilot — 多模型 AI Agent 桌面客户端,基于 Electron + Next.js。 架构细节见 ARCHITECTURE.md,本文件只包含规则和流程。 本项目由作者与 Claude Code、Codex 三方协作开发,分工: Claude Code 优先排查方向(Codex Runtime stop / abort 高发区): 接手 Codex Runtime 的中断 / 卡死类问题时,优先确认这四点(前两点常是同一根因——见 src/lib/stream-session-manager.ts…

6.5k3mo agoDiscuss
op7418CLAUDE.md

CodePilot

op7418/CodePilot/docs/CLAUDE.md

规则: - 检索子目录前先读对应 README.md;增删文件后更新 README.md 索引 - 纯调研放 research/;有明确分阶段步骤的放 exec-plans/active/ - 执行计划完成后移至 exec-plans/completed/ - 设计规范变更后同步更新 design.md 的 anchor implementations 表

6.5k3mo agoDiscuss
SentryCLAUDE.md

XcodeBuildMCP

getsentry/XcodeBuildMCP/CLAUDE.md

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

6.4k7d agoDiscuss
ThinkInAIXYZCLAUDE.md

deepchat

ThinkInAIXYZ/deepchat/CLAUDE.md

READ AGENTS.md

6.3k9d agoDiscuss
MengToCLAUDE.md

Skills

MengTo/Skills/CLAUDE.md

Repo: @MengTo/Skills This repo contains designer-focused AgentSkills for reusable agent workflows. Conventions: - SKILL.md should be concise + actionable. - REFERENCES.md should be links only (no big explanations). - Prefer copy/paste snippets and “when to use” triggers.

6.3k3mo agoDiscuss
czlonkowskiCLAUDE.md

n8n-skills

czlonkowski/n8n-skills/CLAUDE.md

This is the n8n-skills repository - a collection of Claude Code skills designed to teach AI assistants how to build flawless n8n workflows using the n8n-mcp MCP server. Repository: https://github.com/czlonkowski/n8n-skills Purpose: 14 complementary skills that provide expert guidance on using n8n-mcp MCP tools effectively for building n8n workflows, plus deploying the self-hosted n8n that runs them. Architecture: - n8n-mcp MCP Server: Provides data access (800+ nodes, validation, templates, workflow management) - Claude Skills: Provides expert guidance on HOW to use…

6.3k33d agoDiscuss
tradesdontlieCLAUDE.md

tradingview-mcp

tradesdontlie/tradingview-mcp/CLAUDE.md

84 tools for reading and controlling a live TradingView Desktop chart via CDP (port 9222). Use studyfilter parameter to target a specific indicator by name substring (e.g., studyfilter: "Profiler").

6.2k3mo 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.