@rt-tools/agent-kit 0.16.1 → 0.18.0

package/assets/rules/git-workflow.gitlab.md

@@ -20,7 +20,8 @@ description: Правило под «Закон о поставке» для д
 | В законе                         | Здесь                                                                                                                                                                                                 |
 | -------------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
 | главная ветка                    | `main`                                                                                                                                                                                                |
-| отдельная ветка                  | `<КЛЮЧ>-<номер задачи>-<короткий-slug>`; ключ задач — в `implementation.md`. Имя без номера (`feat/…`, `fix/…`) законно, пока ветка живёт локально: MR с неё не откроется                             |
+| отдельная ветка                  | `<КЛЮЧ>-<номер задачи>-<короткий-slug>`. Имя без номера (`feat/…`, `fix/…`) законно, пока ветка живёт локально: MR с неё не откроется                                                                 |
+| ключ задач                       | короткое слово, которым дерево зовёт свои задачи; задаётся ключом `board.taskKey` в `.claude/rt-kit/checks.json`, а в `implementation.md` называется для читателя                                     |
 | задача                           | issue проекта, заголовок `[<КЛЮЧ>-<номер>] <Что не так>`, исполнитель — учётная запись машинной работы; MR прикрепляется к нему строкой `Closes #<номер>` в описании                                  |
 | очередь работ                    | доска задач проекта — Issue Board. Задача попадает на неё меткой списка, а не самим фактом заведения: доска показывает те issue, чью метку знает                                                      |
 | состояние задачи в очереди работ | список доски, за которым стоит метка: заведённая, взятая в работу, ждущая разбора. Имена меток — в `implementation.md`; закрытая задача уходит из очереди слиянием, а не переносом в последний список |
@@ -133,9 +134,16 @@ flowchart TD
 - **Отставший список находится сверкой очереди, а не глазами.** Сверка судит список по PR
   в обе стороны: открытый MR при задаче не в разборе и разбор без открытого MR — оба
   расхождения. Момента, когда задачу берут в работу, ей не видно: ветки на доске нет.
-- **Задачи, чинящиеся одной правкой, сливаются до слияния ветки.** Вторая стирается вместе с
-  номером, а недостающее из неё дописывается в первую. После слияния слить уже нельзя: ветка
-  въехала, и откатывается она целиком.
+- **Ветка с открытой заявкой отстаёт от главной молча.** Гард судит основание один раз — в
+  минуту открытия; всё, что влилось в главную, пока шёл прогон, зелёный прогон не видит вовсе, и
+  влитая оттуда заявка приносит в главную ветку сочетание, которое не проверял никто. Отставание
+  находит сверка очереди работ: она спрашивает у хранилища, на сколько коммитов ветка каждой
+  открытой заявки позади главной, и называет число.
+- **Задачи, чинящиеся одной правкой, сливаются до слияния ветки.** Вторая закрывается как
+  дубликат со ссылкой на поглотившую, а недостающее из неё дописывается в первую. Закон велит
+  вторую стереть — здесь это объявленное отступление: стереть задачу хостинг не даёт вовсе, а её
+  номер остаётся в истории, и ссылка из чужого коммита ведёт в закрытую задачу, а не в пустоту.
+  После слияния слить уже нельзя: ветка въехала, и откатывается она целиком.
 - **Работа, которую одним заходом не закрыть, помечена в двух местах, и они сверяются.** Метка
   на доске и строка о заходах с передачей в замысле эпика говорят одно и то же двум читателям:
   исполнитель открывает карточку раньше, чем замысел эпика, а планирует по замыслу. Одна пометка без
@@ -157,6 +165,11 @@ flowchart TD
   отбивает пуш, а не печатается рядом с ним: напечатанное предупреждение исполнитель читает как
   разрешение. Дважды подряд правка, прошедшая гейт целиком, была отбита конвейером — и оба раза
   зелёный гейт был прочитан как «локально всё зелено».
