Гайд №05. Декомпозиция ИИ-проекта

1. Почему декомпозиция вообще так важна

Большинство проблем в вайбкодинге начинаются не потому, что модель слабая, а потому что задача поставлена как огромная бесформенная глыба. Когда ты говоришь ИИ: «сделай мне ИИ-продукт», он вынужден сам догадываться, что именно важно, в каком порядке идти и что считать результатом. Отсюда и бесконечные переделки.

Без декомпозиции

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

С декомпозицией

чёткие модули и этапы
понятные маленькие задачи
проверяемый результат
быстрый прогресс
масштабирование без хаоса

Ключевая мысль: декомпозиция - это не бюрократия. Это способ превратить идею в управляемую систему, где ИИ работает на тебя, а не ты разгребаешь последствия его импровизации.

Что НЕ надо держать в голове

полный список модулей;
все зависимости между ними;
очередность технических задач;
названия библиотек и файлов;
все edge cases и тесты;
десятки следующих шагов.

Пусть это хранит и актуализирует ИИ в проектных файлах.

Что остаётся за тобой

Результат: что должно получиться.
Приоритет: что важнее прямо сейчас.
Ограничения: деньги, сроки, риски.
Приёмка: устраивает тебя результат или нет.

Ты управляешь. ИИ проектирует, документирует, декомпозирует и исполняет.

2. Полная картина: из каких слоёв состоит ИИ-проект

Почти любой ИИ-проект можно разложить на пять слоёв. Если ученик понимает эти слои, ему намного легче проектировать продукт, задавать вопросы ChatGPT и формулировать задачи Codex.

Цель

Какую ценность даёт проект. Ради чего мы вообще его строим.

Пользователь

Кто будет использовать продукт и какие проблемы он хочет решить.

Функции

Какие сценарии и действия должны работать.

Технологии

На чём мы это делаем: инструменты, сервисы, API, база данных, Telegram и т.д.

Этапы

В каком порядке всё собирается, тестируется и запускается.

Если одного из слоёв нет, проект становится шатким. Например, функции есть, а пользователя никто не описал. Или технологии выбраны, а цель так и осталась туманной.

3. Пример для ученика: Telegram-бот для бизнеса

Чтобы было не абстрактно, берём живой кейс. Допустим, ученик хочет сделать Telegram-бота, который отвечает на вопросы клиентов. Вместо общего «сделай бота» мы раскладываем идею по слоям.

Как мыслить правильно

Идея: бот отвечает клиентам.
Цель: экономить время и повышать продажи.
Пользователь: клиент, менеджер, владелец.
Функции: ответы, заявки, база знаний.
Этапы: MVP → тест → запуск → рост.

Что это даёт

Теперь ученик видит не одну большую страшную идею, а структуру. Дальше её можно перевести в конкретные модули: модуль сообщений, модуль AI-ответов, модуль базы знаний, модуль заявок.

4. Шаг за шагом: как делать декомпозицию

Вот рабочая последовательность. Её можно использовать почти для любого проекта, от сайта до AI-ассистента.

1

Опиши конечный результат.
Не инструмент, а то, что должно получиться в конце.

2

Раздели проект на модули.
Модули - это большие логические блоки: интерфейс, бот, база, интеграция, аналитика.

3

Разбей модули на задачи.
Задача должна быть конкретной и выполнимой за один короткий цикл работы ИИ.

4

Добавь критерии приёмки.
Как ты поймёшь, что каждая задача реально завершена.

5

Определи порядок.
Что делаем сначала, что потом, а что вообще не трогаем в первой версии.

6

Делегируй ИИ по частям.
Не весь проект сразу, а один модуль или одну задачу.

7

Проверяй и иди дальше.
После каждого блока фиксируй результат и только потом открывай следующий слой сложности.

5. Готовые шаблоны планирования

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

Шаблон 1. PROJECT_BRIEF

Нужен, чтобы описать проект целиком: цель, пользователь, MVP, модули, этапы, критерии приёмки.

Шаблон 2. MODULE_CARD

Нужен, чтобы разбирать каждый модуль отдельно: зачем он нужен, что в него входит, какой у него вход и какой должен быть результат.

Шаблон PROJECT_BRIEF.md

# Название проекта

## 1. Конечный результат
Что должно получиться в итоге

## 2. Пользователь
Кто будет использовать продукт

## 3. Проблема
Какую задачу решаем

## 4. MVP
Какая минимальная версия уже даёт пользу

## 5. Основные модули
- Модуль 1
- Модуль 2
- Модуль 3

## 6. Функции по модулям
### Модуль 1
- Функция A
- Функция B

## 7. Задачи по модулям
### Модуль 1
- Задача 1
- Задача 2

## 8. Порядок этапов
1. ...
2. ...
3. ...

## 9. Критерии приёмки
- ...

## 10. Что не входит в V1
- ...

Шаблон MODULE_CARD.md

# MODULE_CARD.md

