0-hexagonal — правило для Claude Code: что делает и как установить
Правило 0-hexagonal раскладывает код контекста по четырём слоям и направляет зависимости внутрь. Оно пригодится для проверки архитектуры TypeScript-кода.
MIT ★ 571 обновлён 2026-10-29
.claude/rules/0-hexagonal.mdЧто делает 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
Codex читает AGENTS.md: вставьте текст правила туда
Вручную: положить файлы
.cursor/rules/0-hexagonal.mdcВо frontmatter: description, globs, alwaysApply
Вручную: положить файлы
.github/instructions/0-hexagonal.instructions.mdПоле applyTo задаёт, к каким файлам применять
Вручную: положить файлы
.devin/rules/0-hexagonal.mdВручную: положить файлы
.clinerules/0-hexagonal.mdПо шагам, с командами для каждой платформы: 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