我扒了 4 个 AI 编程大佬的配置文件,发现他们都藏了同一个秘密

前几天我在逛 GitHub，无意中点进了一个 agentic coding 项目。

代码没什么特别的，但我注意到根目录有个叫 CLAUDE.md 的文件。

打开一看，就几十行。

但这几十行，让我意识到——我之前用 Claude Code 的方式，可能从根上就错了。

那个"无聊"的小文件

CLAUDE.md（有些项目叫 AGENTS.md）看起来平平无奇，就是个 Markdown。

但它是 Claude Code 进入一个项目时最先读到的东西。

你给 Claude Code 发的 prompt 是临时的，而这个文件是持久的"协议"——它规定了 agent 在这个 repo 里怎么干活。

我开始好奇：那些真正用 agentic coding 出活的人，他们的 CLAUDE.md 长什么样？

于是我扒了几个公开的。

第一个发现：计划可以只写两行

Matt Pocock 是 TypeScript 社区的知名开发者。他的 AGENTS.md 里有这么一段：

## Plan Mode- Make the plan extremely concise. Sacrifice grammar for the sake of concision.- At the end of each plan, give me a list of unresolved questions to answer, if any.

就这？就这两条？

但仔细想想，这改变了整个工作模式——

计划不是长篇大论，而是快速迭代。未解决的问题必须显式列出来，卡点立刻暴露。

简洁本身就是一种约束力。

第二个发现：有人把它写成了"宪法"

ruvnet/agentic-flow 的 CLAUDE.md 画风完全不同。

一上来就是：

## 🚨 CRITICAL: CONCURRENT EXECUTION & FILE MANAGEMENT**ABSOLUTE RULES**:1. ALL operations MUST be concurrent/parallel in a single message2.**NEVER save working files, text/mds and tests to the root folder**3. ALWAYS organize files in appropriate subdirectories

还有一条黄金法则：

### ⚡ GOLDEN RULE: "1 MESSAGE = ALL RELATED OPERATIONS"

所有相关操作必须在一条消息里完成。强制批量处理 tool calls，文件放置有严格规则。

这不是建议，是命令。

适合什么场景？ 跑大型多 agent 工作流，要的是可预测性，不是灵活性。

第三个发现：好文件像一张"地图"

awesome-agentic-patterns 的 CLAUDE.md 走的是另一条路——让项目变得"可读"。

## ArchitectureThe project has a unique architecture where pattern documentation drives the entire site:1.**Pattern Files** (`patterns/*.md`): Source of truth for all patterns2.**Automated Generation**: The `scripts/build_readme.py` script:   - Scans all pattern files and extracts metadata   - Updates README.md between markers

它没有很多规则，但把项目的架构和数据流讲清楚了。

agent 不用瞎猜，几分钟就能搞懂项目全貌。

命令跟原因绑定，脆弱行为被标注出来。

第四个发现：护栏要给"出路"

agentic-coding-starter-kit 的 CLAUDE.md 像是资深工程师在做 onboarding：

### Key Points- This project uses **OpenRouter** as the AI provider, NOT direct OpenAI- Default model: `openai/gpt-5-mini` (configurable via `OPENROUTER_MODEL` env var)

注意看——它不只是说"不要用 OpenAI"，而是告诉你用什么代替。

这就是 Anthropic 官方和社区反复强调的一点：

“不许做X"的规则，必须配上"用Y代替”。

只有否定没有替代，agent 还是会瞎猜。

扒完之后，我发现的共同模式

还有一个隐藏共识：文件开头几行是 C 位。

agent 最先读到的就是这里，别把重要的东西埋在后面。

一个可以直接抄的模板

# Project Commands-<command>: <whatitdoes># Style-<rule> (with a short example)# Workflow- Plan before code- Run <testcommand>- Run <lint/typecheck># Guardrails- Don't <riskyaction>, use <safealternative># Project Map-<entryfile>-<coremodule>-<datastore>

控制在一页以内。

别踩这些坑

• • 文字墙：太长会被忽略，agentic 社区自己都这么说
• • 只有否定规则：光说"永远不要"，不给出路
• • 命令不可执行：不能直接跑 = 废话
• • 没有项目地图：agent 浪费时间瞎找

我的三条 takeaway

如果你只能做三件事：

1. 1. 记录人们实际运行的命令
2. 2. 计划步骤保持简短且强制
3. 3. 给安全替代方案，而不是只说"永远不要"

那个"无聊"的小文件，可能才是让 AI 编程效率拉满的关键。