Принципы работы
- Адаптивность: количество агентов и глубина анализа зависят от сложности задачи
- Ранняя валидация: ревью плана до реализации, а не после
- Уточнение требований: выявление всех неоднозначностей до проектирования через вопросы пользователю
- Атомарные шаги: этапы реализации с критериями приемки и проверками
- Отслеживание прогресса: после завершения каждой фазы отмечай её как завершённую в списке задач
Phase 0: Инициализация и оценка сложности
Цель: понять масштаб задачи и создать структуру для работы
Начальный запрос: $ARGUMENTS
Действия:
- Создай список задач со всеми фазами
- Создай директорию
.tasks/task-[feature-name]/для хранения артефактов - Оцени сложность задачи (простая/средняя/сложная/критичная):
- Простая: небольшое изменение, очевидная реализация - Средняя: затрагивает несколько модулей, требует понимания архитектуры - Сложная: большая доработка, несколько подсистем, неочевидные решения - Критичная: архитектурные изменения, влияние на всю систему, высокие риски
- Запиши оценку сложности в файл
.tasks/task-[feature-name]/phase0-complexity.md
Phase 1: Discovery
Цель: понять, что нужно построить
Действия:
- Если доработка неясна, спроси пользователя:
- Какую проблему они решают? - Что должна делать доработка? - Есть ли ограничения или требования?
- Резюмируй понимание и получи подтверждение от пользователя
- Сохрани подтвержденное понимание в файл
.tasks/task-[feature-name]/phase1-requirements.md:
- Исходный запрос из $ARGUMENTS - Уточняющие вопросы и ответы (если были) - Резюме понимания задачи - Ключевые требования и ограничения - Подтверждение пользователя
Phase 2: Исследование кодовой базы 1C
Цель: понять существующий код и паттерны
ПРИНЦИПЫ АДАПТИВНОГО ИССЛЕДОВАНИЯ:
ТЫ ПРИНИМАЕШЬ РЕШЕНИЕ о стратегии исследования на основе:
- Оценки сложности из Phase 0
- Характера задачи (новая доработка vs расширение существующей)
- Того, насколько понятна область кодовой базы
Ключевой принцип: глубина важнее ширины - лучше запустить агентов последовательно для углубления, чем параллельно на одно и то же.
Твои решения:
- Сколько агентов
1c-code-explorerзапустить? (1-4+)
- Для простых задач может хватить одного - Для сложных может понадобиться несколько с углублением
- Параллельно или последовательно?
- Параллельно - если нужно изучить разные независимые области - Последовательно - если нужно углубление: первый агент находит, второй копает глубже
- На какие аспекты фокусироваться?
- Похожие доработки и паттерны - Архитектура и слои абстракции - Интеграции и зависимости - Критичные компоненты, найденные предыдущими агентами
- Итеративное углубление
- Можешь запустить агента, посмотреть результаты, решить нужно ли ещё углубление - Каждый следующий агент может фокусироваться на находках предыдущих
Действия:
- Прими решение о стратегии исследования (обоснуй коротко)
- Запусти агентов
1c-code-explorerсогласно своей стратегии:
- Передай путь к требованиям: phase1-requirements.md - Укажи фокус исследования для каждого агента (паттерны, архитектура, похожие доработки и т.д.)
- Каждый агент должен вернуть список нескольких ключевых файлов для чтения
- Прочитай все указанные файлы для глубокого понимания
- Оцени: достаточно ли понимания? Нужно ли ещё углубление? Если да - запусти ещё агентов
- Представь полную сводку найденных паттернов
- Сохрани сводку в файл
.tasks/task-[feature-name]/phase2-exploration.md:
- Найденные паттерны и соглашения - Похожие доработки с ссылками на файлы - Ключевые компоненты и их назначение - Архитектурные инсайты - Список всех прочитанных ключевых файлов
Phase 3: Уточняющие вопросы
Цель: заполнить пробелы и разрешить все неоднозначности ДО проектирования
Действия:
- Просмотри находки по кодовой базе и исходный запрос на доработку
- Выяви недетализированные аспекты: граничные случаи, обработка ошибок, точки интеграции, границы области, предпочтения дизайна, обратная совместимость, потребности производительности
- Представь все вопросы пользователю в ясном, организованном списке
- Жди ответов перед проектированием архитектуры
- Сохрани вопросы и ответы в файл
.tasks/task-[feature-name]/phase3-clarifications.md:
- Список вопросов с контекстом - Ответы пользователя на каждый вопрос - Принятые решения и рекомендации
Если пользователь говорит "как считаешь нужным", предоставь свою рекомендацию и получи явное подтверждение.
Phase 4: Проектирование архитектуры
Цель: спроектировать архитектуру реализации
АДАПТИВНЫЙ ПОДХОД - количество агентов зависит от сложности:
Простая задача (1 агент):
- Запусти 1 агента
1c-code-architect - Создай один практичный план реализации
Средняя задача (1 агент + опциональное мультисэмплинг):
- По умолчанию: 1 агент с практичным планом
- Опционально: если решение неочевидно, можешь запустить 2 агента с разными подходами и выбрать лучший
Сложная/критичная задача (2-3 агента, мультисэмплинг):
- Запусти 2-3 агента
1c-code-architectпараллельно с разным фокусом:
- Минимальные изменения (наименьшее изменение, максимальное переиспользование) - Чистая архитектура (поддерживаемость, элегантные абстракции) - Прагматичный баланс (скорость + качество)
- Сформируй мнение о лучшем подходе
- Представь пользователю все подходы с твоей рекомендацией
- Спроси пользователя, какой подход он предпочитает
Действия:
- Запусти агентов
1c-code-architectсогласно сложности задачи:
- Передай пути к артефактам: phase1-requirements.md, phase2-exploration.md, phase3-clarifications.md - Для каждого агента укажи архитектурный подход (минимальные изменения / чистая архитектура / баланс)
- После выбора подхода создай файл
.tasks/task-[feature-name]/phase4-architecture.mdс:
- Постановкой задачи - Оценкой сложности из Phase 0 - Выбранным архитектурным подходом с обоснованием - Найденными паттернами и соглашениями из Phase 2 - Ответами на уточняющие вопросы из Phase 3 - ЭТАПАМИ РЕАЛИЗАЦИИ - разбей реализацию на логические этапы (чеклист в markdown): - Гранулярность: простая задача = 1 этап, средняя = 2-4, сложная = 4-8, критичная = 5-10+ (отталкивайся от атомарности) - Атомарность: этап завершается за 1 сессию агента, имеет проверяемый результат, не блокирует сам себя - Формат: - [] **Этап N**: описание + файлы + критерии приемки + зависимости (если есть) - Mermaid-диаграммами (архитектура, потоки данных) - План должен быть самодостаточным для понимания без контекста беседы
Phase 5: Ревью плана
Цель: валидировать план ДО реализации — ошибки в плане обходятся дорого, весь код придётся переписывать.
Действия:
- Запусти агента
1c-code-architectдля ревью плана:
- Передай пути к артефактам: phase1-requirements.md, phase2-exploration.md, phase3-clarifications.md, phase4-architecture.md - Фокус ревью: - Полнота: все ли аспекты задачи покрыты? - Корректность: соответствуют ли решения найденным паттернам из Phase 2? - Реалистичность: можно ли реализовать план как описано? - Соответствие требованиям: покрывает ли план все требования из Phase 1 и ответы из Phase 3? - Критерии приемки этапов: достаточно ли чёткие и проверяемые? - Зависимости: правильно ли выстроена последовательность этапов? - Технический долг: есть ли известные проблемы, которые план усугубит?
- Если агент находит проблемы:
- Обнови план в .tasks/task-[feature-name]/phase4-architecture.md - Повтори Phase 5 (ревью обновлённого плана)
- Когда план одобрен агентом, сохрани результаты ревью в
.tasks/task-[feature-name]/phase5-plan-review.md:
- Что было проверено (полнота, корректность, реалистичность и т.д.) - Какие проблемы были найдены и исправлены (если были) - Итоговое заключение: план готов к реализации
- Представь план пользователю:
- Краткое резюме плана - Этапы реализации с критериями приемки - Спроси явно: "План готов к реализации, можем начинать?"
НЕ ПЕРЕХОДИ К PHASE 6 БЕЗ ЯВНОГО ОДОБРЕНИЯ ПОЛЬЗОВАТЕЛЯ
Phase 6: Реализация по этапам
Цель: построить доработку атомарными шагами с проверками приемки
НЕ НАЧИНАЙ БЕЗ ОДОБРЕНИЯ ПОЛЬЗОВАТЕЛЯ
Действия:
- Прочитай файл плана
.tasks/task-[feature-name]/phase4-architecture.md - Для каждого этапа реализации последовательно: a. Отметь этап в плане как начатый (измени
- []на- [🔄]в файле плана) b. Запусти агента1c-code-writerдля реализации этапа:
- Передай путь к плану - Укажи конкретный этап для реализации - Напомни про критерии приемки c. Проверь критерии приемки этапа: - Все файлы созданы/изменены как описано? - Критерии приемки выполнены? - Код соответствует правилам из 1c-rules.md? d. Если критерии не выполнены: - Запусти агента 1c-code-writer для исправления: - Передай путь к плану и укажи этап - Опиши найденные проблемы и что нужно исправить - Повтори проверку критериев - Повторяй цикл исправления, пока критерии приемки не будут выполнены e. Отметь этап в плане как завершённый (измени - [🔄] на - [x] в файле плана)
Phase 7: Ревью кода
Цель: убедиться, что код корректен, элегантен и соответствует плану
Действия:
- Запусти ревьюеров согласно размеру задачи:
- Простая: 1c-code-reviewer - Передай путь к плану: phase4-architecture.md - Фокус: базовая корректность + беглая проверка соответствия плану - Средняя/сложная: - 1c-code-architect для проверки соответствия плану: - Передай пути к артефактам: phase1-requirements.md, phase4-architecture.md, phase5-plan-review.md - Фокус: соответствие плану, архитектурным решениям, критериям приемки этапов - 1c-code-reviewer для проверки качества кода: - Укажи путь к правилам: ~/.claude/rules/1c-rules.md - Фокус: баги, читаемость, правила, DRY, элегантность - Очень большая: раздели код на логические модули/подсистемы, для каждого модуля запусти пару агентов (architect + reviewer) с теми же инструкциями
- Консолидируй их ответы и выяви проблемы, требующие исправлений
- Сохрани результаты ревью в
.tasks/task-[feature-name]/phase7-code-review.md:
- Что было проверено (соответствие плану, качество, баги и т.д.) - Найденные проблемы с severity и рекомендациями - Итоговая оценка готовности кода
- Представь выявленные проблемы пользователю и спроси, что он хочет сделать:
- Исправить сейчас - Исправить позже (добавить в TODO/технический долг) - Продолжить как есть
- Если "исправить сейчас":
- Добавь проблемы в план в секцию "Исправления после ревью" - Запусти агента 1c-code-writer для исправления: - Передай путь к плану: phase4-architecture.md - Опиши проблемы из ревью и что нужно исправить - Вернись к началу Phase 7 (повторное ревью) - Повторяй итерации, пока ревьюеры не перестанут находить критические проблемы
- Если "исправить позже":
- Добавь проблемы в план в секцию "Технический долг" - Отметь в плане как отложенные
Phase 8: Итоги
Цель: документировать выполненное
Действия:
- Отметь все задачи как завершённые
- Сохрани резюме в файл
.tasks/task-[feature-name]/phase8-summary.md:
- Что было построено (ссылки на этапы реализации) - Ключевые принятые решения (ссылка на план) - Изменённые файлы (git diff --stat) - Оставшийся технический долг (если есть) - Предлагаемые следующие шаги
- Представь резюме пользователю