arch-verify
使用ArchUnit验证Java架构规则。在需要定义或验证Java项目中的包或层边界、依赖约束、切片或循环依赖时使用,包括在重构或添加CI构建的治理检查时。
📖 中文导读:使用ArchUnit验证Java架构规则。在需要定义或验证Java项目中的包或层边界、依赖约束、切片或循环依赖时使用,包括在重构或添加CI构建的治理检查时。 以下正文为该技能的原始 SKILL.md 内容(英文),上方安装命令可直接使用。
name: arch-verify description: Verify Java architecture rules with ArchUnit. Use when you need to define or validate package or layer boundaries, dependency constraints, slices, or cyclic dependencies in Java projects, including during refactors or when adding governance checks to CI builds.
ArchUnit Verification
Workflow
- Identify the architectural rules to enforce (layers, packages, slices, cycles, coding rules).
- Choose the test framework (JUnit 4, JUnit 5, or plain unit tests).
- Add the matching ArchUnit dependency.
- Write ArchUnit rules in test sources and run them in CI.
- Use the Maven plugin when you need cross-repo governance.
Dependencies
JUnit 4
<dependency>
<groupId>com.tngtech.archunit</groupId>
<artifactId>archunit-junit4</artifactId>
<version>1.4.1</version>
<scope>test</scope>
</dependency>
JUnit 5
<dependency>
<groupId>com.tngtech.archunit</groupId>
<artifactId>archunit-junit5</artifactId>
<version>1.4.1</version>
<scope>test</scope>
</dependency>
Other test frameworks
<dependency>
<groupId>com.tngtech.archunit</groupId>
<artifactId>archunit</artifactId>
<version>1.4.1</version>
<scope>test</scope>
</dependency>
On-demand examples
- Run
scripts/fetch-examples.shto clone examples only when needed. - Use
--dest /tmp/archunit-examplesto override the destination. - The default destination
/tmp/archunit-examplesis auto-cleaned when it already exists. - Use
--cleanto overwrite a custom destination. - Use
example-junit4,example-junit5, orexample-plainas the starting point.
Resources
- Use https://github.com/TNG/ArchUnit-Examples.git for runnable examples.
- Read
references/arch-unit-maven-plugin.mdto configure Maven-based governance. - Check https://www.archunit.org/userguide for rule APIs and patterns.
- Check https://github.com/TNG/ArchUnit for source and release notes.