## Название модуля

## Зачем он нужен

## Что должно работать

## Входные данные

## Выходной результат

## Задачи внутри модуля
1. ...
2. ...
3. ...

## Критерии приёмки
- ...

## Что идёт следующим шагом
- ...

6. Как правильно писать задачи для ИИ

Декомпозиция не означает, что теперь ты должен стать проектным менеджером и вручную расписать 80 задач. Наоборот. Правильный подход такой: ты выгружаешь ИИ цель и контекст, а ИИ сам строит карту проекта, модули, зависимости, этапы, задачи и чек-листы.

Не учи структуру наизусть. Храни её в файлах проекта и каждый раз проси ИИ восстановить актуальный контекст. Тебе достаточно понимать, какой результат нужен сейчас и устраивает ли тебя то, что получилось.

Ты говоришь ИИ

«Вот моя цель. Вот ограничения. Разберись в проекте, сам декомпозируй, предложи порядок и веди меня по одному следующему шагу».

ИИ обязан сделать

Исследовать проект, создать и обновлять план, разбить работу, выявить зависимости, предложить следующий шаг, выполнить его, проверить и зафиксировать результат.

Формула: результат → контекст → ИИ сам декомпозирует → показывает план → ты подтверждаешь → ИИ делает один шаг → проверяет → обновляет план → предлагает следующий.

Промпт для ChatGPT на этап декомпозиции

Ты мой AI-архитектор и руководитель разработки. Я не хочу вручную держать в голове структуру проекта, список задач, зависимости и технические детали. Это твоя зона ответственности.

МОЯ ИДЕЯ / ЦЕЛЬ:
[ОПИШИ СВОИМИ СЛОВАМИ, МОЖНО ГОЛОСОМ И НЕИДЕАЛЬНО]

МОИ ОГРАНИЧЕНИЯ, ЕСЛИ ЕСТЬ:
- бюджет: ...
- сроки: ...
- обязательные сервисы/технологии: ...
- что нельзя делать: ...

Работай подход через ИИ. Не начинай писать код сразу.

Сделай самостоятельно:
1. Уточни, какой конечный результат мне реально нужен.
2. Если чего-то критически не хватает, задай только необходимые вопросы. Не заставляй меня проектировать систему вместо тебя.
3. Исследуй готовые решения, репозитории, библиотеки и архитектурные паттерны, если это полезно.
4. Определи пользователя и главные пользовательские сценарии.
5. Предложи минимально рабочую первую версию, которая уже даёт ценность.
6. Разбей проект на понятные модули.
7. Для каждого модуля сформулируй функции, входы, выходы и зависимости.
8. Сам разбей модули на небольшие проверяемые задачи.
9. Для каждой важной задачи добавь критерии приёмки.
10. Определи правильный порядок реализации с учётом зависимостей.
11. Отдельно зафиксируй, что НЕ входит в первую версию.
12. Выяви основные риски, секреты, опасные действия и места, где понадобится подтверждение человека.
13. Сформируй PROJECT_BRIEF.md и MODULE_CARD.md для ключевых модулей.
14. Составь единый актуальный план проекта, который другой ИИ сможет продолжить без объяснений с нуля.
15. В конце не вываливай на меня сотню задач. Покажи:
   - краткую карту проекта;
   - что считаем MVP;
   - три ближайших этапа;
   - только ОДИН следующий конкретный шаг.

Главное правило: ты хранишь сложность и структуру у себя. Я держу в голове цель, ограничения и качество результата.

Промпт для Codex на работу по модулю

Ты исполнитель внутри уже спроектированного проекта. Твоя задача самостоятельно восстановить актуальный контекст и довести текущий шаг до доказанного результата.

ТЕКУЩИЙ ПРОЕКТ:
[ПУТЬ / РЕПОЗИТОРИЙ / ССЫЛКА, ЕСЛИ НУЖНО]

ТЕКУЩАЯ ЦЕЛЬ:
[МОЖНО ОПИСАТЬ ПРОСТЫМИ СЛОВАМИ]

Работай автономно в пределах безопасных обратимых действий. Не перекладывай техническую работу на меня.

Перед началом:
1. Сам изучи README, PROJECT_BRIEF.md, MODULE_CARD.md, правила проекта, git status, структуру файлов и последнюю историю изменений.
2. Восстанови, где проект находится сейчас и что уже сделано.
3. Сверь текущую цель с общей архитектурой.
4. Определи один минимальный законченный шаг, который сейчас логично выполнить.
5. Если план устарел, обнови его сам.

Во время работы:
6. Делай изменения маленькими и проверяемыми.
7. Не расширяй scope без необходимости.
8. Сам ищи документацию и готовые решения, если упёрся в технический вопрос.
9. После существенных изменений запускай подходящие проверки и тесты.
10. Не проси меня выполнять команды, которые можешь выполнить сам.
11. Не раскрывай и не коммить секреты.
12. Перед необратимым удалением, production-изменением или другим опасным действием запроси подтверждение.

