java-naming-readability
Installation
SKILL.md
Activation Contract
Load this skill when reviewing Java refactor plans for: Java naming, readability, test names.
Hard Rules
- Class names: UpperCamelCase nouns; interfaces: UpperCamelCase; methods: lowerCamelCase verbs or verb phrases; variables: lowerCamelCase; constants: UPPER_SNAKE_CASE.
- Prefer semantic test names such as
shouldExpectedBehaviorWhenCondition; acceptshould_expected_behavior_when_conditionwhen the repo consistently uses underscores. - Respect consistent existing repo style, especially test naming.
- Prefer domain terms over generic technical names.
- Avoid abbreviations unless widely understood.
- Do not propose mass renames without clear maintainability benefit.
- Preserve observable behavior; label functional changes as follow-up.
- Require evidence for every recommendation, or mark it as a hypothesis.