easysdd-architecture

easysdd/architecture/ 是项目的"地图"——feature-design 写方案前读它定位、issue-analyze 做根因时读它理解模块边界、新人读它知道系统大致长什么样。这份地图不会自己长出来，也不会自己保持准确——有人在合适的时候起草、刷新、体检。本技能就是这三件事的统一入口。

架构文档的价值在于准、稳、可查。AI 写架构文档和查架构文档时最容易出的几种问题都直接破坏这三点：

• 凭空造系统——文档里写了 AuthManager 协调 TokenService，代码里根本没 AuthManager 这层。
• 替用户拍板架构决策——悄悄选了某种分层方式，读者以为这是既定事实。
• 把文档写成代码复述——每节都只说"这里有什么"，不说"为什么这么分"，读完和 ls -R 的信息量一样。
• 检查时"看一眼感觉没问题"——没给出具体位置证据，用户无从判断是不是真的 ok。

下面整套规则就是为了不让这几种情况发生。

共享路径与命名约定看 easysdd/reference/shared-conventions.md。 文档结构模板、check 覆盖项清单、报告格式看同目录 reference.md。

模式分流