Работа над задачами

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

• Простая задача - как угодно любым способом, просто промпт в сессии. Остальные обязательные командные процессы (автоматические тесты, код-ревью и так далее) соблюдаются
• Сложная задача - описываем задачу по командному шаблону (например, с помощью специального скилла вместе с ИИ-агентом)
• Большое архитектурное изменение или новый проект - можно попробовать специальные подходы к планированию и дизайну - типа planning-with-files или BMAD-Method
• Автономная задача - используем специальные подходы Ralph Loop, Getting Shit Done, etc.
• Повторяющаяся задача - используем/создаём скилл или субагента, коммитим в репу

Пример процесса для сложной задачи

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

• Цель - что именно должно получиться на выходе
• Важный контекст - какая часть проекта, скорее всего, будет затронута, где взять нужные данные, что точно делать не надо (ограничение скоупа), зачем мы это делаем. Это значительно ускорит процесс работы над задачей
• Что нельзя менять - описываем, какие части системы нельзя менять в ходе работы над задачей. Например, нельзя менять контракт API, схему БД, зависимости, бизнес-логику и так далее
• Ограничения и правила - какие-то дополнительные штуки, не описанные в CLAUDE.md. Например, если мы хотим использовать конкретную библиотеку, обязательно переиспользовать какой-то код или просим агента при каждом затупе обращаться к нам за уточнением
• Верификация результата - какие тесты надо запустить, какие добавить, какие сценарии проверить. Чем детальнее, тем лучше
• Артефакт - какой формат должен быть. Например, маркдаун с анализом, коммит, отчёт по тестированию

Этот этап удобно проводить с помощью специального скилла, который может добавить на уровне организации или команды.

Потом просим агента прочитать получившееся описание и приступить к выполнению. Просим обновить описание задачи и создать TODO-лист, сохранить в отдельный файл, трекать там прогресс.

Пример процесса после завершения задачи

• Запускаем /simplify — чистим грязный и мёртвый код
• Просим код-ревью через субагента. Просим исправить найденные косяки или вместе с агентом проходимся по ним
• Просим проверить и по необходимости обновить всю документацию (можно создать скилл для этого)
• Анализируем сессию на предмет необходимости изменения CLAUDE.md, добавления MCP или скиллов в репозиторий. Можно заюзать cc-sessions для анализа сессий
• Проводим ручную верификацию результатов согласно правилам команды (докер собирается, тесты проходят, метрики правильные и так далее)
• Руками описываем пулл-реквест

Важно: Всё, что можно протестировать автоматически, должно быть протестировано автоматически самим агентом ещё на этапе имплементации! Человеческое ревью должно быть сконцентрировано на бизнес-логике, архитектуре, UX, ML-решениях.