在已有代码库中检查架构一致性（分层违规、依赖方向…

用项目图与依赖分析验证代码是否符合其声明的架构（VSA、Clean Architecture、DDD、模块化单体），输出带严重级别与修复建议的违规报告。

适用场景

解决思路

1. 确定声明的架构基线：按权威顺序读取项目的 CLAUDE.md、docs/decisions/ 中的 ADR，或直接询问用户；绝不静默推断，错误的基线会导致错误的报告。四种支持的基线及规则：Vertical Slice——功能之间不互相引用，共享代码仅通过显式共享文件夹/项目；Clean Architecture——Domain 不依赖任何东西，Application 仅依赖 Domain，Infrastructure 依赖 Application，Api 依赖 Application（绝不 Api → Infrastructure 类型，仅做装配）；DDD + Clean——Clean 规则 + 聚合只能通过根引用，跨聚合效果使用领域事件；Modular Monolith——模块之间除 *.Contracts 外无项目引用，跨模块调用通过集成事件或契约。
2. 项目级依赖方向检查（成本最低、能捕获大多数问题）：调用 get_project_graph()，将每个项目引用与基线允许的箭头对照；此处单个错误引用（如 Domain → Infrastructure）即为 CRITICAL 发现，因为它使所有下游违规成为可能。
3. 循环依赖检查：调用 detect_circular_dependencies()；循环在所有基线中都是违规，报告完整链条。
4. 命名空间级泄漏抽查：项目引用可能干净但代码仍会泄漏，探测风险边缘——get_dependency_graph(symbolName: <某个 Domain 实体>, depth: 2) 检查 Domain 类型是否引入 EF Core、HttpClient 或 Infrastructure 命名空间；find_references(symbolName: <某个模块内部类型>) 检查是否被模块外引用；detect_antipatterns() 作为支持性证据发现已知结构异味。按基线选择探测对象：Clean → 抽样 3-5 个 Domain 实体和 Application 处理器；Modular Monolith → 抽样每个模块的内部类型；VSA → 抽样两三个功能文件夹内的类型。
5. 表现层边界检查：调用 get_endpoint_map()；端点必须只位于宿主/Api 层（Clean）或所属模块内（Modular Monolith、VSA 功能文件夹）；定义在 Application 或共享项目中的端点是边界违规；任何端点上未标记的认证作为附带发现报告（深度检查转 /security-scan）。
6. 生成报告，按严重级别分类：CRITICAL——方向错误的项目引用、模块间引用、循环；HIGH——命名空间泄漏（Domain 使用 Infrastructure/EF 类型）、端点位于其层之外；MEDIUM——共享内核逻辑蔓延、通过直接成员访问绕过聚合；INFO——未标记的端点认证、值得一看的反模式命中。每个发现包含：证据（file:line）、为何违反基线、修复方式（移动代码、用接口反转、引入 contracts 项目、抛出集成事件）。主动提出立即修复 CRITICAL 项。

适用边界 · 注意事项

• 不用于选择架构——那应使用 architecture-advisor
• 不适用于没有声明架构基线的代码库（需先确定基线，否则报告会错误）