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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

提交前自查 diff 能发现无关改动、调试代码、格式噪声和遗漏文件，降低代码审查成本。

本地问题不一定是代码问题，排查时应检查 Node、包管理器、环境变量、端口、缓存和依赖状态。

有用日志应包含请求 ID、用户动作、模块、状态和安全参数摘要，帮助线上问题快速定位。

好 PR 描述应包含背景、改动摘要、验证证据、风险和截图或接口示例，减少来回追问。

错误堆栈包含触发点、传播路径、模块边界和最近改动的线索，阅读时要结合 import trace、源码位置和上下文，而不是在恐惧中直接关闭终端。

当旧代码缺少测试时，可以先用特征测试记录当前行为，再逐步重构内部实现。

单元测试最适合覆盖纯函数、权限、状态转换和错误映射，展示样式和普通点击不应占用主要测试预算。

修改代码前先搜索现有实现，能避免重复造轮子、误判目录边界和遗漏调用点。

好错误信息应说明发生了什么、影响范围、可能原因和下一步动作，而不只是抛出失败。

AIGC 内容系统需要把选题、生成、事实校验、人工编辑、版权检查和发布监控串起来。

数据分析平台的核心不是图表，而是指标定义、数据血缘、权限、刷新周期和自助分析边界。

内容审核系统需要把规则引擎、模型判断、人工复核、申诉和审计串成可追踪流程。

客服 AI 系统从知识推荐、话术草稿、工单摘要和质检入手，比直接自动回复更容易控制风险。

电商搜索推荐不只是召回和排序，还要处理商品数据、库存价格、用户行为、实验和可观测性。

企业 RAG 系统不只是向量检索，文档权限、版本、切分、引用和反馈闭环都会影响答案质量。

风控系统需要把实时特征、离线训练、规则策略、模型评分和审计解释串成闭环。

医疗预约分诊系统需要严格区分信息收集、风险提示、科室推荐和医生诊断边界。

物流路径优化系统需要结合订单、仓网、运力、时效、成本和运营干预，不能只输出理论最优路线。

工业质检系统要处理设备数据、图像采集、边缘推理、缺陷标注、追溯和产线反馈。

AI 助教系统要处理课程知识、学生画像、答题记录、反馈安全和教师干预，而不是让模型自由发挥。

库存预测系统需要结合销售、促销、季节、门店、供应链和人工调整，才能服务真实补货。

SaaS 权限系统要贯穿 API、缓存、队列、文件和日志，避免租户隔离只停留在表字段层面。

参与开源贡献时，先理解项目路线、issue、贡献规范、测试命令和维护者偏好，能显著提高合并率。

依赖升级不应只等安全告警，团队需要定期小步升级、阅读 changelog、运行验证并保留回滚路径。

修改开源项目时，要在内部 fork、插件扩展和上游贡献之间权衡维护成本、速度和长期兼容。

评估开源 AI 项目时，应关注模型许可证、推理成本、评测数据、部署方式、可观测性和安全边界。

开源商业化需要明确社区版、云服务、企业功能、支持服务和生态伙伴之间的边界。

开源文档要覆盖快速开始、概念解释、API 参考、迁移指南、故障排查和贡献路径。

产品团队使用开源依赖时，需要理解 MIT、Apache、GPL、AGPL 等许可证对分发、修改和商业化的影响。

开源项目长期健康依赖 issue 分类、贡献者引导、发布节奏、安全响应和决策透明。