@rt-tools/agent-kit 0.2.0 → 0.3.0

package/assets/patterns/spec-driven-domain.md

@@ -0,0 +1,100 @@
+---
+name: spec-driven-domain
+kind: pattern
+rule: spec-driven
+description: Паттерн правила spec-driven. Брать при заведении или правке спека домена — раскладка файлов, обязательные разделы, форма правила и его привязки, форма сценария, порядок работы от спека к коду. Не брать для заведения закона, правила или паттерна — это паттерн spec-driven-rule.
+---
+
+# Спек домена
+
+Паттерн правила `spec-driven`. Что при этом должно быть верно — закон
+`{{lawsDir}}/project-documentation.md`.
+
+## Когда брать
+
+- Заводится новый домен или фича, которой ещё нет.
+- Правится контракт — спеки задетых доменов едут той же веткой.
+- Замечено расхождение спека с кодом.
+
+## Раскладка
+
+```
+<спеки>/<домен>/
+    spec.md              — как домен работает
+    implementation.md    — таблица «правило → файл:символ»
+    scenarios.md         — сценарии SC-<ПРЕФИКС>-<НОМЕР>
+    proposed/<фича>/     — только то, чего ещё нет
+```
+
+## Обязательные разделы
+
+Набор разделов задан заранее и сверяется дословно: зачем, терминология, правила, что не входит,
+контракт с кодами отказов, данные, экраны и состояния, сквозные требования, решения. «Не
+применимо» — законный ответ, отсутствие раздела — нет: сквозные требования вспоминаются
+постфактум именно тогда, когда для них не заведено места.
+
+Шапка несёт статус, префикс сценариев, зависимости от других доменов, строку с законами,
+которые домен применяет, и строку с корнями либ, чьи обработчики он обслуживает.
+
+```markdown
+**Зависимости:** `<домен>` (что берётся), `<домен>` (что берётся)
+**Законы:** `access`, `locales`, `shared-code`
+**Обработчики:** `<корень либы>`
+```
+
+Закон, названный где-нибудь в тексте спека, обязан стоять в этой строке: связь сверяется в обе
+стороны.
+
+## Правило и его привязка
+
+Правило формулируется так, чтобы его можно было нарушить, и начинается с жирной фразы:
+
+```markdown
+- **Применяется одна максимальная скидка.** Сложение скидок даёт цену ниже себестоимости.
+```
+
+Привязка живёт в `implementation.md` рядом, ключ связи — сам текст правила:
+
+```markdown
+| Правило                               | Где исполняется   |
+| ------------------------------------- | ----------------- |
+| Применяется одна максимальная скидка. | `<путь>:<символ>` |
+```
+
+Правило, которому места в коде не нашлось, — намерение: ему место в открытых вопросах, а не
+формальный якорь.
+
+## Сценарий
+
+```markdown
+### SC-<ПРЕФИКС>-19 — подтверждение на занятые даты отбивается
+
+Дано у записи есть подтверждённая соседняя на пересекающиеся даты
+Когда владелец подтверждает заявку
+Тогда отказ подаётся владельцу как занятые даты, а не как ошибка хранилища
+```
+
+Идентификатор ставится в начало заголовка теста, через тире. Сценарий без теста помечается
+отметкой с причиной, сценарий с неполным тестом — отметкой о частичном покрытии.
+
+## Порядок работы
+
+1. Задача заводится сценариями: что станет верно, когда работа закончится.
+2. Спек домена правится **до** кода.
+3. Код пишется под сценарии, тесты называются их идентификаторами.
+4. Проверка спеков — до пуша.
+5. Приёмка идёт по сценариям, а не по пересказу правки.
+
+## Частые промахи
+
+- **Список шагов в спеке:** шаги — артефакт сессии, им место в ветке или в описании PR.
+- **Скопированная из контракта таблица полей:** источник один, а компилируется из двух только
+  одна.
+- **Колонки и индексы в спеке:** они в схеме хранилища, а в спеке остаётся правило, которое
+  ограничение выражает.
+- **Место, где правило исполняется, внутри текста правила:** оно меняется при первом же
+  переносе, и для него заведён отдельный файл.
+- **Отметка о непокрытом при существующем тесте** — отказ: долг закрыли, а отметку не сняли.
+- **Закон, названный в тексте, но забытый в шапке:** по закону тогда не узнать, какие домены на
+  нём стоят.
+- **Правка контракта без спеков задетых доменов** — гард документов отбивает такой коммит.

