Всё, как у людей

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

Я работаю в Codex (да, я нетакуся, не в Claude). Пробовали разные подходы: по треду на фичу, по треду на отдельный элемент продукта, общий тред, отдельные треды на ресёрч и имплементацию, треды с сабагентами. Путалась в тредах, треды постоянно сжимали контекст и превращались в лунтиков. В общем, много часов бессистемной работы.

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

TL;DR мне удалось упорядочить работу, разграничить контексты и в каждый момент времени понимать, в каком состоянии проект и почему. Что добавлено, как работает, почему уверены в этом. В чём не уверены. Что подметили, но отложили на потом. Что ещё предстоит делать. Какие решения ещё не приняты. Что нужно сделать руками. Или головой. Целевое состояние, к которому идём.

Работает это так: копирую шаблон, запускаю init-flow, который опрашивает меня, что будем делать. Он адаптирует шаблон под конкретный проект, собирает бриф проекта и приблизительный роудмап. Дальше передаёт руль координатору. Координатор предлагает следующие шаги, запускает других агентов (архитекторов, аналитиков, воркеров, деплоеров, и т.д.) под каждую следующую фичу. Зовёт меня в непонятных ситуациях или в кейсах, предусмотренных доками. Держится всё не только на мдшках, но и на кодексовских конфигах.

Работа полностью распределена — координатор только рулит и создаёт тиммейтов. Воркеры пишут, ревьюверы только тестят, писать им запрещено. Всё общение со мной через координатора.

Из забавного, периодически координатор реально эскалирует на меня, например, в одном из проектов ревьювер отказывался принимать фичу из-за несоответствия критериям приёмки — агент не мог протестировать сценарий на стейдже из-за доступов. Ревьювер встал в позу, координатор не смог с этим ничего сделать и принёс ситуэйшн мне. Разобрались — протестила сценарий вручную, говорю «передай ревьюверу, что я всё проверила, можно принимать». Ревьювер принял, но с пометкой, что тестирование выполнено частично вручную (снял с себя ответственность, выходит). Только потом разблокировалась возможность переходить к следующей фиче.

В общем, с таким сетапом моя роль сводится по большей части к вычитке доков, булшит-чеку требований и планированию. Ещё из наблюдений — итеративная работа с агентами, которая строится на роудмапе+фича-доках+фоллоупах позволяет тормозить самого себя, когда хочется напихать гениальных идей в неподходящий момент. Координатор ведёт лог моих хотелок, но не позволяет мне навалить в «спринт», когда ведётся работа над чем-то другим. Или пока мы не зафиналили пререквизиты.

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

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

P.S. самое приятное, что теперь процентов 60 моих промптов это «What’s next?» и «Proceed!».

Вот такие пироги.