+- **Причина исключения, называющая задачу, судится на живость этой задачи.** Отсрочка со сроком
+  и отсрочка без срока выглядят одинаково, пока номер никто не спросил; мёртвый номер в причине
+  делает исключение бессрочным, не сказав об этом ни строкой. Спрашивается тем же ярусом, что
+  состояние задачи у гарда поставки: есть чем спросить — спрашивает, нет сети или доступа —
+  пропускает молча.
 - **Сверка раскладки стоит в наборе гейта пуша наравне с линтом и сборкой.** Правка, положенная
   в разложенную копию мимо источника, в день, когда её делают, не ломает ничего: дерево
   работает, проверки зелёные, а расхождение видно только тому, кто позовёт сверку сам. Копится

package/assets/rules/lists.md

@@ -83,6 +83,11 @@ flowchart TD
 - **Недоступное сейчас действие в меню строки не рисуется вовсе.** Пункт заводится под `@if` по
   полю строки, а не выключенным: выключенный пункт перечисляет владельцу запреты вместо того,
   что он может сделать, и набор их меняется от строки к строке.
+- **Необратимое действие спрашивает подтверждение готовым приёмом, а не своим окном.** Пункт
+  меню несёт признак опасного и пару полей подтверждения — заголовок и текст с последствием, — а
+  окно берёт набор. Правило, молчавшее об этом, стоило владельцу выбора из трёх вариантов, среди
+  которых был свой компонент окна в новой либе: ответ лежал в паттерне, и туда исполнитель не
+  дошёл. Поля названы в паттерне `admin-lists-screen`.
 - **Кнопка меню не показывается, если у строки не осталось доступных действий.** За это
   отвечает вход `[rowHasActions]` — предикат по строке; считать по содержимому меню нельзя,
   спроецированный шаблон известен только после отрисовки.

package/assets/rules/observability.needs-app.md

@@ -168,3 +168,7 @@ flowchart TD
   Она работает по имени ключа, и голое значение мимо неё проходит вовсе, — но ключ, который сам
   числится свободным текстом, увозит тело в хранилище отметкой о вычистке целиком. Новая
   обёртка сверяется со списками ключей до того, как её так назвали.
+- **Предохранитель повтора, чей ключ собран из того, чем меряют время, не срабатывает никогда.**
+  При равенстве такта разбора и ширины ведёрка каждый разбор видит пустой замок и шлёт заново.
+  Со стороны это выглядит работающим: предохранитель объявлен, привязка сходится, письма уходят
+  каждый час. Ключ берётся от предмета оповещения, а не от отрезка времени, которым его считают.

package/assets/rules/reuse-first.md

@@ -53,6 +53,12 @@ flowchart TD
   опирается, названо в именах дерева.
 - **Работа начинается с чтения готового, а не с чистого файла.** Сначала находится опора —
   компонент кита, базовый класс, образец в соседнем домене, — потом пишется своё поверх неё.
+- **Значение интеграции берётся тем же путём, что и соседнее значение той же интеграции.**
+  Половина интеграции, сделанная как положено, — готовый образец, и стоит он не в чужом домене,
+  а строкой выше: рядом с зашитым в код идентификатором карты жил её же ключ, приходящий
+  внедрением. Расхождение соседей — это вопрос «почему один параметр сделан, а второй нет», а не
+  выбор между тремя способами починить второй. Не ловится оно ничем: значение синтаксически
+  исправно, линт и сборка зелены, а сверка повторов пару констант под свои признаки не берёт.
 - **Свой примитив и своя основа заводятся только с явного одобрения владельца.** Спрашивается
   это до того, как написан первый файл.
 - **Панель правки записи наследует общую основу, а не собирается своей разметкой.** Тогда она
@@ -72,6 +78,14 @@ flowchart TD
 - **Признаки объявляются деревом, а не зашиты в проверку.** Дерево берёт из rt-tools не всё, и
   признак о готовом из пакета, которого здесь нет, отвечает ложно ровно так же, как имя чужого
   приложения.
