# modular-design-principles

Скилл modular-design-principles даёт правила модульной архитектуры и изолированных контекстов без привязки к стеку. Помогает спроектировать границы модулей и найти неявную связность.

- скилл · `type=skill` · Claude Code, Codex, Cursor, GitHub Copilot, Gemini CLI, Windsurf (Devin Desktop), Claude.ai · ★ 7191 у репозитория
- Автор: tech-leads-club
- Лицензия: MIT · policy=mirror · лицензия открытая, файл — в исходнике
- Исходник: https://github.com/tech-leads-club/agent-skills/tree/HEAD/packages/skills-catalog/skills/(architecture)/modular-design-principles/SKILL.md
- Обновлён: 2026-10-24
- Проверка безопасности: автоматическая, 2026-11-16 (текст) — признаков вредоносного кода не нашли.
- HTML: https://affpapa.org/nevibecode/skills/modular-design-principles

## Что делает

Скилл содержит свод из десяти технологически нейтральных архитектурных принципов, каталог типичных нарушений и процесс создания ограниченных контекстов (`bounded contexts`). В составе идут файл `SKILL.md` с основными правилами и справочник `references/principles.md` с примерами для агента. Ассистент опирается на модель из корней композиции, контекстов и минимальных общих ядер (`shared kernels`). Оркестрация остаётся тонкой. Выбор между монорепозиторием и отдельными библиотеками считается лишь способом поставки, а не признаком модульности.

В чек-лист нарушений входят прямой доступ к чужому хранилищу (`reach-through persistence`), размазанные транзакции, логика внутри транспортных адаптеров и утечка внутренних интерфейсов наружу. Для спорных решений скилл предлагает тест разделения. По умолчанию автор рекомендует держать границы монолитными, пока не возникнут разные темпы изменений или конфликты терминов.

Скилл не строит дорожные карты миграции легаси и не разбирает репозитории по пяти паттернам: для них автор отсылает к `modular-decomposition` и `legacy-migration-planner`. Без сопоставления абстрактных правил с реальной структурой проекта рекомендации останутся голыми схемами.

## Установка

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

1. **Через Skills CLI (Vercel)**
```bash
npx skills add tech-leads-club/agent-skills --skill modular-design-principles -a claude-code
```

2. **Вручную: положить файлы**
- Файл: `~/.claude/skills/modular-design-principles/SKILL.md` — Папка скилла целиком; для одного проекта — .claude/skills/modular-design-principles/

### Codex

1. **Через Skills CLI (Vercel)**
```bash
npx skills add tech-leads-club/agent-skills --skill modular-design-principles -a codex
```

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

### Cursor

1. **Через Skills CLI (Vercel)**
```bash
npx skills add tech-leads-club/agent-skills --skill modular-design-principles -a cursor
```

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

### GitHub Copilot

1. **GitHub CLI**
```bash
gh skill install tech-leads-club/agent-skills 'packages/skills-catalog/skills/(architecture)/modular-design-principles'
```

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

### Gemini CLI

1. **Через Skills CLI (Vercel)**
```bash
npx skills add tech-leads-club/agent-skills --skill modular-design-principles -a gemini-cli
```

2. **Командой платформы**
```bash
gemini skills install https://github.com/tech-leads-club/agent-skills --path 'packages/skills-catalog/skills/(architecture)/modular-design-principles'
```

### Windsurf (Devin Desktop)

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

### Claude.ai

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

Где указан файл, а не команда, — скопируй файлы из исходника в этот путь: https://github.com/tech-leads-club/agent-skills/tree/HEAD/packages/skills-catalog/skills/(architecture)/modular-design-principles/SKILL.md

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

## Примеры запросов агенту
- Проверь архитектуру пакетов проекта на типичные нарушения модульности и утечки состояния.
- Спроектируй ограниченный контекст для модуля биллинга по шагам из руководства.
- Оцени по критериям разделения, нужно ли выносить модуль авторизации в отдельный пакет.

## Похожие
- [software-design-principles](https://affpapa.org/nevibecode/skills/software-design-principles.md) — скилл · ★ 38 у репозитория
- [domain-driven-design](https://affpapa.org/nevibecode/skills/wondelai-domain-driven-design.md) — скилл · 7700 установок
- [domain-model-boundaries-mapper](https://affpapa.org/nevibecode/skills/domain-model-boundaries-mapper.md) — скилл · 270 установок
- [domain-architect](https://affpapa.org/nevibecode/skills/domain-architect.md) — скилл · 249 установок
- [design-code-architecture](https://affpapa.org/nevibecode/skills/design-code-architecture.md) — скилл · 2700 установок
- [architectural-design-principles](https://affpapa.org/nevibecode/skills/architectural-design-principles.md) — скилл · ★ 38 у репозитория

_Часть страницы не вошла по размеру — она есть в HTML-версии._

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