@rt-tools/agent-kit 0.21.0 → 0.23.0

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

@@ -69,15 +69,15 @@ flowchart TD
   за которой в очереди работ ничего не стоит. Заводится задача, и работа переносится в ветку с
   её номером.
 - **Главная ветка влита в ветку задачи до открытия PR.** Гард отбивает открытие, пока вершина
-  главной не стала предком текущей, и называет расхождение числом коммитов: иначе ревьювер видит
-  свою правку вперемешку с чужой, а проверено всё было от основания, которого уже нет.
+  главной не стала предком текущей: иначе ревьювер видит свою правку вперемешку с чужой, а
+  проверено всё было от основания, которого уже нет.
 - **Волна веток от одной главной проверяется пробным слиянием, а не по одной:** каждая зелена
-  сама по себе, а сталкиваются они тем, чего на отдельной ветке не видно.
+  сама по себе, а сталкиваются тем, чего на отдельной ветке не видно.
 - **Ветка следующей работы отводится от предыдущей, пока череда не прервалась.** `git checkout -b
-  <КЛЮЧ>-<номер>-<slug> <предыдущая ветка>` вместо `origin/main`; от главной — только первая работа
-  череды. Иначе первое же слияние делает расходящимися все остальные разом.
+  <КЛЮЧ>-<номер>-<slug> <предыдущая ветка>` вместо `origin/main`; от главной — первая работа
+  череды. Иначе первое слияние разводит все остальные разом.
 - **У заявки в череде основанием стоит предыдущая ветка, а не главная.** `gh pr create --base
-  <предыдущая ветка>` — иначе разбор показывает свою правку вперемешку со всем, что под ней. Базу
+  <предыдущая ветка>` — иначе разбор показывает правку вперемешку со всем, что под ней. Базу
   влитой нижней хостинг переносит сам.
 - **Череда вливается снизу вверх, и порядок стоит в теле каждой заявки.** Родство веток по
   списку не видно: строка «стоит на #<номер>» — единственное место, где владелец это прочтёт.
@@ -87,9 +87,9 @@ flowchart TD
   владельца, разбирающего то же при слиянии, нет ни одной.
 - **Несошедшиеся условия поставки называются одним отказом.** Гард копит их и печатает разом: всё
   несошедшееся известно на первом вызове.
-- **Условие, известное в начале работы, спрашивается в начале.** Заведение ветки отбивает основание
-  без вершины главной и чужую почту в подписи. На пуше те же проверки стоят дороже: основание
-  чинится вливанием с конфликтом, подпись — переписыванием ветки.
+- **Условие, известное в начале работы, спрашивается в начале.** Заведение ветки отбивает
+  основание без вершины главной и чужую почту в подписи; на пуше то же чинится вливанием с
+  конфликтом и переписыванием ветки.
 - **Судится то основание, которое названо командой, а не вершина рабочей копии.** Ветку заводят и
   от `origin/main` прямо — этой командой основание как раз и берут свежим. Основание, о котором
   дерево ничего не знает, не судится вовсе.
@@ -140,12 +140,10 @@ flowchart TD
   прогона, а не цвет, и свежей вершине даёт время.
 - **Прогон, вытесненный из очереди конвейера, сверка называет отдельной строкой.** Он выглядит
   упавшим, хотя ветку не проверял; отличает их число заданий — у него ноль.
-- **Черновик при зелёном прогоне на вершине — расхождение сверки.** Зелёная страница черновика
-  владельцу ничего не разрешает: кнопка заблокирована хостингом. Внутри хода это закрывает гард,
-  между ходами — сверка.
-- **Свои черновики судятся все разом, а не тот один, чья ветка сейчас взята.** Каждый черновик
-  машинной записи судится двумя признаками — зелёный прогон на его вершине и разобранная папка
-  задачи в его ветке; лежащая папка означает идущую работу.
+- **Черновик при зелёном прогоне на вершине — расхождение сверки.** Зелёная страница ничего не
+  разрешает: кнопка заблокирована хостингом. В ходе это закрывает гард, между ходами — сверка.
+- **Свои черновики судятся все разом, а не тот один, чья ветка взята.** Признака два — зелёный
+  прогон на вершине и разобранная папка задачи в ветке; лежащая папка означает идущую работу.
 - **Открытие PR отбивается, пока ветка везёт папку своей задачи.** Кнопку слияния нажимает
   человек там, где гардов нет, и открытие — последняя точка, где отказ ещё виден тому, кто может
   его выполнить.
@@ -168,25 +166,32 @@ flowchart TD
 - **Сборка входит в набор наравне с линтом и юнитами.** Линтер типов не читает, а юниты читают
   только импортированное тестом: ошибка типов в непокрытом коде доживает до сборки образа, то
   есть до мержа.
-- **Набор гейта пуша не бывает уже набора конвейера.** Гейт — обещание, что пуш не приедет
-  красным. Шаг конвейера, которому в наборе гейта нет ни строки, ни объявленного исключения с
-  причиной, отбивает пуш, а не печатается рядом: предупреждение читается как разрешение.
-- **Набор гейта зовёт умолчание пакета, а не перечисляет его строками.** Переписанный строками, он
-  закрывает сегодняшнюю дыру и оставляет завтрашнюю: заведённая пакетом проверка до дерева не
-  доедет. Отсеивать из умолчания законно, но поимённо и с причиной.
-
+- **На машине, где раннеров несколько, любой путь от домашнего каталога общий.** Умолчание
+  готового шага опасно именно тем, что оно общее: соседнее задание переписывает его под свою
+  версию, пока наше стоит между шагами. Каталог установки, имя контейнера и имя сборщика
+  называются поэтому по проекту и постоянно, а временный каталог решением не бывает — в нём
+  живёт хранилище пакетов.
+- **Набор гейта пуша не бывает уже набора конвейера.** Шаг конвейера, которому в наборе нет ни
+  строки, ни объявленного исключения с причиной, отбивает пуш, а не печатается рядом:
+  предупреждение читается как разрешение.
+- **Набор гейта зовёт умолчание пакета, а не перечисляет его строками.** Переписанный строками,
+  он оставляет завтрашнюю дыру: заведённая пакетом проверка до дерева не доедет. Отсеивать из
+  умолчания законно, но поимённо и с причиной.
+- **Итоговый набор перед пушем читается разбором состояния, а не сборкой в уме.** Раздел «набор
+  перед пушем» печатает его целиком и называет рядом то, что умолчание печатало, а в набор не
+  попало: дерево, писавшее надстройку вслепую, дописывало в неё повтор.
 - **Причина исключения, называющая задачу, судится на живость этой задачи.** Мёртвый номер делает
