0-shared-modules — правило для Claude Code
Правило 0-shared-modules помогает решить, когда модуль действительно пора выносить в shared/. Оно пригодится при разборе структуры src/contexts/ и перемещении кода между областями приложения.
MIT ★ 571 обновлён 2026-10-29
.claude/rules/0-shared-modules.mdЧто делает 0-shared-modules
Перед созданием или перемещением модуля в shared/ правило предлагает посчитать области, которые его вызывают. Для этого используется grep -rl <module> src; тест earned-sharing.arch.test.ts учитывается наравне с вызовами. Одной области недостаточно: модуль следует оставить ближе к месту использования. Не считайте runtime/wiring/ отдельной областью.
Файл внутри общего модуля считается его приватным шагом. При переносе модуля правило отсылает к 0-hexagonal.md; при пересечении границы контекста требует объявить его публичным по 0-contexts.md. В kernel/ код перемещают, только когда он перестаёт быть бизнес-логикой. Эти ориентиры относятся к файлам src/contexts/**/*.ts, поэтому путь правила нужно сопоставить со структурой проекта.
Какие задачи решает
- проверить, достаточно ли областей вызывают модуль для переноса в
shared/ - оставить код рядом с единственной областью использования
- отличить
runtime/wiring/от области приложения - определить, когда модуль нужно объявить публичным для другого контекста
- решить, перестал ли модуль быть бизнес-логикой перед переносом в
kernel/
Примеры запросов агенту
- Проверь, можно ли перенести этот модуль в
shared/, и посчитай его вызывающие области. - Посмотри на
src/contexts/и скажи, где оставить модуль с одним вызывающим участком. - Проверь перенос через границу контекста и перечисли нужные изменения.
Как установить 0-shared-modules
Вручную: положить файлы
.claude/rules/0-shared-modules.mdПоле paths во frontmatter ограничивает файлы
AGENTS.md
Codex читает AGENTS.md: вставьте текст правила туда
Вручную: положить файлы
.cursor/rules/0-shared-modules.mdcВо frontmatter: description, globs, alwaysApply
Вручную: положить файлы
.github/instructions/0-shared-modules.instructions.mdПоле applyTo задаёт, к каким файлам применять
Вручную: положить файлы
.devin/rules/0-shared-modules.mdВручную: положить файлы
.clinerules/0-shared-modules.mdПо шагам, с командами для каждой платформы: AGENTS.md и CLAUDE.md: что это, кто читает и какой выбрать
Вопросы о 0-shared-modules
Как установить 0-shared-modules в Claude Code?
Добавьте файл правила по пути .claude/rules/0-shared-modules.md.
Что делает 0-shared-modules?
Правило задаёт условия для переноса кода в shared/: модуль должен вызываться из двух областей. Оно также описывает переходы между контекстами и перенос в kernel/.
Как правило считает области приложения?
Областью считается application/<subdirectory>/ или корень приложения. runtime/wiring/ областью не считается.
Исходный текст
0-shared-modules.md · MIT
--- description: Apply before creating or moving into a shared/ directory; sharing is earned by two calling areas. paths: - "src/contexts/**/*.ts" --- # Shared Modules - `shared/` needs callers in two areas. - One caller: move it down. - Never share for a caller not yet written. - An area is `application/<subdirectory>/` or the application root. - `runtime/wiring/` is never an area. - Count first: `grep -rl <module> src`; `earned-sharing.arch.test.ts` counts the same. - A file nested under a shared module is its private step. - A promoted module follows `0-hexagonal.md`. - Crossing a context: declare the module public (`0-contexts.md`). - Move to `kernel/` only once it stops being business logic.
© ai-driven-dev · MIT · ai-driven-dev/framework