Changelog AI-проекта это короткий файл, куда после каждой сессии с нейросетью падает одна строка: дата, что сделал, какие файлы тронул и что теперь может сломаться. Он нужен по простой причине. Нейросеть забывает контекст между сессиями, а вы забывае…
400 000+ органических переходов за 3 месяца. Со-основатель GoBanana (231K пользователей, 12+ млн ₽ без рекламы) и NeuroScribe (65K пользователей). SEO/GEO-стратегии для AI-поисковиков, 1 700+ единиц контента, 17+ реализованных стратегий.
Об авторе →Claude Code: новый CLI-агент от Anthropic
Anthropic выпустила Claude Code — терминальный AI-агент для разработчиков. Инструмент работает прямо в командной строке и умеет писать, редактировать и запускать код.
Zcode AI: Полный гид по визуальному интерфейсу для Claude Code и AI-агентов
Узнайте, как использовать Zcode для управления Claude Code, Gemini и Codex в едином GUI. Настройка провайдеров, MCP-серверов и визуальный вайбкодинг.
YouTube-канал с монетизацией из любой точки мира: Пошаговый гайд 2026
Инструкция по созданию YouTube-канала: обход блокировок SMS, настройка расширенных функций через виртуальные номера и правила безопасности для монетизации.
Windsurf Code Maps: Как глубоко понимать архитектуру проекта перед написанием кода
Полный гайд по Windsurf Code Maps, модели Sway 1.5 и Sway Grep. Узнайте, как визуализировать архитектуру кода и ускорить разработку в 13 раз.
Vk Fast Cash Strategy
Аудитория ВКонтакте — это те же люди, что и в Instagram, но 'социальный контракт' площадки другой. Если Instagram — это 'дорогой ресторан' с демонстрацией успеха, то VK — это 'душевная шашлычная'. Здесь не работает глянцевый 'успешный успех
Changelog AI-проекта это короткий файл, куда после каждой сессии с нейросетью падает одна строка: дата, что сделал, какие файлы тронул и что теперь может сломаться. Он нужен по простой причине. Нейросеть забывает контекст между сессиями, а вы забываете к третьему дню, что вообще правили во вторник. Ниже разберем формат этой строки, готовый шаблон CHANGELOG.md и промпт, который сам собирает запись после каждого захода в Cursor или Claude Code.
Changelog вайбкодинг-проекта строится по одной строке на сессию: дата в формате ГГГГ-ММ-ДД, задача одной фразой, список файлов, метка риска (auth, платежи, база, none). Формат совместим со стандартом Keep a Changelog 2.0.0. В статье: шаблон, промпт для автогенерации и связка с CLAUDE.md, чтобы файл читала сама нейросеть.
Changelog это отобранная человеком история изменений проекта. git log это сырой поток коммитов. Первый отвечает на вопрос «что поменялось и чем грозит», второй фиксирует каждое движение мышью.
История изменений в вайбкодинге живет в файле CHANGELOG.md в корне проекта. Туда попадает не все подряд, а только то, что меняет поведение продукта. Стандарт Keep a Changelog в версии 2.0.0 от 7 июня 2026 переформулировал главный принцип за девять лет: лог пишут люди и для людей, а сырые коммиты в него сваливать нельзя. Причина в шуме. Коммит и запись в changelog написаны для разных читателей, и одно не переводится в другое напрямую.
Разница видна на одном примере. git log покажет пятнадцать строк вида «fix», «wip», «опять fix». Changelog покажет одну: «починил вебхук Stripe, платежи снова проходят».
| Параметр | git log | changelog проекта |
|---|---|---|
| Кто пишет | git автоматически | человек или нейросеть под контролем |
| Что внутри | каждый коммит, включая мусор | только заметные изменения |
| Для кого | для git и дебага | для вас, команды и AI-агента |
| Формат даты | timestamp коммита | ГГГГ-ММ-ДД, по стандарту ISO 8601 |
| Читается через месяц | почти нет | за минуту |
Нейросеть помнит только внутри активной сессии. Контекст переполняется, срабатывает компакция или /clear, и вся история разговора схлопывается. Changelog остается внешней памятью, которая это переживает.
У любого AI-агента есть окно контекста, и оно конечно. Когда оно забивается, качество ответов падает: агент начинает упрямиться, путать файлы, придумывать несуществующие функции. Инструменты вроде Claude Code решают это компакцией, то есть сжимают старые сообщения в короткое саммари. Команда /clear вообще стирает историю ради чистого старта. Полезно для скорости, но вся память о том, что делали час назад, уходит в ноль.
Вот здесь changelog и выручает. Файл лежит на диске, а не в контексте, поэтому переживает и компакцию, и очистку, и закрытие ноутбука. На следующий день вы открываете проект, читаете последние пять строк и за минуту вспоминаете, где остановились. Нейросеть, если дать ей этот файл, тоже.
Для вайбкодера это особенно критично. Продукт растет по вечерам, сессии рваные, между ними проходит по два-три дня. Без внешней записи проект превращается в черный ящик, который вы сами перестаете понимать.
Одна строка = одна сессия. Четыре поля через разделитель: дата, что сделал одной фразой, тронутые файлы, метка риска. Больше ничего, иначе перестанете вести.
Главный секрет живого changelog в том, что запись должна занимать десять секунд. Как только формат требует абзаца текста, вы бросаете его на второй неделе. Поэтому строка плоская и жесткая.
2026-07-17 | Добавил вебхук Stripe, платежи проходят | api/webhook/route.ts, lib/stripe.ts | РИСК: платежи
2026-07-16 | Вынес авторизацию на middleware | middleware.ts, auth.config.ts | РИСК: auth
2026-07-15 | Правки в шапке, поменял логотип | components/layout/navbar.tsx | РИСК: noneКаждое поле отвечает на конкретный вопрос, и вместе они дают полную картину сессии.
| Поле | Вопрос | Пример |
|---|---|---|
| Дата | когда | 2026-07-17 (всегда ГГГГ-ММ-ДД) |
| Задача | что изменилось для продукта | «Добавил экспорт в PDF» |
| Файлы | где искать, если сломается | api/report/route.ts |
| Риск | что теперь может отвалиться | auth / платежи / база / none |
Дату держите строго в ISO-формате. Он идет от крупного к мелкому (год, месяц, день) и не путается с региональными форматами, где местами меняются число и месяц. Это рекомендация того же стандарта Keep a Changelog, и она реально экономит нервы, когда записей за сотню.
Нейросеть меняет код молча. Она может переписать проверку прав или тронуть миграцию, не предупредив. Метка риска в строке подсвечивает такие места заранее, до того как что-то рухнет в проде.
Агент в Cursor или Claude Code часто правит больше, чем вы просили. Попросили поменять кнопку, а он заодно поправил обработчик формы, который дергает платежку. В git это одна незаметная строка в диффе. В changelog с полем риска это красный флаг «РИСК: платежи», на который вы посмотрите перед деплоем.
Держите четыре простые метки и не плодите новых. Чем меньше вариантов, тем быстрее ставится флаг.
| Метка | Когда ставить | Что проверить перед деплоем |
|---|---|---|
| auth | тронули вход, сессии, права | залогиньтесь под обычным юзером |
| платежи | тронули Stripe, вебхуки, тарифы | проведите тестовую оплату |
| база | миграции, схема, удаление полей | сделайте бэкап заранее |
| none | верстка, тексты, стили | можно катить спокойно |
По опыту наших проектов, три четверти реальных аварий в вайбкодинге приходятся ровно на эти три зоны: авторизация, деньги и база данных. Строка с меткой риска не чинит проблему сама, но заставляет вас глянуть туда до релиза, а не после звонка от пользователя.
Промпт читает дифф последней сессии и отдает одну готовую строку в нужном формате. Запускаете в конце каждого захода, копируете результат в файл. Вся запись занимает секунд пять.
Смысл в том, чтобы не писать строку руками, а поручить это модели, которая и так только что все меняла. Она видела дифф, помнит задачу и знает, какие файлы трогала. Вот готовый промпт под Claude Code или Cursor, можно копировать как есть.
Посмотри git diff за эту сессию. Собери ОДНУ строку в changelog в формате:
ГГГГ-ММ-ДД | что изменилось одной фразой для человека | тронутые файлы через запятую | РИСК: auth/платежи/база/none
Правила:
- дата сегодняшняя в формате ISO 8601
- задачу описывай с точки зрения продукта, а не кода (не «рефакторинг ReportService», а «ускорил выгрузку отчетов»)
- риск ставь по зоне: тронул вход и права -> auth, Stripe и тарифы -> платежи, миграции и схему -> база, остальное -> none
- рефакторинг, который не меняет поведение, в лог не пиши
- верни только строку, без поясненийЧто делает. Превращает дифф в человекочитаемую запись. Когда использовать. В конце каждой сессии, перед /clear или закрытием проекта. Почему работает. Модель уже держит контекст изменений, ей не нужно ничего доисследовать. Лайфхак. Заверните это в кастомную команду (slash-команду) вроде /log, и тогда одна буква после сессии дает готовую строку. В Claude Code такие команды хранятся прямо в репозитории и доступны всей команде.
Добавьте ссылку на CHANGELOG.md внутрь CLAUDE.md через @-импорт. Тогда агент читает свежую историю на старте каждой сессии и не переспрашивает, что уже сделано.
CLAUDE.md это файл памяти проекта. Claude Code читает его при каждом запуске и по нему понимает архитектуру, стандарты и прошлые ошибки, как старший коллега после онбординга. Если внутрь этого файла добавить строку @CHANGELOG.md, агент подтянет и вашу историю изменений. Основной файл остается чистым, а история живет отдельно.
Дальше начинается то, что в англоязычных видео называют compounding engineering: каждая решенная проблема учит нейросеть. Разобрались со сложным багом, попросили агента записать в лог, что пошло не так и как чинили. В следующий раз он на эти грабли не наступит, и вся команда тоже. Тот же принцип советует и стандарт Keep a Changelog 2.0.0: модель может набросать черновик записи, но выбирает, что важно, и формулирует по-человечески все равно человек.
Есть нюанс с гигиеной файла. Раздутый CLAUDE.md ухудшает результаты, поэтому раз в пару недель просите агента пройтись по нему и выкинуть устаревшие правила. Changelog при этом не трогайте, он архив и растет по определению.
Пять шагов: создать файл, задать формат, прописать промпт в команду, подключить к CLAUDE.md, начать вести. Дальше сам процесс держит вас в курсе проекта без усилий.
Разберем по шагам, чтобы запустить прямо сегодня.
Положите в корень проекта файл CHANGELOG.md. В самый верх добавьте заголовок и пометку, что вы следуете стандарту Keep a Changelog. Это стандартное место, туда смотрят GitHub, GitLab и почти все инструменты.
Скопируйте шаблон из раздела ниже. Заведите две зоны: ## Сессии для однострочных записей по датам и ## Релизыдля сгруппированных версий, когда соберетесь публиковать апдейт пользователям.
Сохраните промпт из предыдущего раздела в slash-команду /log. Теперь после каждой сессии одна команда отдает готовую строку, вам остается вставить ее в файл.
В файл CLAUDE.md добавьте строку @CHANGELOG.md. Агент начнет читать историю на старте и перестанет переспрашивать про уже сделанное.
Ведите строго одну строку. Как только захочется расписать абзац, остановитесь. Дисциплина держится ровно на том, что запись занимает секунды, а не минуты.
Четыре типовые ошибки: свалка из git log, запись рефакторинга, отсутствие поля риска и разросшийся файл. Каждая превращает лог в мертвый груз, который никто не открывает.
Первая и главная ошибка, ради борьбы с которой стандарт вообще появился: не сваливайте в лог сырой git log. Пятнадцать строк «fix typo» никому не помогают, а полезная запись в них тонет.
Вторая: не пишите про рефакторинг, который не меняет поведение. Переименовали переменную, разбили функцию на две, продукт снаружи не изменился. В changelog этому не место, лог фиксирует то, что видит пользователь или что может сломаться.
Третья: не выкидывайте поле риска ради краткости. Именно оно превращает список сделанного в инструмент, который спасает прод.
Четвертая: не давайте файлу раздуться в неструктурированную стену. Держите свежие сессии сверху, старые уводите вниз, раз в месяц группируйте в релизы. Формат Keep a Changelog как раз про это: секция сверху, версии ниже, свежее первым.
Максим: «VibeCoderz я собрал за неделю тремя скриптами, голосом в Claude Code. 6 200 материалов внутри. Но на третий день ты уже не помнишь, что трогал вчера. Спасает одна строчка после сессии: дата, что сделал, где, что может отвалиться. Сделал такую привычку, получил проект, который сам себя документирует.»
Ниже полный файл, который можно скопировать в корень проекта прямо сейчас. Внутри две зоны: однострочные сессии и сгруппированные релизы под пользователей.
Верхняя часть для ежедневной работы, нижняя для публичных апдейтов. Для релизов используются шесть типов изменений из стандарта: Added, Changed, Deprecated, Removed, Fixed, Security. Это ровно те категории, которые понимают и люди, и AI-инструменты.
# Changelog
История изменений проекта. Формат основан на Keep a Changelog,
версионирование по SemVer (https://semver.org/).
## Сессии
2026-07-17 | Добавил вебхук Stripe, платежи проходят | api/webhook/route.ts, lib/stripe.ts | РИСК: платежи
2026-07-16 | Вынес авторизацию на middleware | middleware.ts, auth.config.ts | РИСК: auth
2026-07-15 | Поменял логотип и шапку | components/layout/navbar.tsx | РИСК: none
## Релизы
## [Unreleased]
### Added
- Экспорт отчетов в PDF
## [1.1.0] - 2026-07-14
### Added
- Оплата через Stripe
### Fixed
- Падение импорта пустого CSV
### Security
- Закрыта дыра в парсере вебхуковСобрать релизную часть из строк сессий помогают инструменты вроде git-cliff или release-please. Они делают черновик из коммитов, а вы уже отбираете и правите. Полный список инструментов для вайбкодинга есть в каталоге VibeCoderz, а если вы ведете проект в команде и упираетесь в процессы деплоя, посмотрите готовые сценарии в подборке для devops.
Чем changelog отличается от обычных комментариев в коде? Комментарии объясняют, как работает конкретный кусок кода прямо сейчас. Changelog фиксирует, что и когда поменялось во всем проекте. Первое живет в файлах и устаревает вместе с ними, второе это хронология, которую читают через месяцы.
Нужен ли changelog, если я вайбкожу один и без команды? Особенно нужен. Именно в одиночных проектах теряешь нить: сессии рваные, между ними дни. Одна строка после захода возвращает вас в контекст за минуту и заодно кормит нейросеть свежей историей.
Можно ли вести changelog прямо в CLAUDE.md? Лучше отдельным файлом. CLAUDE.md должен оставаться коротким, иначе агент начинает хуже отвечать. Историю выносят в CHANGELOG.md и подключают через @-ссылку, тогда и память чистая, и лог полный.
Как часто добавлять записи? После каждой сессии, где менялось поведение продукта. Правили верстку весь вечер, одна строка с меткой none. Тронули платежи на пять минут, тоже строка, но уже с риском. Правило простое: закончил заход, оставил след.
Какая модель лучше генерирует записи для changelog? Подойдет почти любая сильная модель, потому что задача несложная. В Claude Code это Sonnet 4.6 для экономии или Opus 4.8 для крупных диффов. Для однострочных записей разница в цене важнее разницы в качестве.
Что писать в поле «риск», если сессия тронула сразу и auth, и базу? Ставьте обе метки через запятую: РИСК: auth, база. Формат гибкий, главное не пропустить ни одну зону. Перед деплоем проверите оба места.
Обязательно ли использовать формат Keep a Changelog? Для внутренних сессий нет, там достаточно одной строки. Формат из шести категорий включайте, когда собираетесь публиковать релиз пользователям. Он делает апдейт читаемым и для людей, и для AI-ассистентов.
Changelog это файл с историей изменений проекта, где записи сгруппированы по датам или версиям.
CLAUDE.md это файл памяти проекта для Claude Code. Агент читает его на старте каждой сессии и по нему понимает архитектуру и правила.
Компакция (compaction) это сжатие старых сообщений в короткое саммари, когда окно контекста нейросети переполняется.
Окно контекста это объем текста, который модель держит в памяти одновременно. Заполняется, качество ответов падает.
Slash-команда это своя команда через /, которая запускает заранее описанный сценарий одним словом.
ISO 8601 это международный формат даты вида 2026-07-17, где порядок идет от года к дню.
SemVer это семантическое версионирование в формате МАЖОР.МИНОР.ПАТЧ для нумерации релизов.
Compounding engineering это подход, где каждая решенная проблема записывается в память проекта и учит нейросеть не повторять ошибку.
Заведите CHANGELOG.md в текущем проекте прямо сейчас, скопируйте шаблон и добавьте первую строку за сегодня. Через неделю у вас будет история, которая экономит по десять минут на каждом возвращении в проект. Разобраться с инструментами под вайбкодинг помогут обзоры IDE в каталоге VibeCoderz, а если хотите выстроить процессы под свой продукт с нуля, запишитесь на консультацию к Максиму.
Статья обновлена в июле 2026 года командой VibeCoderz. Данные по стандарту Keep a Changelog актуальны на версию 2.0.0.