Architecture Review

Revue d'architecture Java macro-niveau : agencement des packages, couches et direction des dépendances

par decebals · decebals/claude-code-java

Testé · Fonctionne ★ 8.4/10

Architecture Review — Revue d'architecture Java macro-niveau : agencement des packages, couches et direction des dépendances

Ce que fait

Examine une base de code Java au niveau macro : organisation des packages (par couche vs par fonctionnalité vs hexagonale), direction des dépendances entre les couches, limites des modules, et anti-patterns structurels comme les packages 'god' et les fuites de framework dans le domaine. Se déclenche lorsque l'utilisateur demande d'examiner l'architecture, de vérifier la structure du projet/package, ou d'évaluer la conformité à l'architecture propre/hexagonale. Produit un tableau de résultats classés par gravité avec les emplacements de fichiers et des recommandations priorisées.

Rapport de test

Récupéré SKILL.md et README.md du dépôt (tous deux HTTP 200) ; le frontmatter a un name+description valide et la compétence ne référence aucun fichier de script externe. Construit un petit projet Java fictif avec des violations implantées (entité JPA/Lombok dans le domaine, Spring @Service + import de contrôleur à l'intérieur d'un service de domaine, SQL brut dans le contrôleur, un package util 'god' de 7 classes) et exécuté les commandes find/grep prescrites par la compétence, qui ont correctement révélé chaque violation. Comparé une revue de référence en prose simple à une revue suivant la compétence : la compétence a ajouté un tableau de résultats classés par gravité avec les emplacements fichier:ligne, une classification explicite de la stratégie d'organisation, et a détecté le Spring @Service comme une découverte distincte de gravité Élevée, en plus de nommer l'anti-pattern de domaine anémique que la référence avait regroupé ou manqué. L'amélioration par rapport à une référence compétente est réelle mais modeste, d'où une sortie de 6.

Testé le: 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.

Commandes et exemples de prompts

/architecture-reviewRevue d'architecture Java macro-niveau : agencement des packages, couches et direction des dépendances

Les skills se déclenchent sur des demandes en langage courant — aucune commande à retenir. Après installation, des prompts comme ceux-ci l'activent (en anglais) :

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

Rapport complet →