package/assets/patterns/spec-driven-rule.md

@@ -0,0 +1,112 @@
+---
+name: spec-driven-rule
+kind: pattern
+rule: spec-driven
+description: Паттерн правила spec-driven. Брать при заведении или правке закона, правила или паттерна — готовые шапки, набор разделов каждого слоя, таблица привязки, признак того, что правило пора делить. Не брать для спека домена — это паттерн spec-driven-domain.
+---
+
+# Закон, правило и паттерн
+
+Паттерн правила `spec-driven`. Что при этом должно быть верно — закон
+`{{lawsDir}}/project-documentation.md`.
+
+## Когда брать
+
+- Правило приходится повторять ещё в двух местах — пора заводить закон.
+- Заводится правило под уже существующий закон.
+- Готовый код в правиле разросся — пора выносить паттерн.
+
+## Закон
+
+`{{lawsDir}}/<закон>.md`. О проекте не знает ничего: ни путей, ни имён файлов, ни привязок.
+Признак закона: попытка положить статью в один спек заставляет повторить то же самое ещё в
+двух.
+
+Разделы: вводный абзац без заголовка, затем `## Статьи`. Обязательны статьи — их и сверяет
+проверка.
+
+Ни истории правок, ни доводов о том, почему когда-то выбрали так, в законе нет. Историю держит
+система контроля версий, а довод с отвергнутой альтернативой — свойство работы, а не продукта:
+ему место в «Ловушках» правила под этим законом, где и путям к файлам можно. Утверждение,
+которое нельзя написать как «верно всегда», статьёй не становится вовсе.
+
+```markdown
+# Поставка
+
+Как правка доезжает до работающего приложения. …
+
+## Статьи
+
+- **Выкатывается образ того коммита, который выкатывают.** Умолчание «последний» отстаёт от
+  главной ветки, и приложение молча возвращается к прежней версии, продолжая отвечать.
+```
+
+Поведение кода законом не является: «стор отвечает булевым», «метод называется так-то» — этого
+не видит ни гость, ни владелец. Граница простая: закон описывает то, что видно снаружи
+приложения.
+
+## Правило
+
+`{{rulesDir}}/<правило>/SKILL.md`. Говорит, каким приёмом закон исполняется; на один закон их
+бывает несколько.
+
+```markdown
+---
+name: git-workflow
+kind: rule
+law: delivery
+description: Правило под закон «Поставка». Брать на … Готовый код — в паттернах … Чем это названо здесь — в implementation.md рядом.
+---
+```
+
+Разделы: `## Когда берётся` · `## Что здесь действует` · `## Паттерны` · `## Ловушки`.
+
+Имён этого дерева в правиле нет — оно переносимо ровно поэтому. Как что называется здесь и где
+лежит, пишется рядом, в `implementation.md`, и оттуда же идёт привязка статей к коду:
+
+```markdown
+| Статья                                                          | Где исполняется               |
+| --------------------------------------------------------------- | ----------------------------- |
+| Образы выкатываются по хешу коммита, а не по метке «последний». | `<состав прода>:<переменная>` |
+```
+
+Каждый пункт раздела `## Что здесь действует` начинается жирной статьёй, и у каждой статьи есть
+строка в компаньоне. Утверждение, которому места в коде не нашлось, в этот раздел не ставится:
+оно уходит прозой в «Ловушки» или статьёй в закон.
+
+## Паттерн
+
+`{{rulesDir}}/<правило>-<что>/SKILL.md`. Минимум один на правило.
+
+```markdown
+---
+name: git-workflow-commit
+kind: pattern
+rule: git-workflow
+description: Паттерн правила git-workflow. Брать … Не брать для … — это паттерн …
+---
+```
+
+Разделы: `## Когда брать` · готовый код · `## Частые промахи`. Компаньона у паттерна нет:
+сверять готовый код с ним самим нечем.
+
+## Порядок
+
+1. Статья пишется в закон — без путей и имён файлов.
+2. Правило объявляет закон в шапке и называет приём, которым статья исполняется.
+3. Имена этого дерева и привязка каждой статьи уходят в `implementation.md` рядом; якорь
+   проверяется открытием файла, а не памятью.
+4. Готовый код уезжает в паттерн, а правило на него ссылается.
+5. Проверка спеков — до пуша.
+
+## Частые промахи
+
+- Закон назвал файл проекта. Путям место в правиле, а точнее — в его компаньоне.
+- Компаньон лежит не рядом с правилом, а рядом с законом: он привязывает закон к этому проекту,
+  и зелёная проверка это утвердит, потому что структура совпадёт с тем, чего проверка сама и
+  ждёт.
+- Якорь ведёт в мёртвый символ: объявлен и больше нигде не встречается.
+- Статью переформулировали, а строку в привязке не тронули: связь идёт по тексту, и проверка
+  перестанет её находить.
+- В описании не сказано, когда паттерн **не** брать, — соседний паттерн того же правила
+  становится неотличимым.

