# Задача повторилась третий раз: пора делать инструкцию

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

URL: https://posts.danashkin.ru/guides/zadacha-povtorilas-tretiy-raz
Обновлено: 2026-09-18

---

## Коротко

**Главное**

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

## Как понять, что задача созрела для инструкции?

**Главное**

По счётчику повторов и по объёму объяснений. Правило простое: третий раз одного и того же - сигнал. До третьего раза оформление стоит дороже, чем сама работа, после третьего начинает окупаться.

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

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

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

Чем задача подходит для оформления:

| Признак | Годится в инструкцию | Оставить разовой |
|---|---|---|
| Частота | раз в неделю и чаще | раз в квартал |
| Результат | всегда одного вида | каждый раз разный |
| Требования | устоялись, ты их знаешь наизусть | придумываются по ходу |
| Цена ошибки | заметная, но не критическая | критическая, нужен человек |

Полезно отличать это от выбора первой задачи для ИИ вообще: там вопрос «за что взяться», здесь - «что уже прижилось и просит оформления». Первую тему я разбирал в материале про то, [какую задачу отдать нейросети первой](/guides/kakuyu-zadachu-otdat-ii-pervoy).

## Инструкция против сохранённого промпта

**Главное**

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

Разница выглядит мелкой, а меняет всё.

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

Инструкция в проекте работает иначе: она часть рабочего окружения агента. Он читает её сам, сопоставляет с текущей задачей и говорит, что нашёл подходящий порядок действий. Это ровно то, что называют [контекст-инжинирингом](/concepts/context-engineering): работа не над формулировкой запроса, а над средой, в которой запрос выполняется.

Место, где это живёт, ты уже знаешь, если настраивал агенту память проекта: рядом с файлом-памятью, отдельными документами под конкретные повторяющиеся дела. Про сам файл-память есть подробный разбор - [что писать в файл-память проекта](/guides/chto-pisat-v-claude-md).

## Четыре блока внутри инструкции

**Главное**

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

Структура, к которой я пришёл опытным путём и от которой больше не отклоняюсь.

1. **Когда это применять**

   Описание ситуации словами, которыми её опишет человек. Не «обработка данных», а «мне прислали выгрузку из системы и нужен отчёт по неделе».

2. **Порядок действий**

   Шаги по одному, в том виде, в каком ты сам их делаешь. Здесь же места, где нужно остановиться и спросить тебя.

3. **Красные линии**

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

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

   Как выглядит правильный результат и как проверить, что получилось именно он. Без этого агент отчитается «сделано» на половине пути.

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

Про структуру самого запроса внутри шагов я писал отдельно в материале про [канон промпта для агента](/guides/kanon-prompta-dlya-ai-agenta): те же требования работают и внутри инструкции.

## Почему инструкция не срабатывает?

**Главное**

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

Самая частая поломка выглядит обидно: инструкция написана, лежит на месте, а агент действует по-старому.

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

Лечится переписыванием описания на язык запроса:

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

**Проверка описания за минуту**

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

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

## Что не стоит превращать в инструкцию?

**Главное**

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

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

Что я оставляю в ручном режиме:

- **Решения, а не действия.** «Выбрать подрядчика», «согласовать бюджет» - здесь порядок действий не главное, главное суждение.
- **Работу с деньгами и внешними публикациями.** Отправка, оплата, публикация наружу остаются с явным подтверждением. Инструкция может подвести к кнопке, но не нажать её.
- **Задачи, которые пока меняются.** Если процесс переделывается каждый месяц, инструкция устареет раньше, чем окупится.
- **То, что делается раз в год.** Через год ты всё равно перечитаешь её целиком и половину перепишешь.

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

## Как это выглядит через полгода

**Главное**

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

Расскажу, к чему пришёл сам, потому что этот этап обычно не показывают.

Первые пять инструкций живут прекрасно. К десятой появляется вопрос «а есть ли у меня уже что-то на этот случай». К двадцатой - обнаруживаются две похожие, написанные с разницей в три месяца.

Что помогло:

- **Реестр одной страницей.** Название, одна строка «что делает», одна строка «когда звать». Читается за минуту, и в него смотрит не только человек, но и агент.
- **Карточка на сложные.** Если у инструкции есть зависимости или известные грабли, рядом лежит отдельный файл с ними. Остальным хватает строки в реестре.
- **Правило записи ошибок.** Каждый раз, когда что-то пошло не так, правка идёт в инструкцию, а не в голову. Иначе через месяц то же место повторится.

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

Когда возвращаешься к проекту после паузы, реестр инструкций работает ещё и как карта: видно, что ты вообще делал и чем. Про сам возврат после паузы есть отдельный разбор - [как вернуться к проекту](/guides/vernutsya-k-proektu-posle-pauzy).

## Частые вопросы

**Главное**

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

### Частые вопросы

**Сколько времени занимает первая инструкция?**

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

**Нужно ли уметь программировать?**

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

**Можно ли передать инструкцию коллеге?**

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

**Инструкция устарела, процесс изменился. Переписывать целиком?**

Обычно нет. Меняется один-два шага, остальное остаётся. Правило то же, что с файлом-памятью: правишь по месту, а не пересоздаёшь.

## Главный вывод

**Главное**

Третий повтор задачи - момент, когда объяснение стоит превратить в инструкцию. Четыре блока внутри, живое описание снаружи и запись каждой ошибки в текст: дальше агент делает эту работу с одного слова.

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

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

А сколько раз за последний месяц ты объяснял одно и то же с нуля?

### Источники

- [Extend Claude with skills - как агенту добавляют многоразовые инструкции, документация Claude Code](https://code.claude.com/docs/en/skills)
- [Standard operating procedure - стандартная операционная процедура, Википедия](https://en.wikipedia.org/wiki/Standard_operating_procedure)
- [Rule of three - правило трёх повторов перед обобщением, Википедия](https://en.wikipedia.org/wiki/Rule_of_three_%28computer_programming%29)
- [Don't repeat yourself - принцип «не повторяй себя», Википедия](https://en.wikipedia.org/wiki/Don%27t_repeat_yourself)