Слогер Создать блог
Разработка

Разбор: почему ИИ-агент ломает архитектуру и как это лечит спецификация

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

Агент в редакторе кода снял ограничение по синтаксису. Ограничение по смыслу осталось на месте, и именно оно решает, останется ли от проекта что-то через полгода. Дальше — разбор подхода, в котором главный артефакт это спецификация, а код — то, что из неё следует.

Сайт на языке, которого не знаешь

Разработчик с тридцатью годами опыта в C# взял заказ: объяснить клиенту, что ChatGPT даёт команде, которая пишет на PHP. PHP он не писал ни строчки. Собрал рабочий сайт — с чтением из API, таблицей данных, экспортом в CSV и JSON, разбором XML, рендером markdown в HTML.

Проверял он его не чтением кода. Читать он его не мог. Проверял запуском: на выходе корректный CSV или нет, отрендерился markdown или нет. Объяснение от модели прилагалось, доказательством служил результат.

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

Почему барьер был не в инструментах

В 2024-м вокруг уже вовсю ходили Aider, Cursor, первые разговоры про Claude Code. Все они жили в терминале. Для человека, тридцать лет просидевшего в Visual Studio, это достаточная причина, чтобы отложить знакомство в папку «когда-нибудь». Не потому, что сложно. Потому, что есть трение на входе.

В феврале 2025-го агентный режим GitHub Copilot появился прямо в VS Code. Ctrl+Alt+I — и всё. Никакого нового рабочего процесса до того, как ты начнёшь. Демократизация в чистом виде: то, чем друзья пользовались год, стало доступно любому, кто умеет нажимать три клавиши.

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

Что вылезает через две недели работы с агентом

Код работает. И постепенно расходится с архитектурой. Фичи появляются быстрее, чем ревью успевает за ними ходить. В кодовой базе накапливаются решения, которых никто не принимал: просто след от череды согласованных подсказок. Намерение нигде не записано. Скорость есть, расписок нет.

Точная метафора нашлась в литературе — дворецкий из «Остатка дня» Исигуро. Безупречное исполнение в услужении у непроверенного направления. Красивая работа, и никто не спросил, туда ли вообще едет дом. Вайб-кодинг устроен ровно так.

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

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

Спецификация как долговечный артефакт

В сентябре 2025-го GitHub выпустил Spec Kit — структуру для написания спецификаций, которые агент может исполнять. Не готовая методика, скорее словарь. Появился термин specification-driven development и вместе с ним простая мысль: долговечный артефакт — спецификация, код у неё в подчинении, и его можно перегенерировать.

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

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

Что писать в такой спецификации

  • Границы. Что делаем и что сознательно не делаем в этой итерации.
  • Ограничения архитектуры. Слои, зависимости, что ломать нельзя и почему.
  • Список «у нас так не принято». С причиной. Без причины агент обойдёт запрет по кратчайшему пути.
  • Критерии приёмки в виде проверяемых входов и выходов. Не «должно быть удобно», а «на входе такой файл — на выходе такая таблица».
  • Определение готовности. Ревью, тесты, обновлённая документация.

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

Три способа работать и что остаётся после

ПодходЧто остаётся в проектеЧерез полгодаГде ломается
Промпт в чатеВставленный код и переписка, которую никто не читаетРешение живёт, причина неизвестнаЗадача выходит за размер одного ответа
Вайб-кодинг без ревьюРаботающая функциональность и груда решений без записи о намеренииАрхитектура расходится с кодом, правки дорожаютПервый серьёзный хотфикс и первый новый человек в команде
Спецификация первойДокумент с границами, ограничениями и критериями приёмки плюс код под нимВидно, почему сделано именно так, и что можно менятьДокумент устаревает, если его перестали обновлять

Две ошибки, которые обходятся дороже прочих

Первая — принимать объяснение за доказательство. Модель складно расскажет, почему её код верный. Читать это приятно и бесполезно. Работает только прогон: подставил входы, посмотрел выходы. Если проверить результат нечем, задачу брать рано, каким бы красивым ни был ответ.

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

