К основному содержанию
правило CX Codex

naming-format — правило для Claude Code: Java-стиль и установка

Правило naming-format для Claude Code задаёт соглашения об именах и форматировании Java-кода. Оно охватывает классы, методы, константы и управляющие конструкции.

MIT ★ 517 обновлён 2026-11-16

Установить в Claude Code · Вручную: положить файлы Все способы и платформы ↓
.claude/rules/naming-format.md
Открыть на GitHub

Что делает naming-format

Правило задаёт имена для классов, методов, переменных, констант и пакетов. Для булевых свойств POJO оно запрещает префикс is, а для методов получения и изменения данных предписывает отдельные глагольные префиксы. Есть правила для отступов, длины строк и методов, скобок и веток switch.

Управляющие конструкции должны использовать фигурные скобки, а вложенность if-else ограничена тремя уровнями. Код с табами или методом длиннее 80 строк нарушит заданные требования. В Claude Code правило устанавливается файлом .claude/rules/naming-format.md.

Какие задачи решает

  • привести имена Java-классов и методов к заданному стилю
  • найти префикс is у булевых свойств POJO
  • проверить отступы, длину строк и оформление скобок
  • сократить глубокую вложенность if-else

Примеры запросов агенту

  • Проверь Java-код на соответствие правилу naming-format.
  • Найди в этом классе нарушения соглашений об именах и форматировании.
  • Проверь, что у каждого switch есть ветка default.

Как установить naming-format

Вручную: положить файлы

.claude/rules/naming-format.md

Поле paths во frontmatter ограничивает файлы

По шагам, с командами для каждой платформы: AGENTS.md и CLAUDE.md: что это, кто читает и какой выбрать

Вопросы о naming-format

Как установить naming-format в Claude Code?

Добавь файл правила по пути .claude/rules/naming-format.md.

Что делает naming-format?

Задаёт соглашения для имён Java-сущностей и форматирования кода. Среди прочего, правило запрещает префикс is у булевых свойств POJO и требует фигурные скобки у управляющих конструкций.

Какие требования naming-format задаёт для методов?

Имена методов должны быть в lowerCamelCase; для получения одного значения используется get, для списка — list, для подсчёта — count. Метод не должен превышать 80 строк.

Исходный текст

naming-format.md · MIT
# Naming and formatting guidelines

## Naming conventions

### Basic naming rules
**Detection mode**: semantic

| Type | Rule ID | Convention | Example | Forbidden example |
|------|--------|------|------|---------|
| Class name | MULT-NAME-003 | UpperCamelCase | `UserDO`, `HtmlUtil`, `OrderService` | `userDo`, `htmlutil` |
| Method name | MULT-NAME-004 | lowerCamelCase | `getUserById()`, `calculateTotal()` | `GetUserById()`, `calculate_total()` |
| Constant | MULT-CONST-005 | UPPER_SNAKE_CASE | `MAX_RETRY_COUNT`, `DEFAULT_TIMEOUT` | `maxRetryCount`, `Max_Retry_Count` |
| Package name | MULT-NAME-009 | all lowercase, singular | `com.example.user` | `com.example.Users`, `com.example.userMgmt` |
| Variable | MULT-NAME-004 | lowerCamelCase | `userName`, `orderList` | `user_name`, `UserName` |
| Array | MULT-NAME-007 | `String[] args` | `String[] args` | `String args[]` |

### Special naming rules
**Detection mode**: semantic

| Rule ID | Rule | Description | Example |
|--------|------|------|------|
| MULT-NAME-006 | Abstract class | Must start with Abstract or Base | `AbstractProcessor`, `BaseServiceImpl` |
| MULT-NAME-006 | Exception class | Must end with Exception | `UserNotFoundException`, `InvalidParameterException` |
| MULT-NAME-006 | Test class | Name of the class under test + Test | `UserServiceTest`, `OrderControllerTest` |
| MULT-NAME-011 | Interface implementation | Impl suffix | `UserServiceImpl`, `OrderServiceImpl` |
| MULT-NAME-017 | Domain model | DO/DTO/VO/BO suffix | `UserDO`, `UserDTO`, `UserVO`, `UserBO` |
| MULT-NAME-013 | Enum class | Enum suffix | `StatusEnum`, `TypeEnum` |

