Agentic Engineering — Addy Osmani (Рубрика #Books)

В самолёте по пути на Мальдивы прочитал "Agentic Engineering" Addy Osmani. Книга ещё в раннем доступе: в моей версии пять глав из восемнадцати запланированных. И уже много узнаваемого. Османи удачно собирает в одну картину вещи, которые постепенно обнаруживаешь в работе с агентами: код появляется всё быстрее, а вопросов к собственной работе становится больше.

Особенно зацепила глава про спецификации. Когда писать код становится дёшево, всё важнее понять, что именно нужно сделать. У меня с Spec Kit это регулярно происходило буквально по ходу уточнений: начинаешь с вроде бы понятной просьбы, агент задаёт вопросы, и выясняется, что задача сложнее, а результат нужен немного другой. Пока формулируешь требования, успеваешь пересмотреть собственный замысел. Вот в этом смысле спецификация для меня стала инструментом мышления.

Например, «добавить PDF-вложения на сайт» с аннотированными разборами whitepaper. Звучит как кнопка скачивания. А дальше: храним копию или ссылку? Как убедиться, что документ тот самый? Что произойдёт при повторном импорте? Можно ли считать перенос завершённым, если страница открывается, а файл недоступен? Постепенно за кнопкой обнаруживается целый процесс переноса публикации, в котором ничего не должно потеряться. Кнопка там тоже будет :)

Конечно, агент может сам написать красивую спецификацию, план, код и отчёт о том, что всё выполнено. Поэтому ценность всей этой работы я вижу в моментах, когда приходится сказать: «Я этого не учитывал» или «Такую сложность я не готов принимать». Если после уточнений решили половину не делать — тоже полезный результат.

Хочется только, чтобы с каждым новым запуском не приходилось заново объяснять всё, до чего уже додумались. И здесь мне близок разговор Османи про harness — среду работы агента с её инструментами, контекстом и проверками. Я смотрю на неё как на место, где может накапливаться опыт команды. Почему приняли архитектурное решение, как выполнять повторяющуюся задачу, какую ошибку теперь ловит тест — всё это остаётся доступно следующему исполнителю.

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

С несколькими агентами цена таких договорённостей становится ещё заметнее (особенно, если агенты из разных лагерей, навроде, Claude, Codex, Cursor и Open Code с китайскими модельками). Пока исполнитель один, многое можно удерживать в голове и поправлять по ходу. А если один делает импортёр, другой — отображение документов, им придётся заранее договориться, что они передают друг другу. Иначе оба закончат работу, а соединять два разных понимания задачи придётся тебе.

Здесь согласен с Османи: самостоятельность агента и умение координировать нескольких — разные вещи. Можно далеко отпускать одного исполнителя или внимательно следить за несколькими. Само количество запущенных окон ещё ничего не говорит: легко получить очередь изменений, которую уже не успеваешь осмыслить. Код пишется, а ты разбираешь вопросы, переключаешься между задачами и проверяешь чужие решения. Работы руками меньше, решений в единицу времени — больше.

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

#Books #AI4SDLC #Agents #Engineering #Management