SkillProof tested Claude skills

Architecture Review

Revisione architettura Java a livello macro: layout pacchetti, layering e direzione dipendenze

di decebals · decebals/claude-code-java

Promosso ★ 8.4/10

Architecture Review — Revisione architettura Java a livello macro: layout pacchetti, layering e direzione dipendenze

Cosa fa

Revisiona un codebase Java a livello macro: organizzazione pacchetti (per layer vs per feature vs esagonale), direzione dipendenze tra layer, confini moduli, e anti-pattern strutturali come pacchetti god e perdite di framework nel dominio. Si attiva quando l'utente chiede di revisionare l'architettura, controllare la struttura progetto/pacchetti, o valutare la conformità architettura pulita/esagonale. Emette una tabella di risultanze classificate per gravità con posizioni file e raccomandazioni prioritizzate.

Rapporto di test

Recuperati SKILL.md e README.md dal repo (entrambi HTTP 200); frontmatter ha nome+descrizione validi e la skill non fa riferimento a file di script esterni. Costruito un piccolo progetto Java mock con violazioni piantate (entità JPA/Lombok nel dominio, @Service Spring + import controller all'interno di un service di dominio, SQL grezzo nel controller, un pacchetto util di 7 classi god) ed eseguiti i comandi find/grep prescritti dalla skill, che hanno correttamente evidenziato ogni violazione. Confrontato una revisione baseline in prosa contro una revisione conforme alla skill: la skill ha aggiunto una tabella di risultanze classificate per gravità con posizioni file:riga, una classificazione esplicita della strategia organizzativa, e ha rilevato @Service Spring come distinta risultanza Alta più nominato l'anti-pattern dominio-anemico che il baseline ha raggruppato o mancato. Miglioramento rispetto a un baseline competente è reale ma modesto, quindi output 6.

Testato il: 2026-07-21 · Claude Code 2.x (agent harness)

Installazione

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.

Comandi e prompt di esempio

  • /architecture-reviewRevisione architettura Java a livello macro: layout pacchetti, layering e direzione dipendenze

Gli skill si attivano con richieste in linguaggio naturale, senza comandi da ricordare. Dopo l'installazione, prompt come questi lo attivano (in inglese):

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

Rapporto completo →