Заведите общий журнал изменений и записывайте в него результат каждой задачи, которую команда поручает ИИ-инструменту. Для небольшого сайта подойдёт файл CHANGELOG.md: одна запись объясняет, что поменялось, кто проверил результат и какое действие ещё нужно выполнить. Такой журнал помогает руководителю понять, что готово к публикации, а сотруднику — найти контекст правки без поисков по перепискам. Ниже — шаблон записи и порядок работы, который можно ввести без отдельной системы.
Зачем команде журнал изменений, если задачи уже есть в переписке?
В переписке обычно остаётся просьба: «Добавь поле телефона в форму заявки». После работы ИИ-инструмента нужны другие сведения: появилось ли поле на странице, изменились ли правила заполнения и отправляли ли тестовую заявку. Запись в CHANGELOG сохраняет именно результат. Когда сотрудник вернётся к форме через время, ему не придётся угадывать, какой из запросов привёл к текущему виду страницы.
Это полезно и за пределами разработки. Руководитель видит, что можно показать коллегам. Сотрудник, который принимает обращения, знает, изменилась ли информация в заявке. Разработчик быстрее определяет, с какой правки начать проверку, если форма перестала работать. Один короткий журнал даёт всем участникам общую точку отсчёта.
При этом у каждого рабочего материала своя задача. В заявке или обсуждении команда договаривается, что сделать. В CHANGELOG записывает, что получилось. В инструкции для сотрудников описывает действующий порядок работы. Если после изменения формы поменялся способ передачи заявки, обновите и инструкцию по передаче клиентского обращения внутри команды. Иначе журнал сохранит историю, а сотрудник продолжит действовать по старой схеме.
Что написать в CHANGELOG, чтобы запись пригодилась не только разработчику?
Начните с одного файла CHANGELOG.md там, где команда хранит материалы проекта. Если сотрудники не открывают файлы сайта, договоритесь, кто переносит подтверждённые изменения в доступный им рабочий документ. Важно выбрать одно место для актуального журнала: копии в разных папках быстро начинают расходиться.
Для каждой задачи хватит даты, результата, затронутой страницы или функции и статуса проверки. Пишите словами, которые понятны владельцу сайта. «Изменена валидация» мало помогает при приёмке, а «Форма контактов теперь просит заполнить телефон» подсказывает, что открыть и проверить. Если задачу ещё не закончили, оставьте её в списке задач; в журнал заносите только выполненную часть.
Пример записи для учебной ситуации: «Дата — форма контактов. Изменено: добавлена проверка пустого поля телефона. Затронуто: страница контактов. Проверено: форма показывает подсказку при пустом поле. Осталось проверить: приходит ли тестовая заявка после заполнения формы». Последняя фраза важна: видимая подсказка ещё не подтверждает доставку заявки.
Если ИИ-инструмент изменил заодно текст кнопки или соседний блок, добавьте это отдельным пунктом. Так сотрудник при проверке заметит каждое изменение. Не помещайте в журнал пароли, ключи доступа и содержимое заявок: для истории правок достаточно описать, какая функция изменилась.
Как поручить записи ИИ и распределить ответственность в команде?
Дайте ИИ-инструменту постоянное правило: после задачи проверить список изменённых файлов и предложить запись в CHANGELOG.md. В запросе уточните: «Опиши только то, что есть в файлах. Отдельно укажи, какие проверки ты запустил, а какие остались человеку». Если инструмент не открывал сайт, запись не должна утверждать, что страница верно выглядит на телефоне.
Назначьте одного человека, который принимает запись перед публикацией. В маленькой команде это может быть тот же сотрудник, который ставил задачу. Он сверяет описание с изменениями и проверяет действие, важное для посетителя: отправку формы, открытие страницы или переход по кнопке. ИИ готовит черновик и помогает найти файлы; решение о готовности остаётся у человека.
Когда над сайтом работают несколько сотрудников, договоритесь, кто и когда обновляет общий файл. Если все одновременно правят CHANGELOG.md, записи способны мешать друг другу при объединении изменений. Практичный порядок — каждый участник готовит запись к своей задаче, а ответственный добавляет её в общий журнал после приёмки. Заодно он убирает повторы и приводит названия страниц к одному виду.
При постоянной работе с ИИ правило можно сохранить в инструкции проекта, чтобы не повторять его в каждом запросе. Для деталей о том, как фиксировать изменения агента в вайбкодинг-проекте, подойдёт статья на tit.by. Для рабочего процесса команды к техническому правилу стоит добавить ещё два пункта: кто принимает запись и где сотрудники видят итог.
Как проверить запись перед публикацией сайта?
Сначала сопоставьте запись со списком изменённых файлов. Если ИИ пишет только о форме, но изменил также страницу услуг, попросите объяснить вторую правку. Затем откройте затронутую страницу и выполните основное действие посетителя. Для формы это тестовая отправка; для новой страницы — открытие с телефона и проверка нужных ссылок. Запишите результат рядом с изменением.
Проверка должна соответствовать утверждению в журнале. Сообщение «форма исправлена» предполагает, что кто-то отправил заявку и увидел ожидаемый результат. Если проверили только внешний вид, так и напишите. Когда тест не пройден, оставьте запись в статусе проверки и не сообщайте команде, что задача закрыта.
После приёмки обновите связанные рабочие материалы. Например, если на сайте поменялись условия, которые сотрудник сообщает клиенту, поправьте инструкцию и согласуйте её новую версию. Для такого случая пригодится отдельный порядок согласования документов в небольшой компании: он помогает понять, кто подтверждает актуальный текст. CHANGELOG при этом сохраняет причину правки и дату, а инструкция остаётся источником действующего порядка.
Журнал не заменяет резервную копию сайта и историю изменений файлов. Из записи можно узнать, что команда собиралась исправить и что проверила; для восстановления прежнего состояния понадобятся средства, которыми пользуется разработчик. Поэтому не обещайте откат только на основании строки в CHANGELOG.
Какие ошибки чаще мешают пользоваться журналом?
- Запись «улучшен сайт» не называет затронутую страницу. Укажите видимое изменение: например, какое поле появилось в форме.
- ИИ описал план как готовый результат. Сверьте запись с файлами и уберите пункты, которые ещё не выполнены.
- Проверки перечислены без результата. Напишите, что именно открыли или отправили и что увидели.
- Журнал обновили, а рабочую инструкцию оставили прежней. Найдите документ, по которому сотрудники выполняют изменившееся действие, и назначьте его обновление.
- Общий файл редактируют без ответственного. Назначьте человека, который принимает записи и следит, чтобы в журнале не появлялись противоречивые версии одной правки.
Откройте материалы последней задачи на сайте и создайте для неё одну запись в CHANGELOG.md: что изменилось, где это видно и что ещё нужно проверить.
