ACW 参考结构， 让上下文成为可维护的工程对象。

AI 从哪里进入？

提供工作区路由、必要约束和索引，不复制所有正文，避免上下文膨胀。

长期事实是什么？

保存稳定且可刷新的背景知识。它是事实缓存，不是不可变档案。

协作必须遵守什么？

保存原则、工作流、流程轻重、文档规则和长期记忆机制。

当前工作进行到哪一步？

保存任务状态、上下文、决策、检查证据和归档记录；实际交付物只保存引用。

实际交付物在哪里？

每个子目录是一个独立工作单元，可以是代码工程、文档集、数据集、设计稿或内容项目。

AI 可以执行什么？

提供初始化、任务执行、动作探测、背景刷新、Review 和归档等能力入口。

入口：只负责路由

适合放入工作区目标、各部分位置、必须遵守的硬约束和当前活跃任务指引。不应放入全部背景正文、临时任务细节和长篇规范。

维护方式：目录结构或约定变化时同步更新，始终保持简短。

长期事实缓存

适合放入产品定位、架构事实、技术栈、历史决策和外部约定。不应放入临时状态、单次任务过程和未经确认的推测。

维护方式：事实变化时更新唯一权威版本，保留来源与适用时间。

长期约定与规则

适合放入协作原则、工作流、命名与文档规则、验收标准和流程轻重判断。不应放入一次性的执行指令。

维护方式：确认后统一修改，避免多个版本并存造成判断冲突。

任务上下文与证据

适合放入当前任务目标、已完成事项、待办、决策记录、检查证据和归档摘要。不应放入最终交付物正文。

维护方式：任务结束后只沉淀必要内容，区分已确认结论与待确认问题。

工作单元与交付物

适合放入代码、文档集、数据集、设计稿和内容项目。不应放入背景与规则的权威版本。

维护方式：每个子目录独立演进，过程记录只引用这里的位置。

可调用的能力入口

适合放入初始化、任务执行、动作探测、背景刷新、Review 和归档等可调用工作流。不应放入普通说明文档。

维护方式：能力变更时同步入口描述，保证可发现、可调用。

资料变化时更新权威位置

同一条规则只保留一个权威版本，旧版本明确标为历史，而不是不断追加互相矛盾的新说明。

区分已确认与待确认

把临时猜测留在过程记录中，避免它们在下一次工作中被当成既定事实。

定期备份与访问边界

不要在共享工作区存放凭据和未经授权的资料；本地保存也不等于本地处理。

把所有正文塞进入口

入口一旦变成全文，就失去了路由作用，也更容易随资料膨胀而失真。

背景与约定混放

事实和规则用途不同，混放后既难更新，也难判断哪一条应当优先。

过程与交付物重复维护

过程记录只引用交付物位置，避免同一内容出现两个版本。

只建目录，不验证读取

结构建好后必须用新会话检查 AI 是否真的读到、用对，而不是对照目录自我确认。

目录名称必须完全一致吗？

不必。这套命名是参考模板，不是强制标准；关键是每类资料回答的问题保持清晰。

可以先只用一个目录吗？

可以从小处开始。先保存已经反复使用的资料，再根据实际困难补结构，不必为目录完整而制造空文档。

结构和知识库是什么关系？

知识库可以成为工作区的资料来源；参考结构进一步规定每类上下文如何被路由、执行和归档。

一个人也需要这套结构吗？

它服务的是长期 AI 协作，而不是团队规模。个人做长期项目时，同样会遇到背景散落和会话失忆。