controller-expert

What problem does it solve?

This Skill streamlines the creation of REST API controllers by enforcing a "Thin Controller" pattern, CQRS separation, and strict validation rules. It prevents common API design flaws, security vulnerabilities, and ensures consistent, high-quality API development.

Core Features & Use Cases

• CQRS Controller Separation: Automatically generates distinct Command (POST, PATCH) and Query (GET) controllers, ensuring a clear separation of concerns for state changes and data retrieval.
• Robust Validation & Response Wrapping: Enforces @Valid for all request DTOs and mandates ResponseEntity<ApiResponse<T>> wrapping for consistent, predictable API responses.
• Zero-Tolerance Rules: Prohibits common anti-patterns like Lombok, direct DELETE methods (recommends PATCH for soft delete), and MockMvc for testing (enforces TestRestTemplate).
• Use Case: When implementing a new REST endpoint, activate this skill to generate the controller, DTOs, and mappers. This ensures your API adheres to all architectural and quality standards, saving you from manual boilerplate and review cycles.

Quick Start

Generate a REST API controller for a 'Product' feature, including command and query endpoints, DTOs, and mappers.