Architecture Review

Przegląd architektury Java na poziomie makro: układ pakietów, warstwowanie i kierunek zależności

Autor: decebals · decebals/claude-code-java

Testowano · Działa ★ 8.4/10

Architecture Review — Przegląd architektury Java na poziomie makro: układ pakietów, warstwowanie i kierunek zależności

Co robi ten skill

Przegląda bazę kodu Java na poziomie makro: organizację pakietów (według warstw vs według funkcji vs heksagonalna), kierunek zależności między warstwami, granice modułów i strukturalne antywzorce, takie jak pakiety-bogi i wycieki frameworków w domenie. Uruchamia się, gdy użytkownik prosi o przegląd architektury, sprawdzenie struktury projektu/pakietu lub ocenę zgodności z czystą/heksagonalną architekturą. Generuje tabelę ustaleń posortowanych według ważności z lokalizacjami plików i priorytetowymi rekomendacjami.

Raport z testu

Pobrano SKILL.md i README.md z repozytorium (oba HTTP 200); frontmatter ma prawidłowe name+description, a umiejętność nie odwołuje się do żadnych zewnętrznych plików skryptowych. Zbudowano mały fikcyjny projekt Java z celowo wprowadzonymi naruszeniami (encja JPA/Lombok w domenie, Spring @Service + import kontrolera wewnątrz usługi domenowej, surowy SQL w kontrolerze, pakiet-bóg util z 7 klasami) i uruchomiono przepisane przez umiejętność komendy find/grep, które poprawnie wykryły każde naruszenie. Porównano bazową recenzję w prozie z recenzją zgodną z umiejętnością: umiejętność dodała tabelę ustaleń posortowanych według ważności z lokalizacjami plik:linia, jawną klasyfikację strategii organizacji i wychwyciła Spring @Service jako odrębne ustalenie o wysokiej ważności, a także nazwała antywzorzec anemicznej domeny, który bazowy włączył lub pominął. Poprawa w stosunku do kompetentnej wersji bazowej jest rzeczywista, ale skromna, stąd wynik 6.

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

Instalacja

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.

Komendy i przykładowe prompty

/architecture-reviewPrzegląd architektury Java na poziomie makro: układ pakietów, warstwowanie i kierunek zależności

Skille uruchamiają się na zwykłe polecenia — bez komend do zapamiętania. Po instalacji aktywują go prompty takie jak te (po angielsku):

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

Pełny raport →