API 演进需要兼顾新需求和旧客户端，版本策略应覆盖字段兼容、错误码、弃用和监控。

Feature Flag 不只是产品实验工具，也能帮助架构改造分阶段发布、灰度验证和快速回滚。

架构评审应围绕目标、边界、数据流、故障路径、验证证据和演进成本展开。

数据所有权不清会造成跨模块耦合，架构设计需要明确读写边界、派生数据和同步策略。

事件能降低同步耦合，也会带来一致性、顺序、重试和可观测性问题，需要明确适用边界。

好的模块边界能降低协作成本，让数据、依赖和职责在系统中有清楚归属。

单体系统演进时，优先拆清模块边界、数据所有权和发布验证，再考虑服务拆分。

多租户系统要在数据隔离、权限边界、配置模型、计费和运维成本之间做明确取舍。

架构设计应提前考虑日志、指标、Trace、业务事件和告警，让系统上线后能被理解。

服务调用失败不可避免，系统需要用超时、重试、熔断和降级控制故障扩散。

ADR 的价值不是补文档，而是记录关键架构选择的背景、约束、备选方案和后续影响。

一份有用的系统设计文档应覆盖目标、非目标、架构图、数据流、失败路径、验证和发布计划。

技术债治理不能只靠重构口号，需要按风险、影响面、依赖和验证方式拆成可交付路线图。