Отдел 00 · Агент

Файлы правил: инструктируем агента один раз

время чтения ~11 минут · рецептов: 4 · обновлено: ноябрь 2026

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

Что файл правил решает, а что — нет?

Хорошо: постоянные договорённости. Язык ответов, куда класть готовые файлы, чего не касаться, как называть, в каком формате отчитываться. Инструменты читают такой файл автоматически: у Cursor это правило в корне проекта, у Qoder — файл памяти проекта, у других — похожие механизмы. Категорически плохо: разовые задачи — файл правил их не решает. Правила — то, что верно всегда; задание — то, что нужно сегодня.

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

Для наглядности — как выглядят правила со знаком качества. Размытые: «отвечай вежливо», «делай качественно», «будь аккуратен с файлами». Их нельзя проверить, и агент соблюдает их по настроению. Рабочие: «всегда отвечай по-русски», «готовые файлы складывай в подпапку Итоги, исходники не перезаписывай», «перед любым переименованием покажи список «было → стало» и жди моего «да»». Каждое такое правило проверяется одним взглядом на результат.

Что относится к файлу правил, а что остаётся в задании
Договорённость Файл правил Задание
Язык и тон ответов да, один раз только когда нужен другой на сегодня
Куда класть готовые файлы да редко, если объект новый
Чего в папке не касаться да нет
Формат итогового отчёта каркас тема и срок
Что сделать сегодня нет всегда здесь

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

Шаг 1. Начать с трёх правил, а не с тридцати

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

Три правила, с которых реально начинают

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

Второе — про файлы: «исходники не перезаписывай, готовые клади в подпапку Итоги, новые имена согласуй списком „было → стало“». Это защита от единственной ошибки, которую не отменить вежливым словом: когда вместо правки копии переписывается оригинал.

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

Рецепт 1 · черновик правил из разговора
Мы с вами сделали [задача]. Посмотри нашу переписку и выпиши 3–5 постоянных правил, которые
я повторял или которыми поправлял тебя:
- язык и тон ответов,
- формат итога,
- куда сохранять файлы,
- чего не трогать.
Без разовых деталей этой задачи — только то, что верно для любых будущих задач в этой папке.
Оформли списком, каждое правило — одно предложение.
Сверь правила с перепиской.

Например, в папке с переводами первое правило будет одной строкой: «термины заказчика бери из файла „глоссарий.txt“, своих не выдумывай».

Шаг 2. Записать и проверить на чужой задаче

Черновик перенесите в файл правил вашего инструмента (он создаётся в корне рабочей папки, точное имя подскажет сам агент — у разных систем оно своё). Проверка простая: дайте агенту новую, похожую задачу и посмотрите, соблюдает ли он правила без ваших напоминаний. Если правило не сработало — оно плохо сформулировано: слишком длинно, слишком размыто или противоречит соседнему.

Правило не сработало: три причины и три чинки

Длинное. Пункт на пять строк читается как пожелание: начало соблюдается, середина теряется, конец забывается. Чинка — разбить на два коротких, каждый про одно действие.

Размытое. «Будь аккуратен с файлами» нельзя ни выполнить, ни проверить — для агента это шум. Чинка — назвать действие и признак: «перед удалением покажи список файлов и жди моего согласия».

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

Рецепт 2 · проверка правил
Прочитай файл правил и не пересказывай его. Дальше я дам задачу [новая задача], и ты
выполнишь её молча, только по правилам. После — отдельным блоком напиши:
1) какие правила ты применил,
2) где правило не помог и чего не хватило.
Ничего не спрашивай у меня по ходу — действуй по файлу.
Сверь итог с файлом правил.

Приёмка проверки: на что смотреть

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

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

Шаг 3. Поддерживать: правило рождается из второй ошибки

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

Вторая ошибка — не повод злиться

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

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

Ревизия за десять минут

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

Рецепт 3 · ревизия файла
Посмотри наш файл правил критически: 1) какие пункты противоречат друг другу;
2) какие невозможно проверить («будь внимательным» — невозможно); 3) какие за месяц
ни разу не пригодились бы задачам вида [ваши типовые задачи]. Предложи сокращённую
версию: то же покрытие, но не больше [число] пунктов, каждый — одним предложением.

Какой набор правил берут под свою папку?

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

  • Папка с документами. «Исходники не перезаписывай, правь копию в подпапке Черновики»; «в ответах названия организаций заменяй номером договора»; «перед печатью покажи, сколько страниц получилось».
  • Рабочая папка. «Итог — таблицей, сырые цифры отдельно»; «не отправляй никуда письма и файлы без моего ответа»; «если в задаче две цифры расходятся, не выбирай молча — спроси».
  • Учебная папка. «Каждый факт — со ссылкой на страницу источника»; «не дописывай того, чего не было в лекции»; «итоги делай на одну страницу, подробности — списком ниже».
  • Домашняя папка. «Списки покупок — по три-пять строк, без вступления»; «чеки и выписки не выгружай в переписку целиком»; «планы и расписания сохраняй одним файлом на месяц».

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

Рецепт 4 · перенос правил в новую папку
Вот мой файл правил из другой папки [вставить текст], а здесь задачи такие:
[перечислить три обычные задачи]. Перенеси правила так, чтобы их не пришлось
договаривать: 1) убери пункты про папки и файлы, которых здесь нет;
2) оставь постоянные договорённости про язык, формат и запреты;
3) добавь два правила под местные задачи — так, чтобы каждое проверялось
одним взглядом на результат.
Итог: список не длиннее [число] пунктов, каждый — одно предложение. Отдельно
напиши, что ты убрал и почему.

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

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

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