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

707-technologies-hexagonal-architecture — скилл для Claude Code

Скилл 707-technologies-hexagonal-architecture помогает проверить и улучшить границы Hexagonal architecture в Java-проектах без привязки к Spring Boot, Quarkus или Micronaut.

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

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

Что делает 707-technologies-hexagonal-architecture

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

Анализирует структуру пакетов, импорты, Maven-модули и предлагает конкретные шаги, чтобы исправить нарушения границ. Если в проекте уже используется ArchUnit, подскажет, как добавить правила для проверки архитектуры. Для добавления зависимостей Maven рекомендует делегировать задачу скиллу 111-java-maven-dependencies, для runtime-конфигурации Spring Boot или других фреймворков — обратиться к соответствующему скиллу фреймворка.

Скилл не требует, чтобы вы уже использовали ArchUnit или какие-то тесты; архитектурный обзор работает и без них. Каждое предложение опирается на конкретные классы, импорты и пакеты в вашем коде.

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

  • Проверить, что домен не зависит от фреймворка и инфраструктуры
  • Выявить нарушения зависимостей между портами и адаптерами
  • Убедиться, что приложение координирует логику через порты, а не напрямую через адаптеры
  • Добавить ArchUnit-тесты для контроля архитектурных границ
  • Исправить утечки инфраструктурного кода в доменные пакеты

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

  • Проверь Hexagonal architecture границы в моём Java-проекте
  • Найди утечки инфраструктуры в доменный код и предложи исправления
  • Добавь ArchUnit-правила для контроля зависимостей между портами и адаптерами

Как установить 707-technologies-hexagonal-architecture

1Через Skills CLI (Vercel)

npx skills add jabrena/plinth --skill 707-technologies-hexagonal-architecture -a claude-code

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

~/.claude/skills/707-technologies-hexagonal-architecture/SKILL.md

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

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

Вопросы о 707-technologies-hexagonal-architecture

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

Выполни npx skills add jabrena/plinth --skill 707-technologies-hexagonal-architecture -a claude-code, затем открой файл ~/.claude/skills/707-technologies-hexagonal-architecture/SKILL.md.

Что делает скилл 707-technologies-hexagonal-architecture?

Анализирует архитектуру Java-проектов на предмет нарушений Hexagonal architecture: проверяет, что домен независим от фреймворков и инфраструктуры, адаптеры зависят от ядра, и нет утечек между слоями. Предлагает конкретные исправления.

Нужно ли уже использовать ArchUnit для работы со скиллом?

Нет. Скилл работает с любым Java-проектом и сначала проверяет текущую архитектуру через анализ пакетов и импортов. Если проект готов, скилл подскажет, как добавить ArchUnit-тесты для автоматической проверки границ.

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

SKILL.md · Apache-2.0
---
name: 707-technologies-hexagonal-architecture
description: Use when you need framework-agnostic Hexagonal architecture guidance for Java projects - ports and adapters boundaries, application core independence, driving and driven adapters, dependency direction, infrastructure leakage detection, optional architecture tests, and evidence-backed remediation. This should trigger for requests such as Review Hexagonal architecture; Review ports and adapters boundaries; Enforce dependency direction; Add ArchUnit architecture tests; Detect infrastructure leakage in domain code; Improve ports and adapters boundaries. Part of Plinth Toolkit
license: Apache-2.0
metadata:
  author: Juan Antonio Breña Moral
  version: 0.19.0
---
# Java Hexagonal architecture boundary review

Help teams review and improve **Hexagonal architecture** boundaries in Java applications without coupling the guidance to Spring Boot, Quarkus, or Micronaut runtime wiring.

**What is covered in this Skill?**

- Domain independence: entities, value objects, domain services, and domain policies stay free of framework, persistence, web, messaging, and infrastructure APIs
- Application/use-case orchestration: use cases coordinate domain behavior through inbound or outbound ports without taking dependencies on concrete adapters
- Adapter and infrastructure boundaries: driving adapters call inbound ports, and driven adapters implement outbound ports
- Dependency direction checks: package, module, import, Maven module, and test evidence that adapters depend on the core rather than the core depending on adapters
- Optional architecture verification: ArchUnit-style rules for Hexagonal boundaries when architecture tests fit the project
- Evidence-backed remediation: findings cite concrete classes, imports, dependencies, packages, or tests and propose small boundary-preserving changes

**Scope:** Framework-agnostic architecture boundary review for Java projects. For Spring Boot, Quarkus, or Micronaut runtime wiring, defer to the matching framework skill. For adding ArchUnit or other Maven dependencies, defer to `111-java-maven-dependencies`.

## Constraints

Keep recommendations focused on architecture boundaries and dependency direction unless the user explicitly asks for framework runtime implementation. After editing this repository's XML sources, regenerate skills and verify the build.

