Бесплатные главы Купить

Бесплатно · без регистрации

Две главы
целиком

Введение и «Первое поручение»

Это настоящие главы гайда «Сам себе отдел», в той же читалке, что получают покупатели: словарик, разбор на примере, упражнение на 10–20 минут и готовый шаблон. Почту оставлять не нужно.

Независимое издание: гайд не связан ни с одной компанией-разработчиком ИИ и не обещает дохода. Все примеры в нём учебные.

Бит показывает на текст
ВступлениеПеред стартомДля кого книга и как по ней идти

Вступление

Введение

9 мин чтенияБесплатно

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

Азбука1Работа с агентом2Продвинутое3Сценарии4Деньги и право5Неделя 1
Карта книги: пять частей и финиш первой недели

Словарик главы

Гайд*
Пособие, по которому учатся шаг за шагом. В этой книге так же называем её саму. (от англ. guide, «путеводитель, руководство»)
ИИ*
Общее название программ, которые делают то, что раньше умел только человек: пишут и переводят тексты, узнают речь, находят закономерности. (искусственный интеллект)
Модель*
«Обученная» программа, которая сочиняет ответы. Когда говорят «ИИ ответил», обычно отвечает она. Подробно в главе 01 «Что такое ИИ: объяснение без формул».
ИИ-чат*
Программа-собеседник: вы пишете сообщение, она отвечает текстом. Чат от англ. chat, «беседа»; бот от слова «робот». (чат-бот)
Агент*
Программа на основе модели, которая не только отвечает, но и действует сама: открывает ваши файлы, правит их, запускает команды (короткие текстовые приказы компьютеру), проверяет итог. Глава 05 «От чата к агенту». (ИИ-агент)
Промпт*
Текст, которым вы ставите задачу модели. В этой книге чаще говорим «поручение» или «вопрос». (от англ. prompt, «подсказка»)
Сессия*
Один непрерывный разговор с чатом или агентом: от начала до момента, когда вы закрыли его или начали новый.
Вайбкодинг*
Работа «на ощущениях»: описываете словами, что нужно, и принимаете результат, почти не читая и не проверяя. (от англ. vibe, «ощущение, настроение», и coding, «программирование»)
Агентная инженерия*
Ответственная работа с агентами: вы ставите задачу, проверяете итог и отвечаете за него. «Инженерия» напоминает, что это ремесло, которому можно научиться.
Навык*
Записанная инструкция для повторяющегося дела. Агент берёт её, когда задача подходит. Глава 09 «Навыки». (скилл, от англ. skill, «умение»)
Файл инструкций*
Обычный текстовый файл в папке проекта с правилами работы для агента. Глава 08 «Память проекта».
Чек-лист*
Перечень пунктов, которые вы отмечаете по очереди, чтобы ничего не упустить. (от англ. check list, «список для проверки»)
Лимит*
Ограничение сервиса на объём работы за период. Сервис здесь означает сайт или программу, в которой вы пользуетесь ИИ. Глава 18 «Деньги и лимиты».
«Песочница»*
Рабочая папка с копиями ваших файлов, где можно пробовать и ошибаться. Название по аналогии с детской песочницей: играть можно, но за её край ничего не рассыпается.

Кому этот гайд и что вы сможете через неделю

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

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

На полях вас встречает Бит, маленький парящий помощник. Со щитом он стоит там, где речь о безопасности, со счётчиком монет там, где о деньгах, с лупой там, где пора проверять результат.

Если заниматься по 30–60 минут в день, через неделю у вас будут:

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

Гайд учит поручать агенту рутину (повторяющуюся скучную работу) и проверять, что тот сделал.

Чат советует, агент делает

Представьте, что вы позвонили знающему консультанту. Он подробно объясняет, как свести три прайса в одну таблицу, а таблицу собираете вы. Это ИИ-чат.

Теперь представьте помощника, который сидит рядом за вашим компьютером. Он сам открывает три прайса, собирает таблицу и говорит: «Готово, вот что получилось, вот что мне осталось непонятным». Это агент.

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

Чего вы, возможно, опасаетесь

«Я не программист». Не страшно. Нужны умение ясно объяснить задачу и привычка проверять итог.

«Страшно что-то сломать». Для этого и нужна «Песочница»: вы работаете на копиях. Как делать надёжные копии и возвращать всё как было, расскажет глава 04 «Резервные копии и откат».

