Глоссарий агентной разработки

CLI

CLI (command-line interface, интерфейс командной строки) — способ управлять программой текстовыми командами в терминале, а не кнопками в графическом окне.

Например, start-issue 42 — вызов CLI-утилиты с номером задачи.

GitHub issue

GitHub issue — карточка задачи, ошибки или обсуждения в GitHub. У неё есть номер, заголовок, описание, метки и история комментариев.

Git-репозиторий

Git-репозиторий — директория проекта вместе с историей изменений, ветками и служебными данными Git.

Ветка Git

Ветка Git — именованная линия изменений внутри репозитория. Она позволяет вести работу над задачей отдельно от основной версии проекта.

Базовая ветка

Базовая ветка — ветка, от которой начинается новая работа и с которой затем сравнивают изменения. Часто это main или master.

Git worktree

Git worktree — дополнительная рабочая директория, подключённая к тому же Git-репозиторию. С worktree можно одновременно держать открытыми несколько веток, не переключая одну директорию между ними.

Coding-агент

Coding-агент — AI-инструмент, который может читать репозиторий, изменять файлы, запускать команды и проверять результат, чтобы выполнить задачу разработки.

Shell

Shell — программа, которая принимает команды в терминале и запускает другие программы. Распространённые shell в macOS и Linux — zsh и bash.

Workflow

Workflow — повторяемая последовательность шагов, ролей и проверок, по которой работа проходит от входа к результату. По-русски: рабочий процесс.

Терминальный мультиплексор

Терминальный мультиплексор — программа, которая держит несколько терминальных окон или сессий внутри одного рабочего пространства. Zellij и tmux — примеры таких программ.

Сессия

Сессия — один продолжающийся запуск терминала или агента с его текущим состоянием и историей взаимодействия.

AI-модель

AI-модель — обученная система, которая обрабатывает инструкции и создаёт ответ. Coding-агент использует модель как основу, а сам добавляет к ней инструменты и правила работы.

Prompt

Prompt — инструкция и данные, которые передают AI-модели или агенту перед выполнением задачи. В него могут входить текст задачи, ограничения и ожидаемый результат.

Контекст

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

Dry-run

Dry-run — режим предварительного просмотра. Программа показывает, что собирается сделать, но не выполняет основные изменяющие действия.

init.sh

init.sh — проектный shell-скрипт для подготовки рабочей директории: например, установки зависимостей или создания локальных файлов. Само имя не является стандартом Git; конкретный инструмент должен явно договориться, когда и как запускает этот файл.

Runtime

Runtime — среда или технология, в которой выполняется программа. Например, shell-скрипт исполняет shell, а программу на Go обычно запускают как собранный бинарный файл.

Критерии приёмки

Критерии приёмки (acceptance criteria) — наблюдаемые условия, по которым можно проверить, что задача выполнена правильно и полностью.

Code review

Code review — проверка изменений другим человеком или агентом до их включения в основную ветку. Проверяющий ищет ошибки, риски и расхождения с задачей.

Pull request

Pull request (PR) — предложение в GitHub включить изменения одной ветки в другую. В нём видны различия, проверки и обсуждение перед слиянием.

Merge

Merge — объединение изменений одной ветки с другой, например рабочей ветки с основной.

API

API (application programming interface) — устойчивый способ, которым одна программа обращается к другой. API задаёт допустимые входы, результаты и правила вызова.

Skill агента

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

AGENTS.md

AGENTS.md — файл с локальными правилами для coding-агентов: структурой репозитория, командами проверки, ограничениями и принятыми способами работы.

Human gate

Human gate — обязательная остановка автоматического процесса перед значимым действием, после которой продолжение требует решения человека.