### Boolean variable naming
**Detection mode**: semantic

**Boolean properties in POJOs must not use the is prefix (MULT-NAME-008):**

```java
// Wrong: causes serialization problems
public class User {
    private Boolean isSuccess;  // Forbidden!
    private boolean isActive;   // Forbidden!
}

// Correct
public class User {
    private Boolean success;
    private boolean active;
    
    // getter methods may use the is prefix
    public boolean isSuccess() {
        return success;
    }
}
```

### Method naming conventions
**Detection mode**: semantic

| Operation | Rule ID | Naming prefix | Example |
|---------|--------|---------|------|
| Get one | MULT-NAME-014 | get | `getUserById()`, `getOrderByNo()` |
| Get many | MULT-NAME-014 | list | `listUsersByStatus()`, `listOrdersByUser()` |
| Get count | MULT-NAME-014 | count | `countActiveUsers()`, `countOrders()` |
| Insert | MULT-NAME-014 | save/insert | `saveUser()`, `insertOrder()` |
| Delete | MULT-NAME-014 | remove/delete | `removeUser()`, `deleteOrder()` |
| Update | MULT-NAME-014 | update | `updateUserStatus()`, `updateOrderAmount()` |
| Predicate | - | is/has/can | `isActive()`, `hasPermission()`, `canDelete()` |

### Constant conventions
**Detection mode**: semantic

| Rule ID | Rule | Description |
|--------|------|------|
| MULT-CONST-001 | No magic values | Undefined constants must not appear directly |
| MULT-CONST-002 | Use uppercase L for long literals | `long amount = 2L` (lowercase l is forbidden) |
| MULT-CONST-003 | Group constants by function | Do not keep all constants in one class |
| MULT-CONST-004 | Use enum for fixed ranges | Use an enum when a variable's value changes only within a fixed range |

## Code formatting conventions

### Indentation and spacing
**Detection mode**: semantic

| Rule ID | Rule | Description |
|--------|------|------|
| MULT-FMT-001 | Indentation | 4 spaces; tab characters are forbidden |
| MULT-FMT-002 | Line length | No more than 120 characters |
| MULT-FMT-181 | Operator spacing | One space on each side: `a + b`, `a == b` |
| MULT-FMT-183 | Comma spacing | One space after a comma: `func(a, b, c)` |
| MULT-FMT-181 | Parenthesis spacing | One space between if/for/while and the parenthesis: `if (condition)` |
| MULT-FMT-184 | File encoding | UTF-8, Unix line endings |

### Brace rules
**Detection mode**: semantic

```java
// Correct: opening brace on the same line, body on the next line
if (condition) {
    doSomething();
} else {
    doOther();
}

// Wrong: opening brace on a new line
if (condition)
{
    doSomething();
}
```

### Control statements
**Detection mode**: semantic

**All control statements must use braces, even for a single line (MULT-CTRL-133):**

```java
// Wrong
if (condition) doSomething();

// Correct
if (condition) {
    doSomething();
}
```

**switch must have a default branch (MULT-CTRL-132):**

```java
switch (status) {
    case Status.ACTIVE:
        return "active";
    case Status.INACTIVE:
        return "inactive";
    default:
        return "unknown";
}
```

**if-else nesting must not exceed 3 levels; use guard clauses beyond that (MULT-CTRL-134):**

```java
// Wrong: nesting too deep
if (user != null) {
    if (user.isActive()) {
        if (user.hasPermission()) {
            // ...
        }
    }
}

// Correct: guard clauses
if (user == null) {
    return;
}
if (!user.isActive()) {
    return;
}
if (!user.hasPermission()) {
    return;
}
// Normal logic
```