«ИИ заменит меня?» Наперёд этого не знает никто. Сегодня видно другое: агенты справляются с мелкими повторяющимися делами, а решить, что нужно клиенту, и отвечать за результат приходится человеку. Этому и учит гайд.

Как устроена книга

Книга состоит из пяти частей, заключения и приложений:

  1. Азбука (главы 01–04): ИИ простыми словами, файлы и папки, терминал (окно, где компьютеру пишут команды текстом), резервные копии (запасные экземпляры файлов на случай поломки).
  2. Работа с агентом (главы 05–10): от первой задачи до проверки результата.
  3. Продвинутое (главы 11–14): длинная работа, подключения, команда агентов, публикация.
  4. Сценарии из жизни (главы 15–17): готовые разборы с брифами (короткими описаниями задачи) и проверкой.
  5. Деньги, безопасность, право (главы 18–20).

Заключение, глава 21, даёт план на первую неделю. В конце четыре приложения: А (все шаблоны, то есть готовые образцы текстов, которые вы подставляете под себя), Б (большой словарь), В (что почитать дальше) и Г (разбор образцовых запросов: десять опубликованных запросов и файлов инструкций с пояснениями).

Каждая глава устроена одинаково: зачем она вам, словарик, примеры, «Сделайте сейчас» на 10–20 минут, шаблон, частые ошибки и «Коротко». Словарик повторяется в каждой главе намеренно: можно открыть любую главу и не искать слова в другой.

Выбирайте маршрут по своему уровню:

  • Совсем новичок. Часть 1, затем часть 2 по порядку.
  • Уже пользуетесь ИИ-чатом и уверенно работаете с файлами. Начинайте с главы 05 «От чата к агенту».
  • Есть конкретная задача. Главы 07 «Первое поручение» и 10 «Доверяй, но проверяй», затем нужный сценарий из глав 15–17. Перед настоящими данными прочтите главы 19 «Безопасность» и 20 «Данные клиентов и право».
  • Хотите подключить почту и таблицы. Сначала глава 12 «Подключения и чужой текст». Подключение здесь значит доступ, который вы даёте агенту к почте, таблицам или браузеру.
  • Хотите что-то опубликовать в интернете. Сначала глава 14 «Последняя миля: публикация».
попросили забыл???поручилпроверилпринял
Две дороги: «попросил и забыл» и «поручил, проверил, принял»

Как это называют в сети

Вы наверняка встретите слово «вайбкодинг». В начале 2025 года его придумал исследователь ИИ Андрей Карпати для особого режима работы: просишь словами, принимаешь результат и почти не читаешь, что получилось.

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

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

Что даст гайд

Гайд учит одному: поручать работу ИИ-агентам и проверять итог. Что это даст именно вам, время, деньги или новые заказы, зависит от ваших задач и от того, как вы примените приёмы. Гайд ничего не обещает: он даёт инструменты и привычки, а выбор дел остаётся за вами.

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

Что понадобится

  • Компьютер на Windows, macOS или Linux. Это операционные системы, то есть главные программы компьютера.
  • Доступ хотя бы к одному агенту или ИИ-чату. Для работы с файлами и задачами нужен именно агент. На октябрь 2026 самые популярные из них Claude Code и Codex (это названия программ, подробнее о них глава 05 «От чата к агенту»). Платят за доступ тремя способами. Подписка: фиксированная плата в месяц, но с лимитом на объём работы. Оплата за объём: вы платите за количество обработанного текста. Модель на вашем мощном компьютере: плата не нужна, но нужно «железо» (сам компьютер и его детали). Различия разобраны в главе 06 «Рабочее место». Для первых глав хватит и обычного ИИ-чата.
  • Папка «Песочница» с копиями нескольких рабочих файлов.
  • 30–60 минут в день на неделю.

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

Гайд независимый

Гайд не связан ни с одной компанией, чьи продукты в нём упоминаются, и никем из них не заказан. Названия инструментов приведены как примеры и принадлежат их владельцам.

Кнопки и окна программ меняются часто, поэтому здесь принципы и приёмы, а не расположение пунктов меню. Где без конкретики не обойтись, стоит пометка «на октябрь 2026»: так было на момент написания, сверьтесь со справкой программы (встроенной подсказкой, которую можно открыть из её меню). Законы о данных и правила сервисов сверяйте с теми, что действуют у вас.

Сделайте сейчас

