arch-check 用于验证代码是否仍符合其声称的架构,防止架构因零散合理的改动而腐化,例如 Domain 项目引入 EF Core、模块访问同级模块内部类型、端点定义在宿主之外。它基于项目图与依赖分析而非逐文件阅读,输出违规报告(含严重级别、file:line 证据与具体修复),或给出清洁的一致性通过结果。适用于“check my architecture”“are there layer violations”等场景,发布前或大型功能落地后、接手声称某架构的陌生代码库、多人向共享模块合并的团队,也可周期运行。不用于选择架构,选择架构应使用 architecture-advisor。
使用方式:第一步建立声明架构,按权威顺序取自项目 CLAUDE.md、docs/decisions/ 中的 ADR 或询问用户,不静默推断。支持四种基线及规则:Vertical Slice 特性不引用同级特性,共享代码仅通过显式共享文件夹/项目;Clean Architecture 的 Domain 不依赖任何项,Application 仅依赖 Domain,Infrastructure 依赖 Application,Api 依赖 Application(不依赖 Infrastructure 类型,仅做装配);DDD + Clean 在 Clean 规则上加聚合仅通过根引用、跨聚合影响使用领域事件;Modular Monolith 模块间除 *.Contracts 外无项目引用,跨模块调用通过集成事件或契约。
第二步用 get_project_graph() 检查项目级依赖方向,与基线允许的箭头逐一比对,Domain→Infrastructure 这类错误引用记为 CRITICAL。第三步用 detect_circular_dependencies() 检查循环,任何基线中循环都属违规,需报告完整链路。第四步做命名空间级泄漏抽查,用 get_dependency_graph(symbolName, depth) 查看 Domain 实体是否引入 EF Core、HttpClient 或 Infrastructure 命名空间,用 find_references 检查模块内部类型是否被模块外引用,并可用 detect_antipatterns 作为辅助证据;按基线抽样,如 Clean 抽 3-5 个 Domain 实体与 Application 处理器。第五步用 get_endpoint_map() 检查展示边界,端点只能位于宿主/Api 层(Clean)或所属模块内(Modular Monolith、VSA 特性文件夹),Application 或共享项目中的端点属边界违规;未标记的端点鉴权作为附带发现,深度处理交给 /security-scan。第六步报告,按 CRITICAL(错误方向项目引用、模块间引用、循环)、HIGH(命名空间泄漏、端点越层)、MEDIUM(共享内核逻辑蔓延、绕过聚合直接访问成员)、INFO(未标记鉴权、反模式命中)分级,每条给出证据、违规原因与修复方式,并可提议立即修复 CRITICAL 项。
使用的 MCP 工具包括 get_project_graph、detect_circular_dependencies、get_dependency_graph、find_references、get_endpoint_map、detect_antipatterns。相关项有 architecture-advisor、各架构模板及 /security-scan、/health-check。限制:需先有明确的声明架构基线,否则报告不可靠;其它收费、平台、效果等信息暂未提供。