-  исключение бессрочным, не сказав об этом ни строкой. Спрашивается тем же ярусом, что состояние
-  задачи у гарда: нет сети или доступа — пропускает молча.
-- **Сверка раскладки стоит в наборе гейта пуша наравне с линтом и сборкой.** Правка мимо источника
-  копится молча: раскладка отказывает по правленому файлу целиком. Статьёй выше это не покрывается —
-  сверки нет в конвейере.
+  исключение бессрочным молча. Спрашивается тем же ярусом, что состояние задачи у гарда.
+- **Сверка раскладки стоит в наборе гейта пуша наравне с линтом и сборкой.** Правка мимо
+  источника копится молча, а сверки нет в конвейере.
 - **После вливания главной ветки набор проверок пересматривается по тому, что ветка везёт
-  теперь.** Вливание меняет состав правки: проверять по тому, что правил автор, — значит
-  проверять половину, а отвечает ветка целиком.
-- **Утверждение о главной ветке делается по удалённой ссылке, а не по локальной.** Локальная
-  протухает в минуту, когда её подтянули, и молчит об этом. Сравнение пишется от `origin/main`
-  целиком: смешанные в одной команде, они дают промах, изнутри выглядящий верным.
+  теперь.** Проверять по тому, что правил автор, — значит проверять половину: отвечает ветка
+  целиком.
+- **Главная ветка берётся удалённой ссылкой — и в словах, и в действиях.** Локальная протухает в
+  минуту, когда её подтянули, и молчит об этом: это снимок вчерашнего дня. От `origin/main` идут
+  и сравнение, и основание новой ветки, и счёт влитого, и подтягивание — смешанные в одной
+  команде, ссылки дают промах, изнутри выглядящий верным. Влитая ветка при локальной числится
+  невлитой, и уборка кончается списком невлитого, которого нет.
 - **Правка кода отдаётся человеку открытым PR, а не запушенной веткой.** Ветка во входящие не
   приходит и обсуждения не имеет: до открытия PR правки для человека нет. Открывается он тем же
   ходом, которым исполнитель говорит, что работу отдаёт.
@@ -216,36 +221,32 @@ flowchart TD
   хостинга об авторе гард спрашивает на снятии черновика: влитую заявку не переоткрыть.
 
 - **Автор PR не может быть его ревьювером.** Запрос разбора на себя GitHub принимает и молча не
-  создаёт: разбор выглядит запрошенным. Считаются только запрос и отзыв не от автора.
-- **Вызов клиента хостинга идёт из дерева, а связка команд исхода не проверяет.** Репозиторий
-  клиент берёт у текущего каталога и вне дерева отказывает; следующее звено связки увозит на
-  хостинг то, что осталось от отказавшего, поэтому тело читается обратно тем же ходом.
-- **Метки, исполнитель и ревьювер PR ставятся вызовами `gh api`, а не `gh pr edit`.** На старой
-  борде `gh pr edit` отвечает отказом про Projects.
+  создаёт. Считаются только запрос и отзыв не от автора.
+- **Вызов клиента хостинга идёт из дерева, а связка команд исхода не проверяет.** Вне дерева
+  клиент отказывает, а следующее звено увозит на хостинг остаток отказавшего.
+- **Метки, исполнитель и ревьювер PR ставятся вызовами `gh api`, а не `gh pr edit`:** тот
+  отвечает отказом про Projects.
 - **Борда правится запросом GraphQL по идентификатору борды, а не по имени владельца.**
-- **Почта машинного коммита копируется из компаньона, а не набирается по памяти.** Служебный адрес
-  `<число>+<логин>@users.noreply.github.com` сопоставляется по числу: коммит с чужим числом уезжает
-  подписанным посторонним. Ту же строку держит профиль дерева, и гард отбивает пуш.
-- **Личность машинной записи подтверждается ответом хостинга, а не узнаванием строки.** Спрашивают
-  её токеном, ответом о себе: логин и число приходят вместе.
-- **Сценарии гардов задают настройки git сами, а не берут их с машины.** Подпись, включённая на
-  машине, уводит git в агент ключей, а заблокированный агент роняет весь набор: автор, почта и
-  подпись идут флагами `-c` прямо в команде.
+- **Почта машинного коммита копируется из компаньона, а не набирается по памяти.** Адрес
+  `<число>+<логин>@users.noreply.github.com` сходится по числу: с чужим коммит уезжает подписанным
+  посторонним. Ту же строку держит профиль дерева, и гард отбивает пуш.
+- **Личность машинной записи подтверждается ответом хостинга, а не узнаванием строки:** её
+  спрашивают токеном, и логин с числом приходят вместе.
+- **Сценарии гардов задают настройки git сами, а не берут их с машины.** Подпись с машины уводит
+  git в агент ключей, а заблокированный агент роняет набор: автор, почта и подпись идут флагами
+  `-c` в команде.
 
 - **Каждый коммит вклада ветки подписан машинной записью, и это проверяется набором пуша.** Гард
