Feature Dev

Фаза 2: Исследование кодовой базы

Цель: понять существующий код и паттерны на высоком и низком уровне.

1. Запусти 2–3 суб-агента исследования параллельно. Каждый:

   • Всесторонне трассирует код, сфокусируясь на абстракциях, архитектуре, потоке управления
   • Цели: аналогичные фичи, высокоуровневая архитектура, паттерны тестирования
   • Возвращает 5–10 ключевых файлов для чтения

   Примеры промптов:

   • "Найди фичи, похожие на {фичу}, и подробно проследи их реализацию"
   • "Проанализируй архитектуру и абстракции для {области}, проследи весь поток"
   • "Определи UI-паттерны, подходы к тестированию для {фичи}"

2. Прочитай все файлы, указанные суб-агентами

3. Представь сводку найденных паттернов

Фаза 3: Уточняющие вопросы

Цель: заполнить пробелы и разрешить неясности ПЕРЕД проектированием.

КРИТИЧНО: эта фаза — одна из самых важных. НЕ ПРОПУСКАЙ.

1. Проверь результаты исследования и исходный запрос
2. Определи неспецифицированные аспекты: edge cases, обработка ошибок, точки интеграции, обратная совместимость, лимиты
3. Представь ВСЕ вопросы пользователю в организованном списке
4. Жди ответов перед переходом к архитектуре

Фаза 4: Архитектурное проектирование

Цель: спроектировать несколько подходов к реализации с разными компромиссами.

1. Запусти 2–3 суб-агента архитектора параллельно с разными фокусами:

   • Минимальные изменения: наименьшее изменение, максимальное переиспользование существующего кода
   • Чистая архитектура: поддерживаемость, элегантные абстракции
   • Прагматичный баланс: скорость + качество

2. Оцени все подходы и сформируй мнение, какой подходит лучше

3. Представь пользователю: краткую сводку каждого подхода, таблицу компромиссов, твою рекомендацию с обоснованием

4. Спроси пользователя какой подход выбрать

Фаза 5: Реализация

Цель: построить фичу.

НЕ НАЧИНАЙ БЕЗ ОДОБРЕНИЯ ПОЛЬЗОВАТЕЛЯ.

1. Жди явного одобрения
2. Прочитай все релевантные файлы из предыдущих фаз
3. Реализуй следуя выбранной архитектуре
4. Следуй конвенциям кодовой базы строго:
   • TypeScript strict, no any, no as
   • Компоненты ≤400 строк
   • Все UI состояния (loading, empty, error, success)
   • RLS на каждой таблице, .limit() на запросах
   • Обработка ошибок с toast-уведомлениями
5. Обновляй todo-list по мере прогресса

Фаза 6: Quality Review

Цель: убедиться что код прост, DRY, элегантен, легко читается, функционально корректен.

1. Запусти 3 суб-агента review параллельно:

   • Простота, DRY, элегантность
   • Баги и функциональная корректность
   • Конвенции проекта и абстракции

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

3. Представь находки пользователю (исправить сейчас / исправить позже / продолжить как есть)

4. Устрани проблемы согласно решению пользователя

Фаза 7: Итог

1. Отметь все todo завершёнными
2. Суммируй: что построено, решения, изменённые файлы, рекомендации далее
3. Запусти npx tsc -p tsconfig.app.json --noEmit → 0 ошибок

Суб-агенты

Исследователь кода

Глубоко анализирует существующие фичи, трассирует пути выполнения, маппит слои архитектуры, документирует зависимости. Возвращает: точки входа, поток выполнения, ключевые компоненты, архитектурные решения, список файлов.

Архитектор

Проектирует архитектуру фичи анализируя существующие паттерны. Возвращает: найденные паттерны (с file:line), архитектурное решение с обоснованием, дизайн компонентов, карту реализации, фазированную последовательность.

Рецензент

Проверяет код на баги, проблемы безопасности, качество. Использует оценку уверенности (сообщает только при ≥75%). Возвращает: проблемы сгруппированные по серьёзности.