Architecture Review
Revisión de arquitectura Java a nivel macro: diseño de paquetes, capas y dirección de dependencias.
Probado · Funciona
Qué hace
Revisa una base de código Java a nivel macro: organización de paquetes (por capa vs por característica vs hexagonal), dirección de dependencias entre capas, límites de módulos y anti-patrones estructurales como paquetes dios y fugas de frameworks en el dominio. Se activa cuando el usuario pide revisar arquitectura, verificar estructura de proyecto/paquete, o evaluar cumplimiento de arquitectura limpia/hexagonal. Produce una tabla de hallazgos clasificados por severidad con ubicaciones de archivo y recomendaciones priorizadas.
Informe de la prueba
Obtuve SKILL.md y README.md del repositorio (ambos HTTP 200); el frontmatter tiene nombre+descripción válidos y la skill no hace referencia a archivos de script externos. Construí un pequeño proyecto Java simulado con violaciones plantadas (entidad JPA/Lombok en dominio, Spring @Service + controlador importado dentro de un servicio de dominio, SQL crudo en el controlador, un paquete utilitario de 7 clases como dios) y ejecuté los comandos find/grep prescritos por la skill, que correctamente expusieron cada violación. Comparé una revisión base en prosa simple contra una revisión que sigue la skill: la skill agregó una tabla de hallazgos clasificados por severidad con ubicaciones de archivo:línea, una clasificación explícita de estrategia de organización, y detectó el @Service de Spring como una hallazgo Alto distinto además de nombrar el anti-patrón de dominio anémico que la línea base aglutinó o se perdió. La mejora sobre una línea base competente es real pero modesta, de ahí la salida 6.
Probado el: 2026-07-21 · Claude Code 2.x (agent harness)
Instalación
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.
Comandos y prompts de ejemplo
/architecture-reviewRevisión de arquitectura Java a nivel macro: diseño de paquetes, capas y dirección de dependencias.
Los skills se activan con peticiones en lenguaje natural, sin comandos que memorizar. Tras instalarlo, prompts como estos lo activan (en inglés):
Review this Java project's package organizationCheck if this codebase follows clean architectureAnalyze the module dependency direction in this repo