-  судит только коммит, назвавшийся ею; подписанный человеком проходит мимо, а там, где человек не
-  коммитит вовсе, это промах.
-- **Состояние заявки перечитывается у хостинга сразу после публикации, а не берётся из кода
-  возврата.** Открытие и постановка ревьювера отвечают нулём и тогда, когда не сделали ничего.
+  судит коммит, назвавшийся ею; подписанный человеком проходит мимо.
+- **Состояние заявки перечитывается у хостинга сразу после публикации.** Открытие и постановка
+  ревьювера отвечают нулём и тогда, когда не сделали ничего.
 - **Автор открытой заявки и наличие у неё ревьювера сверяются очередью работ.** До слияния оба
-  промаха не видны: заявка, открытая человеком, ревьювера не получит никогда, и выглядит это как
-  заявка, которой его просто не поставили.
-- **Ревьюверы спрашиваются вызовом REST, а не выборкой клиента.** Её поля собирает GraphQL, а он
-  требует прав, которых у машинной записи нет: «сошлось» не отличить от «спросить было нечем».
+  промаха не видны: открытая человеком заявка ревьювера не получит никогда.
+- **Ревьюверы спрашиваются вызовом REST, а не выборкой клиента.** Её поля собирает GraphQL, прав
+  на который у записи нет: «сошлось» неотличимо от «спросить было нечем».
 
-- **Рабочее дерево не опустошается ради прогона инструмента.** Сравнение с прежним состоянием
-  идёт на второй копии: прятанье уводит незакоммиченную работу туда, где её не видит ни состояние
-  дерева, ни сверка.
+- **Рабочее дерево не опустошается ради прогона инструмента.** Сравнение идёт на второй копии:
+  прятанье уводит незакоммиченную работу туда, где её не видит ни состояние дерева, ни сверка.
 
 ## Чего из закона здесь нет
 
@@ -269,3 +270,4 @@ flowchart TD
 - `git-workflow-merge` — главная ветка влита в ветку задачи, конфликт разобран.
 - `git-workflow-stack` — череда веток: ветвление от предыдущей, основание заявки, порядок отдачи.
 - `git-workflow-freshness` — свои открытые заявки: чтение всех разом, отставание против спора.
+- `git-workflow-pr-ready` — доведение отданного: снятый черновик, разбор красного, волна по череде.

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

@@ -159,12 +159,21 @@ flowchart TD
   только то, что импортировано тестом: ошибка типов в непокрытом коде доживает до сборки
   образа, то есть до слияния. Четыре слияния подряд так и уехали в главную ветку, ломая
   выкатку.
+- **На машине, где раннеров несколько, любой путь от домашнего каталога общий.** Умолчание
+  готового шага опасно именно тем, что оно общее: соседнее задание переписывает его под свою
+  версию, пока наше стоит между шагами. Каталог установки, имя контейнера и имя сборщика
+  называются поэтому по проекту и постоянно, а временный каталог решением не бывает — в нём
+  живёт хранилище пакетов.
 - **Набор гейта пуша не бывает уже набора конвейера.** Гейт — обещание, что пуш не приедет
   красным; набор, из которого выкинуты сборка и снимки, обещает то, чего не проверяет. Шаг
   конвейера, которому в наборе гейта нет ни строки, ни объявленного исключения с причиной,
   отбивает пуш, а не печатается рядом с ним: напечатанное предупреждение исполнитель читает как
   разрешение. Дважды подряд правка, прошедшая гейт целиком, была отбита конвейером — и оба раза
   зелёный гейт был прочитан как «локально всё зелено».
+- **Итоговый набор перед пушем читается разбором состояния, а не сборкой в уме.** Он собирается
+  из умолчания пакета и надстройки дерева, и прочитать сборку было нечем: раздел «набор перед
+  пушем» печатает его целиком, по команде на строку, а рядом называет то, что умолчание печатало,
+  а в набор не попало. Дерево, писавшее надстройку вслепую, дописывало в неё повтор.
 - **Причина исключения, называющая задачу, судится на живость этой задачи.** Отсрочка со сроком
   и отсрочка без срока выглядят одинаково, пока номер никто не спросил; мёртвый номер в причине
   делает исключение бессрочным, не сказав об этом ни строкой. Спрашивается тем же ярусом, что
@@ -186,6 +195,10 @@ flowchart TD
   сломана, она описывает вчерашний день. Сравнение веток пишется от `origin/main` целиком —
   смешав в одной команде удалённую ссылку для одной стороны и локальную для другой, промах
   изнутри выглядит правильным.
+- **Удалённую ссылку берут не только слова, но и действия.** Основание новой ветки, счёт влитого
+  и подтягивание главной судятся по ней же: локальная — снимок последнего подтягивания, и работа,
+  начатая от неё, стартует от основания, которого в главной уже нет. Влитая ветка при ней числится
+  невлитой, и уборка кончается списком невлитого, которого нет.
 - **Слияние по кнопке «Merge when pipeline succeeds» не заменяет проверок до пуша.** Конвейер
   видит только то, что уже отправлено, а отправленная красная ветка занимает очередь работ и
   выглядит готовой к разбору.

package/assets/rules/reuse-first.md

@@ -64,7 +64,16 @@ flowchart TD
 - **Панель правки записи наследует общую основу, а не собирается своей разметкой.** Тогда она
   открывается, закрывается и спрашивает про несохранённое одинаково во всех разделах.
 - **Об удаче и об отказе сообщает общая шина, а не своя разметка на экране.** Своё сообщение
