Словарь

Агент – инструмент, который по вашему описанию задачи сам пишет код, запускает команды и правит файлы в проекте. Отличается от простого чата тем, что действует, а не только советует. За результат его действий отвечает владелец проекта.

Библиотека (зависимость) – чужой готовый код, который ваш проект подключает и использует. Каждая библиотека – это удобство сегодня и обязательство завтра: её обновляют, ломают, забрасывают.

Вайбкодинг – сборка работающего продукта разговором с моделью, без владения ремеслом программиста. Слово прижилось в 2025 году. Эта книга – о том, что происходит с проектом после того, как он собран таким способом.

Ветка – отдельная линия истории изменений, куда можно уйти с опасной работой, не задевая основную. Не понравилось – ветку выбрасывают, и основная линия остаётся невредимой.

Выкладка – перенос проекта с вашей машины туда, где его увидят люди. Хорошая выкладка выполняется одной командой или записанным по шагам порядком, а не копированием файлов по памяти.

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

Гипотеза и документ – главное различение этой книги. Всё, что агент сказал о своей работе, – гипотеза. Документом является результат запуска: прогон теста, ответ сервера, запись в базе.

Домен – имя вашего проекта в интернете. Регистрируется на владельца (на вас, не на подрядчика) и продлевается ежегодно.

Журнал (лог) – файл или таблица, куда программа записывает, что с ней происходило. Первое место, куда смотрят, когда что-то сломалось; пустой журнал означает, что смотреть будет некуда.

Индекс поисковика – список страниц, которые поисковая система знает и может показать людям. Страница, которой в индексе нет, для поиска не существует, даже если открывается по ссылке.

Кеш – сохранённая копия чего-то, чтобы не вычислять заново: браузер держит копии картинок и стилей, сервер – копии страниц. Причина большинства случаев «я поправил, а на сайте старое».

Ключ (токен) – строка, которая даёт доступ к чужому сервису от вашего имени. Разновидность секрета, обращаться соответственно.

Коммит – зафиксированное состояние проекта в истории изменений, с описанием и датой. Единица, к которой можно вернуться. Всё, что не в коммите, существует в одном экземпляре – в вашей папке.

Контейнер – способ упаковать проект вместе со всем, что ему нужно для жизни, чтобы он одинаково работал на вашей машине и на сервере. Лекарство от «у меня работает».

Контекст – то, что агент видит в текущем разговоре: ваши сообщения, показанные файлы, свои прошлые ответы. Он ограничен и по мере заполнения начинает вытеснять раннее, поэтому длинный разговор помнит хуже короткого.

Копия (резервная копия) – отдельно лежащий снимок данных, из которого проект можно восстановить. Копия, восстановление из которой ни разу не пробовали, копией считается условно.

Краевой случай – ситуация на границе ожидаемого: пустая форма, слишком длинный текст, два одновременных нажатия. Место, где живёт большая часть поломок.

Ложное зелёное – проверка, которая говорит «всё хорошо», не проверяя того, что должна. Отдельная глава книги посвящена тому, как такое узнавать.

Миграция – переход схемы данных из одного состояния в другое: добавить поле, переименовать столбец, при этом не потеряв уже накопленное. Пишется как отдельный шаг с записанным порядком действий.

Окружение (среда) – набор условий, в которых работает проект: версия языка, установленные библиотеки, настройки. Разница окружений – причина того, что одинаковый код ведёт себя по-разному.

Откат – возврат проекта к прошлому зафиксированному состоянию. Нормальный рабочий ход, а не признание неудачи.

Отладочный режим – состояние проекта, в котором он подробно рассказывает об ошибках. Полезно вам, опасно на людях: наружу такой режим показывает внутренности, включая иногда и секреты.

Порог – значение, при переходе через которое датчик подаёт сигнал: сутки без обращений, падение показов на пятую часть. Порог без сигнала – просто число.

Права доступа – кто и что имеет право делать с файлом, хранилищем, разделом сайта. Проверяются попыткой, а не чтением настроек: настройки говорят, как должно быть, попытка показывает, как есть.

Рабочий сервер (прод) – то место, где проект живёт для настоящих людей. Противопоставляется отладочному и предварительному, где сначала проверяют.

Репозиторий – папка проекта под управлением системы, которая помнит все изменения. Одновременно место работы и архив.

Сборка – превращение источников в готовый вид, который отдаётся людям. Правки вносятся в источники; правка в готовом виде исчезает при следующей сборке.

Секрет – любая строка, знание которой даёт доступ: пароль, ключ, токен. Живёт в отдельном файле настроек, никогда не попадает в историю изменений; попавший считается утёкшим и подлежит замене.

Сессия – один разговор с агентом. Заканчивается – и он ничего не помнит, поэтому важное живёт в файлах проекта, а не в переписке.

Сквозной путь – проверка главного сценария целиком: отправил, сохранилось, увидели, отметили. Одна такая проверка стоит десятка мелких.

Сторож (датчик) – маленькая программа, которая по расписанию смотрит на признак жизни проекта и подаёт сигнал, если признак исчез. Ловит тишину, которую никто не замечает.

Тест – записанная и выполняемая машиной формулировка того, что проект обязан делать. Пишется владельцем как контракт; агент, которому поручили написать тесты к готовому коду, узаконит его нынешнее поведение вместе с ошибками.

Тишина – отсутствие событий, которых вы ждёте: ноль обращений, ноль публикаций. Худший вид поломки, потому что она не подаёт признаков, и в отчёте выглядит как спокойный день.

Файл правил – текстовый файл в проекте (обычно AGENTS.md), где записаны ваши постоянные требования к агенту. Читается автоматически в начале работы; заменяет повторение одних и тех же указаний в каждой сессии.

Книга написана человеком и ИИ-агентом в четыре руки, по её же собственным правилам: структуру и вычитку вела одна модель, прозу – другая, каждый пример проверялся запуском, ответственность за каждое слово – на авторе-человеке. Список инструментов, которыми она собрана, – на странице книги notevibe.ru/kniga.html, с датой сверки.