v0.1 · Open source · Claude Code Skill

Спроектируй модуль
за 9 шагов а не за 9 итераций

Скилл для Claude Code. Декомпозирует любую задачу в Модуль → Этап → Операцию, прогоняет через инверсию и выдаёт готовый чертёж файловой структуры.

Установить за 30 секунд Глянуть код
MIT · 1 команда установки · 9 шагов · 5 references
Влад Яско, автор скилла module-design, за работой над архитектурой
shipped
Работает с
Claude Code Desktop · CLI · IDE Любой проект Триггерится сам
// Зачем

Все строят пайплайны
на ощупь.

А потом две недели рефактора, потому что «этот класс делает всё подряд», «непонятно где менять конфиг» и «давайте просто перепишем».

Скилл превращает «как-нибудь» в жёсткий процесс. На выходе дизайн-блюпринт, который не стыдно показать команде.

Границы размыты

Модуль utils делает всё подряд. Меняется по любому поводу. SRP идёт лесом.

Этапы вкладываются

Подэтапы в этапах, иерархия плывёт. Через месяц никто не помнит, где живёт логика.

Конфиг везде

API-ключ дублируется в трёх местах. Client тащит бизнес-логику. Storage не заменишь без боли.

// Workflow

9 шагов до чертежа

Каждый шаг закрывает конкретное архитектурное решение. Пропустишь — пробьёт через месяц.

STEP 01 FOUNDATION

ЦКП системы

Одно предложение. Конкретный продукт, не процесс. Без чего система мертва.

STEP 02 FOUNDATION

Инверсия

Премортем, необходимые условия, bottleneck, kill criteria. До декомпозиции, не после.

STEP 03 DECOMPOSE

Модули

Один заказчик — одна граница. Контракт = вход + выход + ошибка.

STEP 04 DECOMPOSE

Этапы

Тест существительного. Разные слова → граница этапа. Одно слово с прилагательным → не граница.

STEP 05 DECOMPOSE

Операции

Атомарный шаг — один семантический акт. Дальше делить — нерабочие фрагменты.

STEP 06 INFRA

Триада

Config / Client / Storage. Один владелец на уровне. Не дублируется между модулем и этапом.

STEP 07 SHAPE

Шаблон

Развернуть этап в папку только если есть нагрузка: своя оркестрация, своя триада.

STEP 08 VALIDATE

Чек-листы

Модуль / этап / операция. Любой «нет» — единица собрана неверно.

STEP 09 VALIDATE

Инверсионная отчётка

Каждый failure mode из шага 2 закрыт конкретной мерой. Никаких «провели премортем и забыли».

// Установка

30 секунд — и работает

Одна команда. Никаких npm, pip, docker. Просто клонируешь в папку со скиллами.

bash 
$ git clone https://github.com/yasikvlad/claude-skill-module-design ~/.claude/skills/module-design
01

Скопируй команду

Выполни в терминале — займёт несколько секунд.

02

Открой Claude Code

В любом проекте, на любом OS.

03

Просто пиши задачу

Скилл активируется на триггеры автоматически.

// Триггеры

На что
реагирует

Не надо вызывать вручную. Claude сам подхватывает скилл, когда видит знакомые формулировки.

Auto-trigger из любой фразы ниже
спроектируй модуль X разложи задачу на этапы это модуль или этап? нужно ли разворачивать этап где жить Config/Client/Storage проведи премортем найди bottleneck определи kill criteria ЦКП этого модуля шаблон модуля триада Config/Client/Storage SRP, изоляция, composability инверсия необходимые условия
// Где работает

Применимо везде,
где есть модули

Методология фрактальна — работает на масштабе операции, модуля, продукта, бизнеса.

AI-агенты

Sales-bot, content-pipeline, research-agent. Понятно где модель, где промт, где tools.

Парсеры и скрейперы

URL → HTML → структура → база. Каждая смена существительного — отдельный этап.

ETL и data pipelines

Extract → Transform → Load. Чёткие контракты, понятно где менять формат и источник.

Модульные бэкенды

Auth, billing, notifications. Меняешь Stripe на LemonSqueezy — трогаешь один Client.

// Ship it

Хватит решать архитектуру
в третий раз.

Поставь скилл, прогоняй любую задачу через 9 шагов, получай чертёж, который держит.

Установить за 30 секунд Star на GitHub