Java Plugin Commands Guide

Java Plugin Commands Guide

This guide documents all commands available in the Developer Kit Java Plugin, organized by category with brief descriptions, usage, and practical examples.

Table of Contents

1. Overview
2. Code Review Commands
3. Testing Commands
4. Code Generation Commands
5. Refactoring Commands
6. Documentation Commands
7. Security Commands
8. Dependency Management Commands
9. Command Usage Guidelines
10. See Also

Overview

The Java Plugin provides specialized commands for Java and Spring Boot development, including code review, testing, code generation, refactoring, documentation, security auditing, and dependency management.

Available Commands

• Code Review: 2 commands for comprehensive code and architecture review
• Testing: 2 commands for unit and integration test generation
• Code Generation: 2 commands for CRUD and documentation generation
• Refactoring: 2 commands for class refactoring and task generation
• Security: 1 command for security auditing
• Dependency Management: 2 commands for dependency audit and upgrades

Code Review Commands

/developer-kit-java:devkit.java.code-review

Purpose: Comprehensive code review of Java/Spring Boot applications for architecture, security, performance, and best practices.

Usage:

/developer-kit-java:devkit.java.code-review [full|security|performance|architecture|testing|best-practices] [path] [options]

Common use cases:

• Before creating a pull request
• After completing a feature
• Verifying code quality
• Refactoring critical components

Examples:

# Full review of current directory
/developer-kit-java:devkit.java.code-review full

# Security-focused review
/developer-kit-java:devkit.java.code-review security src/main/java

# Performance review of specific package
/developer-kit-java:devkit.java.code-review performance src/main/java/service

/developer-kit-java:devkit.java.architect-review

Purpose: High-level architecture review of Java codebases focusing on design patterns, scalability, and architectural decisions.

Usage:

/developer-kit-java:devkit.java.architect-review [path]

Common use cases:

• Reviewing application architecture
• Validating design patterns
• Assessing scalability
• Planning refactoring efforts

Examples:

# Review architecture of entire project
/developer-kit-java:devkit.java.architect-review

# Review specific module
/developer-kit-java:devkit.java.architect-review src/main/java/com/example/orders

Testing Commands

/developer-kit-java:devkit.java.write-unit-tests

Purpose: Generate comprehensive JUnit 5 unit tests with Mockito and AssertJ patterns.

Usage:

/developer-kit-java:devkit.java.write-unit-tests [class-path]

Common use cases:

• Adding test coverage to new classes
• Improving existing test coverage
• Testing edge cases and boundary conditions
• Creating test doubles with Mockito

Examples:

# Generate tests for specific class
/developer-kit-java:devkit.java.write-unit-tests src/main/java/service/UserService.java

# Generate tests for all classes in package
/developer-kit-java:devkit.java.write-unit-tests src/main/java/repository

/developer-kit-java:devkit.java.write-integration-tests

Purpose: Generate Spring Boot integration tests using Testcontainers for complete workflow testing.

Usage:

/developer-kit-java:devkit.java.write-integration-tests [test-scope]

Common use cases:

• Testing complete workflows
• Integration testing with real databases
• API endpoint testing
• Testing Spring configurations

Examples:

# Generate integration tests for controllers
/developer-kit-java:devkit.java.write-integration-tests controllers

# Generate integration tests for repositories
/developer-kit-java:devkit.java.write-integration-tests repositories

Code Generation Commands

/developer-kit-java:devkit.java.generate-crud

Purpose: Generate complete CRUD implementation (controllers, services, DTOs) from a domain class.

Usage:

/developer-kit-java:devkit.java.generate-crud [class-path]

Common use cases:

• Rapid CRUD development
• Scaffold REST endpoints
• Generate service layer
• Create DTOs and mappers

Examples:

# Generate CRUD for entity
/developer-kit-java:devkit.java.generate-crud src/main/java/model/Product.java

# Generate CRUD with custom options
/developer-kit-java:devkit.java.generate-crud src/main/java/model/Order.java --with-validation --with-audit

/developer-kit-java:devkit.java.generate-docs

Purpose: Generate comprehensive API documentation, architecture guides, and technical manuals.

Usage:

/developer-kit-java:devkit.java.generate-docs [project-path]

Common use cases:

• API documentation from controllers
• Architecture documentation
• Technical manual generation
• Design documentation

Examples:

# Generate documentation for entire project
/developer-kit-java:devkit.java.generate-docs

# Generate API documentation
/developer-kit-java:devkit.java.generate-docs --type=api

# Generate architecture guide
/developer-kit-java:devkit.java.generate-docs --type=architecture

Refactoring Commands

/developer-kit-java:devkit.java.refactor-class

Purpose: Intelligent refactoring with Clean Architecture, DDD patterns, and Spring Boot best practices.

Usage:

/developer-kit-java:devkit.java.refactor-class [class-path] [cleanup|architecture|performance|security|testing|comprehensive]

Common use cases:

• Refactoring legacy code
• Applying clean code principles
• Implementing design patterns
• Improving testability

Examples:

# Comprehensive refactoring
/developer-kit-java:devkit.java.refactor-class src/main/java/service/LegacyService.java comprehensive

# Architecture-focused refactoring
/developer-kit-java:devkit.java.refactor-class src/main/java/controller/OrderController.java architecture

