arch-review

Audit Java Spring Boot modules for clean architecture and modulith violations.

13|4|Updated Feb 20, 2026
One-click install
npx skills add https://github.com/OmexIT/claude-skills-pack --skill arch-review-omexit
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: arch-review
Source: https://github.com/OmexIT/claude-skills-pack/tree/main/skills/arch-review
Command: npx skills add https://github.com/OmexIT/claude-skills-pack --skill arch-review-omexit

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Architectural reviews are needed to enforce modular boundaries and detect design violations in Java codebases.

Core Features & Use Cases

  • Detects violations of dependency directions, transaction boundaries, and domain-model safety
  • Generates findings reports with severity, affected files, and remediation guidance
  • Supports a fix-plan workflow by generating ticket skeletons for remediation

Quick Start

Invoke the arch-review skill to analyze your current module or a specified module path.

Frequently Asked Questions about arch-review

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I check my Java Spring Boot module for clean architecture violations?

An architecture review detects violations of clean architecture, hexagonal boundaries, and modulith constraints in Java Spring Boot modules by analyzing dependency direction, transaction boundaries, and event publishing, then producing a findings report with severity and remediation guidance.

What is the best way to enforce hexagonal architecture boundaries in a Java codebase?

Enforcing hexagonal architecture boundaries in a Java codebase requires auditing module dependencies to ensure they point inward toward the domain. A structured architecture review detects these boundary violations and generates remediation guidance to correct dependency directions.

Does ArchUnit work with Spring Boot modulith constraints for static code analysis?

ArchUnit works with Spring Boot modulith constraints by providing static checks to validate architectural rules. An architecture review leverages ArchUnit if available, supplementing it with file-by-file analysis to detect dependency direction and transaction boundary violations.

How do I generate a fix-plan workflow for architectural code defects?

Generating a fix-plan workflow for architectural code defects requires a findings report that includes severity levels, affected files, and remediation guidance. An architecture review outputs this structured report with ticket skeletons to drive subsequent remediation tasks.

Why does my domain model have safety violations in my Java Spring module?

Domain model safety violations in Java Spring modules occur when dependencies bypass hexagonal boundaries or transaction boundaries are improperly managed. An architecture review detects these design violations through file-by-file analysis and static checks using ArchUnit.

Can I audit transaction boundaries and event publishing in a Java module automatically?

You can audit transaction boundaries and event publishing in a Java module automatically through an architecture review. It performs file-by-file analysis and applies static checks via ArchUnit to identify violations and output a structured findings report.