Architecture Review

Macro-niveau Java architectuur review: pakketindeling, gelaagdheid en afhankelijkheidsrichting

Door decebals · decebals/claude-code-java

Getest · Werkt ★ 8.4/10

Architecture Review — Macro-niveau Java architectuur review: pakketindeling, gelaagdheid en afhankelijkheidsrichting

Wat het doet

Controleert een Java codebase op macro-niveau: pakketorganisatie (per-laag vs per-feature vs hexagonaal), afhankelijkheidsrichting tussen lagen, modulegrenzen, en structurele anti-patronen zoals god-pakketten en framework-lekken in het domein. Activeert wanneer de gebruiker vraagt om architectuur te beoordelen, project/pakketstructuur te controleren, of naleving van schone/hexagonale architectuur te beoordelen. Levert een op ernst gerangschikte bevindingentabel op met bestandslocaties en geprioriteerde aanbevelingen.

Testrapport

SKILL.md en README.md opgehaald uit de repo (beide HTTP 200); frontmatter heeft geldige name+description en de skill verwijst niet naar externe scriptbestanden. Een klein mock Java-project gebouwd met ingeplante overtredingen (JPA/Lombok entity in domein, Spring @Service + controller import binnen een domeinservice, ruwe SQL in de controller, een 7-klasse util god-pakket) en de voorgeschreven find/grep commando's van de skill uitgevoerd, die elke overtreding correct aan het licht brachten. Een plain-proza baseline review vergeleken met een skill-volgende review: de skill voegde een op ernst gerangschikte bevindingentabel toe met file:line locaties, een expliciete organisatie-strategie classificatie, en ving de Spring @Service op als een afzonderlijke Hoge bevinding plus benoemde het anemic-domain anti-patroon dat de baseline samenvoegde of miste. Verbetering ten opzichte van een competente baseline is reëel maar bescheiden, vandaar output 6.

Getest op: 2026-07-21 · Claude Code 2.x (agent harness)

Installatie

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.

Commando's en voorbeeldprompts

/architecture-reviewMacro-niveau Java architectuur review: pakketindeling, gelaagdheid en afhankelijkheidsrichting

Skills reageren op gewone verzoeken — geen commando's om te onthouden. Na installatie activeren prompts zoals deze de skill (in het Engels):

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

Volledig rapport (Engels) →