### Method length limit
**Detection mode**: semantic

**A single method must not exceed 80 lines in total (MULT-FMT-186):**

```java
// Correct: single responsibility, manageable length
public UserDTO convertToDTO(UserDO userDO) {
    if (userDO == null) {
        return null;
    }
    UserDTO dto = new UserDTO();
    dto.setId(userDO.getId());
    dto.setName(userDO.getName());
    dto.setStatus(userDO.getStatus());
    return dto;
}
```

© kyy-logs · MIT · kyy-logs/code-review-gate-skill

Похожие правила IDE

Все правила IDE по теме «Код-ревью и рефакторинг» →
golang-naming samber Скилл golang-naming задаёт правила имён в Go: пакеты, типы, ошибки, булевы поля и тесты. Пригодится при написании, ревью и рефакторинге кода. CX Codex +1 43 300установок go-naming cxuu Скилл go-naming для Claude Code следит за именами в Go: пакеты, типы, функции, константы, получатели. Запускается при создании новых типов, пакетов и экспортируемого API. CX Codex +1 1 300установок naming-analyzer davila7 Скилл naming-analyzer проверяет имена переменных, функций, классов и файлов на ясность, находит неточные названия и предлагает варианты по конвенциям языка. CX Codex +1 53установок enforce-rules-format zernie Скилл enforce-rules-format для Claude Code проверяет, отмечены ли правила как enforce, check или guidance, и предлагает исправления. Работает с проектами на Vigiles и файлами инструкций. CX Codex +1 433установок lsp-format-code blackwell-systems Скилл lsp-format-code для Claude Code форматирует исходные файлы или выбранные строки через языковой сервер. Запускается перед коммитом или сразу после генерации кода для выравнивания отступов. CX Codex +1 ★ 182звёзд репо brand-naming arnabbagxd Скилл brand-naming для Claude Code ведёт от брифа до списка названий бренда и их оценки. Генерирует имена или разбирает уже выбранные варианты. CX Codex +1 2 800установок

Из того же набора10

Весь набор →
baseline-java Правило baseline-java для Claude Code добавляет проверки безопасности, многопоточности и обработки исключений в Java. Агент применяет его при разборе Java-кода. CX Codex +1 ★ 517звёзд репо spring-performance Правило spring-performance для Claude Code задаёт практики Spring/JPA и оптимизации производительности. Агент применяет их при работе с Java-кодом и запросами к базе данных. CX Codex +1 ★ 517звёзд репо spring-performance Правило spring-performance для Claude Code задаёт проверки Spring/JPA и производительности. Оно помогает находить ошибки валидации, транзакциях, запросах и пакетной обработке. CX Codex +1 ★ 517звёзд репо concurrency Правило concurrency для Claude Code задаёт требования к многопоточности в Java-коде. Оно охватывает пулы потоков, блокировки, общие данные и другие источники ошибок конкурентного доступа. CX Codex +1 ★ 517звёзд репо exception-logging Правило exception-logging для Claude Code проверяет обработку исключений и логирование в коде на Java. Контролирует пустые блоки catch, вызовы SLF4J, маскирование данных и откат транзакций. CX Codex +1 ★ 517звёзд репо testing-engineering Правило testing-engineering для Claude Code задаёт требования к юнит-тестам, архитектуре проекта и зависимостям. Оно охватывает проектирование слоёв, обработку исключений и соглашения для моделей данных. CX Codex +1 ★ 517звёзд репо code-review-gate Скилл code-review-gate для Claude Code проверяет изменения в коде перед коммитом или слиянием PR. Агент собирает diff, запускает проверки и фиксирует найденные проблемы. CX Codex +1 ★ 517звёзд репо oop-collection Правило oop-collection для Claude Code задаёт требования к Java-коду с объектами и коллекциями. Оно охватывает проверки null, сравнение объектов и безопасное изменение списков. CX Codex +1 ★ 517звёзд репо

Спонсоры проекта

Компании, которые помогают держать аналитику открытой