用途：maestro-next 是 maestro-flow 的单步推荐引擎，把用户意图路由到最合适的下一步，并附带辅助工具。它只从 prepare/ 与 workflows/ 中注册的 15 个一线步骤里挑选候选，流水线编排器（maestro、maestro-ralph*）永不进入候选池。
主要能力与用法：常用参数包括 -y/--yes 跳过确认直接执行首选、--dry-run 只展示建议不执行、--top N 展示前 N 个候选（默认 3）、--list 按工作流集群列出全部可用步骤、--suggest 仅建议并准备内容但不自动执行、--note <text> 追加结构化笔记、--promote 交互式把运行洞察提升到 spec/knowhow、--lite 强制轻量伴随通道、--run 强制标准通道。模式判定优先级为 --note、--promote、--lite、--suggest、--list，有意图文本则走状态推断，无参数则根据生命周期推断自然的下一步。
执行标准步骤的流程：先用 maestro run prepare --platform codex <step> --workflow-root . 获取前置思考内容，再由模型生成 prep YAML，随后用 maestro run create <step> --session YYYYMMDD-<step>-<topic> --intent "<short goal>" --workflow-root . 创建运行，接着用 maestro run brief --platform codex <run_id> --workflow-root . 加载执行手册并执行，最后 maestro run complete <run_id> --workflow-root .
适用场景：根据项目状态推断生命周期位置（brainstorm、analyze、roadmap、plan、execute、review、auto-test、debug 等）并推荐自然下一步；也支持按关键词把 brainstorm、blueprint、analyze、plan、execute、verify、debug、review、test、auto-test、roadmap、quick、retrospective、grill、collab 等意图路由到对应步骤。复杂路由时优先标准通道而非轻量通道，不确定时创建运行。
限制：错误码中 E001 表示澄清后意图仍为空，需提供意图或使用 --list；E002 表示注册表无步骤；E003 表示步骤缺少 prepare/workflow 文件；W001 为前两名分数接近时强制展示前 3；W002 为无良好匹配时建议使用 /maestro 或 /maestro-ralph。其余收费、平台细节暂未提供。