Как переехать в новый чат за минуту

Лимит сообщений в чате с ИИ. Бац. Всё, окно закрыто, дальнейшие сообщения не отправляются. Я сижу и смотрю на этот экран, а у меня половина задачи не доделана.

Раньше это был бы полный трындец. Потому что каждый новый чат - это чистый лист. ИИ не помнит ни меня, ни проект, ни то, почему я принял те или иные решения. Начинаешь ему рассказывать: так мол и так, у меня вот такой стек, вот такие правила, вот это мы уже сделали, а это отклонили. Через десять сообщений он что-то путает. Через двадцать предлагает то, что я уже отверг неделю назад. Через тридцать я сам забываю, что говорил в начале. Устная передача контекста теряет 80% информации за час. Бесит неимоверно.

Но в этот раз всё было иначе. Я открыл новый чат, прикрепил два файла и написал: «прочитай, спроси на какой фазе, продолжи».

ИИ за пять секунд всё прочитал. Спросил: «Ты на фазе 1.1 аналитики? Продолжаем с таблицы analytics_hits?». Я ответил: «Да». И он продолжил. Без единого вопроса «расскажи мне заново про свой проект». Без предложений переписать всё на Python.

Это не магия. Это просто два файла. И сейчас я расскажу, как это работает.

Два файла вместо тысячи слов.

Вся суть в том, чтобы не пересказывать ничего словами. Всё, что нужно новому ИИ, умещается в два файла. Один медленный, другой быстрый.

Первый - HANDOFF.md. Это «медленный» файл. Он меняется редко, я обновляю его руками только тогда, когда происходят какие-то архитектурные изменения. Что в нем лежит?

Во-первых, правила работы. Чтобы ИИ не начал деплоить без проверки, не использовал !important в CSS и не плодил костыли. Во-вторых, стек. Чтобы он не предлагал мне переписать бэкенд на Go. В-третьих, инфраструктура. Алиасы SSH, где лежат файлы, как смотреть логи. Без этого он будет тупить и спрашивать «а куда деплоить?».

Дальше - архитектура. Как устроена та же аналитика, схема базы данных, поток данных. Чтобы ИИ не переизобретал велосипед.

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

Пример из жизни. Я решаю сделать аналитику. ИИ тут же выдает список на 40 метрик. Тепловые карты, воронки, геолокация. Мы вычеркнули 80%. Осталось четыре таблицы и пять виджетов. Почему? Потому что у меня есть правило: одна метрика - один вопрос. «Расту ли я?» - это понятно. А «средняя глубина просмотра» - это непонятно. Каждая новая циферка должна отвечать на понятный вопрос. Это правило записано в файле.

И самое главное - отклоненные решения. Например, ИИ предлагает использовать Redis для real-time онлайна. А я открываю файл и показываю: «Слушай, это уже обсуждали. Для 38 постов это избыточно. Мы заменили Redis на простую выборку уникальных заходов за час из SQLite». Через месяц другой ИИ снова предлагает Redis. Я снова открываю файл. И разговор не повторяется. Это экономит часы жизни.

Второй файл - hitin-project-dump.md. Это «быстрый» файл. Он генерируется одной командой ./dump-project.sh и всегда актуален. Там лежит весь код плюс история коммитов за последние 30 раз.

Зачем история коммитов? Это не дневник, это хронология работы. ИИ видит темп и направление. Если неделю назад был коммит «fix: убрать X», он поймет, что X - это больная тема, и не будет его снова предлагать.

И еще один важный момент. В HANDOFF.md у меня лежит ссылка на живой сайт. ИИ может зайти, почитать посты, посмотреть страницу «О проекте». Это дает ему понимание стиля за две минуты. Без ссылки он начинает писать «удивительные возможности» в стиле маркетингового лендинга. Со ссылкой - пишет в моем стиле, с моим сленгом.

Как это выглядит на практике.

Раньше я держал HANDOFF.md и дамп отдельно. И постоянно забывал обновлять первый. Поэтому теперь dump-project.sh сам вставляет содержимое HANDOFF.md в начало дампа. Получается один файл. При передаче прикрепляешь только его, и не надо помнить про два.

Когда его обновлять? Есть три правила. Когда закрыта фаза (например, «таблица создана, виджет работает»). Когда появилось новое архитектурное решение. Или перед закрытием чата. Не надо обновлять его после каждой строчки кода. Иначе в файле будет 200 мелких правок, и никто не поймет статус. Если я делаю коммит в код, но не трогаю HANDOFF.md, это подозрительно. Значит, забыл обновить статус. Git как зеркало.

Куда это масштабируется.

Я не какой-то там «AI-инженер». Я просто упертый человек, который научился писать ТЗ для ИИ так, чтобы оно не разваливалось через две недели.

Файл HANDOFF.md - это не инновация. Это обычный технический долг, только для нейросети. Инженеры в компаниях пишут такое же для коллег. Я пишу для ИИ. Разница только в получателе.

Дальше в планах регистрация, чат, каталог. Каждая новая фича - это новый файл (AUTH.md, CHAT.md, CATALOG.md) по тому же принципу. Правила, архитектура, одобренные и отклоненные решения. Все файлы собираются в один дамп.

Это не просто «документация». Это система передачи контекста. Она работает между чатами. Работает через полгода. Работает, если я захочу отдать проект другому человеку. Он прочитает файл и поймет, что тут к чему.

Главный вывод.

ИИ не помнит ничего. Ни тебя, ни проект. Но если ты потратишь один час на составление хорошего HANDOFF.md - ты сэкономишь двадцать часов на пересказах в каждом новом чате.

Это как инвестиция. Час сейчас, двадцать потом. Я уже вложился. И теперь переезд в новый чат занимает у меня минуту, а не полдня.

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

Правильная лень - двигатель прогресса.