用途：这是“逆向工程到规格驱动开发”流程的第4步（共6步），预计耗时15分钟，前置条件为第3步已完成（.specify/目录及规格已存在），输出与路线相关的分析和实施路线图。使用前须检查.stackshift-state.json中的detection_type与route：route分greenfield（构建新应用、技术栈无关规格）与brownfield（管理已有应用、技术栈规定性规格）；detection_type分generic、monorepo-service、nx-app、turborepo-package、lerna-package。
Greenfield路线：分析规格完整性与就绪度，不分析旧代码。检查每个.specify/specs/*/spec.md中的[NEEDS CLARIFICATION]、验收标准、用户故事，标记常见歧义（UI/UX、业务规则、数据关系、非功能需求），询问目标技术栈并记入Constitution，产出以构建顺序为主的实施路线图。
Brownfield路线：识别现有代码与规格之间的差距。首选AST分析，命令为node ~/stackshift/scripts/run-ast-analysis.mjs roadmap . --format=markdown，可提供函数签名校验、桩检测、缺失参数、业务逻辑模式、测试覆盖差距、0-100%置信度与详细路线图；失败时回退/speckit.analyze（需检查.specify/scripts/bash/check-prerequisites.sh），再失败则手动分析。随后细查PARTIAL与MISSING功能、技术债，按P0-P3优先级分类，划分阶段路线图，并输出docs/gap-analysis-report.md。
限制：必须实际运行AST分析工具；文档未提供具体安装方式、收费、平台支持或效果数据，暂未提供。