Файл инструкций для ИИ-ассистента: чтобы он знал проект с первой минуты

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

У меня такой файл лежит в проекте Hytaleservers.tech — это мониторинг и топ-лист серверов Hytale. Я назвал его LOCAL SETUP. Ниже разбираю, что туда кладу и зачем.

Зачем это нужно на практике

Без контекста ассистент угадывает. Спросишь про запуск — предложит команды для случайного стека. Попросишь поправить компонент — напишет на другой версии React. Каждая такая ошибка стоит тебе одного сообщения на уточнение, и так весь диалог.

Файл инструкций закрывает три вещи сразу:

• ассистент понимает, с чем работает, ещё до первого твоего вопроса;
• ты перестаёшь повторять одно и то же в каждом новом чате;
• новый человек в проекте (или ты сам через полгода) открывает один файл и въезжает за пять минут.

Паспорт проекта: несколько строк, которые экономят час

Первым делом — короткая шапка. Это паспорт, по которому ассистент понимает, куда попал. Вот как выглядит моя:

• Название: Hytaleservers.tech
• Описание: мониторинг и топ-лист серверов Hytale
• Стек: Next.js 16.1.1 + React 19.2.3 + TypeScript 5 + Tailwind CSS 4 + Supabase
• Порт локально: 3000
• Порт на продакшене: 3003 (VPS)

Обрати внимание на версии. Я пишу не просто «Next.js», а конкретные цифры. React 19 и React 17 — это разные подходы к некоторым вещам, и ассистент должен знать твою версию, чтобы не советовать устаревшее. Порты тоже важны: когда локалка на 3000, а прод на 3003, ассистент не будет путаться, где что запускается.

Инструкции по шагам

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

Начинаю с самого базового — проверки Node.js:

node --version

И рядом пишу, чего ожидать: версия v20.0.0 или выше. Если ниже — что делать. Дальше по той же логике идут установка зависимостей, переменные окружения, подключение к Supabase, запуск дев-сервера.

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

Что стоит добавить помимо запуска

Шапка и настройка — это минимум, с которого начинают. Со временем в файл переезжает всё, что ты устал объяснять руками:

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

Я не пишу этот файл за один присест. Замечаю, что второй раз объясняю ассистенту одно и то же, — и переношу объяснение в файл. Через пару недель он сам собирается из твоих же повторов.

Как заставить ассистента реально его читать

Файл бесполезен, пока лежит мёртвым грузом. Я кладу его в корень проекта под понятным именем — так его видно сразу. В Claude Code и похожих инструментах есть договорённость: файл вроде CLAUDE.md подхватывается автоматически в начале сессии. Если твой инструмент так не умеет, просто в первом сообщении просишь: «прочитай LOCAL SETUP перед работой». Одна строчка вместо получаса пересказа.

Коротко

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