用途:用并行 mapper 智能体分析代码库,产出 .planning/codebase/ 下的 7 份结构化文档,描述代码库现状。每个 mapper 智能体负责一个关注区域并直接写入文档,编排器只接收确认,从而将上下文占用降到最低。
适用时机:绿地(brownfield)项目初始化前先建立代码库地图;初始化后随代码演进更新地图;随时刷新对代码库的理解;接手不熟悉的代码库;重大重构前了解现状;当 STATE.md 引用的代码库信息过时时。
不建议使用:尚无代码的全新项目,或少于 5 个文件的简单代码库。
用法要点:若存在 .planning/STATE.md 会加载项目上下文;执行上下文来自 {{PLATFORM_ROOT}}/get-shit-done/workflows/map-codebase.md。
成功标准:创建 .planning/codebase/ 目录;7 份文档全部由 mapper 智能体写出;文档符合模板结构;并行智能体无错误完成;用户了解后续步骤。