package/assets/patterns/styling-bem-component.md

@@ -0,0 +1,77 @@
+---
+name: styling-bem-component
+kind: pattern
+rule: styling-bem
+description: Паттерн правила styling-bem. Брать при правке стилей компонента источника вида — готовый хост, модификаторы, значения только токенами, перебивание умолчаний источника вида. Не брать для раскладки экрана — это паттерн styling-bem-layout.
+---
+
+# Стили компонента
+
+Паттерн правила `styling-bem`. Что при этом должно быть верно — закон
+`{{lawsDir}}/frontend-application.md`.
+
+## Когда брать
+
+- Правится компонент источника вида.
+- Правится оформление отдельного компонента.
+- Нужно перебить умолчание источника вида в своём компоненте.
+
+## Хост — сам блок
+
+Хост несёт класс блока, раскладка на хосте, элементы вложены внутрь:
+
+```scss
+:host {
+    display: inline-flex;
+
+    .<блок > {
+        display: inline-flex;
+        gap: var(--<токен отступа>);
+        align-items: center;
+
+        &--<модификатор > {
+            border-radius: var(--<токен скругления>);
+        }
+    }
+}
+```
+
+Модификатор — вложенным селектором или привязкой класса на хосте. У экрана вне источника вида
+такого раздела нет: раскладка на хосте — это общий слой приложения, а не файл экрана.
+
+## Значения — только токенами
+
+```scss
+✗ color: #fff;
+✗ box-shadow: 0 1px 2px rgb(0 0 0 / 12%);
+✓ color: var(--<токен цвета поверхности>);
+✓ box-shadow: var(--<токен тени>);
+```
+
+Составное значение берётся готовым токеном целиком, а не собирается из частей. Переменные
+препроцессора для значений оформления не используются вовсе: они разрешаются на сборке и темой
+не переключаются.
+
+## Перебить умолчание источника вида
+
+Стили компонента без инкапсуляции весят столько же, сколько умолчания источника вида: у обоих
+селекторов по одному классу, и исход решает порядок подключения. Переопределение пишется
+потомком блока — так вес растёт на единицу, и порядок перестаёт что-либо решать:
+
+```scss
+& &__item {
+    color: var(--<токен приглушённого текста>);
+}
+```
+
+## Частые промахи
+
+- **Комментарий-выключатель линтера стилей:** селекторы объединяются вложенностью, а не
+  отключением правила.
+- **Приоритетное объявление:** запрещено, и оформление, заданное на месте, перебить им всё
+  равно не выйдет.
+- **Новые объявления при переносе стилей:** переносится существующее, новое появляется, только
+  когда задача — фича.
+- **Замечание линтера, лежавшее в файле раньше, оставлено:** правятся все, и новые, и старые.
+- **Своё наследование гарнитуры в компоненте:** оно включено глобально, и местное объявление
+  только расходится с ним.

package/assets/patterns/styling-bem-layout.md

