Спокойно. Сначала план, потом промпт.

Недавно я кое-что понял о своём бывшем руководителе.

Он всё пытался убедить меня пользоваться Kiro.

«Бассель, используй Kiro».

Моя первая реакция была простой:

«Что, чёрт возьми, такое Kiro?»

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

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

Результат появляется. Он работает. Возможно, где-то прячутся две небольшие галлюцинации, но при беглом осмотре ничего не выглядит сломанным.

Поэтому я выпускаю это.

Быстро. Аккуратно. Готово.

По крайней мере, так я себе говорил.

Мой руководитель заметил проблему

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

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

Поэтому он и повторял:

«Бассель, используй Kiro».

Kiro пишет код, как и многие другие инструменты ИИ. Его настоящая ценность в том, что он побуждает определить работу до того, как вы попросите ИИ её выполнить.

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

Проще говоря, Kiro заставлял меня планировать.

И, судя по всему, меня нужно было заставить.

Промпты и планирование требуют разных навыков

Хороший промпт может содержать множество деталей. Он может описывать базу данных, интерфейс, валидацию, тесты, безопасность и ожидаемое поведение.

Даже подробный промпт может скрывать слабую проработку мысли.

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

Затем ИИ сразу начинает реализацию.

Скорость впечатляет, но за ней может скрываться неопределённость. Вы видите, как появляются файлы, запускаются тесты и отображаются компоненты. Это движение создаёт впечатление, что проблема уже понята.

Иногда она лишь интерпретирована.

Планирование создаёт паузу между желанием что-то получить и его созданием. Во время этой паузы можно спросить:

• Какую проблему мы на самом деле решаем?
• Какое поведение должна поддерживать система?
• От каких действий она должна явно отказываться?
• Какие решения влияют на архитектуру?
• Что может сломать существующую функциональность?
• Как мы узнаем, что реализация правильная?

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

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

Проблема фастфуда

Представьте, что промпты без планирования подобны фастфуду.

Вы голодны. Заказываете что-нибудь. Заказ приходит почти сразу. Вкусно, и сиюминутная проблема исчезает.

Вы не узнали, как это приготовили. Вы не обязательно знаете состав. Возможно, вы даже не заметите, чего не хватает, потому что всё внимание сосредоточено на том, как быстро исчез голод.

Именно так может ощущаться быстрая реализация с помощью ИИ.

Вы просите функцию. Функция появляется. Вы пару раз по ней кликаете. Ничего не взрывается.

Выпущено.

Но чему вы научились?

Понимаете ли вы, почему база данных устроена именно так? Можете объяснить модель авторизации? Знаете, какие предположения сделал агент? Что произойдёт, когда другому разработчику потребуется изменить эту функцию через полгода?

У фастфуда есть своё место. Иногда это именно то, что нужно. Прототипам, экспериментам, одноразовым инструментам и ранним идеям не всегда нужна формальная спецификация.

Ошибка начинается, когда вы едите фастфуд каждый день и называете это полноценным питанием.

Две «безобидные» галлюцинации

Раньше я относился к небольшим галлюцинациям ИИ как к фоновому шуму.

ИИ неправильно понял две детали? Ладно. Функция всё равно работает.

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

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

Этап планирования делает эти решения видимыми.

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

Исправить его тогда гораздо дешевле.

Скорость по-прежнему важна

Я сохраняю быстрые промпты в своём рабочем процессе. Это одна из моих сильных сторон, и было бы глупо притворяться, что это не так.

Урок в том, что скорость становится ценнее, когда у неё есть направление.

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

Цель состоит в осознанном выполнении без ненужной бюрократии.

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

Определите требования.

Проверьте проект.

Разбейте работу на задачи.

А затем позвольте ИИ двигаться быстро.