После реализации:
13. Проверь критерии приёмки фактически.
14. Покажи evidence: что запускал и какой результат получил.
15. Проверь git diff/status.
16. Обнови PROJECT_BRIEF.md / MODULE_CARD.md / checkpoint, если состояние проекта изменилось.
17. Кратко сообщи:
   - что сделано;
   - чем доказано;
   - что не проверено;
   - есть ли блокеры;
   - какой ОДИН следующий шаг рекомендуешь.

Не пиши «готово», если результат не проверен. Не заставляй меня помнить план проекта, поддерживай его сам.

Промпт: ИИ сам держит проект в контексте и даёт следующий шаг

Ты ИИ-проект-менеджер моего проекта. Твоя задача снять с меня необходимость помнить десятки деталей и каждый раз быстро возвращать меня в контекст.

Изучи все доступные материалы проекта: PROJECT_BRIEF.md, MODULE_CARD.md, README, checkpoints, git history, issues, TODO и текущий код.

После этого:
1. Скажи в 5-7 строках, что мы строим глобально.
2. Определи текущую стадию проекта.
3. Покажи, что уже завершено и чем это подтверждено.
4. Назови незакрытые блокеры и риски.
5. Проверь, не устарел ли план. Если устарел, обнови его.
6. Не показывай весь backlog, если я не попросил.
7. Дай только ОДИН лучший следующий шаг, который максимально приблизит проект к работающему результату.
8. Сформулируй готовый промпт для coding agent, чтобы я мог просто передать задачу исполнителю.

Если следующий шаг можно выполнить самостоятельно имеющимися инструментами, предложи сразу выполнить его, а не объяснять мне технические действия.

Промпт: аудит и упрощение декомпозиции

Проведи жёсткий аудит декомпозиции этого проекта как senior product engineer и AI-архитектор.

Твоя цель: не добавить больше функций, а сделать план проще, короче и надёжнее.

Проверь:
1. Ясна ли конечная ценность для пользователя.
2. Не раздут ли MVP.
3. Все ли модули действительно нужны в первой версии.
4. Нет ли модулей, которые можно заменить готовым сервисом, API, MCP или open-source решением.
5. Правильно ли определены зависимости между модулями.
6. Не слишком ли крупные задачи.
7. Есть ли критерии приёмки.
8. Можно ли проверить каждый важный результат.
9. Есть ли скрытые риски по безопасности, данным, секретам, стоимости и внешним API.
10. Можно ли изменить порядок так, чтобы получить работающий результат раньше.

После аудита:
- покажи 5 главных проблем текущего плана;
- предложи упрощённую версию архитектуры;
- предложи более маленький MVP, если возможно;
- обнови декомпозицию;
- дай один следующий шаг.

Не заставляй меня разбираться в технических деталях без необходимости. Переводи их на язык решений и результата.

7. Типичные ошибки при декомпозиции

Ошибки - нормальная часть роста. Важно не прятать их, а научиться быстро распознавать.

Ошибка 1

Слишком большая задача. Например: «сделай мне AI-платформу». Без рамок, без модулей, без этапов.

Ошибка 2

Нет критериев приёмки. В итоге непонятно, что именно проверять и когда останавливать разработку.

Ошибка 3

Сразу всё в продакшен. Без MVP, без тестов, без логики постепенного наращивания.

Ещё часто забывают про контекст, пытаются строить без плана, не документируют промежуточный результат и не фиксируют, что не входит в V1.

8. Чек-лист самопроверки

Пройди этот чек-лист перед тем, как отдавать проект в активную разработку ИИ.

Моя готовность к разработке0 / 12

Отмечай пункты прямо здесь. Галочки сохраняются на этом устройстве.

10-12 галочек: отличная база. Можно уверенно идти в реализацию.

7-9 галочек: уже неплохо, но структуру ещё стоит усилить.

0-6 галочек: не надо садиться и вручную дописывать план. Дай ИИ промпт выше и попроси его закрыть недостающие пункты вместе с тобой.

Практическое задание

Возьми свой реальный проект. Но не садись вручную расписывать огромный план. Твоя практика заключается в том, чтобы научиться правильно поручать проектирование ИИ.

1

Расскажи ChatGPT идею своими словами или голосом. Используй расширенный промпт из гайда.

2

Попроси ИИ самому создать PROJECT_BRIEF.md, выделить модули, задачи, зависимости и критерии приёмки.

3

Твоя работа: проверить, совпадает ли план с твоей реальной целью, убрать лишнее и утвердить MVP.

4

Попроси ИИ выбрать один лучший следующий шаг и сформировать готовую задачу для Codex.

5

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

Цель практики: не выучить декомпозицию наизусть. Цель - научиться управлять ИИ так, чтобы он сам держал сложность проекта, а ты управлял направлением и принимал результат.

Декомпозиция ИИ-проекта