java

What problem does it solve? When AI agents write or refactor Java code, they often produce overly clever, deeply nested, or hard-to-maintain implementations. This Skill defines a single, enforceable set of Java language-level rules so every generated class, method, and control flow stays readable, testable, and consistent with the project's conventions. ## Core Features & Use Cases - Code Design Rules: Enforces single-responsibility classes and methods, bans God Classes, limits method length, and caps control-flow and loop nesting at three levels. - Readability Constraints: Prohibits nested ternaries, show-off Stream chains, peek-based side effects, Optional abuse, magic numbers, and meaningless comments; requires full Javadoc contracts on every method. - Exception & Safety Standards: Forbids swallowing exceptions, requires preserving cause context, bans hardcoded secrets, System.out logging, and reflection used to shortcut clear code. - Use Case: When an agent is asked to add a cancel-order endpoint to a service, it applies these rules to split responsibilities across Service and Mapper classes, use enums for status, write Guard Clauses instead of nested ifs, and document every method's contract. ## Quick Start Ask the agent to write or refactor a Java class, and it will apply these Java language and code design rules to the implementation.