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

0-hexagonal — правило для Claude Code: что делает и как установить

Правило 0-hexagonal раскладывает код контекста по четырём слоям и направляет зависимости внутрь. Оно пригодится для проверки архитектуры TypeScript-кода.

MIT ★ 571 обновлён 2026-10-29

Установить в Claude Code · Вручную: положить файлы Все способы и платформы ↓
.claude/rules/0-hexagonal.md
Открыть на GitHub

Что делает 0-hexagonal

Правило применяется к файлам src/contexts/**/*.ts и src/runtime/**/*.ts. Внутри контекста оно разделяет код на domain/, application/ и infrastructure/: домен хранит сущности, объекты-значения и чистые преобразования, слой приложения оркестрирует сценарии, а инфраструктура отвечает за реализации портов и ввод-вывод.

Порты объявляются интерфейсами в domain/ports/ или kernel/ports/, а адаптеры размещаются в infrastructure/ и получают порт через конструктор. Архитектуру проверяют import-rules-bite.arch.test.ts и ports-are-called.arch.test.ts; ограничения импортов и глобальных переменных задаются в biome.json. В domain/ и application/ обращение к process запрещено, поэтому там нужен порт.

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

  • разделить контекст на четыре слоя
  • направить зависимости к домену
  • вынести ввод-вывод в адаптеры
  • проверить границы импортов
  • связать каждый адаптер с одним портом

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

  • Проверь файлы src/contexts/orders/**/*.ts по правилу 0-hexagonal и укажи нарушения слоёв.
  • Проведи архитектурную проверку для src/runtime/**/*.ts: найди прямой доступ к process и нарушения портов.
  • Проверь, что каждый адаптер в infrastructure/ реализует один порт и получает его через конструктор.

Как установить 0-hexagonal

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

.claude/rules/0-hexagonal.md

Поле paths во frontmatter ограничивает файлы

По шагам, с командами для каждой платформы: AGENTS.md и CLAUDE.md: что это, кто читает и какой выбрать

Вопросы о 0-hexagonal

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

Сохраните правило в файле .claude/rules/0-hexagonal.md.

Что делает 0-hexagonal?

Правило задаёт четыре слоя внутри контекста, направляет зависимости внутрь и разделяет порты с адаптерами. Оно также описывает архитектурные проверки для импортов и вызовов портов.

Почему в domain/ и application/ нельзя использовать process?

Это ограничение задаётся через biome.json. Для доступа к окружению нужно использовать порт, а ввод-вывод оставлять инфраструктурному слою.

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

0-hexagonal.md · MIT
---
description: Apply inside a context; four layers, dependencies pointing inward, one adapter per port.
paths:
  - "src/contexts/**/*.ts"
  - "src/runtime/**/*.ts"
---

# Layers Inside a Context

Which context owns a concept is `0-contexts.md`.

## Layers

- `domain/`: entities, value objects, pure transforms, capabilities. No I/O.
- Validate an invariant at construction.
- `domain/ports/`: interfaces only.
- `application/`: one class per use case, orchestration only.
- Never branch on the targeted tool; read its capability class.
- `infrastructure/`: port implementations and every piece of I/O.
- Dependencies point inward; `biome.json` holds one `noRestrictedImports` override per layer.
- `biome.json`'s `noRestrictedGlobals` refuses `process` in `domain/` and `application/`; take a port.
- `import-rules-bite.arch.test.ts` fails a pattern naming a vanished directory.

## Ports and adapters

- One context: `domain/ports/`. Two: `kernel/ports/`.
- Name an adapter `*Adapter`, in `infrastructure/`; `runtime/` for a kernel port.
- An adapter does I/O and format translation only.
- Inject through the constructor, typed as the port.
- One adapter, one port; `FileAdapter` is recorded debt.
- A port declares no uncalled method (`ports-are-called.arch.test.ts`, empty baseline).
- `CLIOutput` implements the kernel `Logger` from `presentation/output.ts`.

