CLAUDEmd

可以先理解为:为Claude建立项目指令兼容层

CLAUDEmd 像写给某个 AI 同事的入职手册。它告诉这个助手项目怎么工作、哪些文件先读、哪些命令常用、哪些事不能碰,让它不要每次都从零猜。

关键结构图

当前相关远处弱强

AGENTSmd 在中心,CLAUDEmd 作为一层适配器连接 Claude agent、命令和项目 specs。

CLAUDEmd 是给 Claude 类代码助手读取的项目指令文件,用来建立工具、边界和协作习惯的兼容层。

CLAUDEmd 是一种面向 Claude 等 AI coding agent 的项目指令文档。它记录项目背景、约束、命令、代码风格、数据边界和协作规则。它的边界是给特定工具建立上下文兼容,不是替代通用 AGENTS.md 或长期 specs。

StructureCLAUDEmd = 项目规则 + 工具偏好 + 禁止事项 + 协作协议

当项目会使用 Claude 或类似 agent 反复协作,并且需要它遵守本地命令、目录和安全边界时,可以添加 CLAUDEmd。

先从 AGENTS.md 或项目主规则抽取共通约束,再补充 Claude 工具环境需要知道的命令、路径和工作习惯。保持短、清楚、可执行。

一个项目在 CLAUDEmd 写明测试命令和禁止写回原始数据,Claude 在改代码前就能先跑正确的验证。

如果 CLAUDEmd 和 AGENTS.md 互相矛盾,AI 可能按不同入口做出不同决策,协作会变得不稳定。

类型:AI 工程实践 / 项目文档

事实线:AI coding agent 需要项目上下文和稳定规则才能在多轮协作中减少误解,不同工具可能读取不同约定文件。

依据:AI coding workflow、agent instruction file 实践、项目级协作经验。

边界:适合需要兼容特定 AI 工具的项目;规则仍应与项目主文档保持一致。

常见误读:不要把 CLAUDEmd 变成第二套真相源。它应该引用和贴合主 specs。