+- **Второе значение той же интеграции повторяет свой род, а не соседа по файлу.** У внешней
+  службы редко один параметр: рядом с ключом стоит идентификатор, рядом с адресом — область, и
+  первый обычно сделан как положено, а второй остаётся зашитым. Спрашивается при этом не сосед,
+  а род: где значения этого рода заводят, кто их правит, каким путём они доезжают до сборки.
+  Сосед бывает сам не переехавшим, и повторение разносит устаревший способ дальше; ближайший
+  сосед берётся образцом, только когда такого рода в дереве нет вовсе. Зашитое значение не
+  отбивают ни линтер, ни сборка, ни тест: оно синтаксически исправно и просто не принадлежит
+  этому дереву — так демонстрационное значение из документации поставщика уезжает в прод-сборку.
 
 ## Чего из закона здесь нет
 

package/assets/rules/shared-code.md

@@ -69,6 +69,11 @@ flowchart TD
 - **Строковая настройка и таблица соответствий сверяются по значению, а не по имени.** Имя
   здесь не ключ: `BEM_BLOCK` и `LOG_CONTEXT` объявлены десятками, и значения у них свои, а
   один и тот же перевод статуса живёт под тремя разными именами.
+- **Копии, у которых общего места нет по границам импортов, сводятся в тот слой, который видят
+  обе стороны, а не в общий.** Общая либа приложения не видит значений хранилища, и ребро оттуда
+  развернуло бы зависимость: сведение «как положено» тут ломает границы, а не чинит копии. Место
+  такой копии — слой выхода того домена, чьё значение она переводит; заводить под это новую либу
+  не надо, нужный слой у домена обычно уже объявлен и пуст.
 
 ## Чего из закона здесь нет
 

package/assets/rules/spec-driven.md

@@ -51,7 +51,7 @@ description: Правило под «Закон о документации пр
 | утверждение документа           | пункт `## Правила` в спеке, `## Статьи` в законе, `## Как закон применяется здесь` в правиле         |
 | место, где оно исполняется      | строка в `implementation.md` рядом: `` `файл:символ` ``                                              |
 | обещанное поведение             | сценарий `SC-<ПРЕФИКС>-<НОМЕР>` в `docs/specs/<домен>/scenarios.md`                                  |
-| открытый вопрос                 | `Q-N` — на него ссылаются из задачи на борде и из коммитов; номер после закрытия не переиспользуется |
+| открытый вопрос                 | `Q-<буква закона>-<номер>` в разделе «Открытые вопросы» закона; на него ссылаются из задачи и коммитов, номер после закрытия не переиспользуется |
 | законы, которые применяет домен | строка `**Законы:**` в шапке спека, именами в кавычках                                               |
 
 ## Где это лежит
@@ -92,10 +92,14 @@ flowchart TD
   именно тогда, когда для них не заведено места.
 - **Каждое утверждение привязано к месту в коде, и связь сверяется в обе стороны.** Ключ
   связи — сам текст утверждения, поэтому переформулировать его, забыв про привязку, нельзя.
-- **Привязка не ведёт в код, который никто не зовёт.** Символ, объявленный в своём файле и
-  больше нигде не встречающийся, местом исполнения не считается.
-- **Таблица процедур сверяется с декораторами в обе стороны.** Иначе процедура, которую домен
-  обслуживает, но забыл описать, видна только в декораторе.
+- **Первая колонка компаньона — текст статьи, скопированный, а не пересказанный.** Ключ связи —
+  сам текст, поэтому строка, написанная по смыслу статьи, разрывает связь, оставаясь на вид
+  заполненной. Проверка считает статьи без адреса и о статье, адрес которой описывает не её, не
+  знает ничего: совпадает род, а не перечень, и строка стоит до перечитывания диффа.
+- **Привязка не ведёт в код, который никто не зовёт:** нигде не зовущийся символ — не место.
+- **Таблица процедур сверяется с декораторами в обе стороны, право — вместе с именем.** Иначе
+  процедура, которую домен обслуживает, но забыл описать, видна только в
+  декораторе, а право, разошедшееся со спеком, — нигде.
 - **Код отказа принимается, только если он в домене бросается.** Коды выписывались по
   замыслу, и на одном пути обещанный отказ не бросал никто.
 - **Префикс сценариев в спеке один, и по всему дереву он занят им одним.** Второй префикс
