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

053-design-simple-rules — скилл для Claude Code

Скилл 053-design-simple-rules разбирает дизайн и рефакторинг Java-кода по четырём правилам Кента Бека: тесты, ясность замысла, отсутствие дублирования, минимум элементов.

Apache-2.0 172 установок ★ 465 обновлён 2026-10-21

Установить в Claude Code · Через Skills CLI (Vercel) Все способы и платформы ↓
npx skills add jabrena/plinth --skill 053-design-simple-rules -a claude-code
Открыть на GitHub

Что делает 053-design-simple-rules

Скилл ведёт разбор Java-дизайна по правилам Кента Бека и держит фиксированный порядок: сначала проходят тесты, потом ясность замысла, затем дублирование, и только в конце — минимум элементов. Ослабить раннее правило ради позднего он не даст, это прямо прописано в ограничениях.

Работа идёт в пять шагов. Агент читает references/053-design-simple-rules.md и выясняет, чем подтверждается поведение кода: тесты, проверки текущего поведения, сборка или ручные наблюдения. Дальше смотрит имена, типы, ответственности и форму API, ищет повторяющееся знание и лишь после этого убирает лишние классы, методы и параметры. В конце сравнивает варианты и называет выбранный, отвергнутые компромиссы, сигнал проверки и остаточный риск.

Файл references/053-design-simple-rules.md лежит рядом со скиллом, и без него разбор не начнётся — читать его обязательно. Процесс интерактивный, поэтому агент будет задавать вопросы по вашему коду, а не выдаст готовый вердикт.

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

  • разобрать спорный дизайн класса по правилам Кента Бека
  • выбрать между двумя вариантами рефакторинга и увидеть компромиссы
  • найти дублирование, которое прячет смысл домена
  • убрать лишние слои и параметры после того, как тесты зелёные
  • объяснить команде, почему один вариант проще другого

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

  • Прогони OrderService по простым правилам дизайна Кента Бека
  • Выбери между этими двумя вариантами рефакторинга PricingPolicy и объясни компромиссы
  • Проверь, нет ли здесь дублирования, которое мешает читать замысел

Как установить 053-design-simple-rules

1Через Skills CLI (Vercel)

npx skills add jabrena/plinth --skill 053-design-simple-rules -a claude-code

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

~/.claude/skills/053-design-simple-rules/SKILL.md

Папка скилла целиком; для одного проекта — .claude/skills/053-design-simple-rules/

По шагам, с командами для каждой платформы: Как установить скилл в Claude Code: пять способов

Вопросы о 053-design-simple-rules

Как установить 053-design-simple-rules в Claude Code?

Выполните npx skills add jabrena/plinth --skill 053-design-simple-rules -a claude-code. Скилл окажется в ~/.claude/skills/053-design-simple-rules/SKILL.md.

Что делает 053-design-simple-rules?

Разбирает дизайн и рефакторинг Java-кода по четырём правилам Кента Бека в заданном порядке. В конце сравнивает варианты и называет компромиссы, сигнал проверки и остаточный риск.

В каком порядке применяются правила?

Тесты, ясность замысла, отсутствие дублирования, минимум элементов. Ослаблять ранние правила ради поздних скилл не разрешает.

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

SKILL.md · Apache-2.0
---
name: 053-design-simple-rules
description: Use when Java design, refactoring, or implementation tradeoffs should be evaluated with Kent Beck's simple design rules, including passes the tests, reveals intention, has no duplication, and has the fewest elements. This should trigger for requests such as Apply simple design rules; Review this design with Beck's rules; Choose between these refactoring options; Keep this Java design simple. Part of Plinth Toolkit
license: Apache-2.0
metadata:
  author: Juan Antonio Breña Moral
  version: 0.19.0
---
# Simple Design Rules

Guide Java developers through Kent Beck's simple design rules when evaluating design and refactoring choices. **This is an interactive SKILL**.

**What is covered in this Skill?**

- Using tests as the first correctness boundary before design cleanup
- Revealing intention and maximizing clarity before abstraction pressure
- Reducing duplication without hiding domain meaning or worsening readability
- Treating fewer elements as the final simplification pressure after correctness, clarity, and duplication
- Comparing Java design and refactoring options with the ordered rules
- Reporting the chosen option, tradeoffs, validation signal, and remaining risk

## Constraints

Apply simple design rules in priority order, and do not optimize later rules by weakening earlier rules.

- **MUST** read `references/053-design-simple-rules.md` before applying the rules
- **MUST** evaluate the rules in this order: passes the tests, reveals intention, has no duplication, has the fewest elements
- **MUST** treat passing tests as the correctness boundary before design cleanup
- **MUST** prefer clear intention over abstraction for its own sake
- **MUST** reduce duplication only when the result preserves or improves clarity
- **MUST** consider fewer elements only after correctness, clarity, and duplication have been addressed

