既有项目常见问题
关于在 established projects（既有项目）中使用 BMad Method 的高频问题，快速说明如下。
我必须先运行文档梳理工作流吗？
Section titled “我必须先运行文档梳理工作流吗？”不绝对必须，但通常强烈建议先运行 bmad-document-project，尤其当：
- 项目文档缺失或明显过时
- 新成员或智能体难以快速理解现有系统
- 你希望后续
workflow基于真实现状而不是猜测执行
如果你已有完整且最新的文档（包含 docs/index.md），并且能通过其他方式提供足够上下文，也可以跳过。
如果我忘了运行文档梳理怎么办？
Section titled “如果我忘了运行文档梳理怎么办？”可以随时补跑，不影响你继续推进当前任务。很多团队会在迭代中期或里程碑后再运行一次，用来把”代码现状”回写到文档里。
既有项目如何进入实施？
Section titled “既有项目如何进入实施？”运行 bmad-build，与新项目使用同一实施 workflow。清晰改动可以直接进入；较大工作可以提供已规划 story 及其上游产物。
它会尝试识别现有技术栈、代码模式和约定，并据此生成更贴近现状的实现方案。
如果现有代码不符合最佳实践怎么办？
Section titled “如果现有代码不符合最佳实践怎么办？”工作流会优先问你：“是否沿用当前约定？”你可以主动选择：
- 沿用：优先保持一致性，降低短期改动风险
- 升级：建立新标准，并在 tech-spec 或架构中写明迁移理由与范围
BMad Method 不会强制“立即现代化”，而是把决策权交给你。
什么时候需要增加规划？
Section titled “什么时候需要增加规划？”当任务出现以下信号时，建议在运行同一个 bmad-build 实施 workflow 前增加规划：
- 改动跨多个
epic或多个子系统 - 需要明确
architecture决策，否则容易冲突 - 涉及较大协作面、较高回归风险或复杂验收要求
如果你不确定，先让 bmad-help 判断当前阶段更稳妥的 workflow。
还有问题？ 欢迎在 GitHub Issues 或 Discord 提问。
如果你想了解这套接入方式的操作步骤，可继续阅读 How-to：既有项目 与 How-to：项目上下文。想理解统一实施 workflow，可参见 Build。