用途:分析现有代码库,适用于初始化前理解棕地项目、重大变更后刷新代码库地图、上手不熟悉的代码库、大规模重构前了解现状,以及 STATE.md 中代码库信息过期时。无代码的绿地项目或文件极少(少于 5 个)的简单代码库不适用。
主要能力:多个 mapper 智能体各负责一个焦点区域,直接将文档写入 .planning/codebase/,编排器只接收确认,从而保持上下文占用最小。输出包括 .planning/codebase/ 下 7 份结构化文档,以及 .planning/intel/ 下压缩的智能体可读产物(源自文档的 summary.md,加上代码扫描得到的 index.json 与 conventions.json)。
使用方式:按执行上下文引用 @./references/project-analyze.md;若存在 .planning/STATE.md 则加载项目状态。可在 /kata-new-project 之前(棕地代码库)先建代码库地图,也可在其之后(绿地代码库)随代码演进更新,或随时刷新理解。
成功标准:创建 .planning/codebase/ 与 .planning/intel/ 目录(含 summary.md、index.json、conventions.json),7 份代码库文档全部由 mapper 智能体写出并符合模板结构,并行智能体无错误完成,用户明确后续步骤。具体安装命令、平台与收费信息资料未提供。