Займёт около 20 минут.

  1. Создайте папку «Песочница» в документах или на рабочем столе. С ней вы будете работать всю неделю.
  2. Скопируйте в неё 5–10 файлов из реальной работы: таблицу, пару документов, несколько фотографий. Копируйте через «Копировать» и «Вставить»: если перетащить файл мышью в другую папку на том же диске (диск — место, где компьютер хранит файлы), он обычно переедет, а не скопируется. Оригиналы остаются на месте.
  3. Просмотрите копии. Уберите всё, где есть пароли, паспортные и банковские данные, личные сведения клиентов (имя вместе с телефоном и адресом).
  4. Заполните карту рутины из шаблона ниже: пять дел, которые вы повторяете каждую неделю. Она пригодится уже в главе 05.
ПесочницаОригиналы
«Песочница» с копиями отдельно от оригиналов

Шаблон

Шаблон
КАРТА РУТИНЫ

Дело | Времени в неделю | С какими файлами | Что раздражает
1.
2.
3.
4.
5.

Учебный пример (Олег):
Разбор съёмки | 3 часа | папка с RAW и JPG | переименовывать и раскладывать вручную

Частые ошибки

  • Читать подряд и откладывать упражнения. Умение появляется только после первых настоящих поручений.
  • Учиться на оригиналах. Ошибку в копии исправить легко, в единственном файле клиента тяжело. Для проб есть «Песочница».
  • Ждать «самый лучший инструмент». Приёмы из гайда работают в любом агенте. Начните с доступного.
  • Пропускать главы 19 и 20 перед работой с настоящими данными. Они берегут ваши деньги, данные и репутацию.
  • Ждать, что агент всё сделает без вас. Он выполняет поручения, а решает, что нужно, и принимает работу человек.

Коротко

  • Гайд учит поручать работу ИИ-агентам и проверять итог. Программировать не нужно. Что это даст вам, зависит от ваших задач и от того, как вы примените приёмы: гайд ничего не обещает.
  • Выберите маршрут: новичку части 1 и 2 подряд, уверенному пользователю с главы 05. Главы 19 и 20 прочтите до работы с настоящими данными.
  • Подготовьте «Песочницу» с копиями файлов и карту рутины.

Часть 2 · Работа с агентом

Первое поручение

18 мин чтенияБесплатно

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

Словарик главы

Агент*
Программа, которая сама читает ваши файлы, запускает команды и проверяет результат. Подробнее в главе 05 «От чата к агенту». (ИИ-агент)
Поручение*
Текст, которым вы ставите задачу модели или агенту. Базовые приёмы запроса к модели в обычном чате разобраны в главе 01 «Что такое ИИ: объяснение без формул». (на сленге «промпт», от англ. prompt, «подсказка»)
Бриф*
Короткий документ, где заказчик объясняет исполнителю, что нужно сделать. В этой главе так называем готовое поручение из пяти частей. (от англ. brief, «краткое изложение»)
ТЗ*
Документ, по которому исполнитель работает: что должно получиться и каким требованиям отвечать. (техническое задание; спецификацию в разговоре зовут «спека»)
Спецификация*
Похожее по смыслу подробное описание по пунктам; слово пришло из программирования.
Сессия*
Один непрерывный разговор с агентом, от открытия окна до закрытия. Новая сессия начинается без памяти о прошлой. (от англ. session, «сеанс»)
Контекст*
Всё, что агент видит прямо сейчас: ваши сообщения, прочитанные файлы, результаты его действий. «Рабочий стол» ограниченного размера.
Галлюцинация*
Уверенный ответ модели, которого нет в источниках: выдуманная цифра, имя, факт.
Исходные файлы*
Материалы, которые вы даёте агенту на входе: анкеты, замеры, фото. (исходники)
Путь к файлу*
Адрес файла на компьютере: цепочка папок, в которых он лежит. Глава 02 «Файлы, папки и форматы».
«Песочница»*
Рабочая папка с копиями ваших файлов, где можно пробовать и ошибаться, не боясь испортить оригиналы. Глава 06 «Рабочее место».
Ограничения, критерии готовности и формат результата*
Три из пяти частей поручения. Ограничения: чего не делать и что не трогать. Критерии готовности: пункты, по которым вы проверите, что работа закончена. Формат результата: в каком виде вы ждёте итог (какой файл, какие разделы, какая длина).
Режим планирования*
Агент читает файлы и пишет план, но ничего не меняет (глава 06).
Уточняющие вопросы*
Вопросы, которые агент задаёт вам до начала работы, чтобы выяснить то, чего нет ни в поручении, ни в файлах: для кого результат, какой тон, что делать со спорными данными. Не путайте с подтверждениями («можно выполнить эту команду?», глава 05): те спрашивают разрешения, а эти спрашивают, что вы имели в виду.
Итерация*
Один круг «поручили, получили, поправили». Обычно работа идёт несколькими кругами. (от лат. «повторение»)
Референс*
Образец, на который равняются: фото, документ, пример готовой работы. (от англ. reference, «образец»)
Markdown*
Простой текст с метками разметки: решётка в начале строки делает заголовок. («маркдаун», файл с окончанием .md)
Word-документ*
Файл программы для текстов, окончание .docx. (docx)
PDF*
Файл, где страница выглядит одинаково на любом устройстве, но править его неудобно.

