Подготовка и утверждение спецификации

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

Подготовка и утверждение​

Задай границы до подготовки черновика​

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

Практический цикл выглядит так:

Исходный замысел человека → Исследование → Черновик: вытекающие требования и отдельные предложения расширить объём работ → Критическое ревью: оспорить, проследить, убрать → Исправления без незаметного расширения → Человек принимает, отклоняет, откладывает или уточняет → Утверждение

Исследование​

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

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

Обнаруженное — свидетельство, а не разрешение. Факт может обосновывать требование; возможность становится лишь предложением, решение по которому принимает человек. В бенчмарке выполнения задач агентами для программирования отказ от явного согласия повысил долю действий Claude Code, которых пользователь не запрашивал, с 0% до 17,1%.¹ Исследование проверяло выполнение, а не подготовку спецификаций, поэтому напрямую переносить эти числа нельзя. Но они показывают, почему агент не должен принимать правдоподобную возможность за разрешение.

Черновик​

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

Критическое ревью​

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

Исправление​

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

Критическое ревью и исправления делают черновик точнее до чтения человеком. Они не устанавливают ответственность за замысел: ревью с помощью LLM всё ещё вероятностно, и только человек может решить, верен ли получившийся замысел.

Прочитай и прими решение​

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

Порядок имеет значение. Люди, которые формируют собственное суждение до знакомства с советом ИИ, значительно реже принимают его вслепую — ценой дополнительных усилий и удобства.² Уверенность действует в обратную сторону: чем больше люди доверяют ИИ-ассистенту, тем менее критически оценивают его результат.³ Оба наблюдения указывают на одно: человек принимает решение до того, как вывод агента становится решением.

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

Количество циклов подготовки зависит от случая. Для знакомого, обратимого изменения может хватить одного прохода. Новая, дорогая или опасная работа может потребовать профильных рецензентов, альтернатив, прототипов или нескольких редакций до утверждения.

Главное​

• Задавай границы до черновика. Начинай с замысла, сформулированного человеком так, чтобы последующие расширения объёма работ были заметны. Гладкий черновик, обходящий этот исходный шаг, рискует превратить предложения агента в уже принятые решения.
• Исследование даёт свидетельства, а не разрешение. Агент может выявлять факты, формирующие требования, но возможности остаются предложениями до утверждения человеком. Явно отмечай разницу.
• Критическое ревью ищет слабые места. «Прожарка» проверяет черновик по коду и внешним свидетельствам, а не одобряет его. Проход, не нашедший ничего подозрительного, не выполнил свою работу.
• Человек решает до того, как вывод агента становится решением. Утверждение — итог человеческого суждения, а не беглый просмотр текста ИИ. Люди, сначала формирующие собственное мнение, критичнее принимают советы ИИ.