# Cleanup refactoring
/developer-kit-java:devkit.java.refactor-class src/main/java/util/DateUtil.java cleanup

/developer-kit-java:devkit.java.generate-refactoring-tasks

Purpose: Generate a prioritized list of refactoring tasks for codebase improvement.

Usage:

/developer-kit-java:devkit.java.generate-refactoring-tasks [path]

Common use cases:

• Planning refactoring efforts
• Identifying technical debt
• Prioritizing improvements
• Creating refactoring roadmap

Examples:

# Generate tasks for entire project
/developer-kit-java:devkit.java.generate-refactoring-tasks

# Generate tasks for specific package
/developer-kit-java:devkit.java.generate-refactoring-tasks src/main/java/service

Documentation Commands

Documentation commands are covered under code generation. See /developer-kit-java:devkit.java.generate-docs above.

Security Commands

/developer-kit-java:devkit.java.security-review

Purpose: Security-focused audit for Spring Boot and Jakarta EE applications covering OWASP, CVEs, and configurations.

Usage:

/developer-kit-java:devkit.java.security-review [path]

Common use cases:

• Security auditing before deployment
• Identifying OWASP vulnerabilities
• Checking for CVEs in dependencies
• Reviewing authentication/authorization

Examples:

# Full security review
/developer-kit-java:devkit.java.security-review

# Security review of specific package
/developer-kit-java:devkit.java.security-review src/main/java/security

Dependency Management Commands

/developer-kit-java:devkit.java.dependency-audit

Purpose: Comprehensive dependency audit for vulnerabilities, licenses, and update recommendations.

Usage:

/developer-kit-java:devkit.java.dependency-audit [project-path]

Common use cases:

• Checking for vulnerable dependencies
• License compliance verification
• Identifying outdated dependencies
• Dependency health assessment

Examples:

# Audit all dependencies
/developer-kit-java:devkit.java.dependency-audit

# Audit with severity filter
/developer-kit-java:devkit.java.dependency-audit --severity=critical,high

/developer-kit-java:devkit.java.upgrade-dependencies

Purpose: Upgrade dependencies with compatibility checks and conflict resolution.

Usage:

/developer-kit-java:devkit.java.upgrade-dependencies [options]

Common use cases:

• Upgrading Spring Boot version
• Updating security patches
• Keeping dependencies current
• Resolving dependency conflicts

Examples:

# Upgrade all dependencies
/developer-kit-java:devkit.java.upgrade-dependencies

# Upgrade specific dependency
/developer-kit-java:devkit.java.upgrade-dependencies --artifact=spring-boot

# Dry run to see changes
/developer-kit-java:devkit.java.upgrade-dependencies --dry-run

Command Usage Guidelines

How to Invoke Commands

Commands are invoked using the slash syntax in Claude Code:

/developer-kit-java:devkit.java.{command-name} [arguments]

Best Practices

1. Read command docs first: Each command has detailed documentation
2. Provide clear context: Give commands the information they need
3. Review output: Commands generate suggestions you should review
4. Iterate: Use command output as starting point, refine as needed
5. Test thoroughly: Especially for refactoring and dependency upgrades

Common Workflows

Feature Development Workflow

# 1. Generate CRUD for new entity
/developer-kit-java:devkit.java.generate-crud src/main/java/model/Product.java

# 2. Generate unit tests
/developer-kit-java:devkit.java.write-unit-tests src/main/java/service/ProductService.java

# 3. Generate integration tests
/developer-kit-java:devkit.java.write-integration-tests controllers

# 4. Review implementation
/developer-kit-java:devkit.java.code-review full src/main/java/product/

# 5. Security review
/developer-kit-java:devkit.java.security-review src/main/java/product/

Code Review Workflow

# 1. Run comprehensive review
/developer-kit-java:devkit.java.code-review full

# 2. Run architecture review
/developer-kit-java:devkit.java.architect-review

# 3. Run security review
/developer-kit-java:devkit.java.security-review

# 4. Address critical issues

# 5. Re-review
/developer-kit-java:devkit.java.code-review full

Refactoring Workflow

# 1. Generate refactoring tasks
/developer-kit-java:devkit.java.generate-refactoring-tasks

# 2. Review and prioritize tasks

# 3. Refactor specific classes
/developer-kit-java:devkit.java.refactor-class src/main/java/service/LegacyService.java comprehensive

# 4. Update tests
/developer-kit-java:devkit.java.write-unit-tests src/main/java/service/RefactoredService.java

# 5. Review refactored code
/developer-kit-java:devkit.java.code-review architecture

Dependency Management Workflow

# 1. Audit dependencies
/developer-kit-java:devkit.java.dependency-audit

# 2. Review vulnerabilities and licenses

# 3. Plan upgrades

# 4. Upgrade dependencies
/developer-kit-java:devkit.java.upgrade-dependencies --dry-run

# 5. Test after upgrade
# Run full test suite

# 6. Re-audit
/developer-kit-java:devkit.java.dependency-audit

Command Selection Guide

See Also

• Java Agents Guide - Java plugin agents
• Spring Boot Skills Guide - Spring Boot skills
• JUnit Test Skills Guide - JUnit testing skills
• LangChain4J Skills Guide - LangChain4J skills
• AWS Java Skills Guide - AWS Java SDK skills
• Core Command Guide - All commands across plugins