用途：分析现有代码库，借助并行 mapper 智能体各自探索一个关注领域，并把文档直接写入 .planning/codebase/。编排器只接收确认信息，从而把上下文占用降到最低。
主要能力：输出 .planning/codebase/ 目录下的 7 份结构化文档，以及 .planning/intel/ 中供智能体读取的压缩产物，包括由文档生成的 summary.md、代码扫描得到的 index.json 与 conventions.json。若存在 .planning/STATE.md，会加载项目上下文。
使用方式：该命令可在 /kata-new-project 之前运行（棕地代码库，先建立代码库地图），也可在其之后运行（绿地代码库，随代码演进更新地图），还可随时刷新对代码库的理解。执行上下文引用 @./references/project-analyze.md。
适用场景：初始化前理解棕地项目；重大变更后刷新代码库地图；熟悉陌生代码库；大规模重构前了解现状；STATE.md 中代码库信息过时时。
限制：绿地项目尚无代码时跳过；代码库过于简单（少于 5 个文件）时跳过。成功标准包括创建 .planning/codebase/ 与 .planning/intel/ 目录、由 mapper 智能体写完全部 7 份文档、文档符合模板结构、并行智能体无错误完成，并让用户知道后续步骤。