Architecture Review

Makro-Ebene Java-Architekturprüfung: Paket-Layout, Schichtung und Abhängigkeitsrichtung

von decebals · decebals/claude-code-java

Getestet · Funktioniert ★ 8.4/10

Architecture Review — Makro-Ebene Java-Architekturprüfung: Paket-Layout, Schichtung und Abhängigkeitsrichtung

Was es kann

Überprüft eine Java-Codebasis auf Makroebene: Paketorganisation (nach Schicht vs. nach Feature vs. hexagonal), Abhängigkeitsrichtung zwischen Schichten, Modulgrenzen und strukturelle Anti-Patterns wie God-Packages und Framework-Lecks in der Domäne. Wird ausgelöst, wenn der Benutzer eine Architektur überprüfen, die Projekt-/Paketstruktur prüfen oder die Einhaltung einer Clean/Hexagonal-Architektur bewerten möchte. Gibt eine nach Schweregrad geordnete Tabelle mit Funden, Dateispeicherorten und priorisierten Empfehlungen aus.

Testbericht

SKILL.md und README.md aus dem Repo abgerufen (beide HTTP 200); Frontmatter hat gültigen Namen+Beschreibung und der Skill verweist auf keine externen Skriptdateien. Ein kleines Mock-Java-Projekt mit eingebauten Verstößen erstellt (JPA/Lombok-Entität in der Domäne, Spring @Service + Controller-Import innerhalb eines Domänendienstes, rohes SQL im Controller, ein 7-Klassen-Util-God-Package) und die vorgeschriebenen find/grep-Befehle des Skills ausgeführt, die jeden Verstoß korrekt aufdeckten. Eine einfache Prosa-Baseline-Review mit einer Skill-konformen Review verglichen: Der Skill fügte eine nach Schweregrad geordnete Fundtabelle mit Datei:Zeilen-Positionen, eine explizite Organisationsstrategie-Klassifizierung hinzu und erkannte den Spring @Service als einen eigenständigen High-Fund sowie das anemic-domain Anti-Pattern, das die Baseline zusammenfasste oder verpasste. Die Verbesserung gegenüber einer kompetenten Baseline ist real, aber bescheiden, daher Ausgabe 6.

Getestet am: 2026-07-21 · Claude Code 2.x (agent harness)

Installation

git clone --depth 1 https://github.com/decebals/claude-code-java.git /tmp/architecture-review-src
mkdir -p ~/.claude/skills
cp -R /tmp/architecture-review-src/.claude/skills/architecture-review ~/.claude/skills/architecture-review
# Pure-knowledge skill: no external deps, scripts, or API keys.
# The bash snippets inside SKILL.md (find/grep) are inline analysis examples, not bundled files.
# Repo ships ~20 sibling Java skills under .claude/skills/ if you want the whole set.

Befehle & Beispiel-Prompts

/architecture-reviewMakro-Ebene Java-Architekturprüfung: Paket-Layout, Schichtung und Abhängigkeitsrichtung

Skills reagieren auf normale Anfragen — keine Slash-Befehle nötig. Nach der Installation aktivieren Prompts wie diese den Skill (auf Englisch):

Review this Java project's package organization
Check if this codebase follows clean architecture
Analyze the module dependency direction in this repo

Vollständiger Testbericht (Englisch) →