⚪️ Флоу инжиниринг: планирование

#flow

❓ Вопрос аудитории - кто как планирует? Для эвала на силу кодинга моделей задумал улучшить планирование в своем флоу. Хочу составить очень подробный крутой план. Кто как к этому вопросу подходит?

▶️ Я сейчас делаю так: стадии процесса:
• подготовка контекста,
• обсуждение,
• планирование

▶️ Стадия подготовки контекста: сначала делаю прайминг свежего контекста индексом меморибанка. Потом прошу агента подготовится по вопросам подсистем, с которыми собираюсь работать. Например "изучи работу cli в системе, сформируй контекст, подготовься. Возвращайся как будешь готов"

▶️ После этого начинаю обсуждать доработки/задачу, в свободной форме. Прошу составлять план работы. По план спрашиваю: что осталось неясным? Что можешь доработать? что не учли/забыли? Какие смежные вопросы не проработаны? Какие gaps остались?

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

Этап финалится, когда мне кажется, что мы с агентом пришли к устраивающему меня пониманию вопроса.

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

▶️ После этого зависит от процесса: если через оркестратор - то там системный промпт на планирвоание. Если "руками" - то прорабатываем план:
• разбиваем работу на шаги оптимального размера для одной итерации
• если по кодовой базе остаются неопределенности - планируем как подадачи проведение исследований на темы, требующие прояснения или доп исследований
• без оверинжиниринга, задачи решаем максимально простым способом из имеющихся но с полной требуемой функциональностью
• не вводим новых сущностей, абстранций, слоев без крайней на то необходимости
• максимально переиспользуем имеющиеся общие модули, хелперы, классы, другие сущности системы
• тестовое покрытие: важно сделать реализацию сценария использования системы с обсуждавшейся доработкой в формате теста, который может прогнать агент, все остальные тестовые штуки - вспомогательные
• гейты качества: typecheck / lint / build / test:unit / test:integration / test:e2e

В оркестраторе примерно так же, но чуть сложнее: там для каждого шага еще и исследования прописаны, со ссылками на артефакты исследования, прописан контекст, релевантные файлы и прочие всякие штуки. можно и вручную попросить это сделать до реализации!

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

👉ИТАК: а ваш флоу какой? Какой видите идеальный процесс планирования?

@deksden_notes