Не отдавайте ИИ то, что должны придумать сами

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

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

Решение пришло, когда он перестал делегировать ИИ продумывание. Теперь он чётко разделяет, что должен придумать сам, а что можно отдать машине. В его подходе документация и архитектура работают как стенки конуса, которые направляют агента к цели, а роудмап становится линией по центру этого конуса. Свою схему он назвал «пятислойным харнесом» для Claude Code. Она охватывает весь путь от пустой папки с одним именем до папки с готовым кодом, в которую автор ни разу не заглянул.

Главный совет разработчика коллегам звучит просто: не отдавайте ИИ то, что должны придумать сами. Иначе даже самый мощный агент будет генерировать уверенные, но бесполезные результаты. Сначала продумайте структуру и контекст, а остальное модель сделает сама.