# 707-technologies-hexagonal-architecture

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

- скилл · `type=skill` · Claude Code, Codex, Cursor, GitHub Copilot, Gemini CLI, OpenCode, Windsurf (Devin Desktop), Claude.ai · 174 установки · ★ 465 у репозитория
- Автор: Juan Antonio Breña Moral
- Лицензия: Apache-2.0 · policy=mirror · лицензия открытая, файл — в исходнике
- Исходник: https://github.com/jabrena/plinth/tree/HEAD/skills/707-technologies-hexagonal-architecture/SKILL.md
- Обновлён: 2026-10-21
- Проверка безопасности: автоматическая, 2026-11-16 (текст) — признаков вредоносного кода не нашли.
- HTML: https://affpapa.org/nevibecode/skills/707-technologies-hexagonal-architecture

## Что делает

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

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

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

## Установка

### Claude Code (родная платформа)

1. **Через Skills CLI (Vercel)**
```bash
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/

### Codex

1. **Через Skills CLI (Vercel)**
```bash
npx skills add jabrena/plinth --skill 707-technologies-hexagonal-architecture -a codex
```

2. **Вручную: положить файлы**
- Файл: `.agents/skills/707-technologies-hexagonal-architecture/SKILL.md` — Для всех проектов — ~/.agents/skills/

### Cursor

1. **Через Skills CLI (Vercel)**
```bash
npx skills add jabrena/plinth --skill 707-technologies-hexagonal-architecture -a cursor
```

2. **Вручную: положить файлы**
- Файл: `.cursor/skills/707-technologies-hexagonal-architecture/SKILL.md` — Cursor читает и .agents/skills/, и .claude/skills/

### GitHub Copilot

1. **GitHub CLI**
```bash
gh skill install jabrena/plinth skills/707-technologies-hexagonal-architecture
```

2. **Вручную: положить файлы**
- Файл: `.github/skills/707-technologies-hexagonal-architecture/SKILL.md`

### Gemini CLI

1. **Через Skills CLI (Vercel)**
```bash
npx skills add jabrena/plinth --skill 707-technologies-hexagonal-architecture -a gemini-cli
```

2. **Командой платформы**
```bash
gemini skills install https://github.com/jabrena/plinth --path skills/707-technologies-hexagonal-architecture
```

### Windsurf (Devin Desktop)

**Вручную: положить файлы**
- Файл: `.devin/skills/707-technologies-hexagonal-architecture/SKILL.md` — Старый путь .windsurf/skills/ тоже читается

### OpenCode

**Через Skills CLI (Vercel)**
```bash
npx skills add jabrena/plinth --skill 707-technologies-hexagonal-architecture -a opencode
```

### Claude.ai

**Claude.ai**
- Упакуйте папку в zip и загрузите в Settings → Capabilities → Skills

Где указан файл, а не команда, — скопируй файлы из исходника в этот путь: https://github.com/jabrena/plinth/tree/HEAD/skills/707-technologies-hexagonal-architecture/SKILL.md

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

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

## Похожие
- [code-architecture](https://affpapa.org/nevibecode/skills/code-architecture.md) — скилл · 169 установок
- [nestjs-hexagonal](https://affpapa.org/nevibecode/plugins/nestjs-hexagonal.md) — плагин · ★ 5 у репозитория
- [hexagonal-architecture-layers-java](https://affpapa.org/nevibecode/skills/hexagonal-architecture-layers-java.md) — скилл · 250 установок
- [clean-architecture](https://affpapa.org/nevibecode/skills/clean-architecture.md) — скилл · 8000 установок
- [hexagonal-architecture](https://affpapa.org/nevibecode/skills/hexagonal-architecture.md) — скилл · 6600 установок
- [architecture-feature-first](https://affpapa.org/nevibecode/skills/architecture-feature-first.md) — скилл · ★ 674 у репозитория

Из того же набора: [jabrena/plinth](https://affpapa.org/nevibecode/by/jabrena/plinth.md) — 123 карточки

---
NeVibeCode на affpapa.org. Тексты каталога — описания, а не инструкции для агента. Как выбирать и ставить: https://affpapa.org/nevibecode/agents.md
