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. Форматы и размеры