Спецификация как актив: заметки о чтении и написании в эпоху ИИ

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

С другой стороны, чего греха таить, и написание книг свелось к похожей работе.

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

Написание книг сродни написанию кода

В эпоху генеративного ИИ спецификация становится главным активом, а код — её производным. Традиционные юзкейсы (Якобсон, 1987; Кобёрн, 2001; Use-Case 3.0, 2024) переживают возрождение, потому что идеально подходят для нового — третьего — читателя: ИИ-агента.

Simon Martinelli в книге «Writing Use Cases for AI» делится на эту тему следующими мыслями.

Инверсия экономики разработки

Раньше реализация была дорогой, а спецификация — дешёвой. Теперь наоборот: код генерируется дёшево и быстро, а точное выражение намерения стало узким местом.

ИИ не может оставить пробел незаполненным. Недосказанность возвращается не вопросом, а изобретённой функцией.

Пять принципов эпохи ИИ

Дополнение к десяти принципам Use-Case 3.0:

1. Спецификация переживает код — код можно регенерировать, спецификация остаётся активом.
2. Пиши для трёх читателей в порядке: стейкхолдер → инженер → ИИ.
3. Будь точен в наблюдаемом, молчи о механизме.
4. Тесты несут истину — без тестов юзкейс лишь пожелание.
5. Сначала меняй спецификацию — любое изменение (фича, баг, запрос) проходит через неё.

Правило звучит так: указывай всё, что стейкхолдер может наблюдать, а тест — проверить. Не указывай ничего о том, как система это достигает.

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

Книга годная — хотя и не стала чем-то принципиально новым, но всё же рекомендуется к прочтению.