From e9a85ad1a4d5b462fc760efa61ed56346cbe082f Mon Sep 17 00:00:00 2001 From: BrowenSiz Date: Sun, 8 Nov 2026 17:31:21 +0300 Subject: [PATCH] =?UTF-8?q?docs:=20=D0=B4=D0=BE=D0=B1=D0=B0=D0=B2=D0=BB?= =?UTF-8?q?=D0=B5=D0=BD=D0=BE=20=D0=BF=D1=80=D0=B0=D0=B2=D0=B8=D0=BB=D0=BE?= =?UTF-8?q?=20=D0=BF=D0=B8=D1=81=D0=B0=D1=82=D1=8C=20=D0=BA=D0=BE=D0=BC?= =?UTF-8?q?=D0=BC=D0=B8=D1=82=D1=8B=20=D0=B8=20PR=20=D0=BD=D0=B0=20=D1=80?= =?UTF-8?q?=D1=83=D1=81=D1=81=D0=BA=D0=BE=D0=BC?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit Единый понятный стиль истории для обоих разработчиков и AI-ассистентов. Тип и область остаются латиницей для инструментов (git-cliff, lefthook). Refs: 1.2.9 Generated with [Devin](https://devin.ai) Co-Authored-By: Devin <158243242+devin-ai-integration[bot]@users.noreply.github.com> --- AGENTS.md | 7 +++++++ docs/ai/PROTOCOL.md | 2 ++ 2 files changed, 9 insertions(+) diff --git a/AGENTS.md b/AGENTS.md index cb0f4f9..b72648a 100644 --- a/AGENTS.md +++ b/AGENTS.md @@ -113,6 +113,13 @@ shtil-roadmap.html дорожная карта ### Общее - Термины — по `docs/glossary.md`. Новый термин сначала добавляется в словарь. - Ветки `feat/-кратко`, коммиты Conventional Commits с областью (`feat(server): …`) и строкой `Refs: `, PR в Gitea «[ID] Название», squash merge. +- **Коммиты и PR пишутся на русском языке, понятно и чётко.** Тип и область остаются латиницей (их читают инструменты), всё остальное — по-русски: + - заголовок: `тип(область): что сделано` — с маленькой буквы, без точки, до 72 символов, глагол в прошедшем времени (`добавлен`, `исправлена`, `убрано`); + - тело (если нужно): почему и что важно знать, а не пересказ диффа; + - последняя строка: `Refs: `. + - Хорошо: `feat(server): добавлен WithTenantTx для доступа к данным организации`, `fix(console): исправлен повтор запроса после истечения токена`. + - Плохо: `fix`, `правки`, `update files`, `WIP`, английский текст. + - Заголовок squash-коммита при слиянии PR тоже по-русски, обычно совпадает с названием PR. - Изменения `api/openapi.yaml`, `proto/`, `migrations/` — отдельным PR. - Значимое техническое решение — ADR в `docs/adr/NNNN-название.md` и поле «Решение» в дорожной карте. - Без лишних комментариев: комментарий объясняет «почему», а не «что». diff --git a/docs/ai/PROTOCOL.md b/docs/ai/PROTOCOL.md index 3190d06..756f759 100644 --- a/docs/ai/PROTOCOL.md +++ b/docs/ai/PROTOCOL.md @@ -106,6 +106,8 @@ Документы коммитятся в той же ветке, что и код (`docs(<область>): …` или вместе с кодом), с той же строкой `Refs: `. +**Коммиты, названия и описания PR — только на русском** (правило в `AGENTS.md`, раздел 6): `тип(область): что сделано`, тип и область латиницей, остальное по-русски, понятно и конкретно. Ассистент сам предлагает сообщение коммита в этом формате и не использует английские шаблоны своего инструмента. + --- ## 6. Форматы и размеры -- 2.54.0