@@ -0,0 +1,67 @@
+---
+name: styling-bem-layout
+kind: pattern
+rule: styling-bem
+description: Паттерн правила styling-bem. Брать при сборке экрана раздела, формы, панели или окна — блоки общего слоя, разметка директивами блока и элемента, свой элемент в чужом поддереве, признак того, что правка идёт не туда. Не брать для стилей компонента источника вида — это паттерн styling-bem-component.
+---
+
+# Экран на общем слое раскладки
+
+Паттерн правила `styling-bem`. Что при этом должно быть верно — закон
+`{{lawsDir}}/frontend-application.md`.
+
+## Когда брать
+
+- Собирается экран раздела, форма, содержимое панели или модального окна.
+- В файле стилей экрана появляется раскладка.
+
+## Файл стилей экрана по умолчанию пустой
+
+Раскладка объявлена один раз в общем слое приложения, а экран её только применяет. Блоков этого
+слоя немного, и каждый отвечает за свой род экрана: экран раздела с заголовком и прокруткой,
+форма с разделами и строками полей, содержимое панели правки, содержимое модального окна.
+
+Блок вешается на хост, элементы получают классы от директивы блока в корне шаблона:
+
+```
+host: { class: '<блок экрана>' },
+```
+
+```html
+<ng-container rtBlock="<блок экрана>">
+    <header rtElem="header">
+        <div rtElem="header-main">
+            <h1 rtElem="title">{{ '<ключ заголовка>' | <перевод> }}</h1>
+        </div>
+    </header>
+</ng-container>
+```
+
+Директива блока на контейнере без своего узла класса не ставит — узел это комментарий. Второго
+носителя класса блока не нужно, и своей обёртки тоже.
+
+## Свой элемент в чужом поддереве
+
+Пара директив на одном элементе; класс блока при этом не ставится, только класс элемента:
+
+```html
+<div rtBlock="<свой блок>" rtElem="confirm"></div>
+```
+
+Класс получается составной, а потомки внутри считаются от того же блока.
+
+## Своё в файле экрана
+
+Остаётся только то, что принадлежит одному этому экрану и в общий слой не просится, — сетка
+календаря, карта на странице записи, лента переписки. Рядом пишется, почему это не общее.
+
+## Частые промахи
+
+- **Раскладка на хосте в файле экрана.** Одинаковые с виду экраны от неё расходятся: заголовок
+  страницы, объявленный в каждом экране заново, живёт тремя разными кеглями.
+- **Директива элемента без предка, объявившего блок:** отрисовка падает во время работы, сборка
+  и линтер молчат.
+- **Класс, у которого правило сняли, а директива в шаблоне осталась:** ловит проверка «класс
+  без правила».
+- **Элемент чужого блока в чужом поддереве:** имя блока приходит от предка, и подмешать его
+  нечем.

package/assets/patterns/testing-e2e.md

@@ -0,0 +1,90 @@
+---
+name: testing-e2e
+kind: pattern
+rule: testing
+description: Паттерн правила testing. Брать при правке и прогоне сквозных спек — что вообще закрывается сквозной спекой, прогон одним рабочим, стенд из прод-сборки под настоящим прокси, выключатели разрушающих спек. Не брать для юнитов — это паттерн testing-unit.
+---
+
+# Сквозные спеки
+
+Паттерн правила `testing`. Что при этом должно быть верно — закон
+`{{lawsDir}}/verifiability.md`.
+
+## Когда брать
+
+- Пишется или правится сквозная спека.
+- Надо воспроизвести дефект, который виден только на прод-конфигурации.
+- Готовится стенд под прогон против прокси.
+
+## Сквозной спекой закрывается накопленное состояние
+
+Случай для неё — тот, где состояние копится нажатиями: открытая панель, активный маршрут, страж
+прошлого экрана. Всё, что проверяется одним заходом по адресу, дешевле закрыть юнитом на чистой
+функции или замером экрана.
+
+Отсюда и способ: нажатия по тем же элементам, что нажимает владелец, несколько подряд, без
+перезагрузки между ними. Заход по прямому адресу поднимает приложение заново, накопленного
+состояния у него нет, и проход читается как «дефект не подтверждается».
+
+Элементы находятся по якорям спек: классы меняются вместе с вёрсткой, а поиск по роли и тексту
+ломается на переводах.
+
+## Прогон
+
+По умолчанию конфиг идёт на порт разработки и подхватывает уже поднятый сервер. С заданным
+адресом стенда свой сервер не стартует вовсе.
+
+Полный набор спек с настоящей сессией гоняется **одним рабочим**: такие тесты правят одни и те
+же записи живого хранилища и в параллельном прогоне мешают друг другу. Одни и те же файлы дают
+падения на многих рабочих и ноль на одном.
+
+## Стенд из прод-сборки под настоящим прокси
+
+Дешевле полного состава прода: один контейнер прокси с боевым конфигом, а приложения за ним —
+процессы на хосте.
+
+```bash
+<сборка всех приложений>
+<адрес хранилища> <порт> node <собранный сервер> &
+docker run -d --name <стенд> \
+  --add-host <имя апстрима>:host-gateway \
+  -p <внешний порт>:80 \
+  -v "$PWD/<конфиг прокси>:/etc/nginx/conf.d/default.conf:ro" \
+  -v "$PWD/<каталог сборки>:/usr/share/nginx/html:ro" \
+  <образ прокси>
+```
+
+Порты апстримов зашиты в конфиг именами — менять их нельзя, подстановка хоста заменяет только
+адрес.
+
+## Выключатели
+
+```
+const РАЗРЕШЕНО = окружение['<имя переменной>'] === '1';
+тест.пропустить(!РАЗРЕШЕНО, 'меняет живой адрес записи: включается переменной');
+```
+
+- Спека, необратимо меняющая данные стенда, по умолчанию пропускается и включается своей
+  переменной.
+- Проверки, которым нужен прокси, просыпаются вместе с адресом стенда. Голый сервер отдачи
+  страниц их не проходит, и падения выглядят регрессией.
+- Правило линтера, запрещающее выключенный тест, снимается в конфиге: выключатель здесь — приём,
+  а не забытый пропуск.
+
+## Частые промахи
+
+- **Порт приложения занимать осторожно:** стенд разработчика ходит по тому же имени через
+  подстановку хоста, и пока на нём висит чужой процесс, стенд отдаёт чужую сборку.
+- **Браузер обычно установлен один.** Ошибка «Executable doesn't exist» разобрана в правиле
+  `testing`: она же приходит после смены версии прогонщика.
+- **Спеки без учётных данных пропускаются молча** — прогон выглядит успешным, а проверено
+  меньше половины.
+- **Конфиг прокси монтируется каталогом, а не одиночным файлом:** редактор пересоздаёт файл, и
+  контейнеру остаётся обрезанная копия.
+- **Подменяется не только то, что запрашивает экран, но и то, что запрашивает шапка.** Общий
+  запрос идёт на каждом экране; без подмены на него отвечает настоящий сервер, поддельный вход
+  он отбивает, перехватчик сбрасывает сессию — и десятки тестов падают на пропавшей шапке, что
+  выглядит дефектом экрана.
+- **Каталог сборки, удалённый под смонтированным томом, оставляет контейнер с пустым корнем:**
+  стенд отвечает отказом на всё, и падают сразу все тесты. Контейнер после такого удаления
+  пересоздаётся.

