Tech Handbook  /  AI Engineering

Глоссарий

Один термин — одна строка — ссылка на разбор. Для быстрого освежения.

CS-фундамент

Append-only
данные только дописываются, прошлое не редактируется. История неизменяема. → orchestration
Atomicity / транзакция
набор операций целиком или никак, без промежуточного состояния. → orchestration
Busy-loopактивное ожидание
процесс крутится вхолостую, опрашивая «уже можно?», зря жрёт CPU. → orchestration
Compare-and-swap (CAS)
«меняй, только если значение всё ещё то, что ты видел». Защита от затирания при гонке. → orchestration
Fail-fast
при нарушении инварианта система останавливается громко сразу, а не продолжает с повреждённым состоянием. → orchestration
Negative space
то, что система определяет как «не может случиться никогда». Безопасность строится здесь. → orchestration
Saga
длинная транзакция как цепочка шагов, у каждого компенсирующая операция (откат назад при сбое). Не путать с checkpoint-resume. → harness
Snapshotснимок состояния
зафиксированная копия состояния на момент. Все наблюдатели видят согласованную картину. → orchestration
Tabula rasaлат. «чистая доска»
система стартует без встроенного знания. Новый чат LLM ничего не помнит из прошлых сессий. → harness
Идемпотентность
повторное выполнение даёт тот же результат, что однократное. «Оплатить» дважды → списание одно. → orchestration
Инвариант
правило, истинное всегда или система падает громко. Не «желательно», а закон. → orchestration
Конечный автоматfinite state machine
фиксированный набор состояний + разрешённые переходы. Светофор: зелёный→жёлтый→красный. → orchestration

AI-инженерия

Acceptance CriteriaAC, критерии приёмки
проверяемые условия «фича готова». Спека для нас + тест для агента. → sdd
Adversarial Agent Pattern
отдельный агент-верификатор целенаправленно ищет ошибки, сверяясь со спекой. → multi-agent
Antifragilityантихрупкость; Талеб
система не просто устойчива к стрессу, а усиливается от него. → harness
Context rot
контекст заполняется историей, актуальная задача вытесняется, агент галлюцинирует сделанное. → context
Creator ≠ Verifier
тот, кто пишет код, не может быть единственным, кто решает что код верен. → sdd
EARS-нотация
машиночитаемый формат AC; семья из 5 паттернов. Автор A. Mavin (Rolls-Royce). → sdd
In-the-loop / on-the-loop
человек внутри цикла (одобряет каждый шаг) vs над циклом (наблюдает, вмешивается). → harness
Progressive disclosure
показывать ровно нужное на шаге, детали по запросу. Лечит context rot. → harness
Runbook
пошаговая инструкция «что делать в повторяющейся ситуации» (из ops/SRE). Скил = runbook для агента. → skills
Spec drift
постепенное отклонение агента от требований по мере роста контекста. → sdd
МаховикFeedback flywheel
самоусиливающийся цикл: каждая ошибка → правило → система умнее. Раскрутить трудно, дальше крутится сам. → harness

Эвалуация

Distribution driftдрейф распределения
реальные запросы уходят от тех, на которых систему делали → качество тихо падает. Подвид data drift. → evals
Evalэвалуация
проверка качества AI-системы на наборе примеров (не «работает ли код», а «хорошо ли отвечает»). → evals
Golden Datasetэталонный набор
выверенные кейсы «вход → правильный выход». Эталон для замера. → evals
LLM-as-judge
модель в роли оценщика чужих ответов. Масштабируется, но вероятностна — калибруется human review. → evals
Precision@kточность@k
доля релевантного среди первых k результатов. → evals
Recallполнота
доля найденного из всего релевантного. Обычно в конфликте с precision. → evals
Регрессия
новое изменение ломает то, что раньше работало. → evals

Серверная инфраструктура

CIContinuous Integration
конвейер, прогоняющий проверки автоматически на каждое изменение кода. → evals
Durable Execution
движок, переживающий перезапуск: процесс продолжается с места сбоя (Temporal). → orchestration
git worktree
несколько рабочих копий одного репозитория в разных папках (изолированные песочницы). → orchestration
Handshakeрукопожатие
обмен «приветствиями» в начале соединения: версия, возможности, заведение сессии. → mcp
Stateless / stateful
сервер не помнит / помнит состояние между запросами. Stateless → любой запрос на любой инстанс. → mcp
Stateless Orchestrator
дирижёр без собственной памяти, состояние во внешнем хранилище (напр. GitHub Labels). → orchestration
Sticky-сессии
балансировщик всегда шлёт клиента на тот же инстанс (нужны при stateful). → mcp
Verification Gate
обязательный барьер-проверка перед переходом дальше. → orchestration
Инстанс
одна работающая копия сервера; под нагрузкой запускают много параллельно. → mcp
Заглушка-поиск: верхнее поле фильтрует пункты глоссария и заголовки разделов вживую. Полный текст определений — на страницах вики.