用途：为 AI 代理组织项目上下文，让代理只读取当前任务所需内容，而非加载整棵文档树。核心是把文档组织成有向无环图（DAG），索引文件作为枢纽节点，代理读索引、识别相关边、只沿这些边进入叶子文档。
四层信息流：refs/（现状，只读输入）→ kits/（必须实现什么）→ plans/（如何实现，任务图）→ impl/（已完成什么）。每层消费上一层输出，层间交叉引用构成代理遍历的 DAG 边。designs/ 是横切约束层而非第五层，项目根目录的 DESIGN.md 在各阶段被读取。
目录结构：context/ 下含 CLAUDE.md 根入口，以及 refs/、kits/、designs/、plans/、impl/ 各带 CLAUDE.md。索引文件统一用表格列出领域、文件、摘要、状态。领域默认单文件，当文件包含可独立理解的多个关注点时，改为索引文件指向子目录，原文件保留为索引以免引用断裂。
CLAUDE.md 层级：从项目根延伸到源码树，形成代码与上下文 DAG 的连接组织。代理在 src/auth/ 工作时按层级加载 project/CLAUDE.md、src/CLAUDE.md、src/auth/CLAUDE.md，后者桥接到上下文 DAG，指明应加载哪个 cavekit。设计原则为最小（源码树文件 3-10 行）、连接性、上下文相关、诚实（只写确定的映射）。
遍历方式：从根进入读 context/CLAUDE.md，选层，读索引枢纽，只读相关领域文件，按需跟随交叉引用，领域有子目录时从其根文件继续。
反向传播：源码树 CLAUDE.md 提供反向遍历，从 bug 定位到需求，判断是规格缺失、规格错误还是实现错误，规格变更后传播到 plans/ 并标记受影响任务。正向传播在 /ck:revise 时扫描源码树 CLAUDE.md 引用，标记可能受影响的模块。
引导与更新：运行 /ck:init 创建完整层级，扫描现有结构、创建目录与 CLAUDE.md 模板、创建空索引文件，若存在旧版 context/sites/ 则提供迁移；该操作幂等、非破坏性。兼容性上，命令先查 context/plans/，找不到回退 context/sites/，不自动迁移。
多仓库：共享的 Tier 1-2 用 git 子模块，Tier 3-4 每仓库独立。
限制与反模式：避免扁平文件堆、缺失 CLAUDE.md、单体文档、活跃目录中的陈旧归档、在 CLAUDE.md 中重复 cavekit 内容。具体命令、模板细节与集成方式以官方资料为准，部分内容暂未提供。