-  расходится с соседним видом, местом и временем показа.
+  расходится с соседним видом, местом и временем показа. Готовое сообщение набора, поставленное
+  на экран, — та же своя разметка: правило говорит про место показа, а не про тег, и замена
+  своего абзаца на готовый компонент нарушения не снимает — она снимает признак.
+- **Инлайновое сообщение законно там, где панель правки записи остаётся открытой после отказа.**
+  Держит его основа панели; экран, список и публичная страница к этому месту не относятся.
+- **Маркер отступления ставится после чтения инвентаря готового, и прочитанное называется рядом.**
+  Объяснение при маркере называет компонент кита и то, чего в нём не хватает. Маркер без этого —
+  не отступление, а глушитель: он снимает признак, ничего не доказав.
+- **Проверка не снимается с гейта ради того, чтобы пуш прошёл.** Расхождение закрывается готовым
+  либо объявляется отступлением в самом коде; надстройка профиля для этого не средство.
 - **Компонент объявляется тремя файлами: `.ts`, `.html`, `.scss`.** `template:` и `styles:` в
   декораторе, атрибут `style=` и правка размеров через `[ngStyle]` — это стили, до которых не
   дотянется ни кит, ни `stylelint`.
@@ -107,13 +116,18 @@ flowchart TD
 Списком их здесь нет: признак — это данные, а не текст правила и не код проверки. Наборы лежат
 при пакете, по файлу на пакет rt-tools, и в каждом только то, что везёт он сам. Дерево называет
 нужные ему наборы ключом `reuse.bundles` в настройке проверок и дописывает свои признаки файлом,
-названным ключом `reuse.signals`; совпавший ключ замещает пакетный, новый дописывается. Гард на
+названным ключом `reuse.signals`; совпавший ключ замещает пакетный, новый дописывается. Там же
+дерево называет директивы своей дизайн-системы — ключом `reuse.kitDirectives`: нативный тег,
+несущий такую директиву, из признаков вырезается, потому что источник вида в дереве бывает не
+один. Гард на
 правке и сплошная проверка читают отсюда оба — разойтись им нечем.
 
 Что бывает признаком:
 
 - нативный контрол в шаблоне там, где кит везёт свой;
-- отказ, предупреждение или ожидание, собранные руками вместо готового;
+- отказ, предупреждение или ожидание, собранные руками вместо готового, — признак называет тег,
+  а решение принимается по месту показа: готовое сообщение на экране закрывает признак, не
+  закрывая нарушения;
 - наложение поверх страницы, объявленное своими стилями, — подложка, порядок слоёв, вращение;
 - раскладка, объявленная в файле стилей экрана, а не применённая директивами из общего слоя;
 - своя реализация того, что даёт основа кита, вместо наследования;

package/assets/rules/task-flow.md

@@ -115,56 +115,60 @@ flowchart TD
   правится.** Гард хода работы требует три вещи: папку задачи по имени ветки, замысел в ней и
   объявленное в ходе работы состояние. Договорённость о продукте требует свой гард на те же
   события.
-- **Гард судит объявленный переход, а не наличие файлов.** Пустой замысел, положенный ради
-  снятия отказа, лежит так же, как написанный, поэтому отказ снимает объявленное состояние —
-  `этап-идёт`, `этапы-кончились`, `разбор-кончился`. Четвёртый путь не состояние, а история
-  ветки: папка, разобранная её коммитом, означает отданную работу, и правка по замечаниям идёт
-  без замысла на диске.
+- **Гард судит объявленный переход, а не наличие файлов.** Пустой замысел лежит так же, как
+  написанный, поэтому отказ снимает объявленное состояние — `этап-идёт`, `этапы-кончились`,
+  `разбор-кончился`. Четвёртый путь не состояние, а история ветки: папка, разобранная её
+  коммитом, означает отданную работу, и правка по замечаниям идёт без замысла на диске.
 - **Строка состояния, переведённая вперёд, — то же объявление намерения, только машиночитаемое.**
-  Пустоты за ней не видно никому: состояние объявляется тем ходом, в котором его обязательное
-  действие начато делом, а не тем, в котором о нём отчитались.
-- **Отказ по состоянию называет обязательное действие объявленного состояния.**
-  Исполнитель, которому сказано только «не в том состоянии», перепишет строку состояния вместо
-  того, чтобы сделать шаг.
+  Состояние объявляется тем ходом, в котором его обязательное действие начато делом.
+- **Отказ по состоянию называет обязательное действие объявленного состояния.** Услышав только
+  «не в том состоянии», исполнитель перепишет строку состояния вместо шага.
 - **Именем состояния считается только слово из перечня.** Своё слово не говорит ни о входе, ни о
-  выходе, ни об обязательном действии, а перечень называет все три.
-- **Два требования — два гарда, и снять одно можно, не теряя второго.** Одним файлом отказ от
-  требования договорённости снимал заодно папку задачи — то, о чём дерево не просило. Судят
-  порознь: строка о неизменном поведении снимает договорённость, а не требование дойти до
-  правки кода.
+  выходе, ни об обязательном действии.
+- **Два требования — два гарда, и снять одно можно, не теряя второго.** Судят порознь: строка о
+  неизменном поведении снимает договорённость, а не требование дойти до правки кода.
 - **Влитая договорённость ветку не запирает.** После вливания директории «предложено» на диске
-  нет, а замысел на неё ссылается до конца работы: гард отличает влитое от незаведённого по
-  истории ветки. Иначе правкам по замечаниям не было бы дороги.
+  нет, а замысел ссылается на неё до конца работы: влитое от незаведённого гард отличает по
+  истории ветки.
 - **Договорённость требуется по путям правки, а не по оценке задачи.** `apps/**` и `libs/**` —
   признак; правила, тексты, обвязка и зависимости под него не подпадают. Обход — строка
   `**Поведение:** не меняется — <причина владельца>` в замысле; пустая причина не принимается.
 - **Что требует слова владельца, берётся списком, а не оценкой на месте.** Оценку «это безопасно»
