Вчера я подхватил чужой эпик. Коллеги несколько дней не будет, а работа ждать не может.
Сегодня утром я написал промпт, чтобы кодинг-агент продолжил работу. Перечитав его, я заметил, что про задачу там почти ничего нет. Сама задача умещается в одно предложение: привести дизайн нескольких экранов в порядок, с вариантами, из которых я сначала выберу. Остальное про то, как мы работаем, кто за что отвечает и где агент должен остановиться.
Думаю, большую часть времени в ближайшие месяцы я потрачу именно на это, поэтому вот что было в промпте.
Контекст. Ссылки на спеку, мои заметки по спеке, прототип, правила по дизайну в AGENTS.md и 15 PR, которые мы смержили накануне, по одной строке на каждый. Так эпик попал ко мне, и так он попадает к агенту. Созваниваться никому не пришлось.
Как проверяется код. Сначала красный тест. Потом агент-писатель в своём worktree, отдельный агент-судья, который пытается сломать результат, и ревью-бот. Branch protection не пускает ничего в main без одобрения бота на последнем коммите. Писать код теперь быстро. Почти вся настройка про то, как его проверить.
Что агент не решает. Включать ли фича-флаг для клиента, решаю я. Сообщения в Slack остаются черновиками, отправляю их я сам. Один тикет в эпике принадлежит коллеге, и агент его не трогает. Если CI не зелёный или бот не одобрил, агент спрашивает меня и не мержит.
Мелкие привычки. Наш GitHub CLI работает только с префиксом репозитория. Соавторов в коммитах не указываем. Тикет упоминается ссылкой, названием, владельцем и статусом. Людям такое не записывают, а агент без записи ошибается в этом каждый раз.
Приватность. Демо-видео собираются из скриншотов браузера, а не из записи экрана, потому что запись захватывает уведомления и чужие окна.
Сам эпик про агентов, которые работают как члены команды: у каждого своя машина, статус и heartbeat. Мой любимый баг со вчерашнего дня: агент писал людям, что ждёт себя, хотя на самом деле ждал их. Мелкий баг в формулировке, но после такого статусу уже не доверяешь. Дальше добавляем превью изменений до их применения и отмену.
15 PR за день для нас теперь норма, и код нас не тормозил. Время ушло на другое: понять, что такое хорошо, и проверить это на стейджинге. Думаю, промпты будут становиться короче в части задачи и длиннее во всём остальном.