Новичок в первый день

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

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

Было: задача в одну строку

Аня написала агенту одну строку: «Сделай ТЗ по Смирновым».

На экране всё выглядело мирно. В окне агента побежали строки хода работы: «читаю папку», «нашёл 23 файла», «пишу документ». Через пару минут последняя строка сообщила: «Готово, ТЗ сохранено». Ни одного вопроса.

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

Агент ответил на тот вопрос, который ему задали, а пробелы заполнил догадками. Бюджет он выдумал: это называют галлюцинацией. Исправлять нужно саму задачу.

Пять частей поручения

СделайТЗбылоЦельКонтекстОграниченияГотово, когдаФорматстало
Было и стало: одна строка против брифа из пяти блоков

Так же устроены задание подрядчику (человеку или фирме, которые выполняют работу по договору) и бриф дизайнеру. К каждой части есть приём, который сильно меняет итог.

1. Цель

Что должно получиться и зачем. Хорошая цель говорит, кто будет пользоваться результатом. Формулировка «ТЗ, по которому дизайнер и визуализатор начнут эскизы, не звоня мне с вопросами» подсказывает агенту, что главное здесь полнота и однозначность, а красота слога вторична.

2. Контекст

Всё, что знаете вы и не знает агент. Пересказывать содержимое файлов не нужно, он прочитает их сам. Объяснять нужно то, чего в файлах нет. Что значит ваше сокращение: «ТП» в заметках Ани означает тёплый пол. Каким источникам верить больше: замеры точнее анкеты, их делал замерщик (специалист, который снимает размеры помещений). Для кого документ.

Два приёма. Первый: называйте файлы и папки точно, по именам и путям. «Посмотри материалы по Смирновым» заставит агента гадать, а «прочитай файлы в папке „Смирновы-квартира“» нет. Второй: дайте образец. Приложите ТЗ, которое вам понравилось, и напишите «оформи в том же порядке». Образец заменяет страницу объяснений.

3. Ограничения

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

Три приёма, часть которых вы видели в главе 01 «Что такое ИИ: объяснение без формул». Для агента с файлами они важнее. Пишите, что делать, а не только чего не делать: «пиши связными абзацами» работает лучше, чем «не используй списки». Объясняйте причину запрета: «без телефона и адреса клиентов, документ уйдёт внештатному подрядчику». С причиной агент сам применит правило и в случаях, о которых вы не подумали. И перечитайте ограничения на противоречия: «опиши подробно» рядом с «не больше страницы» заставит агента тратить силы на примирение, а не на работу.

4. Критерии готовности

Как вы поймёте, что работа сделана. Пишите пункты, которые можно отметить галочкой без спора о вкусе. Если не знаете, с чего начать, представьте, что открываете готовый файл. Что вы проверите первым делом? Это и есть критерий.

РасплывчатоПроверяемо
Хорошее ТЗКаждая комната из таблицы замеров есть в ТЗ
Без ошибокПлощади сверены с замерами, расхождения вынесены в отдельный список
Аккуратно оформленоРазделы названы, как в образце, не больше двух страниц

У критериев есть и второй смысл. Агент умеет проверять себя (глава 05 «От чата к агенту»). Получив список, он пройдёт по нему перед сдачей и сам поймает часть ошибок.

ТЗ3 из 4 пунктов ясны
Перед стартом: три пункта ясны, четвёртый требует вопроса

5. Формат результата

Где и в каком виде лежит итог: имя файла, вид, разделы, длина. И что агент напишет вам в ответе. Полезная привычка: просить короткий отчёт «что сделал, в чём сомневаюсь, что проверить вам». Сомнения агента подсказывают, куда смотреть в первую очередь.

