Architecture Review

Makro-úrovňová revize Java architektury: rozvržení balíčků, vrstvení a směr závislostí

od decebals · decebals/claude-code-java

Otestováno · Funguje ★ 8.4/10

Architecture Review — Makro-úrovňová revize Java architektury: rozvržení balíčků, vrstvení a směr závislostí

Co umí

Revize Java kódové báze na makro úrovni: organizace balíčků (podle vrstvy vs. podle funkce vs. hexagonální), směr závislostí mezi vrstvami, hranice modulů a strukturální anti-vzory jako god packages a úniky frameworku v doméně. Spouští se, když uživatel požádá o revizi architektury, kontrolu struktury projektu/balíčků nebo posouzení souladu s čistou/hexagonální architekturou. Vytváří tabulku zjištění seřazených podle závažnosti s umístěním souborů a prioritizovanými doporučeními.

Testovací report

Získal jsem SKILL.md a README.md z repozitáře (oba HTTP 200); frontmatter má platné name+description a skill neodkazuje na žádné externí skriptové soubory. Vytvořil jsem malý mock Java projekt s vloženými porušeními (JPA/Lombok entita v doméně, Spring @Service + import kontroleru uvnitř doménové služby, syrový SQL v kontroleru, 7-třídový util god package) a spustil předepsané find/grep příkazy skillu, které správně odhalily každé porušení. Porovnal jsem základní prozaickou recenzi s recenzí podle skillu: skill přidal tabulku zjištění seřazených podle závažnosti s umístěním souborů a řádků, explicitní klasifikaci organizační strategie a zachytil Spring @Service jako zřetelné High zjištění a pojmenoval anti-vzor anemic-domain, který základní verze zahrnula nebo minula. Zlepšení oproti kompetentní základní verzi je skutečné, ale skromné, proto výstup 6.

Testováno: 2026-07-21 · Claude Code 2.x (agent harness)

Instalace

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.

Příkazy a ukázkové prompty

  • /architecture-reviewMakro-úrovňová revize Java architektury: rozvržení balíčků, vrstvení a směr závislostí

Skilly se spouštějí běžnými požadavky — žádné příkazy k zapamatování. Po instalaci ho aktivují prompty jako tyto (anglicky):

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