Файл запретов для ИИ-помощника: четыре правила полным текстом, куда его класть и как проверить, что он подхватился

Репозиторий, забирай ссылку

Открытый репозиторий, внутри один главный файл CLAUDE.md, версия для Курсора и примеры применения.

Внутри: CLAUDE.md с четырьмя правилами, CURSOR.md под редактор Курсор, EXAMPLES.md с примерами и каталог skills с тем же набором в виде скилла.

Установка, два пути

Первый путь ставит правила один раз на все проекты. Второй кладёт файл в один конкретный проект.

Путь 1. Плагином в Клод Коде, действует во всех проектах

Путь 2. Файлом в один проект

Если CLAUDE.md в проекте уже есть, не перезаписывай его. Открой скачанный файл и добавь четыре раздела в конец своего, помощник читает файл целиком.

Четыре правила по-русски, и что каждое меняет

Перевод рабочий, по смыслу. Рядом с каждым правилом написала, что именно оно убирает из поведения помощника.

1. Думай до кода

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

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

2. Сначала простота

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

Что убирает: раздувание. Проверочный вопрос из файла хороший: сказал бы сильный инженер, что тут переусложнено.

3. Точечные правки

Трогай только то, что должен. Не улучшай соседний код, комментарии и форматирование. Не переписывай то, что не сломано. Держись стиля, который уже есть в файле, даже если сам сделал бы иначе. Заметил мёртвый код не по теме, скажи о нём и не удаляй. Убирай за собой только то, что осиротело от ТВОИХ правок.

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

4. Работа от цели

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

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

Три проверки, что файл подхватился

Помощник умеет отвечать «правила принял» и при этом их не видеть. Проверяй фактом, каждая проверка занимает минуту.

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

Задача намеренно неполная: непонятно, по каким данным, в каком виде и зачем. Помощник с работающим вторым запретом задаст вопрос. Помощник без него принесёт готовую таблицу из выдумки, и это видно сразу.

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

Как добавить свой пятый запрет

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

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

Когда запрет всё-таки нарушен

Спорить с помощником бесполезно, он не запоминает разговор навсегда. Работает короткий возврат и правка файла.

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

Как это выглядело у меня

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

Мой собственный файл запретов, если нужен русский вариант

Этот файл я писал под свой отдел помощников до того, как увидел набор Карпатого. Он про то же самое, но короче и по-русски. Бери его, если работаешь в обычном чате без настроек, либо клади рядом с файлом из репозитория, они не спорят.