From 55f48c0227014a80ec556f3714512e5055ac6aa8 Mon Sep 17 00:00:00 2001
From: Aleksey Sabilin <aleksey@sabilin.com>
Date: Wed, 15 Jul 2026 00:16:19 +0300
Subject: [PATCH] =?UTF-8?q?docs:=20=D0=BF=D1=80=D0=BE=D0=BF=D1=83=D1=81?=
 =?UTF-8?q?=D0=BA=20CI=20=D1=87=D0=B5=D1=80=D0=B5=D0=B7=20[skip=20ci]=20/?=
 =?UTF-8?q?=20SKIP=5FCI=20=D0=B2=20git-commit.sh?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

---
 WORKFLOW.md | 25 +++++++++++++++++++++++++
 1 file changed, 25 insertions(+)

diff --git a/WORKFLOW.md b/WORKFLOW.md
index 20fdf8e..956cfe8 100644
--- a/WORKFLOW.md
+++ b/WORKFLOW.md
@@ -87,6 +87,29 @@ bash $GIT/git-commit.sh $EH/EventHubBack \
 
 Ручной коммит — тот же вызов в WSL-терминале.
 
+### Пропуск CI (Gitea Actions)
+
+В **последнем** коммите пуша (или в title PR) можно отключить запуск workflow:
+
+| Маркер | Пример |
+|--------|--------|
+| `[skip ci]` | предпочтительно |
+| `[ci skip]` / `[no ci]` / `[skip actions]` / `[actions skip]` | синонимы |
+
+Gitea не ставит run в очередь → не сработают deploy по `workflow_run`.  
+Через скрипт:
+
+```bash
+SKIP_CI=1 bash $GIT/git-commit.sh $EH/EventHubBack \
+  "docs only. Refs EventHub/EventHubBack#N" \
+  path/to/file
+
+# или
+bash $GIT/git-commit.sh $EH/EventHubBack "docs" file.md --skip-ci
+```
+
+Не злоупотреблять: без CI нет образов/IFT. Ручной `workflow_dispatch` по-прежнему доступен.
+
 ### Push на remote
 
 **Agent делает `git push` только после явного подтверждения пользователя** («пуш», «отправь», «push»):
@@ -226,6 +249,7 @@ IFT и stage крутят **одну и ту же** сборку `sha-*`. Produc
 - Метки во всех репозиториях держать одинаковыми (`sync-labels.ps1`).
 - Секреты и токены не коммитить; Gitea token — только в env / `~/.cursor/secrets/`.
 - **Git commit/push — через WSL** (`~/.cursor/eventhub/git-commit.sh`, `git-push.sh`); **push — только после подтверждения пользователя** (см. §2.1).
+- **Пропуск CI:** `[skip ci]` (и синонимы) в сообщении последнего коммита пуша / title PR; `SKIP_CI=1` или `--skip-ci` в `git-commit.sh` (см. §2.1).
 - Новая задача — **отдельный чат** с брифом по §5.
 - **Версии/деплой:** product = `VERSION` (`MAJOR.MINOR`); IFT+stage = `sha-*` (+ floating `:ift`/`:stage`); без ручных stage-тегов и без patch++ на каждый push (см. §6).
 - **FrontAdmin E2E:** mock-suite обязателен в CI; IFT smoke — после Deploy IFT (`e2e-ift.yml`, учётки из стендового `.env`).
@@ -236,6 +260,7 @@ IFT и stage крутят **одну и ту же** сборку `sha-*`. Produc
 
 | Дата | Изменение |
 |------|-----------|
+| 2026-07-15 | §2.1: пропуск CI — `[skip ci]` / `SKIP_CI=1` в git-commit.sh |
 | 2026-07-14 | §6 + gate: Playwright E2E (mock CI + IFT smoke secrets) |
 | 2026-07-14 | §6: VERSION MAJOR.MINOR + auto stage по sha после CI |
 | 2026-07-07 | Git-скрипты Agent перенесены в `~/.cursor/eventhub/` (не в репозиториях) |