-  назначает тот, кому она удобна, и меняется она с настроением разговора, а не со свойствами
-  команды. Недовольство владельца простоем разрешением не бывает.
+  назначает тот, кому она удобна. Недовольство владельца простоем разрешением не бывает.
+- **На команду владельца ответ начинается с результата, а не с намерения и не с его обоснования.**
+  Владелец, поставивший задачу, мнения о ней не запрашивал, и обоснование при уже принятом чужом
+  решении читается его оценкой: авторство переписывается на исполнителя. Исключение одно —
+  исполнение упёрлось в препятствие: тогда называется препятствие, а не отношение к задаче.
 - **Заход работу не начинает сам.** Начало требует слова владельца в этом же заходе: передача,
   состояние из хука запуска и назначенный эпик говорят, что делать, если работать, и молчат о
   том, работать ли. Судится это формой реплики, а не смыслом: правка кода после пустой реплики,
   одного слова или одного пути ход не заканчивает.
-- **Указание работать по ходу работы покрывает все его шаги, включая меняющие историю.** Отметка
-  этапа, пуш и заявка предписаны им самим: спрашивают о том, чего в нём нет.
+- **Указание работать по ходу работы покрывает все его шаги, включая меняющие историю.**
+  Спрашивают о том, чего в ходе работы нет.
 - **Вопрос, записанный прошлым заходом, вопросом владельца не становится.** Он адресован автору
   передачи, и часть таких вопросов закрыта шагом работы.
+- **Указание владельца действует до его отмены, и новый факт против него — строка в ответе о
+  цене, а не новый вопрос.** Переспрашивают то, чего указание не покрывает; обстоятельство,
+  меняющее цену указания, но не смысл, называется вслух, и работа идёт дальше. Меню, где два
+  варианта из трёх предлагают отменить решение владельца, и есть такая отмена. Правило о развилке
+  говорит, КАК задавать вопрос, и молчит о том, задавать ли его вовсе.
+- **Ответ, данный репликой владельца, записан наравне с ответом в документе.** Вопрос, на который
+  в разговоре уже отвечали, второй раз не задают.
 - **Слово владельца об устройстве — постановка, а не решение.** Названное им обычно уже живёт в
-  дереве под этим самым словом: у него есть имя на экране, раздел в спеке и поле в модели. Прежде
-  чем строить, слово сверяется с ними, а разошлось прочтение с деревом — спрашивается владелец, до
-  правки: истолкованное по ближайшему коду, оно выглядит исполненной просьбой ровно до приёмки.
+  дереве под этим самым словом — именем на экране, разделом спека, полем модели, — и сверяется с
+  ними до правки. Разошлось прочтение — спрашивается владелец: истолкованное по ближайшему коду
+  выглядит исполненной просьбой ровно до приёмки.
 - **Папка задачи заводится под любую работу, без исключений.** Исключение, у которого есть хоть
-  одна законная форма, исполняется как разрешение. Заводится она до первой правки: сколько
-  заходов уйдёт на работу, заранее не знает никто.
+  одна законная форма, исполняется как разрешение. Заводится она до первой правки.
 - **Папка задачи едет в ветку коммитом, а не живёт в одном рабочем дереве.** Незакоммиченная,
-  она проходит все правки без отказа, а признак отданной работы берётся из истории: отказ придёт
-  в последней точке, когда замысел уже снят. Вне истории законен один черновик без номера.
+  она проходит все правки без отказа, а отказ приходит в последней точке, когда замысел уже снят:
+  признак отданной работы берётся из истории. Вне истории законен один черновик без номера.
 - **Папка задачи разбирается последним коммитом до открытия PR, а не после одобрения.** Человек
   вливает, как только видит зелёное, и закрывающему коммиту места не остаётся вовсе. Цена:
   замысла с этой минуты на диске нет, и признак отданной работы гард берёт из истории ветки.
-- **Открыв PR, исполнитель называет владельцу три вещи: номер, чего ждёт и что сделает следом.**
-  Ждёт он прогона, следом идёт снятие черновика. Зелёный прогон говорит, что не сломано, и молчит
-  о заблокированной у черновика кнопке слияния.
+- **Открыв PR, исполнитель называет владельцу номер, чего ждёт и что сделает следом.** Ждёт он
+  прогона, следом снимает черновик: зелёный прогон говорит, что не сломано, и молчит о
+  заблокированной у черновика кнопке слияния.
 - **Просьба о слиянии — отдельный ход, и раньше зелёного прогона её не бывает.** Порядок один:
   папка разобрана и запушена → PR открыт черновиком → прогон зелёный → черновик снят →
   исполнитель просит влить, называя номер.
@@ -174,66 +178,60 @@ flowchart TD
 - **Гард замысла — нижняя граница требования, а не его предел.** Он требует папку только под
   правку кода приложения, а статья выше — под любую работу. Прочитанный как признак, он
   становится разрешением работать без замысла везде, куда не смотрит.
