这套结构化方案帮Claude Code避免Agent上下文膨胀

分享一套由架构师 Brij Kishore Pandey 提出的标准， 是目前避免 Agent 上下文膨胀最优雅的工程解法。

90% 的人都把 CLAUDE.md 当成普通的提示词文件，难怪你的 AI 永远像个乱改代码的弱智实习生： 把代码规范、API 格式、业务逻辑全往根目录死命塞， 模型还没动工，注意力就被几千行无用说明给稀释光了。

想让 Claude Code 真正变成常驻在你代码库里的资深架构师， 你需要的不是写更长的 Prompt，而是这套把上下文物理切开的项目解剖学：

1️⃣ 根目录只放极简骨架（四维契约）: 只写系统是做什么的目标、文件在哪的地图、允许禁止什么的死规则，以及怎么完成任务的工作流，绝不堆砌具体代码；

2️⃣ 业务上下文下沉到子目录： 很多人不知道 Claude 会自动读取子目录的独立记忆，在 src/api 和持久化目录下分别建局部 CLAUDE.md，模型钻进哪个模块才读哪份手册；

3️⃣ 工作流封装进 .claude/skills: 代码审查、重构、发布流程不要每次口头重打，全部固化成可复用技能，用完即走；

4️⃣ 刚性护栏交给 .claude/hooks: 关键改动前强制触发自动化检查，不符合规范直接代码级打回，绝不靠模型的自觉。

提示词做减法，工程结构做加法， 保持上下文的最小化与精确性，模型才能在你的代码库里大杀四方。 你现在的项目根目录，还塞着一份几千字的大杂烩提示词吗？

附上这套模块化仓库结构的最小落地模板（建议转推收藏备用）：

1. 根目录 CLAUDE.md 模板（控制在 100 行内）：
- ## System Overview：用两句话说清系统定位与技术栈；
- ## Codebase Map：标明核心模块目录与职责入口；
- ## Absolute Constraints：列出绝对禁止的库、设计反模式与安全红线；
- ## Common Workflows：指向具体的触发命令。

2. 子目录分流：在数据层、业务层各自放置微型 CLAUDE.md，专门交代该目录下的数据 Schema 与调用约定，实现“模型走到哪，上下文加载到哪”；

3. 规范自动化：架构决策记录在 docs/ 方便溯源，重复动作做成 SKILL.md，安全校验用 Hook 兜底。