easysdd-architecture-gen

easysdd/architecture/ 是项目的"地图"——feature-design 写方案前读它定位，issue-analyze 做根因时读它理解模块边界，新人读它知道系统大致长什么样。但这份地图不会自己长出来：需要有人在合适的时候把脑子里 / 代码里隐含的结构沉淀成文字。本技能就是专门干这件事的。

地图的价值在于准、稳、可查。AI 写架构文档最常翻的几种车都直接砸这三点：

• 凭空造系统——文档里写了 AuthManager 协调 TokenService，代码里根本没 AuthManager 这层。
• 替用户拍板架构决策——悄悄选了某种分层方式，读者以为这是既定事实。
• 把文档写成代码复述——每节都只说"这里有什么"，不说"为什么这么分"，读完和 ls -R 的信息量一样。

下面整套规则都是为了让这三种车开不起来。

共享路径与命名约定看 easysdd/reference/shared-conventions.md。

适用场景