0-contexts — правило для Claude Code: что делает и как установить
Правило 0-contexts ограничивает импорты между контекстами TypeScript-проекта и защищает ядро от бизнес-логики.
MIT ★ 571 обновлён 2026-10-29
.claude/rules/0-contexts.mdЧто делает 0-contexts
Правило заставляет модель группировать код по ограниченным контекстам, а не техническим слоям. Зависимости направляются строго в одну сторону — к kernel/. В самом ядре разрешено оставлять лишь общую лексику: базовые типы, чистые вспомогательные функции, типизированные ошибки и порты в kernel/ports/. Любые решения предметной области в ядре запрещены.
Взаимодействие между контекстами идёт только через модули, зафиксированные в PUBLIC_MODULES. Сквозные вызовы и самовозврат из контекста отсекают проверки context-boundary.arch.test.ts и context-self-reentry.arch.test.ts.
Без тестов в tests/architecture/ и файла aidd_docs/memory/codebase-map.md правило теряет практическую силу: ассистент сверяет структуру по списку ALLOWED и тестам паритета с biome.json.
Какие задачи решает
- Запретить бизнес-логику в общем ядре проекта
- Выстроить однонаправленный граф импортов между контекстами
- Ограничить доступ к внутренностям модуля через публичные экспорты
- Синхронизировать архитектурные границы с проверками в Biome
Примеры запросов агенту
- Добавь новый модуль в проект с учётом контекстов из
codebase-map.md - Проверь импорты в
src/billingи вынеси общие интерфейсы вkernel/ports/ - Раздели зависимости между контекстами, чтобы исключить циклические вызовы
Как установить 0-contexts
Вручную: положить файлы
.claude/rules/0-contexts.mdПоле paths во frontmatter ограничивает файлы
AGENTS.md
Codex читает AGENTS.md: вставьте текст правила туда
Вручную: положить файлы
.cursor/rules/0-contexts.mdcВо frontmatter: description, globs, alwaysApply
Вручную: положить файлы
.github/instructions/0-contexts.instructions.mdПоле applyTo задаёт, к каким файлам применять
Вручную: положить файлы
.devin/rules/0-contexts.mdВручную: положить файлы
.clinerules/0-contexts.mdПо шагам, с командами для каждой платформы: AGENTS.md и CLAUDE.md: что это, кто читает и какой выбрать
Вопросы о 0-contexts
Как установить 0-contexts в Claude Code?
Создайте файл .claude/rules/0-contexts.md и сохраните в него содержимое правила. Claude Code автоматически задействует его при обработке файлов по маске src/**/*.ts.
Что разрешено хранить в директории kernel/?
Только общие типы, чистые хелперы, типизированные ошибки и контракты портов в kernel/ports/. Бизнес-логику контекстов помещать в ядро нельзя.
Как контролируются границы между контекстами?
Разрешённые связи задаются массивом ALLOWED в tests/architecture/helpers.ts, а тесты context-graph.arch.test.ts блокируют любые лишние импорты.
Исходный текст
0-contexts.md · MIT
--- description: Apply when adding or moving a module; keeps the import chain one-way and the kernel free of business logic. paths: - "src/**/*.ts" --- # Contexts Organise by bounded context, never by layer. ## Chain - Allowed edges live in `tests/architecture/helpers.ts` (`ALLOWED`). - Arrows run one way, toward the kernel. - `presentation` and `runtime` depend on any context. - A context depending on either is `BASELINE` debt; it only shrinks. - `context-graph.arch.test.ts` fails any other edge. - `biome-context-parity.arch.test.ts` holds `biome.json` to the same data. ## Kernel - `kernel/` imports no context. - Keep only shared vocabulary: types, pure helpers, typed errors. - A port two contexts need lives in `kernel/ports/`. - A domain decision is never kernel material. ## Interior - Import only a module listed in `PUBLIC_MODULES` (`context-boundary.arch.test.ts`). - Everything else is internal. - Never leave a context to re-enter it (`context-self-reentry.arch.test.ts`). ## Adding - Pick the owning context first. - A use case fitting nowhere means the contexts are wrong. - Cross through the target's public module, in the allowed direction. - Wrong direction: the caller sits in the wrong context. - Placement is `aidd_docs/memory/codebase-map.md`, held by `codebase-map.arch.test.ts`.
© ai-driven-dev · MIT · ai-driven-dev/framework