From fc589c9130e90480c09f8fe8d47dd871aa05145e Mon Sep 17 00:00:00 2001 From: Sergey Krylov Date: Mon, 12 Oct 2026 20:29:00 +0300 Subject: [PATCH] docs: refine workflow conventions after review (#27) --- .ai/conventions/engineering-workflow.md | 10 +++++----- README.md | 3 ++- 2 files changed, 7 insertions(+), 6 deletions(-) diff --git a/.ai/conventions/engineering-workflow.md b/.ai/conventions/engineering-workflow.md index e45df73..cee2219 100644 --- a/.ai/conventions/engineering-workflow.md +++ b/.ai/conventions/engineering-workflow.md @@ -62,7 +62,8 @@ Commitlint требует распознаваемую conventional-commits-pars в нём ссылку. `chore(release): X.Y.Z` освобождён только при точном SemVer заголовке release-it. Стандартные Gitea merge commits освобождаются по точному шаблону merge message; sync PR используют обычный review/merge process. -Историю не переписывать ради формата. +Шаблонные сообщения `Revert`/`fixup!`/`squash!` не освобождаются: revert +оформляй как `revert: … (#N)`. Историю не переписывать ради формата. ## Pull Request Process @@ -147,10 +148,9 @@ Frontend/backend запускают их как jobs в едином `verify.yml актуальный HEAD; если AC изменились — обновить Issue и при SDD вернуть change к затронутому approval gate. При недоступной Gitea продолжать только анализ. Изменение PR title после зелёного CI: проверить, что check пересчитан; -для docs/specs/frontend/backend `edited` trigger у существующих checks может -отсутствовать. До подтверждения настройки/отдельного исправления этих gates -reviewer проверяет текущий title вручную. Новые правила не применяются к -историческим коммитам и автоматической обратной синхронизации релиза. +если `edited` trigger у существующих checks отсутствует, reviewer проверяет +текущий title вручную. Новые правила не применяются к историческим коммитам +и автоматической обратной синхронизации релиза. Примеры: фича с новым поведением — Issue → согласованный OpenSpec change → ветки Apply → PR каждого affected repo → archive → закрытие Issue. Локальный diff --git a/README.md b/README.md index c96d2a8..53aabba 100644 --- a/README.md +++ b/README.md @@ -168,7 +168,8 @@ Commits и заголовки PR — Conventional Commits. `feat:` повыша `docs:`, `spec:`, `chore:`, `build:`, `ci:`, `refactor:`, `test:`, `style:` и `revert:` дают patch при выпуске. `chore(release):` — служебная запись, исключённая из changelog и рекомендации версии. Release-it не запускается -автоматически после каждого commit. Для обычных commits ссылка на Issue обязательна. +автоматически после каждого commit. Ссылка на Issue — в +[Commit Conventions](.ai/conventions/engineering-workflow.md#commit-conventions). ### Подготовка релиза