Ещё один приём касается глагола. «Предложи правки в ТЗ» даст список замечаний, а файл останется прежним. «Внеси правки в ТЗ» изменит сам файл. Новички часто просят совета, а ждут исправления, и наоборот. Для начала безопаснее связка: сначала «предложи», потом «внеси».

Не каждый агент умеет собрать Word-документ, PDF или таблицу. Спросите заранее. Запасной вариант, который работает везде: файл в Markdown, который вы потом перенесёте в нужный формат сами.

Стало: то же поручение целиком

Бриф занял у Ани около семи минут. Агент задал два вопроса, показал план, получил «да» и сдал ТЗ на полторы страницы. В списке противоречий нашлось расхождение: площадь кухни в анкете и в замерах отличалась на два квадратных метра. Без этого списка визуализатор рисовал бы кухню по неверным размерам. Как проверять такой результат, разберёт глава 10 «Доверяй, но проверяй».

Приём: «Задавай уточняющие вопросы»

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

Зачем это нужно. Без вопроса агент заполняет пробел догадкой и не сообщает об этом: так у Ани в начале главы появился выдуманный бюджет. Ответить на вопрос стоит вам полминуты. Переделывать работу, построенную на неверной догадке, дольше. Заодно вопросы показывают, что именно агент понял не так, и вы дополняете бриф.

Готовая фраза. Допишите её в конец поручения, если задача не мелкая:

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

У каждой части фразы своя роль. «По одному» помогает отвечать без путаницы. «С предложением ответа» позволяет написать просто «да». «Не больше пяти» не даёт разговору превратиться в допрос. «Не спрашивай то, что есть в файлах» защищает от вопросов про очевидное. Пересказ задачи в конце показывает, правильно ли агент всё понял.

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

Как отвечать. Коротко и по существу. Не знаете ответа? Напишите: «Реши сам и отметь это в отчёте как допущение». Ответ меняет задачу? Допишите его в бриф, чтобы он не потерялся, если работа продолжится в новой сессии.

Когда приём не нужен.

  • Задача мелкая и обратимая: переименовать десять файлов в «Песочнице», поправить пару опечаток. Исправить результат проще, чем отвечать на вопросы.
  • Вы уже заполнили бриф целиком, с образцом и проверяемыми критериями, и дыр в нём нет.
  • Задача повторяющаяся, и всё уже записано в навыке (глава 09 «Навыки») или в файле инструкций.
  • Вы просто спрашиваете в чате, а не поручаете работу с файлами.

И одна оговорка. Ответ «вопросов нет» не гарантия, что агент всё понял. Он не знает того, чего не знает: про отстающие часы в фотоаппарате (глава 05 «От чата к агенту») он бы тоже не спросил. Приёмка результата остаётся за вами (глава 10).

Сначала вопросы и план

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

?Для кого??Какой срок??Что нельзя?задание
Интервью: вопросы по одному, ответы в задание

Вот как это выглядит на экране, в сокращении (учебный пример).

Файл «задание.md» здесь играет роль спецификации: подробного описания, что делаем. Он переживёт закрытие окна, и в новой сессии агент прочитает его, а не начнёт с пустого места.

Две просьбы стоит запомнить. Попросить агента раскритиковать собственный план: первый вариант обычно выглядит гладко, а слабые места всплывают после прямого вопроса. И попросить объяснить план простыми словами: если объяснение не сходится с задуманным, это видно сразу.

Для мелочей план не нужен. Правило такое: чем больше файлов затронет задача и чем труднее откатить результат, тем нужнее план. Переименовать десять файлов в «Песочнице» можно сразу. Перекладывать сотни файлов, удалять что-либо или отправлять письма стоит только после плана и вашего «да». Как вести план в файле на долгой работе, разберёт глава 11 «Длинная работа: контекст, сессии, план».