package/assets/patterns/testing-unit.md

@@ -0,0 +1,93 @@
+---
+name: testing-unit
+kind: pattern
+rule: testing
+description: Паттерн правила testing. Брать при заведении или правке файла спеки рядом с исходником — раскладка блоков, сборщик фикстур, идентификатор сценария в заголовке, спека обработчика серверной стороны с рукописным двойником хранилища, разовый тест-доказательство. Не брать для сквозных спек — это паттерн testing-e2e.
+---
+
+# Спека на чистую функцию и на обработчик
+
+Паттерн правила `testing`. Что при этом должно быть верно — закон
+`{{lawsDir}}/verifiability.md`.
+
+## Когда брать
+
+- Заводится или правится файл спеки рядом с исходником.
+- Логику надо вынести из компонента или службы, чтобы её стало чем проверить.
+- Пишется спека на обработчик серверной стороны.
+
+## Импорты явные
+
+Даже когда прогонщик кладёт свои имена в глобальную область, список пишется: файл, читаемый
+без конфига, не должен зависеть от настройки, о которой в нём ни слова.
+
+## Один блок на функцию
+
+Имя блока совпадает с именем функции дословно; заголовки тестов — предложения настоящим
+временем, о поведении, а не об устройстве:
+
+```
+описание('applyDayClick', () => {
+    тест('SC-<ПРЕФИКС>-19 — нажатие по занятому дню ничего не меняет', () => {
+        ожидать(applyDayClick(day('2026-08-12'), selection)).равно(selection);
+    });
+});
+```
+
+Идентификатор сценария из спека домена стоит в начале заголовка, через тире. Краевые случаи —
+отдельные тесты в том же блоке, а не один тест с десятком проверок.
+
+## Фикстура собирается функцией с частичной подменой
+
+Не повторяющимся литералом: литерал, размноженный по файлу, при первой же новой обязательной
+колонке правится в каждом месте — и в одном обязательно забывается.
+
+```
+функция day(iso, подмена = {}) {
+    вернуть { iso, dayOfMonth: число(iso.срез(8)), busyNight: занято(iso), past: ложь, ...подмена };
+}
+```
+
+Общие константы лежат наверху файла, в области модуля.
+
+## Решение выносится в чистую функцию
+
+Логика уезжает в отдельный файл рядом и проверяется вызовом — без подъёма каркаса и без
+подмены зависимостей. Компонент и служба остаются обёрткой, у которой своего ветвления нет.
+
+## Обработчик зовётся напрямую
+
+Обработчик — метод класса; двойник хранилища пишется руками. Проверяются порядок действий,
+откат при отказе половины, идемпотентность повтора и то, что именно ушло в хранилище. Раскладку
+полей стерегут тесты слоя обращения к серверу, и здесь она не повторяется.
+
+## Разовый тест-доказательство
+
+Дефект, который иначе подтверждается только чтением кода, доказывается тестом, написанным на
+время разбора: он поднимает настоящий обработчик, подменяет его единственный выход наружу и
+считает походы.
+
+Число до правки и число после — единственная форма ответа, которую такая проверка даёт: «сто из
+ста» и «двадцать из ста» различимы, а «код выглядит правильным» — нет.
+
+Второй способ снять «до» — вернуть на место версию файла из точки расхождения ветки и прогнать
+тест ветки: падение теста и есть воспроизведение дефекта. Файл после этого восстанавливается
+копией, и восстановление проверяется прогоном того же теста, а не памятью.
+
+Двойники соседей не выдумываются: рабочий набор берётся из теста соседнего обработчика того же
+домена. Двойник, собранный по типу, падает не на утверждении, а на вызове метода, которого у
+него нет.
+
+**Такой файл не коммитится.** Он живёт до конца разбора и удаляется вместе с ним; проверка,
+которую стоит оставить, переписывается в обычную спеку с идентификатором сценария в заголовке.
+Признак временного файла — его заголовок не называет ни одного сценария.
+
+## Частые промахи
+
+- **Либа без своего конфига прогонщика проходит зелёной, не запустив ни одного файла.** Прежде
+  чем писать первый тест в либе, проверить, что конфиг рядом есть.
+- **Подмена модуля скрыла бы то, ради чего тест и заводится** — какой именно вызов ушёл в
+  хранилище и в каком порядке. Двойник пишется руками.
+- **Своих помощников для проверок не заводить** — утверждения пишутся прямо.
+- **Заголовок с несуществующим идентификатором сценария роняет проверку спеков**, а сами тесты
+  при этом остаются зелёными.