© ai-driven-dev · MIT · ai-driven-dev/framework

Похожие правила IDE

Каталог правил IDE →
hexagonal-architecture affaan-m Скилл hexagonal-architecture помогает изолировать доменные правила от фреймворков, баз данных и очередей в сервисах на TypeScript, Java, Kotlin и Go. Пригодится при распутывании бизнес-логики и I/O. CX Codex +1 6 600установок hexagonal-architecture-layers-java diegnghrmr Скилл hexagonal-architecture-layers-java раскладывает Java-сервис по слоям Domain, Application и Infrastructure. Нужен при создании сервиса или рефакторинге Spring-кода. CX Codex +1 250установок 707-technologies-hexagonal-architecture Juan Antonio Breña Moral Скилл 707-technologies-hexagonal-architecture помогает проверить и улучшить границы Hexagonal architecture в Java-проектах без привязки к Spring Boot, Quarkus или Micronaut. CX Codex +1 174установок nestjs-hexagonal Softtor Плагин nestjs-hexagonal для проектирования NestJS-приложений по принципам Hexagonal Architecture, DDD и CQRS. Содержит скиллы для каждого слоя, агентов на Opus и Sonnet, проверку кода и workflow TDD. ★ 5звёзд репо context-mode Mert Koseoğlu Правило context-mode направляет вывод терминала и веб-страниц в песочницу MCP, чтобы сырой текст не забивал контекстное окно агента. CX Codex +1 ★ 34 370звёзд репо context-mode Mert Koseoğlu Правило направляет задачи анализа данных в MCP-инструменты context-mode и не даёт засорять диалог сырыми файлами. CX Codex +1 ★ 34 370звёзд репо json-structured-prompting calesthio Правило json-structured-prompting задаёт схему сборки промптов через JSON для сложных визуальных сцен с несколькими героями и точным расположением объектов. CX Codex +1 ★ 78 316звёзд репо i2i-prompting calesthio Правило i2i-prompting для Claude Code помогает составлять промпты для редактирования изображений через FLUX.2: менять отдельные объекты и текст, переносить стиль. CX Codex +1 ★ 78 316звёзд репо

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

Весь набор →
0-contexts Правило 0-contexts ограничивает импорты между контекстами TypeScript-проекта и защищает ядро от бизнес-логики. CX Codex +1 ★ 571звёзд репо 1-conventions Правило 1-conventions задаёт соглашения для TypeScript-файлов в src/ и tests/: структуру модулей, имена файлов и уровни тестов. Оно пригодится при добавлении кода и тестов в проект. CX Codex +1 ★ 571звёзд репо 05-rule-generate Скилл 05-rule-generate проводит правило кодинга от черновика до записи в файлы установленных ИИ-хостов: создание, правка, публикация, удаление. CX Codex +1 ★ 571звёзд репо 07-command-generate Скилл 07-command-generate для Claude Code создаёт и обновляет плоские слэш-команды для подключённых в проекте ИИ-инструментов. Готовит команды вызова без ручной подгонки путей. CX Codex +1 ★ 571звёзд репо 09-mermaid Скилл 09-mermaid для Claude Code собирает диаграммы Mermaid из текста: сначала планирует, затем генерирует и проверяет их. Показывает архитектуру или поток схемой, а не абзацем. CX Codex +1 ★ 571звёзд репо 06-test Скилл 06-test находит непокрытое поведение, дописывает тесты до зелёного статуса и прогоняет сценарии пользователя в браузере. CX Codex +1 ★ 571звёзд репо 03-release-tag Скилл 03-release-tag для Claude Code готовит релиз по SemVer: выводит версию и заметки из недавних коммитов, обновляет файлы версии и создаёт аннотированный тег. Выпускает новую версию. CX Codex +1 ★ 571звёзд репо 08-hook-generate Скилл 08-hook-generate собирает хук: обработчик на событии жизненного цикла для нужного инструмента, запись в его конфиг и скрипт-обработчик. CX Codex +1 ★ 571звёзд репо

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

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