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

hexagonal-architecture-layers-java — скилл для Claude Code

Скилл hexagonal-architecture-layers-java раскладывает Java-сервис по слоям Domain, Application и Infrastructure. Нужен при создании сервиса или рефакторинге Spring-кода.

MIT 250 установок ★ 678 обновлён 2026-03-28

Установить в Claude Code · Через Skills CLI (Vercel) Все способы и платформы ↓
npx skills add Gentleman-Programming/Gentleman-Skills --skill hexagonal-architecture-layers-java -a claude-code
Открыть на GitHub

Что делает hexagonal-architecture-layers-java

Скилл задаёт границы hexagonal architecture для Java-сервисов. Domain хранит чистую бизнес-логику без аннотаций фреймворков, работы с базой и I/O. Application описывает use case и порты, вызывает домен и передаёт внешний ввод через эти порты.

Infrastructure реализует порты и связывает адаптеры: контроллеры, репозитории и клиенты. Внутри есть примеры модели Order, входного и выходного портов, сервиса use case и JPA-адаптера со Spring wiring. Также разобраны типичные ошибки: зависимость домена от Spring Repository или JPA-аннотаций.

Если доменный класс получает Spring-аннотации или прямой доступ к репозиторию, нарушается заданное направление зависимостей. Скилл помогает держать такие связи за пределами Domain и поддерживать несколько адаптеров, например REST с messaging или JPA с Mongo.

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

  • разложить Java-сервис по слоям Domain, Application и Infrastructure
  • выделить входные и выходные порты для use case
  • изолировать домен от Spring, JPA и I/O
  • подключить REST, messaging, JPA или Mongo через адаптеры

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

  • Разложи этот Java-сервис по слоям Domain, Application и Infrastructure.
  • Проверь, не зависит ли домен от Spring-аннотаций, JPA и прямого I/O.
  • Перепиши сохранение заказа через выходной порт и инфраструктурный адаптер.

Как установить hexagonal-architecture-layers-java

1Через Skills CLI (Vercel)

npx skills add Gentleman-Programming/Gentleman-Skills --skill hexagonal-architecture-layers-java -a claude-code

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

~/.claude/skills/hexagonal-architecture-layers-java/SKILL.md

Папка скилла целиком; для одного проекта — .claude/skills/hexagonal-architecture-layers-java/

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

Вопросы о hexagonal-architecture-layers-java

Как установить hexagonal-architecture-layers-java в Claude Code?

Выполните npx skills add Gentleman-Programming/Gentleman-Skills --skill hexagonal-architecture-layers-java -a claude-code, затем проверьте файл ~/.claude/skills/hexagonal-architecture-layers-java/SKILL.md.

Что делает hexagonal-architecture-layers-java?

Скилл задаёт разделение Java-сервиса на Domain, Application и Infrastructure, описывает порты и адаптеры и показывает анти-паттерны зависимостей.

Можно ли использовать несколько адаптеров с этим скиллом?

Да. В описании приведён подход для сочетаний REST и messaging, а также JPA и Mongo через порты и инфраструктурные адаптеры.

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

SKILL.md · MIT
---
name: hexagonal-architecture-layers-java
description: >
  Hexagonal architecture layering for Java services with strict boundaries.
  Trigger: When structuring Java apps by Domain/Application/Infrastructure, or refactoring toward clean architecture.
metadata:
  author: diegnghrmr
  version: "1.0"
---

## When to Use

Load this skill when:
- Designing a new Java service with clean, testable layers
- Refactoring Spring code to isolate the domain from frameworks
- Supporting multiple adapters (REST + messaging, JPA + Mongo)
- Enforcing dependency direction and clear module boundaries

## Critical Patterns

### Pattern 1: Domain is pure

Domain has no framework annotations, no persistence concerns, and no I/O.

### Pattern 2: Application orchestrates

Application defines use cases and ports, calling domain logic and delegating I/O to ports.

### Pattern 3: Infrastructure adapts

Infrastructure implements ports and wires adapters (controllers, repositories, clients).

## Code Examples

### Example 1: Domain model + output port

```java
package com.acme.order.domain;

public record OrderId(String value) { }

public final class Order {
  private final OrderId id;
  private final Money total;

  public Order(OrderId id, Money total) {
    this.id = id;
    this.total = total;
  }

  public OrderId id() { return id; }
  public Money total() { return total; }
}
```

```java
package com.acme.order.application.port;

import com.acme.order.domain.Order;
import com.acme.order.domain.OrderId;

public interface OrderRepositoryPort {
  OrderId nextId();
  void save(Order order);
}
```

### Example 2: Application use case + input port

```java
package com.acme.order.application.usecase;

import com.acme.order.application.port.OrderRepositoryPort;
import com.acme.order.domain.Order;
import com.acme.order.domain.OrderId;
import com.acme.order.domain.Money;

public interface PlaceOrderUseCase {
  OrderId place(Money total);
}

public final class PlaceOrderService implements PlaceOrderUseCase {
  private final OrderRepositoryPort repository;

  public PlaceOrderService(OrderRepositoryPort repository) {
    this.repository = repository;
  }

  @Override
  public OrderId place(Money total) {
    OrderId id = repository.nextId();
    Order order = new Order(id, total);
    repository.save(order);
    return id;
  }
}
```

