只共享 contracts 往往还不够——按我目前的理解，更稳妥的做法是把 ArchUnit、japicmp、Deprecation/Sunset 头、ignore-unknown、WireMock 这些检查组合起来。本文记录 Shop Platform 里的落地方式和一些可参考资料。

在 code agent 普及的背景下，我在 Shop Platform 用 ArchUnit 作为可执行的 harness。本文结合实际实践，说明它在微服务、monorepo 与普通 repo 中的落地方式。

架构约束很难只靠 Code Review 口头约定。本文结合 Shop Platform 当前实现，整理 19 条 ArchUnit 规则、6 个 Maven Archetype、WireMock contract testing 和 API 路径版本化校验这几层工程护栏。