Как дать ИИ контекст о твоём коде — чтобы он перестал угадывать

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

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

1. Пойми, чего ИИ на самом деле не знает

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

Значит, твоя задача — не заставить ИИ «понять», а положить перед ним нужное. Дальше — как именно.

2. Заведи файл-контекст в корне проекта

Создай в корне репозитория текстовый файл, куда соберёшь всё главное о проекте. У популярных ИИ-редакторов для этого есть стандартные имена: CLAUDE.md, AGENTS.md, а универсальный вариант — обычный README.md.

Фишка в том, что агенты-редакторы (Cursor, Claude Code и другие) читают такой файл сами перед работой. Написал один раз — и он подмешивается в каждый запрос без твоего участия.

3. Опиши стек и структуру в двух абзацах

Первым делом — что это за проект и на чём. Коротко:

Приложение заметок. Фронт — React, бэкенд — Supabase (Postgres). Стили — Tailwind. Папка src/components — UI, src/lib — работа с базой.

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

4. Задай правила и договорённости

Дальше — то, что модель не угадает никогда: ваши негласные правила.

• Стиль: «пиши на TypeScript, без any».
• Границы: «не трогай папку legacy/, она уходит».
• Договорённости: «все запросы к базе — только через src/lib/db.ts».

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

5. Покажи один живой пример

Одна показанная функция стоит десяти описаний. Вставь короткий образец того, как у вас принято писать: типовой компонент, типовой запрос. Модель отлично копирует стиль по примеру — она для этого и создана.

6. Ссылайся на реальные файлы, а не пересказывай

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

7. Держи файл коротким и обновляй

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

Что получится

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

Наглядно: без файла на просьбу «добавь кнопку выхода» ИИ выдаёт кнопку на чужом фреймворке и в чужом стиле — переделываешь трижды. С файлом он сразу берёт твой React, твой Tailwind и твой db.ts, потому что прочитал про них ещё до задачи. Тот же запрос — один заход вместо пяти. И бонус: файл-контекст — это общий язык для команды. Новый человек (или новый ИИ-агент) открывает его и за минуту въезжает в проект, вместо того чтобы выспрашивать всё по кусочкам.

Вопрос: обязательно называть файл CLAUDE.md или AGENTS.md?

Нет. Эти имена читаются автоматически конкретными инструментами — удобно, но не обязательно. Если твой редактор их не поддерживает, просто держи context.md или README.md и вставляй его содержимое в начало запроса руками. Суть не в имени, а в том, что контекст есть.

Вопрос: сколько контекста давать — чем больше, тем лучше?

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

Вопрос: почему ИИ иногда игнорит мой файл-контекст?

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