Scope-файл ограничивает нейросеть в проекте одним markdown-документом: он фиксирует, что AI-агенту можно делать, что нельзя, и по каким признакам задача считается готовой. Без него Cursor или Claude Code достраивают функционал сами: меняют стили, трогают код, который просили не трогать, добавляют то, что никто не заказывал. Разберем пошагово, что писать в scope-файл, как правильно формулировать запреты, что такое definition of done для AI-агента, и дадим готовый промт, который соберет scope.md за 2 минуты.
Обновлено: октябрь 2026. Scope-файл — это CLAUDE.md, AGENTS.md или правило в .cursor/rules, которое задает AI-агенту границы проекта до начала работы. В статье: разбор структуры файла, таблица с запретами, которые реально работают, и что делать, если агент их все равно нарушает.
Почему AI-агент делает лишнее в проекте?
Без явных границ AI-агент заполняет пустоты сам: угадывает цвета, стек, архитектуру. Это не сбой модели, а прямое следствие отсутствия правил в проекте.
В одном показательном эксперименте разработчик собирал Pomodoro-таймер без единого правила: агент сам выбирал палитру, шрифты и подход к верстке, и через несколько итераций проект превратился в набор случайных решений. Стоило добавить один файл с правилами, и то же самое приложение стало собираться предсказуемо, хотя задача осталась прежней.
Дело не в том, что модель "глупая". Ей просто не хватает контекста, который у человека-разработчика есть в голове по умолчанию: какой у проекта стиль, что уже решено, куда нельзя лезть. Агент честно выполняет промт, а недостающие детали додумывает сам, и додумывает не так, как хотелось бы.
На своих проектах в VibeCoderz мы видим это постоянно: без ограничений AI-агент за один запрос может отрефакторить соседний модуль, добавить авторизацию, которую никто не просил, или сменить цветовую схему по своему вкусу. Каждая такая правка это откат и повторное объяснение, а время как раз то, чего у соло-разработчика меньше всего.
Максим: «GoBanana мы собрали за 3 часа после выхода новой модели. Всего 6-8 часов ушло на продукт, который потом принес 12 миллионов рублей выручки. Без четких границ в промтах это невозможно физически, каждая лишняя фича, которую агент придумывает сам, это часы, которых у нас просто нет.»
Что такое scope-файл и зачем он нужен?
Scope-файл — это markdown-документ с контекстом проекта, стеком, списком запретов и определением готовности. Он подключается к AI-агенту как система координат перед каждой задачей, а не после третьей правки.
Формально это может быть CLAUDE.md, AGENTS.md, rules.md или отдельное правило в .cursor/rules, суть везде одна. Файл описывает пять вещей: кто вы и что за проект, какой стек обязателен, что разрешено менять, что запрещено трогать без согласования, и как понять, что задача сделана. По сути это онбординг для нового сотрудника, только сотрудник искусственный и читает его перед каждой сессией заново.
Ключевое отличие от обычного промта: scope-файл не про конкретную задачу, а про правила игры на весь проект. Промт говорит "сделай кнопку", scope-файл говорит "в этом проекте кнопки такого цвета, такого размера, и без сторонних библиотек". Официальная документация Claude Code уточняет важный момент: CLAUDE.md агент воспринимает как контекст, а не как жесткую конфигурацию, поэтому для гарантированной блокировки действия нужен отдельный PreToolUse hook, а не только текст в файле. Это честная оговорка, которую стоит держать в голове: scope-файл снижает количество ошибок агента в разы, но не заменяет технический контроль там, где цена ошибки высокая.
Как создать scope.md за 2 минуты?
Быстрее всего не писать scope-файл вручную, а попросить сам AI-агент собрать его через пять коротких вопросов о проекте. Готовый промт ниже займет у вас 2 минуты на ответы.
Разработчики, которые уже прошли путь от хаотичного вайб-кодинга к управляемому, называют это переходом от "vibe coding" к "vibe engineering": не пассажир, который смотрит, что получится, а тот, кто задает агенту правила до старта работы. Вставьте промт ниже в Claude Code, Cursor или Windsurf, ответьте на пять вопросов, и агент сам оформит файл.
Ты помогаешь мне собрать scope-файл для этого проекта.
Проанализируй код, package.json или requirements и структуру
папок, затем задай мне 5 коротких вопросов:
1. Какая единственная задача у проекта или фичи прямо сейчас
(одна, а не список)
2. Какой стек и версии обязательны, ничего лишнего не подключать
3. Что нельзя менять, трогать или рефакторить без моего разрешения
4. Какой стиль и паттерны уже приняты в проекте
(дизайн, именование, архитектура)
5. По каким признакам задача считается готовой (definition of done)
После моих ответов собери файл scope.md с разделами:
Контекст, Стек, Разрешено, Запрещено, Definition of done.
Пиши коротко, пунктами, без воды. В конце добавь одно предложение
о том, что делать, если мой следующий запрос противоречит этому
файлу: не выполнять молча, а переспросить у меня.Лайфхак из практики авторов канала про rules.md: относитесь к файлу не как к идеальному документу, который нужно отполировать, а как к спасательному кругу для будущего себя. Добавляйте туда быстрые заметки "кстати" сразу после того, как агент что-то напутал, вместо того чтобы держать это в голове.
Что обязательно включить в scope-файл?
Пять обязательных блоков: контекст проекта, стек, что разрешено, что запрещено, и definition of done. Без последнего пункта агент физически не может понять, когда остановиться.
Пропуск любого из этих пяти блоков возвращает вас к тому же хаосу, с которого начиналась статья. Разработчики, которые ведут rules.md параллельно с кодом, называют это "контрактом" между собой, будущим собой и AI-инструментом: чем конкретнее пункт, тем меньше откатов потом.
| Раздел | Что писать | Пример |
|---|---|---|
| Контекст | Кто вы, что за проект, для кого | "SaaS для фрилансеров, соло-разработка, ноль дизайнеров в команде" |
| Стек | Языки, фреймворки, версии | "Next.js 14, TypeScript, Tailwind, без Redux и без новых пакетов" |
| Разрешено | Что можно менять без согласования | "Компоненты в src/components, стили внутри уже принятой палитры" |
| Запрещено | Что трогать нельзя | "Не рефакторить auth-модуль, не менять схему БД, no persistence" |
| Definition of done | Признаки завершенной задачи | "Функция работает на мобильном и десктопе, тесты зеленые, лишних файлов нет" |
Отдельно стоит пункт про стиль. Вместо перечисления конкретных цветов пикселями, лучше описать общую стилистику и сослаться на уже принятые решения в проекте: агент сам подтянет нужные оттенки и шрифты из существующего кода, если знает, где искать.
Как правильно запретить AI-агенту лишний функционал?
Запреты работают, только если сформулированы конкретно: не "будь аккуратнее", а "не трогай auth, не добавляй persistence, не создавай новых панелей настроек". Общие формулировки агент интерпретирует по-своему.
Классический список запретов из практики разработчиков, которые уже проходили через хаотичные правки: не рефакторить существующий код без явного запроса, не добавлять persistence там, где ее не просили, не создавать панели настроек и новые страницы "на всякий случай", не подключать сторонние пакеты без согласования, не менять архитектурные решения, которые уже приняты.
Работает и обратный прием: явно указать AI-агенту переспрашивать, если новый запрос противоречит правилам из scope-файла, а не тихо решать конфликт самостоятельно. В одном тесте разработчик специально заложил в CLAUDE.md противоречивые правила, чтобы проверить реакцию агента, и получил именно то, что нужно: вопрос вместо самовольного решения.
Для командной разработки такой список запретов удобно хранить прямо в репозитории и коммитить вместе с кодом, тогда все участники и все AI-инструменты работают по одним границам. У Cursor для этого есть Project Rules, которые версионируются вместе с проектом и не зависят от личных настроек конкретного разработчика.
Что значит «готово» для AI-агента?
Definition of done — это конкретный, проверяемый список условий, а не общее "работает". Без него агент либо останавливается слишком рано, либо продолжает докручивать то, что уже не нужно.
Definition of done лучше писать как чек-лист, а не как одну фразу: функция работает на всех заявленных экранах, нет console-ошибок, старый функционал не сломан, лишние файлы не созданы. Чем конкретнее условия, тем меньше пространства для агента додумывать за вас.
Максим: «Мог просто засесть до пяти ночи и просто там править одну какую-то функцию, которая не работала. Если бы не терпение, в моменте я уже испотел и хотелось все закрыть. Но я понимал, что это можно решить и нужно решить, чтобы идти дальше.»
Это история про человека, но с definition of done в scope-файле такая же дисциплина появляется и у агента: он не останавливается на "вроде работает", а сверяется с конкретным списком условий, который вы задали заранее.
Cursor, Claude Code или Windsurf — где хранить scope-файл?
В каждом инструменте свой формат: CLAUDE.md у Claude Code, .mdc-правила у Cursor, .windsurfrules у Windsurf. Логика одна и та же, различаются только расположение файла и способ активации.
Если работаете в нескольких AI-редакторах одновременно, проще держать один общий AGENTS.md как источник правды и подключать его через каждый инструмент отдельно, а не дублировать текст в трех форматах.
| Инструмент | Файл | Где хранится | Особенность |
|---|---|---|---|
| Claude Code | CLAUDE.md | В корне проекта, можно вложенные в подпапках | После /compact агент заново читает файл с диска |
| Cursor | .mdc-правила | В папке .cursor/rules, версионируются с репозиторием | Старый .cursorrules еще работает, но помечен как устаревший |
| Windsurf | .windsurfrules | В корне проекта, плюс global_rules.md для всех проектов | Один файл на проект, без вложенной иерархии как у CLAUDE.md |
Для новичков, которые еще не решили, в каком инструменте работать, разница на старте не критична: логика scope-файла одинаковая везде, а сравнение возможностей и цен каждого редактора удобнее смотреть в каталоге AI-инструментов.
Что делать, если AI-агент игнорирует scope-файл?
Обычно дело не в файле, а в его размере или в том, что правило "выпало" из недавнего контекста разговора. Решение: коротко напомнить правило прямо в следующем промте.
У длинных диалогов есть эффект смещения внимания к недавним сообщениям: правило из scope-файла могло сработать в начале сессии и постепенно потерять вес по мере роста переписки, это задокументированная особенность работы с контекстным окном. Рабочий способ вернуть правило в фокус: явно сослаться на него в следующем запросе, коротко и без пересказа всего файла.
Второй частый источник проблем, разросшийся scope-файл. Если в CLAUDE.md накопилось три сотни строк с исключениями и оговорками, агент начинает путаться в приоритетах между ними. Практическое правило: если вы дважды поправили агента за одну и ту же ошибку, добавьте это в файл одной короткой строкой, но при этом уберите или перепишите старое правило, которому она противоречит.
Разбивайте scope-файл на несколько модульных документов по темам, если он растет: общий контекст в корневом CLAUDE.md, а специфичные для конкретной папки правила в отдельных вложенных файлах. Такой подход держит корневой файл коротким и стабильным, а детали не теряются.
Итог: стоит ли тратить время на scope-файл
Да, если проект живет дольше одной сессии. Два минуты на промт с вопросами экономят часы на откатах, особенно там, где AI-агент работает без постоянного присмотра.
VibeCoderz собран за неделю тремя скриптами голосом в Claude Code, и без четких границ по стеку и стилю такой темп был бы невозможен: 6 200 материалов не разъехались бы по случайным шаблонам. Это не абстрактный совет, а рабочая практика на живом проекте.
| Сегмент | Что важно | С чего начать |
|---|---|---|
| Новичок | Простой контекст без терминов | 5 вопросов из промта выше, без раздела про архитектуру |
| Разработчик | Технические запреты и стек | Список "не трогать" + Project Rules в Cursor |
| Вайбкодер | Definition of done и командная работа | Модульный scope + коммит правил в репозиторий |
Если вы уже строите продукт с четким scope и хотите поставить AI-агента на конкретную роль в команде, посмотрите каталог ИИ-агентов по нишам — там же есть готовые сетапы под devops-задачи, где границы особенно важны.
Частые вопросы про scope-файл для AI-агента
Что такое scope-файл простыми словами? Это документ, который заранее говорит AI-агенту, что можно делать в проекте, а что нельзя, и как понять, что задача готова. Работает как памятка для нового сотрудника, только для нейросети.
Чем scope-файл отличается от обычного промта? Промт описывает конкретную задачу здесь и сейчас, а scope-файл задает общие правила на весь проект и подключается к каждой сессии заново.
Нужен ли scope-файл, если я работаю один, без команды? Да, разница даже больше, чем в команде: некому напомнить агенту контекст кроме вас, а без файла придется каждый раз объяснять одно и то же заново.
Как понять, что AI-агент нарушил границы scope-файла? Смотрите на симптомы: агент меняет код в местах, которые вы не упоминали, добавляет функции, которых не было в задаче, или меняет стиль без причины. Это сигнал вернуться к файлу и уточнить формулировки.
Нужно ли переписывать scope-файл под каждую новую задачу? Нет, файл описывает проект целиком и меняется редко: после крупных решений или когда вы дважды поправили агента за одну и ту же ошибку.
Работает ли один и тот же scope-файл в Cursor и Claude Code одинаково? Логика одна, но формат разный: в Cursor это .mdc-правила в .cursor/rules, в Claude Code это CLAUDE.md. Проще всего держать общий AGENTS.md и адаптировать под конкретный инструмент.
Что делать, если правила в scope-файле начинают противоречить друг другу? Явно попросите агента переспрашивать при конфликте вместо того, чтобы решать самому, а затем удалите устаревшее правило вместо того, чтобы добавлять новое поверх старого.
Хотите настроить scope и правила под конкретный проект, а не переписывать этот шаблон вслепую? Загляните в каталог AI-инструментов VibeCoderz или запишитесь на консультацию к Максиму, разберем ваш кейс за один звонок.
Обновлено: октябрь 2026