Как поправлять по ходу

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

  1. Поправляйте сразу. Ошибку на первом шаге исправить легко, на десятом приходится переделывать всё. Найдите заранее в своей программе кнопку или клавишу остановки работы.
  2. Называйте место, проблему и как надо. Вместо «опять не то» напишите: «В разделе „Кухня“ площадь 14 м², а в замерах 12. Бери цифры из замеров и проверь остальные разделы на то же».
  3. Две неудачные поправки подряд, значит, пора менять подход. К этому моменту контекст забит неудачными попытками, и агент опирается на них. Это как исписанный черновик: проще взять чистый лист. Исправьте бриф, учтите, что узнали, и начните новую сессию.
  4. Не ругайте агента. Всё, что вы пишете, занимает место в контексте, а эмоции ничего в работе не улучшают.
  5. Не расслабляйтесь после удач. Есть ловушка: после нескольких хороших результатов поручения становятся всё короче, а ожидания растут. Тогда качество падает, и вы не понимаете почему. Заполняйте бриф целиком, хотя бы коротко.

Те же пять частей в другой работе

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

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

Сделайте сейчас

Займёт 15–20 минут. Работайте на копиях в «Песочнице».

  1. Возьмите реальную небольшую задачу этой недели, у которой на выходе один файл: письмо, таблица, список, ТЗ.
  2. Поручите её агенту одной строкой, как привыкли. Результат сохраните, не правя.
  3. Заполните шаблон брифа ниже, допишите в конец готовую фразу про уточняющие вопросы и поручите ту же задачу заново, в новой сессии. Какие вопросы задал агент? Часть из них, скорее всего, про пробелы, которых вы не замечали.
  4. Сравните оба результата по своим критериям готовности. Отметьте, какая часть брифа сильнее всего изменила итог.
  5. Сохраните заполненный бриф отдельным файлом. Он пригодится в главе 08 «Память проекта»: постоянная часть контекста из брифа переедет в файл инструкций (текстовый файл с правилами, который агент читает в начале каждой сессии).

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

Шаблон

Шаблон
БРИФ ДЛЯ АГЕНТА

ЦЕЛЬ
Что должно получиться:
Зачем и кто будет этим пользоваться:

КОНТЕКСТ
Какие файлы и папки прочитать:
Каким источникам верить больше:
Что важно знать (договорённости, сокращения, «как у нас принято»):
Образец, на который равняться:

ОГРАНИЧЕНИЯ
- Работай только в папке: ___
- Исходные файлы не меняй. Результат сохрани в: ___
- Ничего не удаляй и никуда не отправляй без моего подтверждения.
- Не придумывай факты, цифры, имена. Если данных нет, пиши «нет данных».
- Не включай в результат личные данные: ___ (потому что ___)

ГОТОВО, КОГДА
- [ ] ___
- [ ] ___
- [ ] ___
Перед сдачей проверь результат по этим пунктам.

ФОРМАТ РЕЗУЛЬТАТА
Файл (имя, вид, где сохранить):
Разделы и длина:
В ответе мне: что сделано, в чём сомневаешься, что проверить мне.

ПОРЯДОК РАБОТЫ
Если чего-то не хватает, сначала задай до пяти вопросов по одному.
Потом опиши план в 3–5 шагов и дождись моего «да».

Чек-лист (список пунктов для проверки) перед отправкой:

Шаблон
- Цель одной фразой: что получится и кто этим воспользуется?
- Названы точные файлы и папки, а не «посмотри везде»?
- Есть то, чего нет в файлах: сокращения, договорённости, образец?
- Сказано, что не трогать и куда сохранить результат?
- Критерии готовности можно проверить галочкой?
- Указан формат и то, что агент напишет мне в ответе?
- Нет противоречий между пунктами?
- Для крупной задачи просил сначала вопросы и план?

Частые ошибки

  • Задача в одну строку. Всё, что не написано, агент додумает сам, и не обязательно так, как вы хотели.
  • Непроверяемые критерии. «Качественно», «красиво», «профессионально» ничего не говорят агенту. Пишите пункты, которые можно посчитать или найти в тексте.
  • Пять задач в одной. ТЗ, смета, письмо клиенту и презентация за один заход. Агент теряет нить, а вы не поймёте, на каком шаге случилась ошибка. Одно поручение даёт один результат.
  • Контекст остался в голове. Сокращения, договорённости с клиентом, правила студии. Если фразу поймёт только ваш коллега, её нужно расшифровать.
  • Нет запрета трогать исходники. Агент «улучшит» оригинал, и вы можете этого не заметить. Работайте на копиях и прямо указывайте, куда сохранять результат.
  • Спор и ругань вместо нового брифа. Десять сообщений подряд в той же сессии не лучше одного исправленного задания в новой.

Коротко

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

Десять опубликованных запросов с разбором и переделкой под вашу работу собраны в приложении Г «Разбор образцовых запросов».