### Example 3: Infrastructure adapter + wiring

```java
package com.acme.order.infrastructure.persistence;

import com.acme.order.application.port.OrderRepositoryPort;
import com.acme.order.domain.Order;
import com.acme.order.domain.OrderId;
import org.springframework.stereotype.Repository;

@Repository
public final class OrderJpaAdapter implements OrderRepositoryPort {
  private final SpringOrderRepository repository;
  private final OrderMapper mapper;

  public OrderJpaAdapter(SpringOrderRepository repository, OrderMapper mapper) {
    this.repository = repository;
    this.mapper = mapper;
  }

  @Override
  public OrderId nextId() {
    return new OrderId(java.util.UUID.randomUUID().toString());
  }

  @Override
  public void save(Order order) {
    repository.save(mapper.toEntity(order));
  }
}
```

## Anti-Patterns

### Don't: Put framework annotations in domain

```java
// BAD: domain tied to JPA
@jakarta.persistence.Entity
public class Order {
  @jakarta.persistence.Id
  private String id;
}
```

### Don't: Call infrastructure directly from domain

```java
// BAD: domain depends on Spring repository
public class Order {
  private final SpringOrderRepository repository;
}
```

## Quick Reference

| Task | Pattern |
|------|---------|
| Persist domain data | Define output port in application, implement in infrastructure |
| Expose use case | Define input port and service in application |
| Keep domain pure | No annotations, no I/O, no framework imports |

## Resources

- Hexagonal Architecture: https://alistair.cockburn.us/hexagonal-architecture/
- Clean Architecture: https://www.oreilly.com/library/view/clean-architecture/9780134494272/

© diegnghrmr · MIT · Gentleman-Programming/Gentleman-Skills

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

Все скиллы по теме «Бэкенд и API» →
clean-architecture giuseppe-trisciuoglio Проектирование многоуровневых Java 21+ приложений на Spring Boot 3.5+. Отделяет бизнес-логику от фреймворка через Clean Architecture, Hexagonal Architecture и Domain-Driven Design. CX Codex +1 4 200установок hexagonal-architecture affaan-m Скилл hexagonal-architecture помогает изолировать доменные правила от фреймворков, баз данных и очередей в сервисах на TypeScript, Java, Kotlin и Go. Пригодится при распутывании бизнес-логики и I/O. CX Codex +1 6 600установок architecture-patterns Seth Hobson Скилл architecture-patterns помогает спроектировать слои backend-сервиса и разделить бизнес-логику с инфраструктурой. Пригодится при создании микросервиса, рефакторинге монолита и поиске циклических зависимостей. CX Codex +1 24 144установок 707-technologies-hexagonal-architecture Juan Antonio Breña Moral Скилл 707-technologies-hexagonal-architecture помогает проверить и улучшить границы Hexagonal architecture в Java-проектах без привязки к Spring Boot, Quarkus или Micronaut. CX Codex +1 174установок architecture-review decebals Скилл architecture-review для Claude Code: макроразбор Java-проекта — структура пакетов, границы модулей, направление зависимостей и слои. Выявляет, где нарушена архитектура и что с этим делать. CX Codex +1 394установок java-software-architect-review Giuseppe Trisciuoglio Субагент java-software-architect-review проверяет архитектуру Java-проекта на соответствие Clean Architecture и DDD, а также оценивает Spring Boot. Подключайте его при проектировании или ревью архитектуры. CX Codex ★ 372звёзд репо

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

Весь набор →
java-21 Учит генерировать код на Java 21 через records, sealed-типы и виртуальные потоки. Включается при работе с иммутабельными DTO, закрытыми иерархиями и блокирующим вводом-выводом. CX Codex +1 330установок angular-architecture Скилл angular-architecture задаёт правила, куда класть компоненты Angular, как называть файлы и что менять в официальном стайлгайде. CX Codex +1 322установок pytest Добавляет шаблоны тестов на pytest: фикстуры, моки, маркеры и параметризацию. Помогает агенту писать тесты для Python-кода. CX Codex +1 291установок react-native Скилл с паттернами React Native для кроссплатформенной мобильной разработки. Включает типизированные компоненты, навигацию, стилизацию через NativeWind и управление состоянием. CX Codex +1 263установок angular-core Скилл angular-core учит агента современным паттернам Angular: standalone-компоненты, сигналы вместо хуков, zoneless-режим и встроенный control flow. CX Codex +1 230установок jira-task Скилл jira-task автоматизирует создание задач в Jira по стандарту Prowler. Генерирует структурированные баги, фичи и рефакторинги с правильными заголовками, критериями приёма и разбивкой по компонентам. CX Codex +1 217установок github-pr Скилл github-pr задаёт правила оформления пулл-реквестов по стандарту Conventional Commits и готовит вызовы gh pr create без рутины. CX Codex +1 205установок playwright Скилл для написания E2E-тестов на Playwright с паттерном Page Objects. Помогает строить тесты через исследование реального UI с MCP-инструментами, затем кодировать селекторы и проверки на основе точных данных. CX Codex +1 194установок

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

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