15、架构师的沟通与文档实践指南

架构师的沟通与文档实践指南

1. 结构化沟通

架构师确保项目顺利推进的主要方式之一是通过结构化沟通，而这往往涉及会议。为使会议富有成效，拥有一套核心文档并定期审查和签字确认是个好办法。要与项目领导层合作，将此过程设为强制性的正式项目流程。通常还需要开展工作会议，共同处理这些文档。

建立定期的架构审查委员会（ARB）会议有助于保持清晰的沟通渠道和维护项目文档。鼓励领导层定期参与，以确保他们重视相关工作。同时，应邀请具有前瞻性的架构师和工程师参加。若有安全或数据架构团队，他们也是很好的合作伙伴。

ARB 会议的主要重点应围绕决策的制定、记录和沟通，这些决策要与长期和短期的成功指标保持一致。确定这些决策的适当详细程度更像是一门艺术而非科学。决策可以由 ARB 做出，也可由团队独立做出，或由团队做出后提交给 ARB 审查。记录和分享无需升级的决策，能为项目的进展提供清晰的轨迹，这在涉及多个团队时尤为关键。

以下情况的决策通常需要提交给 ARB 审查：
- 导致技术方法与原计划有重大改变，例如：
- 新的集成
- 权限结构的变更
- 购买第三方组件
- 创建可重用组件
- 导致项目直接成本或后续维护成本发生变化
- 产生可能在后期造成影响的技术债务
- 标志着项目的重要里程碑
- 为避免事后诸葛亮式的质疑和利益相关者缺席提供保障
- 不会让领导层感到乏味

一个维护良好的决策日志可以为项目的技术组件提供重要记录。一个普通团队每个冲刺周期应产生 1 - 5 个可记录的决策。

2. 文档记录

文档是架构从业者的另一