-- **Указание работать по правилу — это указание делать его шаги, включая те, что меняют
-  историю.** Отметка сделанного этапа, коммит, пуш и открытие заявки правилом предписаны, и
-  отдельного слова владельца на каждый из них не требуется: спросить надо о том, чего в правиле
-  нет. Ход, который довёл работу до готовности и встал перед коммитом, работу не отдал, а спрятал.
-- **Взятая задача ходом не кончается.** Заведение задачи, ветки, колонки и папки — подготовка, а
-  не работа: они переводят её в состояние записанного замысла, где обязательное действие уже
-  другое. Держит это страж выхода хода, называя в отказе первый этап замысла.
-- **Ожидание одной части этапа остановкой этапа не бывает.** Части, которые от ожидаемого не
-  зависят, делаются тем же ходом, а владельцу называется, что сделано и что осталось на его шаг.
-  Отбитая гардом команда и отклонённый вызов читаются так же: сперва делается всё, что мимо них.
+- **Указание работать по правилу — это указание делать его шаги, включая меняющие историю.**
+  Отметка этапа, коммит, пуш и открытие заявки правилом предписаны: спросить надо о том, чего в
+  нём нет. Ход, доведший работу до готовности и вставший перед коммитом, её не отдал, а спрятал.
+- **Взятая задача ходом не кончается.** Заведение задачи, ветки, колонки и папки — подготовка:
+  она переводит работу в состояние записанного замысла, где действие уже другое. Держит это страж
+  выхода хода, называя в отказе первый этап.
+- **Ожидание одной части этапа остановкой этапа не бывает.** Независимые от ожидаемого части
+  делаются тем же ходом, а владельцу называется, что сделано и что осталось на его шаг. Отбитая
+  команда читается так же: сперва делается всё, что мимо неё.
 - **Сделанное отмечается только в ходе работы.** «Где стоим» перезаписывается каждым заходом, а
   не дописывается: это первое, что читает следующий заход.
 - **Слово для нового понятия ищется в словаре дерева.** Общую часть везёт пакет, предметную
   дописывает дерево надстройкой; словарь уезжает в контекст на запуске сессии целиком, поэтому
   «не читал» основанием не бывает.
 - **Папка задачи заводится черновиком и получает номер командой.** До конца разбора неизвестно,
-  сколько задач из него выйдет, поэтому номер не может быть первым. Команда заведения
-  переименовывает черновик, проставляет шапку замысла и собирает папку с образца, снимая с копий
-  шапку раскладки.
+  сколько задач из него выйдет, поэтому номер не бывает первым. Команда переименовывает черновик,
+  проставляет шапку замысла и снимает с копий шапку раскладки.
 - **Брошенный разбор виден.** Черновик старше недели перечисляет сверка очереди.
 - **Следующая задача берётся из замысла эпика, а список очереди работ спрашивается только там, где
   эпика нет.** По списку номеров первая задача чужого эпика неотличима от своей. Кончившийся эпик
   называется владельцу тем же ходом, которым берётся работа вне его.
-- **Эпик не закрывается по признаку, подтверждённому только чтением.** Признак, проверяемый
-  глазами, называется проверенным лишь вместе с командой или замером и их выводом.
+- **Эпик не закрывается по признаку, подтверждённому только чтением.** Проверяемое глазами
+  называется проверенным лишь вместе с командой и её выводом.
 - **Задачи эпика заводятся все разом, тем же ходом, что и сам эпик.** Заведение по одной прячет
   объём. Номера возвращаются в раздел порядка той же правкой: без них «взять следующую» отвечает
   названием, а не карточкой.
 
 - **Замысел эпика лежит там, где его найдут без сети и после мержа.** Карточка порядка задач не
-  держит, а папка задачи держала бы его до слияния первой из них; каталог называет компаньон
-  правила. Имя, адрес и способ, названные владельцем по ходу, дописываются туда же тем ходом,
-  каким приняты.
+  держит, а папка задачи держала бы его до слияния первой; каталог называет компаньон правила.
+  Названное владельцем по ходу дописывается туда же тем ходом, каким принято.
 - **Сборка по образцу начинается с чтения самого образца, а не пересказа о нём.** Пересказ лежит
   в разборе просьбы и в замысле эпика; образцом они не считаются. Повторяемая часть открывается
   целиком — обходом каталогов, а не одним файлом, за которым пришли.
 - **Что действует на дерево, а не на правку, лежит вне индекса.** Путь к образцу и разрешение
-  работать вне эпика ветке не принадлежат: записанные файлом репозитория, они в ней и остаются,
-  а следующая, отведённая от главной, их не несёт. Место записи — рядом с передачей захода.
+  работать вне эпика ветке не принадлежат и живут рядом с передачей захода.
 - **Закрытая работа разбирается правилами, и это шаг закрытия, а не отдельная просьба.** Что
-  грузилось, что помогло и чего не хватило, видно только тому заходу, который работу вёл. Разбор
-  кончается правкой слоя правил или предложением наружу; ведёт его роль разбора закрытой задачи,
-  если дерево её разложило.
+  грузилось и чего не хватило, видно только заходу, который работу вёл. Разбор кончается правкой
+  слоя правил или предложением наружу.
 - **Разбор закрытой работы уходит в фон, а исполнитель берёт следующую задачу.** Роль работает
-  своим ходом и ничего не спрашивает. Сводку собирают до запуска, вернувшиеся находки принимают
-  одним ходом.
+  своим ходом; сводку собирают до запуска, находки принимают одним ходом.
 - **Находки разбора ждут владельца, а в пакет уезжает только сводка наблюдений.** Предложение —
   заготовка правки чужого дерева, и уехавшая без разбора, она становится работой того, кто её не
   заказывал. Сводка уезжает всегда: она говорит, чем пользовались, и мнением не бывает.
-- **Дешёвый шаг закрытия идёт раньше дорогого, а прогон — после вливания.** Вливание договорённости
-  и приведение текстов стоят минуты, прогон — окно захода. Идущий после вливания, он проверяет и его
-  самого: идущий до, он смотрит то, что в главную не поедет.
+- **Дешёвый шаг закрытия идёт раньше дорогого, а прогон — после вливания.** Вливание
+  договорённости и приведение текстов стоят минуты, прогон — окно захода; идущий до вливания, он
+  смотрит то, что в главную не поедет.
 - **Договорённость вливается в спек домена одним из последних коммитов ветки, до открытия PR.**
   К этому моменту код написан, привязки известны, и в главной ветке директория `proposed/` не
   появляется вовсе. Готовые к вливанию перечисляет `npm run check:specs`.
 - **Папка закрытой задачи разбирается, а не переносится целиком.** В `docs/archive/` уезжает то, что
   объясняет решение; остальное удаляется. Неразобранную ловит сверка очереди.
 - **Открытие PR и снятие черновика отбиваются, пока ветка везёт папку своей задачи.** Слияние