package/assets/patterns/translations-key.md

@@ -0,0 +1,51 @@
+---
+name: translations-key
+kind: pattern
+rule: translations
+description: Паттерн правила translations. Брать, когда в интерфейсе появляется видимый текст — куда положить ключ, как подставить его в разметку и в класс, чем дозаполнить остальные локали и чем проверить полноту. Не брать для перевода содержимого записи — его заполняет серверная сторона.
+---
+
+# Ключ перевода
+
+Паттерн правила `translations`. Что при этом должно быть верно — закон `{{lawsDir}}/locales.md`.
+
+## Когда брать
+
+- В интерфейсе появляется любой текст, который видит человек.
+- Правится подпись, пустое состояние, текст отказа, подпись кнопки подтверждения.
+
+## Куда кладётся ключ
+
+Словари разложены по разделам, и наборы ключей сверяются **внутри раздела**: общее для всех
+приложений, публичная часть, внутренняя часть, письма. Ключ заводится во всех локалях сразу —
+пустое значение считается пропуском, а не переводом.
+
+## Подстановка
+
+В разметке — преобразователем, в классе — реактивным значением:
+
+```html
+<h1 rtElem="title">{{ '<ключ заголовка>' | <перевод> }}</h1>
+<table [emptyMessage]="'<ключ пустого списка>' | <перевод>"></table>
+```
+
+```typescript
+protected readonly title: Signal<string> = translateSignal('<ключ заголовка>');
+```
+
+## Дозаполнить и проверить
+
+Дозаполнение недостающего делается командой, а полноту держит тест: он роняет прогон на
+недостающем или пустом ключе. Глазами это не проверяется — ключей тысячи.
+
+## Частые промахи
+
+- **Текст строкой прямо в шаблоне:** он уедет в интерфейс на одном языке во всех локалях.
+- **Ключ заведён только в паре локалей:** тест полноты падает, но замечают это уже в гейте
+  пуша.
+- **Пустая строка вместо перевода:** на экране она выглядит как задуманная — кнопка без
+  подписи, заголовок без текста.
+- **Ключ положен не в свой раздел:** наборы сверяются внутри раздела, и расхождение вылезет как
+  недостача в другом.
+- **Свой ключ успеха у панели правки записи:** текст успеха принадлежит самой операции и
+  заводится во всех локалях сразу.