claude-commands

Repositorio de Custom Commands listos para usar con Claude Code en proyectos Java/Gradle. Complementa la serie de tutoriales en javatutoriales.com.

Comandos incluidos

Comando	Modelo	Descripción
/git:commit	Haiku	Genera y ejecuta commit con Conventional Commits a partir del staged area
/git:branch	Haiku	Crea rama con formato estándar (feature/fix/hotfix/refactor)
/git:changelog	Haiku	Genera changelog entre dos tags con secciones por tipo
/git:pr	Sonnet	Prepara descripción de PR y opcionalmente lo abre con gh CLI
/gen:service	Sonnet	Scaffolding: interfaz + implementación + DTOs + test unitario
/gen:controller	Sonnet	Controller REST con CRUD completo y documentación OpenAPI
/gen:migration	Sonnet	Migración Flyway con naming convention y rollback documentado
/gen:feature	Sonnet	Scaffolding completo: entidad + repo + servicio + controller + tests
/fix:tests	Sonnet	Corre tests, analiza fallos y los corrige distinguiendo bug vs. test obsoleto
/fix:build	Sonnet	Corre build, captura errores de compilación y los corrige en orden
/review	Opus	Code review: security | performance | architecture | all
/doc:explain	Sonnet	Explica código y genera Javadoc para clases o métodos
/doc:readme	Sonnet	Genera o actualiza el README de un módulo

Estructura

.claude/commands/
├── git/
│   ├── commit.md      → /git:commit
│   ├── branch.md      → /git:branch
│   ├── changelog.md   → /git:changelog
│   └── pr.md          → /git:pr
├── gen/
│   ├── service.md     → /gen:service
│   ├── controller.md  → /gen:controller
│   ├── migration.md   → /gen:migration
│   └── feature.md     → /gen:feature
├── fix/
│   ├── tests.md       → /fix:tests
│   └── build.md       → /fix:build
├── doc/
│   ├── explain.md     → /doc:explain
│   └── readme.md      → /doc:readme
└── review.md          → /review

Instalación

# Copia el directorio .claude/commands/ a la raíz de tu proyecto
cp -r .claude/commands/ /ruta/a/tu/proyecto/.claude/

# Verifica que están disponibles en Claude Code
# Dentro de una sesión: escribe / y verifica el autocompletado

Uso

# Git
/git:commit
/git:branch agrega rate limiting al api de pagos
/git:changelog v1.3.0 v1.4.0
/git:pr develop

# Generación de código
/gen:service Payment payments "Procesa pagos con tarjeta y PayPal"
/gen:controller User users
/gen:migration "agrega columna phone a la tabla users"
/gen:feature Order orders "Gestión completa del ciclo de vida de pedidos"

# Correcciones
/fix:tests
/fix:tests --tests "*PaymentService*"
/fix:build

# Review
/review security
/review performance
/review architecture
/review all
/review

# Documentación
/doc:explain src/main/java/com/miapp/pagos/PaymentService.java
/doc:explain src/main/java/com/miapp/pagos/PaymentService.java charge
/doc:readme src/main/java/com/miapp/pagos

Personalización

El campo model en el frontmatter de cada comando está configurado para balancear velocidad y calidad. Puedes cambiarlo:

• haiku → más rápido, más económico, ideal para tareas mecánicas
• sonnet → balance calidad/velocidad, ideal para implementación
• opus → mayor calidad, ideal para análisis complejos

Recursos

• Claude Code — Documentación oficial de Custom Commands
• Serie de tutoriales Claude Code — javatutoriales.com