-  нажимает человек на хостинге, где гардов нет: снятый черновик он читает как приглашение влить и
-  кнопку нажимает, не дожидаясь коммита уборки. Судится содержимое ветки, а не рабочее дерево.
+  нажимает человек на хостинге, где гардов нет: снятый черновик он читает приглашением влить.
+  Судится содержимое ветки, а не рабочее дерево.
 - **Ветка, снёсшая папку, обязана прибавить запись в архив.** Снести дешевле, чем разобрать, а
   первым уходит разбор просьбы — единственная запись слов владельца.
 - **Обход — строка `Task-folder-skip: <причина>` в PR или в самой команде.** Пустая причина обходом
@@ -253,8 +251,9 @@ flowchart TD
 видит правку файла и не знает ни о разведке до первого вопроса, ни о шести обязательных, ни об
 ответах на них — пустая таблица проходит так же, как заполненная.
 
-Гард разговора судит завершение хода, а не отправку вопроса: к моменту отказа вопрос уже у
-владельца. Отсюда порядок — правило читается первым движением захода, а не по отказу гарда.
+Понимания текста у гарда разговора нет: второй его признак судит общие слова темы вопроса и
+последней реплики владельца, а не смысл — вопрос о другом предмете, названный прежними словами,
+он отобьёт. Отказ называет законный ход: назвать то, чего в прежнем ответе владельца нет.
 
 Неизменность замысла не стережёт ничто: правка по ходу отличима от первоначальной записи только
 по истории.

package/assets/skills/agent-kit.md

@@ -228,17 +228,17 @@ npx agent-kit adopt [файлы] # отдать пакету свой файл,
 
 ## Установка туда, где уже всё своё
 
-1. `init`, затем `skip` на всё, что дерево держит само. Пустая раскладка — законное начало.
-2. Снимок того, что говорят проверки дерева, до единой правки. Он и есть мерило.
+1. `init`, затем `skip` на всё, что дерево держит само; пустая раскладка — законное начало.
+2. Снимок того, что говорят проверки дерева, до единой правки: он и есть мерило.
 3. Ресурс за ресурсом: пакетную редакцию довести до здешней, предметность вынести в
    надстройку, снять отказ, разложить, прогнать сценарии и сверить снимок.
 4. Разложенное поверх своего пакет не пишет: файл без шапки для него чужой. Отдаётся он
-   командой `adopt` — прежнее содержимое ложится рядом с пометкой `.before-rt-kit`, и снять его
-   потом решает владелец.
-5. Свои сценарии отданного файла переписываются под пакетное поведение либо снимаются. Чинить
-   пакетную редакцию на месте нельзя: правка разложенной копии живёт до следующей раскладки, а
-   её адрес — источник пакета или надстройка дерева. Сценарий, ждущий поведения снятого файла,
-   краснеет и после верной отдачи: он проверяет то, чего в дереве больше нет.
+   командой `adopt` — прежнее содержимое ложится рядом с пометкой `.before-rt-kit`.
+5. Ресурс, у которого здешняя редакция богаче пакетной по существу, в раскладку не берётся.
+   Признак — статья, которой в пакетной редакции нет и не может быть: она выводится из предмета
+   дерева. Он уходит в `skip`, а наверх едет предложение снять его из пакета.
+6. Свои сценарии отданного файла переписываются под пакетное поведение либо снимаются: чинить
+   пакетную редакцию на месте нельзя, её адрес — источник пакета или надстройка.
 
 ## Свойства дерева
 
@@ -272,6 +272,10 @@ npx agent-kit adopt [файлы] # отдать пакету свой файл,
 
 ## Ловушки раскладки
 
+- **Словарь — такой же разложенный ресурс, как правило.** Хук запуска кладёт его в контекст
+  целиком, до первой реплики, и оттого он выглядит обычным документом дерева; шапка у него есть,
+  но читается служебной строкой. Новое слово идёт в надстройку словаря, своим разделом.
+
 - **Запись файла командой оболочки судится по всем путям, названным в её теле.** Гейт вынимает
   пути из текста команды, а тело документа читает целиком, как только в команде встречается имя
   интерпретатора, — и строка запуска первой строкой записываемого файла возвращает его туда сама.
@@ -281,18 +285,14 @@ npx agent-kit adopt [файлы] # отдать пакету свой файл,
   оболочки остаётся для того, что файлом дерева не станет.
 - **Своё, стоящее рядом с разложенным, повторяет его механику молча.** Проверка, гард и утилита
   дерева лежат в тех же каталогах, что и пакетные, а общий разбор списка известного, корни
-  исходников, список пропускаемых каталогов и снимок долга приезжают модулем настройки проверок.
-  Второе такое же заводится в своей проверке без единого сигнала: имена разные, форма разная, и
-  повтора не видит ни сверка раскладки — файл не разложен, — ни проверка повторов, которая ищет
-  совпадение текста. Признак один, и он читается, а не ищется: до того как в своей проверке
+  исходников и снимок долга приезжают модулем настройки проверок. Второе такое же заводится без
+  сигнала: повтора не видит ни сверка раскладки — файл не разложен, — ни проверка повторов,
+  которая ищет совпадение текста. Признак один, и он читается: до того как в своей проверке
   заводится разбор списка, чтение настройки или сравнение с накопленным, смотрят, что
-  экспортирует модуль настройки проверок и чем живут соседние проверки.
+  экспортирует модуль настройки проверок.
 - **Правило, загруженное инструментом, бывает показано не целиком, и обрыв ничем не помечен.**
   Длинный файл приезжает в контекст обрезанным по строке, а снаружи это выглядит концом: показанное