@@ -175,14 +179,12 @@ flowchart TD
 
     Образцы разделены пробелом и сверяются с путём правки как образцы оболочки, а не поиском по
     словам: поиск называет не ту статью и молчит об этом. Образец без каталога сверяется и с
-    именем файла. Комментарий не виден в собранной разметке, поэтому статья читается человеком
-    как прежде.
+    именем файла, а комментарий в собранной разметке не виден.
 
 - **Статья без признака законна, и правило без единого признака — тоже.** Признак ставится тем
   статьям, чьё правило отбивает на правке файла; остальные размечаются по мере того, как их
   отбития попадут в сводку. Отсутствие признака означает «эту статью по пути правки не
-  выбирают», а не промах: требовать его у всех значило бы размечать наугад те правила, которые
-  ни разу никого не отбили.
+  выбирают», а не промах: требовать его у всех значило бы размечать наугад.
 
 - **Паттерн находится по полю `rule:`, а не по приставке имени.** Приставку имени несут не все
   паттерны, и поиск по имени правила таких не видит: сверка ищет их полем, человек — разделом
@@ -202,6 +204,11 @@ flowchart TD
   сторон: якорем утверждения оказывается слово из комментария, тогда как объявление рядом
   называется иначе.
 
+- **Проверка, прибитая к имени ресурса, ломается на его делении, и знать об этом надо до правки.**
+  Имя правила и имя паттерна стоят не только в текстах, но и в проверках дерева, в пробах их наборов
+  и в таблицах состояний. Деление поэтому начинается с поиска имени по всему дереву: иначе красное
+  приходит по одной проверке за прогон — так деление одного правила уронило три.
+
 ## Форма сжатой статьи
 
 Правило грузится в заход целиком и платит за это каждый заход, чем бы он ни занимался. Замер
@@ -242,14 +249,17 @@ flowchart TD
 
 Закон, которого не применяет ни один спек, отказом не считается: законы про устройство кода,
 поставку и проверяемость доменов не касаются вовсе. Порядок «сначала описание, потом код»
-держится договорённостью — это `Q-PD-3` в законе.
+держится договорённостью: закон о документации проекта такого требования не несёт, и открытого
+вопроса под него в нём не заведено.
 
 Таблицы состояний экрана не сверяются ничем. `check:specs` знает сценарии против заголовков
-тестов, правила против якорей, процедуры против декораторов и коды отказа против бросков —
-строка таблицы состояний не привязана ни к чему и проходит зелёной, даже когда код в
-названное состояние не попадает. Состояние «проверка не загрузилась» стояло в таблицах двух
-доменов раньше, чем код научился в него приходить, и всё это время читалось описанием
-работающего.
+тестов, правила против якорей, процедуры против декораторов и коды отказа против бросков — строка
+таблицы состояний не привязана ни к чему и проходит зелёной, даже когда код в названное состояние
+не попадает. Состояние «проверка не загрузилась» стояло в таблицах двух доменов раньше, чем код
+научился в него приходить, и всё это время читалось описанием работающего.
+
+Смысл сценария с соседним не сверяется ничем: проверка судит номер. Два сценария, обещающих одно
+и то же разными словами, для неё разные, и второй числится непроверяемым, сколько проживёт.
 
 Полноту разметки статей признаком применимости не считает ничто. Правило, у которого признака
 нет ни у одной статьи, отбивает прежним текстом — и от размеченного отличается только тем, что
@@ -278,3 +288,11 @@ flowchart TD
 
 - `spec-driven-domain` — заведение и правка спека домена, сценарии, привязка.
 - `spec-driven-rule` — заведение закона, правила и паттерна.
+- `spec-driven-sweep` — сплошной разбор привязки домена, проходы и их разбор.
+
+## Ловушки
+
+- **Строка требования к соседнему ресурсу не проверяется ничем, и промах в ней виден только
+  счётом.** Правило без неё выглядит целым: разделы на месте, привязки сходятся, набор полноты
+  зелёный. Считается она одной командой по каталогу правил, и расхождение читается сразу — сколько
+  правил объявило требования и сколько ссылается на соседний ресурс прозой.