让AI真正”懂”项目：文件夹结构替代复杂编排框架icm-architect

让 AI 代码助手真正「懂」你的项目——用文件夹结构替代复杂编排框架

你有没有这种感觉：Claude Code 很强，但每次新会话都要从头解释项目背景？多 Agent 框架很酷，但搭起来像在写另一个操作系统，出了问题根本不知道去哪找？

icm-architect 这个 Skill 给了一种完全不同的思路：不用加框架，用文件夹结构本身当架构。

它的方法论叫 ICM（Interpretable Context Methodology），论文发在 arXiv，MIT 协议开源。核心就一句话——编号文件夹管顺序、层级管上下文范围、Markdown 文件管状态。一个 Agent 读对的文件、对的时刻，干完活就走。人类打开任意文件夹，状态一目了然，因为状态就是文件本身。

具体怎么用？Build 模式和 Restructure 模式两种：

Build 模式：你描述工作流程，它帮你提取出天然的结构——哪些步骤有顺序依赖、哪里需要人工把关、哪些是每次都一样的工厂配置、哪些是这次才有的产出。从中选出 5 种成熟形态之一（Pipeline、Umbrella、Record library、Knowledge bundle、Context map），自动搭出最小可行的文件夹骨架。每个文件夹里有 CONTEXT.md 明确声明「我读什么、做什么、写什么」，Agent 照着执行就行。

Restructure 模式：你的老项目文件夹乱成一团？它先盘点全部文件，分类成 Catalog（路由）、Contract（步骤契约）、Factory（共享配置）、Product（产出）、Dead（归档），然后给你一张「迁移地图」，你点头了才动手。不乱删、不乱挪，尊重现有结构。

验证方式很有意思——Walk Test：一个没有任何记忆的 Agent，光靠读文件，能不能定位自己在哪、该做什么、当前状态是什么？答案是「能」，才算合格。

给谁用？

• 经常在 Claude Code 里跑多步骤流水线（研究/代码生成/报告）的开发者
• 想把团队知识库搭成「AI 友好」结构的 Tech Lead
• 受不了复杂 LangChain/LlamaIndex 编排，又想要结构化的工程师

上手超简单：克隆到 ~/.claude/skills/icm-architect/，然后对 Claude 说「ICM this」或者「帮我搭一个 X 的 workspace」。

GitHub：https://github.com/RinDig/icm-architect

作者是 RinDig，目前 404 ⭐，论文依据是 arXiv:2603.16021。趁还没爆火先收藏。

GitHub: https://github.com/RinDig/icm-architect