## When to use this skill

- Apply simple design rules
- Use Beck's simple design rules
- Review this design with simple design rules
- Choose between these refactoring options
- Keep this Java design simple
- Does this design pass the simple design rules?

## Workflow

1. **Anchor Correctness**

Read `references/053-design-simple-rules.md`, then identify the behavior under discussion and the tests, characterization checks, build checks, or manual evidence that define whether the code works.

2. **Reveal Intention**

Evaluate whether names, types, responsibilities, control flow, API shape, and test descriptions make the domain decision clear to a future maintainer.

3. **Reduce Duplication Carefully**

Find repeated knowledge, policy, mappings, validation, queries, or workflow decisions. Remove duplication only when the abstraction keeps the intent easier to understand.

4. **Minimize Elements Last**

After correctness, clarity, and duplication are handled, remove unnecessary classes, methods, parameters, branches, layers, configuration, or indirection that no longer pay for themselves.

5. **Compare Options and Report**

Compare available design or refactoring options against the ordered rules. Recommend the option that satisfies the earlier rules best, describe rejected tradeoffs, and name the verification signal.

## Reference

For detailed guidance, examples, and constraints, see [references/053-design-simple-rules.md](references/053-design-simple-rules.md).

© Juan Antonio Breña Moral · Apache-2.0 · jabrena/plinth

Похожие скиллы

Все скиллы по теме «Код-ревью и рефакторинг» →
design-patterns decebals Скилл design-patterns для Claude Code добавляет справочник Java-паттернов с шаблонами кода, помогая агенту структурировать классы при рефакторинге и проектировании архитектуры. CX Codex +1 389установок solid-principles decebals Скилл solid-principles проверяет Java-код на соответствие принципам SOLID и помогает разгрузить разросшиеся классы. Пригодится при проектировании архитектуры и ревью дизайна. CX Codex +1 408установок java-refactoring-extract-method официальный github Скилл java-refactoring-extract-method помогает выделять связные блоки из сложных Java-методов в отдельные методы. Подходит, когда нужно упростить код и сохранить его поведение. CX Codex +1 9 284установок java-refactoring-remove-parameter официальный github Скилл java-refactoring-remove-parameter помогает находить неиспользуемые или выводимые из контекста параметры Java-методов и удалять их вместе со всеми вызовами. Подходит для рефакторинга, когда важно сохранить поведение и проверить тесты. CX Codex +1 8 900установок modernize-uplift официальный Anthropic Команда modernize-uplift обновляет проект на новую версию рантайма в том же стеке без переписывания логики. Проверяет поведение через параллельный прогон тестов. CX Codex +1 ★ 47 914звёзд репо java sanjeed5 Правило задаёт агенту стиль кода Java: Google Java Style, именование, иммутабельность, Stream API и работа с ресурсами. CX Codex +1 ★ 3 589звёзд репо

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

Весь набор →
707-technologies-hexagonal-architecture Скилл 707-technologies-hexagonal-architecture помогает проверить и улучшить границы Hexagonal architecture в Java-проектах без привязки к Spring Boot, Quarkus или Micronaut. CX Codex +1 174установок 056-design-avoid-breaking-changes Скилл 056-design-avoid-breaking-changes проверяет планы, спецификации OpenSpec и код на риск несовместимости перед релизом. CX Codex +1 172установок 055-design-parallel-change Скилл 055-design-parallel-change помогает спланировать безопасную миграцию схемы базы данных, когда старая и новая версии приложения должны работать одновременно. Разбивает сложные изменения на три отдельные фазы развёртывания. CX Codex +1 172установок 052-design-hamburger-method Скилл 052-design-hamburger-method разбивает крупные фичи и задачи на вертикальные срезы по методу гамбургера. Помогает выделить минимальную работающую версию вместо горизонтальных техзадач. CX Codex +1 172установок 057-design-feature-toggles Скилл 057-design-feature-toggles для Claude Code помогает проектировать и проверять feature toggles в Java-сервисах — от kill switch до rollout и удаления старых флагов. CX Codex +1 171установок 051-design-two-steps-methods Скилл 051-design-two-steps-methods для Claude Code разбивает сложные или рискованные изменения кода на два этапа: рефакторинг без изменения логики, затем внесение нужного поведения. CX Codex +1 170установок 045-planning-azure-devops Скилл 045-planning-azure-devops помогает безопасно работать с задачами Azure Boards через консольную утилиту az. Запрашивает установку недостающих утилит и возвращает только идентификаторы карточек. CX Codex +1 168установок 811-regulations-eu-market-abuse-regulation Скилл 811-regulations-eu-market-abuse-regulation помогает разбирать Java-системы на предмет контролей EU Market Abuse Regulation, доказательств и маршрутов эскалации. CX Codex +1 166установок

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

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