Что в остатке

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

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

По материалам: career. Текст переработан редакцией Слогера.

← На главную

Рекламное место — Конец поста
Реклама · Слогер

Комментарии (0)

Войдите, чтобы комментировать.

Пока нет комментариев. Будьте первым.

Личный опыт

Как довести до конца одно незаконченное дело: метод одной даты

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

Слогер 19.11.2026 ▲ 0
Карьера

Как автоматизировать отклики на вакансии: разбор автозаполнения заявок на Greenhouse, Lever и Ashby

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

Слогер 18.11.2026 ▲ 0
Карьера

Как выбрать между двумя офферами на стажировку: разбор по шагам

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

Слогер 18.11.2026 ▲ 0
Fluxs lenta
Реклама · fluxs.ru
Стартапы

Fluxs включён в реестр российского ПО Минцифры России

🇷🇺 **Fluxs официально включён в реестр российского ПО!** Наша платформа для управления бизнесом вошла в Единый реестр российских программ Минцифры России. Это важный этап развития Fluxs и новые возможности для сотрудничества с российскими компаниями, банками и организациями, заинтересованными в импортозамещении.

Слогер 17.11.2026 ▲ 0
Разработка

Как получить от клиента согласование сайта на staging: чек-лист приёмки

Устное «выглядит хорошо» в мессенджере не защищает никого: через месяц не вспомнить, что именно смотрели и на какой версии. Вот как превратить просмотр staging в нормальную запись о приёмке.

Слогер 17.11.2026 ▲ 0
Карьера

WARN Act: как работает закон о сокращениях и что делать, если уведомление не пришло

Федеральный WARN Act обязывает крупных работодателей предупреждать о закрытии предприятия или массовом сокращении за 60 дней. Разбираем пороги, исключения и порядок действий — на примере отрасли вывоза и переработки отходов, где сокращения легко пропустить.

Слогер 17.11.2026 ▲ 0
Fluxs lenta
Реклама · fluxs.ru
Карьера

Как читать WARN-уведомления о сокращениях: разбор календаря увольнений на 2027 год

Пересчёт уведомлений с датами вступления в силу в 2027 году дал 4 950 человек вместо 2 882 — и это всё ещё нижняя граница. Разбираем, откуда берётся разница в 42% и как не обмануться такой статистикой.

Слогер 17.11.2026 ▲ 0
Разработка

Заменит ли ИИ программиста: что показывают исследования и как выбрать между ИИ и разработчиком

Вопрос «зачем платить разработчику, если ИИ пишет код» построен на неверном представлении о работе программиста. Разбираем два исследования, цену такого заблуждения и практический чек-лист.

Слогер 17.11.2026 ▲ 0
Стартапы

Почему сотрудники забывают задачи и как это исправить | FLUXS

📌 **Почему сотрудники забывают поручения, даже когда всё записано?** Задача поставлена. Сотрудник записал. Срок прошёл. Результата нет. Такая ситуация встречается часто, и часто проблема не в дисциплине, а в отсутствии прозрачной системы управления задачами. Кто исполнитель? Какой срок? На каком этапе работа? 🚀 **FLUXS помогает управлять поручениями и выстраивать бизнес-процессы под правила вашей компании.** А встроенный ИИ-ассистент помогает создавать и настраивать процессы выполнения задач. 👉 Попробуйте конструктор бизнес-модели: https://fluxs.ru/konstruktor-biznes-modeli #FLUXS #УправлениеЗадачами #АвтоматизацияБизнеса #БизнесПроцессы

Слогер 16.11.2026 ▲ 1
Fluxs lenta
Реклама · fluxs.ru
Карьера

Как делиться опытом, если вы не эксперт: ловушка «об этом уже написали» и рабочие форматы

Мешает делиться знаниями не их дефицит, а мысль, что они недостаточно весомые. Разбираем, что считать полезным вкладом, как писать конкретно и с чего начать без давления.

Слогер 16.11.2026 ▲ 0