prikotov · prikotov-agent · Sep 22, 2026 · Sep 22, 2026 · Sep 22, 2026 · Sep 22, 2026
diff --git a/AGENTS.md b/AGENTS.md
@@ -40,7 +40,7 @@ bin/
 docs/
   git-workflow/              # Документация, копируемая в проект-потребитель
     index.md                 # Оглавление раздела
-    glossary.md              # Словарь терминов со ссылками на определения
+    glossary/                 # Словарь терминов: index.md + один файл на термин
     branches.md              # Ветки: типы, именование, жизненный цикл
     commits.md               # Conventional Commits: формат и правила
     pull-request.md          # Процесс PR и требования

diff --git a/README.md b/README.md
@@ -10,7 +10,7 @@
 
 ## Правила
 
-- **[Словарь терминов](docs/git-workflow/glossary.md)** — короткие определения со ссылками на отдельные термины
+- **[Словарь терминов](docs/git-workflow/glossary/index.md)** — определения терминов, один термин — один файл
 - **Ветки** — как назвать ветку для задачи, релиза или хотфикса; когда удалить
 - **Коммиты** — Conventional Commits: тип, scope, subject — чтобы история читалась как журнал изменений
 - **Пулреквесты** — от создания до мержа: проверки, ревью, squash

diff --git a/docs/git-workflow/glossary.md b/docs/git-workflow/glossary.md
diff --git a/docs/git-workflow/glossary/approval.md b/docs/git-workflow/glossary/approval.md
@@ -0,0 +1,7 @@
+---
+package: prikotov/git-workflow
+---
+
+# Одобрение (Approval)
+
+Подтверждение, что проверенное состояние изменений принято проверяющим. Разрешения на слияние и выпуск определяются отдельно по [правилам PR](../pull-request.md).
diff --git a/docs/git-workflow/glossary/branch.md b/docs/git-workflow/glossary/branch.md
@@ -0,0 +1,7 @@
+---
+package: prikotov/git-workflow
+---
+
+# Ветка (Branch)
+
+Именованная линия разработки, указатель которой перемещается при добавлении коммитов.
diff --git a/docs/git-workflow/glossary/ci.md b/docs/git-workflow/glossary/ci.md
@@ -0,0 +1,7 @@
+---
+package: prikotov/git-workflow
+---
+
+# Непрерывная интеграция (Continuous Integration, CI)
+
+Регулярное объединение изменений, сопровождаемое автоматической сборкой и проверками.
diff --git a/docs/git-workflow/glossary/code-review.md b/docs/git-workflow/glossary/code-review.md
@@ -0,0 +1,7 @@
+---
+package: prikotov/git-workflow
+---
+
+# Ревью кода (Code review)
+
+Проверка предложенных изменений человеком или агентом: корректности, понятности и соответствия правилам проекта.
diff --git a/docs/git-workflow/glossary/commit-sha.md b/docs/git-workflow/glossary/commit-sha.md
@@ -0,0 +1,7 @@
+---
+package: prikotov/git-workflow
+---
+
+# Идентификатор коммита (Commit SHA)
+
+Хеш, по которому Git однозначно находит конкретный коммит, независимо от последующих изменений ветки.
diff --git a/docs/git-workflow/glossary/commit.md b/docs/git-workflow/glossary/commit.md
@@ -0,0 +1,7 @@
+---
+package: prikotov/git-workflow
+---
+
+# Коммит (Commit)
+
+Запись в истории Git, фиксирующая состояние файлов, автора, сообщение и связь с предыдущей историей.
diff --git a/docs/git-workflow/glossary/deployment.md b/docs/git-workflow/glossary/deployment.md
@@ -0,0 +1,7 @@
+---
+package: prikotov/git-workflow
+---
+
+# Выкладка (Deployment, deploy)
+
+Установка выбранной версии в целевую среду. В этом процессе рабочая среда обновляется по опубликованному тегу, а не по вершине ветки.
diff --git a/docs/git-workflow/glossary/e2e-tests.md b/docs/git-workflow/glossary/e2e-tests.md
@@ -0,0 +1,7 @@
+---
+package: prikotov/git-workflow
+---
+
+# Сквозные тесты (End-to-end tests, E2E)
+
+Проверки пользовательских сценариев целиком через публичные интерфейсы приложения.
diff --git a/docs/git-workflow/glossary/github-release.md b/docs/git-workflow/glossary/github-release.md
@@ -0,0 +1,7 @@
+---
+package: prikotov/git-workflow
+---
+
+# Запись релиза на GitHub (GitHub Release)
+
+Запись на GitHub, связанная с тегом и содержащая описание версии; к ней могут прилагаться файлы для скачивания. Это не сам тег и не установка приложения.
diff --git a/docs/git-workflow/glossary/hotfix.md b/docs/git-workflow/glossary/hotfix.md
@@ -0,0 +1,7 @@
+---
+package: prikotov/git-workflow
+---
+
+# Срочное исправление (Hotfix)
+
+Исправление ошибки в рабочей версии без нарушения совместимости; готовится от тега текущей версии рабочей среды.
diff --git a/docs/git-workflow/glossary/index.md b/docs/git-workflow/glossary/index.md
@@ -0,0 +1,45 @@
+---
+package: prikotov/git-workflow
+---
+
+# Словарь терминов (Glossary)
+
+Термины используются в значениях ниже. На отдельное определение можно ссылаться файлом термина, например: [выкладка](deployment.md).
+
+## Репозиторий и ветки
+
+- [Репозиторий (Repository)](repository.md)
+- [Ветка (Branch)](branch.md)
+- [Основная ветка (Main branch)](main-branch.md)
+- [Релизная ветка (Release branch)](release-branch.md)
+- [Коммит (Commit)](commit.md)
+- [Идентификатор коммита (Commit SHA)](commit-sha.md)
+- [Тег релиза (Release tag)](release-tag.md)
+
+## Проверка и включение изменений
+
+- [Запрос на слияние (Pull Request, PR)](pull-request.md)
+- [Ревью кода (Code review)](code-review.md)
+- [Одобрение (Approval)](approval.md)
+- [Слияние веток (Merge)](merge.md)
+- [Объединение коммитов (Squash)](squash.md)
+- [Перенос коммитов (Rebase)](rebase.md)
+- [Непрерывная интеграция (Continuous Integration, CI)](ci.md)
+- [Сквозные тесты (End-to-end tests, E2E)](e2e-tests.md)
+
+## Версии и релизы
+
+- [Версия (Version)](version.md)
+- [Семантическое версионирование (Semantic Versioning, SemVer)](semver.md)
+- [Релиз (Release)](release.md)
+- [Выпуск (Release publishing)](release-publishing.md)
+- [Запись релиза на GitHub (GitHub Release)](github-release.md)
+- [Фиксация состава релиза (Release cut)](release-cut.md)
+- [План релиза (Release plan)](release-plan.md)
+- [Срочное исправление (Hotfix)](hotfix.md)
+- [Патч-релиз (Patch release)](patch-release.md)
+
+## Выкладка и рабочая среда
+
+- [Выкладка (Deployment, deploy)](deployment.md)
+- [Рабочая среда (Production)](production.md)
diff --git a/docs/git-workflow/glossary/main-branch.md b/docs/git-workflow/glossary/main-branch.md
@@ -0,0 +1,7 @@
+---
+package: prikotov/git-workflow
+---
+
+# Основная ветка (Main branch)
+
+Ветка по умолчанию репозитория, в которую включаются согласованные изменения и от которой готовятся обычные релизы.
diff --git a/docs/git-workflow/glossary/merge.md b/docs/git-workflow/glossary/merge.md
@@ -0,0 +1,7 @@
+---
+package: prikotov/git-workflow
+---
+
+# Слияние веток (Merge)
+
+Объединение истории разработки для включения изменений одной ветки в другую.
diff --git a/docs/git-workflow/glossary/patch-release.md b/docs/git-workflow/glossary/patch-release.md
@@ -0,0 +1,7 @@
+---
+package: prikotov/git-workflow
+---
+
+# Патч-релиз (Patch release)
+
+Релиз совместимых исправлений ошибок с увеличением третьего числа версии, например `1.2.0` → `1.2.1`. Такое повышение версии само по себе не означает срочность выпуска.
diff --git a/docs/git-workflow/glossary/production.md b/docs/git-workflow/glossary/production.md
@@ -0,0 +1,7 @@
+---
+package: prikotov/git-workflow
+---
+
+# Рабочая среда (Production)
+
+Среда, в которой приложение обслуживает реальных пользователей и работает с рабочими данными.
diff --git a/docs/git-workflow/glossary/pull-request.md b/docs/git-workflow/glossary/pull-request.md
@@ -0,0 +1,7 @@
+---
+package: prikotov/git-workflow
+---
+
+# Запрос на слияние (Pull Request, PR)
+
+Предложение включить изменения из исходной ветки в целевую; содержит обсуждение, результаты проверок и решение по изменениям.
diff --git a/docs/git-workflow/glossary/rebase.md b/docs/git-workflow/glossary/rebase.md
@@ -0,0 +1,7 @@
+---
+package: prikotov/git-workflow
+---
+
+# Перенос коммитов (Rebase)
+
+Повторное применение изменений коммитов к новой базе; пересозданные коммиты получают новые идентификаторы.
diff --git a/docs/git-workflow/glossary/release-branch.md b/docs/git-workflow/glossary/release-branch.md
@@ -0,0 +1,7 @@
+---
+package: prikotov/git-workflow
+---
+
+# Релизная ветка (Release branch)
+
+Ветка подготовки одной конкретной версии, например `release/1.2.1`. В этом процессе сохраняется после выпуска и не переиспользуется для другой версии.
diff --git a/docs/git-workflow/glossary/release-cut.md b/docs/git-workflow/glossary/release-cut.md
@@ -0,0 +1,7 @@
+---
+package: prikotov/git-workflow
+---
+
+# Фиксация состава релиза (Release cut)
+
+Определение окончательного набора изменений при одобрении PR подготовки релиза.
diff --git a/docs/git-workflow/glossary/release-plan.md b/docs/git-workflow/glossary/release-plan.md
@@ -0,0 +1,7 @@
+---
+package: prikotov/git-workflow
+---
+
+# План релиза (Release plan)
+
+Документ с составом версии, рисками и действиями до и после её выпуска и выкладки.
diff --git a/docs/git-workflow/glossary/release-publishing.md b/docs/git-workflow/glossary/release-publishing.md
@@ -0,0 +1,7 @@
+---
+package: prikotov/git-workflow
+---
+
+# Выпуск (Release publishing)
+
+Публикация подготовленной версии: тега и записи GitHub Release после необходимых проверок и разрешений. Не включает [выкладку](deployment.md).
diff --git a/docs/git-workflow/glossary/release-tag.md b/docs/git-workflow/glossary/release-tag.md
@@ -0,0 +1,7 @@
+---
+package: prikotov/git-workflow
+---
+
+# Тег релиза (Release tag)
+
+Именованная отметка коммита выпуска, например `v1.2.1`. В этом процессе опубликованный тег неизменяем.
diff --git a/docs/git-workflow/glossary/release.md b/docs/git-workflow/glossary/release.md
@@ -0,0 +1,7 @@
+---
+package: prikotov/git-workflow
+---
+
+# Релиз (Release)
+
+Опубликованная версия продукта; её публикация не означает, что она уже установлена в рабочей среде.
diff --git a/docs/git-workflow/glossary/repository.md b/docs/git-workflow/glossary/repository.md
@@ -0,0 +1,7 @@
+---
+package: prikotov/git-workflow
+---
+
+# Репозиторий (Repository)
+
+Хранилище файлов проекта и истории их изменений в Git.
diff --git a/docs/git-workflow/glossary/semver.md b/docs/git-workflow/glossary/semver.md
@@ -0,0 +1,7 @@
+---
+package: prikotov/git-workflow
+---
+
+# Семантическое версионирование (Semantic Versioning, SemVer)
+
+Правила выбора номера `major.minor.patch` с учётом характера изменений и совместимости. Применение к версиям `0.x` и `1.x` описано в [регламенте релизов](../release.md#semver-и-линии-релиза).
diff --git a/docs/git-workflow/glossary/squash.md b/docs/git-workflow/glossary/squash.md
@@ -0,0 +1,7 @@
+---
+package: prikotov/git-workflow
+---
+
+# Объединение коммитов (Squash)
+
+Сведение изменений нескольких коммитов в один новый коммит.
diff --git a/docs/git-workflow/glossary/version.md b/docs/git-workflow/glossary/version.md
@@ -0,0 +1,7 @@
+---
+package: prikotov/git-workflow
+---
+
+# Версия (Version)
+
+Определённое состояние продукта, обозначенное номером, например `1.2.1`.
diff --git a/docs/git-workflow/index.md b/docs/git-workflow/index.md
@@ -11,7 +11,7 @@ package: prikotov/git-workflow
 - Этот файл — оглавление раздела.
 - Детали и правила находятся в документах по ссылкам ниже.
 
-- [Словарь терминов (Glossary)](glossary.md)
+- [Словарь терминов (Glossary)](glossary/index.md)
 - [Ветки (Branches)](branches.md)
 - [Коммиты (Commits)](commits.md)
 - [Pull Request (PR)](pull-request.md)