hexagonal-architecture-layers-java — скилл для Claude Code
Скилл hexagonal-architecture-layers-java раскладывает Java-сервис по слоям Domain, Application и Infrastructure. Нужен при создании сервиса или рефакторинге Spring-кода.
MIT 250 установок ★ 678 обновлён 2026-03-28
npx skills add Gentleman-Programming/Gentleman-Skills --skill hexagonal-architecture-layers-java -a claude-codeЧто делает 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-code2Вручную: положить файлы
~/.claude/skills/hexagonal-architecture-layers-java/SKILL.mdПапка скилла целиком; для одного проекта — .claude/skills/hexagonal-architecture-layers-java/
1Через Skills CLI (Vercel)
npx skills add Gentleman-Programming/Gentleman-Skills --skill hexagonal-architecture-layers-java -a codex2Вручную: положить файлы
.agents/skills/hexagonal-architecture-layers-java/SKILL.mdДля всех проектов — ~/.agents/skills/
1Через Skills CLI (Vercel)
npx skills add Gentleman-Programming/Gentleman-Skills --skill hexagonal-architecture-layers-java -a cursor2Вручную: положить файлы
.cursor/skills/hexagonal-architecture-layers-java/SKILL.mdCursor читает и .agents/skills/, и .claude/skills/
1GitHub CLI
gh skill install Gentleman-Programming/Gentleman-Skills community/hexagonal-architecture-layers-java/SKILL.md2Вручную: положить файлы
.github/skills/hexagonal-architecture-layers-java/SKILL.md1Через Skills CLI (Vercel)
npx skills add Gentleman-Programming/Gentleman-Skills --skill hexagonal-architecture-layers-java -a gemini-cli2Командой платформы
gemini skills install https://github.com/Gentleman-Programming/Gentleman-Skills --path community/hexagonal-architecture-layers-javaВручную: положить файлы
.devin/skills/hexagonal-architecture-layers-java/SKILL.mdСтарый путь .windsurf/skills/ тоже читается
Через Skills CLI (Vercel)
npx skills add Gentleman-Programming/Gentleman-Skills --skill hexagonal-architecture-layers-java -a opencodeClaude.ai
Упакуйте папку в zip и загрузите в Settings → Capabilities → Skills
По шагам, с командами для каждой платформы: Как установить скилл в 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