- **MANDATORY**: Run `./mvnw compile` or `mvn compile` before proposing Java or Maven changes in the same change set
- **BOUNDARIES**: Domain packages must not depend on application, adapter, infrastructure, framework, persistence, web, messaging, or dependency-injection APIs
- **USE CASES**: Application/use-case code may orchestrate domain behavior and depend on inbound/outbound ports, but must not depend on concrete adapter implementations
- **ADAPTERS**: Driving adapters call inbound ports and driven adapters implement outbound ports; adapters must not become shared domain logic or depend on each other unnecessarily
- **ARCHUNIT OPTIONAL**: Treat ArchUnit as an optional verification approach selected when it fits the project; do not require adding it before Hexagonal architecture guidance is useful
- **DEPENDENCIES**: Route Maven dependency evaluation, including ArchUnit dependency additions, to `111-java-maven-dependencies`
- **FRAMEWORK ROUTING**: Defer Spring Boot, Quarkus, and Micronaut runtime wiring to the matching framework-specific skill without embedding direct framework skill links in this guidance
- **VERIFY**: Run `./mvnw clean verify` or `mvn clean verify` before promoting changes
- **EDGE CASE**: If package layout, module boundaries, framework ownership, or persistence strategy is ambiguous and affects the review, ask a clarifying question before editing architecture-sensitive code
- **EDGE CASE**: Distinguish confirmed boundary violations from assumptions, conventions inferred from naming, and missing context

## When to use this skill

- Review Hexagonal architecture
- Review ports and adapters boundaries
- Review architecture boundaries
- Enforce dependency direction
- Add ArchUnit architecture tests
- Detect infrastructure leakage in domain code
- Improve ports and adapters boundaries

## Workflow

1. **Read reference and map the codebase**

Read `references/707-technologies-hexagonal-architecture.md` and inspect packages, modules, imports, Maven modules, tests, and framework entry points before making claims about architecture boundaries.

2. **Identify ports, adapters, and dependency direction**

Map domain, application/use-case, inbound ports, outbound ports, driving adapters, driven adapters, and infrastructure responsibilities; record the evidence used and mark unclear areas as assumptions.

3. **Review violations and propose boundary-preserving changes**

Report concrete core-to-adapter dependency violations, framework or infrastructure leakage, adapter coupling, and misplaced behavior with small remediation steps aligned to the existing project structure.

4. **Recommend optional verification and route out-of-scope work**

Suggest ArchUnit-style tests when useful, route dependency additions to `111-java-maven-dependencies`, route framework runtime wiring to the matching framework skill, and summarize verification results.

## Reference

For detailed guidance, examples, and constraints, see [references/707-technologies-hexagonal-architecture.md](references/707-technologies-hexagonal-architecture.md).

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

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

Все скиллы по теме «Бэкенд и API» →
code-architecture curiositech Скилл code-architecture с паттернами организации кода внутри одного приложения: чистая и гексагональная архитектура, структура по фичам, инверсия зависимостей и границы модулей. CX Codex +1 169установок nestjs-hexagonal Softtor Плагин nestjs-hexagonal для проектирования NestJS-приложений по принципам Hexagonal Architecture, DDD и CQRS. Содержит скиллы для каждого слоя, агентов на Opus и Sonnet, проверку кода и workflow TDD. ★ 5звёзд репо hexagonal-architecture-layers-java diegnghrmr Скилл hexagonal-architecture-layers-java раскладывает Java-сервис по слоям Domain, Application и Infrastructure. Нужен при создании сервиса или рефакторинге Spring-кода. CX Codex +1 250установок clean-architecture wondelai Скилл clean-architecture держит бизнес-правила отдельно от фреймворка и базы: исходники зависят только от внутренних слоёв, и это проверяется по чек-листу. CX Codex +1 8 000установок hexagonal-architecture affaan-m Скилл hexagonal-architecture помогает изолировать доменные правила от фреймворков, баз данных и очередей в сервисах на TypeScript, Java, Kotlin и Go. Пригодится при распутывании бизнес-логики и I/O. CX Codex +1 6 600установок architecture-feature-first Ivanna Kaceviča Скилл architecture-feature-first задаёт слоистую feature-first архитектуру для Flutter: где лежит UI, где данные и когда нужен доменный слой. CX Codex +1 ★ 674звёзд репо

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

Весь набор →
805-regulations-eu-cyber-resilience-act Скилл 805-regulations-eu-cyber-resilience-act помогает проверять Java-продукты и связанные компоненты на инженерные требования EU Cyber Resilience Act. Пригодится перед изменением или выпуском продукта с цифровыми элементами. CX Codex +1 212установок 806-regulations-eu-data-act Скилл 806-regulations-eu-data-act разбирает Java-сервисы, API и пайплайны на инженерные контроли EU Data Act: доступ к данным, экспорт, переносимость, переход между облаками. Полезен до релиза функции обмена данными. CX Codex +1 212установок 500-frameworks-micronaut-create-project Скилл 500-frameworks-micronaut-create-project создаёт Maven-проект на Micronaut 4.x через SDKMAN и Micronaut CLI. Он пригодится, когда нужно подготовить новый сервис и проверить сборку. CX Codex +1 211установок 054-design-tdd Скилл 054-design-tdd ведёт разработчика через цикл «красный-зелёный-рефакторинг» при тестировании Java-кода. Пишешь падающий тест, минимум кода для прохода, потом переделываешь — всё время держа тесты зелёными. CX Codex +1 177установок 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установок 053-design-simple-rules Скилл 053-design-simple-rules разбирает дизайн и рефакторинг Java-кода по четырём правилам Кента Бека: тесты, ясность замысла, отсутствие дублирования, минимум элементов. CX Codex +1 172установок

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

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