App Router 项目中，页面文件应承担路由装配和数据边界，复杂 UI 与业务逻辑要下沉到组件和功能模块。

从数据读取、组件拆分、客户端交互和缓存策略出发，理解 RSC 在真实项目里的边界设计。

状态管理的关键是作用域和生命周期，局部状态、URL 状态、服务端数据和全局状态应分开处理。

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

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

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

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

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

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

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

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

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

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

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

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

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

新开发者进入项目时，应先掌握本地运行、目录边界、验证命令、发布流程和常见故障。

好提交信息应说明为什么改、影响什么范围，并帮助后续定位历史和回滚。

稳定调试流程应先复现、收集证据、缩小范围，再做最小修复和回归验证。

Feature Flag 不只服务大项目，小团队也可以用它降低上线风险、做灰度和快速回滚。