-  кончается осмысленным пунктом, и число разделов с оглавлением никто не сверяет. Бьёт обрыв ровно
-  по хвосту, а хвост — то место, где дерево отменяет умолчания пакета: разделы надстройки сливаются
-  по совпавшему заголовку и новыми уходят в конец. Заход, читавший правило до конца по своему
-  ощущению, исполнил пакетный образец буквально и открыл заявку черновиком там, где дерево
-  черновиков не держит вовсе. Отсюда порядок: решение о порядке работы принимается только после
-  того, как показанные строки сверены с длиной файла — одной командой, — а расходятся они, файл
-  дочитывается чтением.
+  кончается осмысленным пунктом. Бьёт обрыв ровно по хвосту, а хвост — то место, где дерево
+  отменяет умолчания пакета: разделы надстройки сливаются по совпавшему заголовку и новыми уходят
+  в конец. Отсюда порядок: решение о порядке работы принимается после того, как показанные строки
+  сверены с длиной файла одной командой, а расходятся они — файл дочитывается чтением.

package/lib/commands.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"commands.d.ts","sourceRoot":"","sources":["../../../projects/agent-kit/src/lib/commands.ts"],"names":[],"mappings":"AAeA,OAAO,EAAE,WAAW,EAAE,MAAM,gBAAgB,CAAC;AAsB7C,MAAM,WAAW,iBAAiB;IAC9B,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,KAAK,EAAE,SAAS,MAAM,EAAE,CAAC;CACrC;AAED,2FAA2F;AAC3F,MAAM,WAAW,YAAY;IACzB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B;;;;OAIG;IACH,QAAQ,CAAC,KAAK,CAAC,EAAE,WAAW,GAAG,IAAI,CAAC;IACpC;;;OAGG;IACH,QAAQ,CAAC,IAAI,CAAC,EAAE,MAAM,CAAC;CAC1B;AA2DD,+DAA+D;AAC/D,eAAO,MAAM,WAAW,EAAE,MAAyB,CAAC;AA0ZpD;;;;GAIG;AACH,wBAAgB,IAAI,CAChB,IAAI,EAAE,MAAM,EACZ,IAAI,GAAE,SAAS,MAAM,EAAO,EAC5B,QAAQ,GAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAM,EAC/C,SAAS,GAAE,MAAW,GACvB,iBAAiB,CAgCnB;AAmKD,wBAAgB,IAAI,CAAC,GAAG,EAAE,YAAY,EAAE,KAAK,EAAE,OAAO,GAAG,iBAAiB,CA8DzE;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,KAAK,CAAC,GAAG,EAAE,YAAY,EAAE,KAAK,EAAE,SAAS,MAAM,EAAE,GAAG,iBAAiB,CA+CpF;AAQD,0EAA0E;AAC1E,MAAM,WAAW,aAAa;IAC1B,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,8FAA8F;IAC9F,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,IAAI,EAAE,OAAO,CAAC;CAC1B;AA8JD;;;;;;GAMG;AACH,wBAAgB,KAAK,CAAC,GAAG,EAAE,YAAY,EAAE,OAAO,EAAE,aAAa,GAAG,iBAAiB,CA6DlF;AA0BD,wBAAgB,MAAM,CAAC,GAAG,EAAE,YAAY,GAAG,iBAAiB,CA6E3D;AAED;;;;;GAKG;AACH,wBAAgB,IAAI,CAAC,GAAG,EAAE,YAAY,GAAG,iBAAiB,CA2DzD"}
+{"version":3,"file":"commands.d.ts","sourceRoot":"","sources":["../../../projects/agent-kit/src/lib/commands.ts"],"names":[],"mappings":"AAeA,OAAO,EAAE,WAAW,EAAE,MAAM,gBAAgB,CAAC;AAuB7C,MAAM,WAAW,iBAAiB;IAC9B,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,KAAK,EAAE,SAAS,MAAM,EAAE,CAAC;CACrC;AAED,2FAA2F;AAC3F,MAAM,WAAW,YAAY;IACzB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B;;;;OAIG;IACH,QAAQ,CAAC,KAAK,CAAC,EAAE,WAAW,GAAG,IAAI,CAAC;IACpC;;;OAGG;IACH,QAAQ,CAAC,IAAI,CAAC,EAAE,MAAM,CAAC;CAC1B;AA2DD,+DAA+D;AAC/D,eAAO,MAAM,WAAW,EAAE,MAAyB,CAAC;AA0ZpD;;;;GAIG;AACH,wBAAgB,IAAI,CAChB,IAAI,EAAE,MAAM,EACZ,IAAI,GAAE,SAAS,MAAM,EAAO,EAC5B,QAAQ,GAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAM,EAC/C,SAAS,GAAE,MAAW,GACvB,iBAAiB,CAgCnB;AAmKD,wBAAgB,IAAI,CAAC,GAAG,EAAE,YAAY,EAAE,KAAK,EAAE,OAAO,GAAG,iBAAiB,CA8DzE;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,KAAK,CAAC,GAAG,EAAE,YAAY,EAAE,KAAK,EAAE,SAAS,MAAM,EAAE,GAAG,iBAAiB,CA+CpF;AAQD,0EAA0E;AAC1E,MAAM,WAAW,aAAa;IAC1B,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,8FAA8F;IAC9F,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,IAAI,EAAE,OAAO,CAAC;CAC1B;AA8JD;;;;;;GAMG;AACH,wBAAgB,KAAK,CAAC,GAAG,EAAE,YAAY,EAAE,OAAO,EAAE,aAAa,GAAG,iBAAiB,CA6DlF;AA0BD,wBAAgB,MAAM,CAAC,GAAG,EAAE,YAAY,GAAG,iBAAiB,CAkF3D;AAED;;;;;GAKG;AACH,wBAAgB,IAAI,CAAC,GAAG,EAAE,YAAY,GAAG,iBAAiB,CA2DzD"}