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; accept should_expected_behavior_when_condition when 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.

Decision Gates

Installs
3
First Seen
Jul 12, 2026
java-naming-readability — andresnator/agents-orchestrator