CLAUDE.md examples from real projects

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

Your trail

Files you open will collect here, so you can find them again.

Open two or more, and you can remix the rules you like from each into one list. Kept in this browser only.

Worked for most · soon

nicepkg Hiding risky files

nicepkgCLAUDE.md

ctxport

nicepkg/ctxport/CLAUDE.md

这是一家由独立开发者驱动的一人公司，通过 AI Agent 团队实现独角兽级别的产品能力。创始人是唯一的人类成员，担任最终决策者和产品所有者。所有其他职能由 AI Agent 团队承担。核心理念：一个人 + 世界顶级思维模型 = 一支超级团队当前处于 Day 0 — 创建阶段，尚未确定具体产品方向。所有决策应以探索和验证为优先，避免过早投入重资产。公司由 10 个 AI Agent（Subagent）组成，每个 Agent 的思维模型基于该领域公认最顶尖的专家。Agent 定义文件位于 .claude/agents/ 目录，使用 Markdown + YAML frontmatter 格式，遵循 Claude Code 自定义 Subagent 规范。四个标准流程（按需通过对话调用对应 Agent）：每个 Agent 产出的文档存放在 docs/<role>/ 目录下，<role> 对应 Agent 的职能名称：例如：CEO 产出的 PR/FAQ 文档存放在 docs/ceo/pr-faq-xxx.md，CTO 的架构决策记录存放在 docs/cto/adr-xxx.md。这是 Day 0。一切皆有可能。

6299mo agoReviewMount

nicepkgCLAUDE.md

chat2poster

nicepkg/chat2poster/CLAUDE.md

Turn AI chats into share-worthy posters. Chat2Poster converts AI chat sessions (ChatGPT / Claude / Gemini) into beautiful, export-ready PNG images. You are not writing code. You are crafting a work of art. Every pixel, every animation, every interaction should spark delight. Chat2Poster's design character:

29mo agoReviewMount

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.