@rt-tools/agent-kit 0.20.0 → 0.22.0

package/assets/pitfalls/spec-driven.md

@@ -58,6 +58,26 @@
     и число это падает по мере того, как их читают. Счёт при этом грубый: строка, показанная
     образцом внутри ограды, считается наравне с настоящей — тот, кто учит её писать, попадает
     в число объявивших.
+- **Закон, которого не назвало ни одно правило, не судит никто, и виден он только счётом.**
+  Статья правила без адреса отбивает сверку спеков — привязка у неё требуется. У статьи закона
+  адреса нет по устройству: закон говорит, что должно быть верно, и на код не показывает. Ловить
+  это отказом нельзя — закон, которому в этом дереве нечего исполнять, законное состояние, — а
+  незамеченным он живёт сколько угодно: две статьи так и легли молча, пока две соседние статьи
+  правила отбивали сверку требованием адреса. Судят поэтому два числа рядом: сколько законов в
+  каталоге и какие из них ни одно правило не назвало.
+
+    ```bash
+    ls <каталог законов>/*.md | wc -l
+    for law in <каталог законов>/*.md; do
+        grep -rqlF "constitution/$(basename "$law")" <каталог правил>/*/SKILL.md || echo "$law"
+    done
+    ```
+
+    Названный список читается глазами: у закона, который дереву нечего исполнять, это законное
+    состояние, а у остальных — забытая половина работы. Счёт грубый и здесь: закон, названный
+    правилом в одной строке и не разобранный ни одной его статьёй, в список не попадает —
+    связь статьи с правилом держится текстом, а не ключом.
+
 - **Привязка пишется по тексту статьи, а не по смыслу имени гарда.** Гард, чьё имя звучит про то
   же самое, статью не закрывает: статья перечисляла шесть действий по отдельному слову владельца
   — коммит, пуш, открытие заявки, запись в вики, заведение задачи, правка закона, — а

package/assets/pitfalls/task-flow.md

@@ -7,6 +7,12 @@
 
 ## Ловушки
 
+- **Задача, отобранная в эпик по своему телу, бывает закрыта до начала работы.** Между заведением
+  задачи и её взятием проходят недели, и всё это время дерево правится соседними работами: у двух
+  задач одного эпика по три части из четырёх оказались сделанными — тело описывало дерево
+  месячной давности. Отбор поэтому начинается с чтения кода, а разбор просьбы называет, что из
+  тела задачи в дереве ещё верно.
+
 - **Разрешение владельца, оставленное в репозитории, теряется на каждой новой ветке.** Оно
   записано номером в файл ветки, а следующая ветка отводится от главной и его не несёт: гард
   отбивает работу, которую владелец разрешил, — и повторяется это ровно столько раз, сколько
@@ -31,13 +37,13 @@
   договорённость обязана его пережить: её сценарии получают номера в общей нумерации домена,
   и на них ссылаются заголовки тестов. Обратное тоже верно — ход работы не кладётся в
   `proposed/`: спек, в котором завелись шаги, снова становится планом и умирает после мержа.
-- **У меню нет строки «вопрос не тот».** Меню годится для выбора значения из закрытого набора;
+- **У меню нет строки «вопрос не тот».** Меню годится там, где выбор действительно закрыт;
   пока постановка вопроса не подтверждена, отвергнуть её владельцу нечем — он выбирает из
-  вариантов, выведенных из неверной посылки. Настройки владельца, требующие меню, требование
-  не снимают: тогда к каждому вопросу добавляется свободный вариант, и он же — единственное
-  место, где вопрос отвергается целиком. Три вопроса ушли одним меню, у одного постановка была
-  ложной, и сказать «вопрос не тот» было нечем. Выбор слова, имени и термина узким вопросом не
-  является никогда.
+  вариантов неверной посылки, и выйти из набора может только руками. Настройки владельца,
+  требующие меню, требование не снимают: тогда к каждому вопросу добавляется свободный вариант,
+  и он же — единственное место, где вопрос отвергается целиком. Три вопроса ушли одним меню, у
+  одного постановка была ложной. Там, где под сомнением сама уместность вопроса, его сперва
+  проверяют по репликам владельца — и чаще всего не задают.
 - **Субагент вопросов владельцу не задаёт.** Ни роли, ни конвейер до него не достучатся —
   они возвращают текст главному агенту. Поэтому разбор ведёт главный агент, а роли стоят по
   обе стороны от него.
@@ -48,20 +54,17 @@
   Спрашивают до правки, а не показывают замер после.
 - **Путь, предложенный человеку, судится числом его шагов и тем, чем ему для этого надо
   владеть.** Со стороны кода вариант выглядит дешёвым — «меньше путей», «строку запуска не
-  трогаем», — а человеку он стоит захода на сервер. Однажды рекомендуемым вариантом так стояла
-  выдача токена, за которой владельцу надо было идти по ssh в работающий контейнер; отбивал
-  этот вариант он сам. Цена называется со стороны того, кто пойдёт: сколько шагов и что ему для
-  них нужно. Пересказ действующего порядка без такой оценки владелец читает как одобрение.
+  трогаем», — а человеку он стоит захода на сервер: рекомендуемым так стояла выдача токена, за
+  которой владельцу надо было идти по ssh в работающий контейнер. Цена называется со стороны
+  того, кто пойдёт; пересказ порядка без неё владелец читает как одобрение.
 - **Эпик по теме читается до того, как решается раскладка.** Замысел эпика держит решения,
   которые пережили десяток задач, и разведка по коду их не находит: снятое решение следа в
   дереве не оставляет. Домен, заведённый генератором и снесённый через полчаса, стоял в замысле
   прямым запретом — но замысел открыли уже после того, как он был заведён во второй раз.
 - **Работа, которая разбирает чужую папку задачи, разбирает и свою — одним коммитом.** Свою
-  папку она заводит наравне со всеми: исключения из этого требования нет. Круг, которым
-  исключение оправдывали, закрывается не отказом от папки, а порядком разбора: последний
-  коммит снимает обе, и после работы неубранного не остаётся. Однажды такой разбор оставил
-  свою папку, и на неё пришлось заводить третью задачу — лечится это порядком, а не правом
-  работать без замысла на диске. Как разобрать две папки — паттерн `task-flow-archive`.
+  папку она заводит наравне со всеми, и круг, которым исключение оправдывали, закрывается
+  порядком разбора: последний коммит снимает обе. Однажды такой разбор оставил свою папку, и на
+  неё пришлось заводить третью задачу. Как разобрать две папки — паттерн `task-flow-archive`.
 - **Слово для нового понятия берётся из `docs/GLOSSARY.md` или заводится там же.** Третий файл
   папки задачи называется `progress.md`, а не `journal.md`, ровно поэтому: журнал в этом
   дереве один, и он другой.
@@ -81,13 +84,42 @@
   задание, он даёт заходу работу, которой владелец не просил. То же с любой репликой без
   глагола: спросить, что с этим делать, дешевле, чем написать полсотни файлов мимо просьбы.
 
+- **Признак готовности этапа пишется о своей половине вывода, а не обо всём выводе.** Проверка
+  считает всё дерево, а этап правит его часть: «вывод без единой строки долга» не сходится не
+  потому, что этап не сделан, а потому, что три строки принадлежат невлитой соседней ветке.
+  Признак называет свои строки и своё число, а сказанное обо всём выводе держится до первого
+  соседа.
+
+- **Копия образца папки задачи несёт шапку раскладки, и первая же правка отбивается гардом.**
+  Образец разложен пакетом наравне с остальным разложенным, а гард места правки судит по шапке:
+  копия под задачу выглядит разложенным файлом, и отказ называет адрес источника пакета — то
+  есть уводит править образец вместо своей копии. Команда заведения задачи шапку снимает сама,
+  копирование руками — нет. Правится такая копия только записью заново: правку по месту гард
+  отбивает и её.
+- **Имя проекта в признаке готовности этапа спрашивается у сборщика, а не пишется по памяти.**
+  На неизвестное имя сборщик отвечает «задач не запущено» и выходит нулём: команда признака не
+  прогнала ни одной пробы и промолчала так же, как зелёный прогон. Видно это только по числу
+  прогнанных задач, а его никто не читает.
+
+- **Этап, закрытый без пуша, гоняет проверки гейта своим последним движением.** Признак этапа
+  зовёт свои команды и общих не знает, а гейт краснеет только на отправке: ветка без пушей копит
+  красное до первой из них, и промах уезжает на два этапа от места, где его сделали.
+
+- **У признака закрытия спрашивают, может ли исполнитель подтвердить его сам.** Признак,
+  требующий человека — пароля, кнопки в чужой панели, взгляда владельца, — останавливает работу
+  на последнем шаге: сделано всё, а сказать «закрыто» нечем. Спрашивается это при разборе
+  просьбы.
+
+- **Признак закрытия проверяет исход у той стороны, которая его хранит, а не ответ вызова.**
+  Вызов отвечает о себе: ушёл, принят, код нулевой — и всё это верно при том, что записанного
+  нет. Восемь задач подряд считали отметку работающей по ответу команды, а она не двигала
+  ничего.
+
 - **Своё временное кладётся вне дерева кода — иначе его снятие судится как правка приложения.**
-  Признак записи, которым гарды судят команду оболочки, считает записью и удаление, и это в нём
-  нарочно: снятое без замысла не оставляет следа вовсе. Отличить свой временный каталог от
-  каталога домена признаку нечем — путь у обоих под тем же корнем, — поэтому гард требует
-  замысла на диске за уборку черновика, к приложению не относящуюся. Каталог для своего
-  временного называет профиль дерева, и лежит он вне дерева кода; положенный внутрь, он платит
-  этим отказом при каждой уборке.
+  Признак записи считает записью и удаление, и это в нём нарочно: снятое без замысла не
+  оставляет следа. Отличить свой временный каталог от каталога домена признаку нечем — путь у
+  обоих под тем же корнем, — и гард требует замысла за уборку черновика. Каталог называет
+  профиль дерева, и лежит он вне дерева кода.
 
 - **Тело задачи, написанное вперёд замысла, называет способ, и способ стареет раньше дефекта.**
   Задача серии заводится за недели до того, как её берут, и к этому дню предложенный ход бывает
@@ -124,10 +156,15 @@
   подряд не пересилили одну строку на диске. Снимается она тем же ходом, которым владелец
   ответил, — а не тем, в котором о ней вспомнили.
 
-- **У меню с закрытым набором нет строки «вопрос не тот».** Вариантами вопрос выглядит
-  разобранным, и владельцу, чтобы отвергнуть саму постановку, приходится выходить из набора
-  руками. Спрашивают меню то, где выбор действительно закрыт; там, где под сомнением сама
-  уместность вопроса, его сперва проверяют по репликам владельца — и чаще всего не задают.
+- **Очередь работ эпиком не кончается.** Занятый другими исполнителями или законченный эпик
+  означает следующую задачу из очереди, а не остановку: «свободных задач эпика нет» ответом на
+  «чем заняться» не бывает, потому что отвечает на этот вопрос не эпик, а очередь. Спрашивается
+  она командой, а не вспоминается по передаче: утверждение переданного текста описывает то
+  дерево и тот день, в котором его писали.
+- **Шаг закрытия работы за взятие следующей задачи не считается.** Перевод закрываемой задачи в
+  колонку разбора и снятие её папки — обязательные шаги закрытия, и оба случаются тем же ходом,
+  которым открывается заявка. Ход, в котором больше ничего нет, работу не двигает, сколько бы
+  команд в нём ни стояло.
 
 ## Поведение исполнителя — по разборам происшествий
 
@@ -183,34 +220,27 @@
   Отказ при этом уводит править образец пакета вместо копии под задачу.
 - **Правка по замечаниям идёт без замысла на диске.** Папка разобрана коммитом ветки раньше
   открытия заявки, и состояния у работы с этой минуты нет: судит её история ветки.
-- **Прогон, поставленный раньше дешёвых шагов, съел окно захода.** Потративший его на прогон
-  упирался в порог заполнения на четырёх строках привязки — то есть на работе минут на пять.
-- **Граница состояния выглядит законченным куском лучше всякой вехи.** Владельцу отчёт о взятой
-  задаче неотличим от остановки: названы номер, ветка и колонка, и всё названное правда.
+- **Граница состояния выглядит законченным куском лучше всякой вехи.** Отчёт о взятой задаче
+  владельцу неотличим от остановки: номер, ветка и колонка названы, и всё названное правда.
 - **Заявка на чужом языке.** В дереве, где заявки пишутся на другом языке, чужой заголовок
   дважды уехал на хостинг, и оба раза до него добрались глазами.
-- **Вопрос, утонувший в отчёте.** Владелец трижды переспрашивал, почему работа стоит, и каждый
-  круг стоил захода обоим.
-- **Чужой эпик в списке очереди.** Дважды подряд следующей была взята первая задача чужого
-  эпика — по списку она выглядела ровно как своя.
+- **Вопрос, утонувший в отчёте.** Владелец трижды переспрашивал, почему работа стоит.
+- **Чужой эпик в списке очереди.** Дважды подряд следующей брали первую задачу чужого эпика:
+  по списку она выглядит своей.
 
 - **Некоммиченная папка задачи отказывает там, где чинить уже нечего.** Гард спрашивает её с
-  диска, поэтому все правки проходят без единого отказа, а признак отданной работы берётся из
-  истории ветки. Отказ приходит на открытии заявки — в минуту, когда папка разобрана своими
-  руками: замысел снят, и собирать его приходится заново по памяти. Владелец при этом всю
-  работу видит ветку без единого следа того, что в ней делается, а следующий заход находит
-  пустоту вместо «Где стоим».
+  диска, поэтому все правки проходят без отказа, а признак отданной работы берётся из истории
+  ветки. Отказ приходит на открытии заявки — когда папка разобрана своими руками: замысел снят,
+  и собирать его приходится по памяти. Владелец при этом всю работу видит ветку без следа того,
+  что в ней делается.
 - **Прогон, поставленный первым шагом закрытия, съедает окно захода.** Он стоит дороже всех
-  остальных шагов вместе, и потративший его на прогон упирался в порог заполнения на четырёх
-  строках привязки — то есть на работе, которая стоила бы минуты, если бы шла первой.
+  остальных шагов вместе: потративший его упирался в порог заполнения на четырёх строках
+  привязки — на работе, которая шла бы минуту, будь она первой.
 - **Разрешение работать вне назначенного эпика принадлежит рабочему дереву, а не ветке.**
   Записанное в файл репозитория, оно уезжает вместе с веткой: из соседней его не видно, и гард
-  эпика отбивает ровно ту работу, которую владелец разрешил. За один заход это случилось дважды
-  — сперва на отказе конца хода, потом на переводе колонки, и оба раза номер дописывался заново.
-  Место такому разрешению там же, где передача захода: оно не откатывается вместе с правкой и не
-  принадлежит ни одной задаче.
+  эпика отбивает ровно ту работу, которую владелец разрешил — за один заход дважды. Место ему
+  там же, где передача захода: оно не откатывается с правкой и не принадлежит ни одной задаче.
 - **Задача, вынесенная в другой эпик, снимается из состава прежнего тем же ходом.** Вынос — два
-  движения, и сделанное наполовину оставляет задачу в двух составах сразу: итог прежнего эпика
-  считается по числу, которого в нём уже нет, и эпик выглядит незакрытым при всех сделанных
-  работах. Итог вписывается там же, где правится состав: отложенный, он пишется по памяти о том,
-  сколько задач было, а не о том, сколько осталось.
+  движения, и сделанное наполовину оставляет задачу в двух составах сразу: эпик выглядит
+  незакрытым при всех сделанных работах. Итог вписывается там же, где правится состав:
+  отложенный, он пишется по памяти о том, сколько задач было, а не сколько осталось.

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

@@ -157,6 +157,11 @@ flowchart TD
   только то, что импортировано тестом: ошибка типов в непокрытом коде доживает до сборки
   образа, то есть до слияния. Четыре слияния подряд так и уехали в главную ветку, ломая
   выкатку.
+- **На машине, где раннеров несколько, любой путь от домашнего каталога общий.** Умолчание
+  готового шага опасно именно тем, что оно общее: соседнее задание переписывает его под свою
+  версию, пока наше стоит между шагами. Каталог установки, имя контейнера и имя сборщика
+  называются поэтому по проекту и постоянно, а временный каталог решением не бывает — в нём
+  живёт хранилище пакетов.
 - **Набор гейта пуша не бывает уже набора конвейера.** Гейт — обещание, что пуш не приедет
   красным; набор, из которого выкинуты сборка и снимки, обещает то, чего не проверяет. Шаг
   конвейера, которому в наборе гейта нет ни строки, ни объявленного исключения с причиной,

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

@@ -168,6 +168,11 @@ flowchart TD
 - **Сборка входит в набор наравне с линтом и юнитами.** Линтер типов не читает, а юниты читают
   только импортированное тестом: ошибка типов в непокрытом коде доживает до сборки образа, то
   есть до мержа.
+- **На машине, где раннеров несколько, любой путь от домашнего каталога общий.** Умолчание
+  готового шага опасно именно тем, что оно общее: соседнее задание переписывает его под свою
+  версию, пока наше стоит между шагами. Каталог установки, имя контейнера и имя сборщика
+  называются поэтому по проекту и постоянно, а временный каталог решением не бывает — в нём
+  живёт хранилище пакетов.
 - **Набор гейта пуша не бывает уже набора конвейера.** Гейт — обещание, что пуш не приедет
   красным. Шаг конвейера, которому в наборе гейта нет ни строки, ни объявленного исключения с
   причиной, отбивает пуш, а не печатается рядом: предупреждение читается как разрешение.
@@ -217,35 +222,33 @@ 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` сопоставляется по числу: коммит с чужим числом уезжает
+- **Почта машинного коммита копируется из компаньона, а не набирается по памяти.** Адрес
+  `<число>+<логин>@users.noreply.github.com` сходится по числу: с чужим числом коммит уезжает
   подписанным посторонним. Ту же строку держит профиль дерева, и гард отбивает пуш.
-- **Личность машинной записи подтверждается ответом хостинга, а не узнаванием строки.** Спрашивают
-  её токеном, ответом о себе: логин и число приходят вместе.
-- **Сценарии гардов задают настройки git сами, а не берут их с машины.** Подпись, включённая на
-  машине, уводит git в агент ключей, а заблокированный агент роняет весь набор: автор, почта и
-  подпись идут флагами `-c` прямо в команде.
+- **Личность машинной записи подтверждается ответом хостинга, а не узнаванием строки:** её
+  спрашивают токеном, и логин с числом приходят вместе.
+- **Сценарии гардов задают настройки git сами, а не берут их с машины.** Подпись с машины уводит
+  git в агент ключей, а заблокированный агент роняет весь набор: автор, почта и подпись идут
+  флагами `-c` прямо в команде.
 
 - **Каждый коммит вклада ветки подписан машинной записью, и это проверяется набором пуша.** Гард
-  судит только коммит, назвавшийся ею; подписанный человеком проходит мимо, а там, где человек не
-  коммитит вовсе, это промах.
-- **Состояние заявки перечитывается у хостинга сразу после публикации, а не берётся из кода
-  возврата.** Открытие и постановка ревьювера отвечают нулём и тогда, когда не сделали ничего.
+  судит только коммит, назвавшийся ею: подписанный человеком проходит мимо.
+- **Состояние заявки перечитывается у хостинга сразу после публикации.** Открытие и постановка
+  ревьювера отвечают нулём и тогда, когда не сделали ничего.
 - **Автор открытой заявки и наличие у неё ревьювера сверяются очередью работ.** До слияния оба
-  промаха не видны: заявка, открытая человеком, ревьювера не получит никогда, и выглядит это как
-  заявка, которой его просто не поставили.
-- **Ревьюверы спрашиваются вызовом REST, а не выборкой клиента.** Её поля собирает GraphQL, а он
-  требует прав, которых у машинной записи нет: «сошлось» не отличить от «спросить было нечем».
+  промаха не видны: заявка, открытая человеком, ревьювера не получит никогда — и выглядит как
+  заявка, которой его не поставили.
+- **Ревьюверы спрашиваются вызовом REST, а не выборкой клиента.** Её поля собирает GraphQL, прав
+  на который у машинной записи нет: «сошлось» не отличить от «спросить было нечем».
 
-- **Рабочее дерево не опустошается ради прогона инструмента.** Сравнение с прежним состоянием
-  идёт на второй копии: прятанье уводит незакоммиченную работу туда, где её не видит ни состояние
-  дерева, ни сверка.
+- **Рабочее дерево не опустошается ради прогона инструмента.** Сравнение идёт на второй копии:
+  прятанье уводит незакоммиченную работу туда, где её не видит ни состояние дерева, ни сверка.
 
 ## Чего из закона здесь нет
 

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

@@ -159,6 +159,11 @@ flowchart TD
   только то, что импортировано тестом: ошибка типов в непокрытом коде доживает до сборки
   образа, то есть до слияния. Четыре слияния подряд так и уехали в главную ветку, ломая
   выкатку.
+- **На машине, где раннеров несколько, любой путь от домашнего каталога общий.** Умолчание
+  готового шага опасно именно тем, что оно общее: соседнее задание переписывает его под свою
+  версию, пока наше стоит между шагами. Каталог установки, имя контейнера и имя сборщика
+  называются поэтому по проекту и постоянно, а временный каталог решением не бывает — в нём
+  живёт хранилище пакетов.
 - **Набор гейта пуша не бывает уже набора конвейера.** Гейт — обещание, что пуш не приедет
   красным; набор, из которого выкинуты сборка и снимки, обещает то, чего не проверяет. Шаг
   конвейера, которому в наборе гейта нет ни строки, ни объявленного исключения с причиной,

package/assets/rules/spec-driven.md

@@ -93,24 +93,25 @@ flowchart TD
 - **Каждое утверждение привязано к месту в коде, и связь сверяется в обе стороны.** Ключ
   связи — сам текст утверждения, поэтому переформулировать его, забыв про привязку, нельзя.
 - **Первая колонка компаньона — текст статьи, скопированный, а не пересказанный.** Ключ связи —
-  сам текст, поэтому строка, написанная по смыслу статьи, разрывает связь, оставаясь на вид
-  заполненной. Проверка считает статьи без адреса и о статье, адрес которой описывает не её, не
-  знает ничего: совпадает род, а не перечень, и строка стоит до перечитывания диффа.
+  сам текст: строка, написанная по смыслу, разрывает связь, оставаясь на вид заполненной. Проверка
+  считает статьи без адреса и о статье с чужим адресом не знает ничего.
 - **Привязка не ведёт в код, который никто не зовёт:** нигде не зовущийся символ — не место.
+- **Привязка «не исполняется» переезжает вместе со своей статьёй.** Иначе строка компаньона
+  держит в горячей части статью, за которой не стоит ничего: снятая одна, она оставляет привязку
+  без пункта, и сверка краснеет. Переезжают обе стороны разом.
 - **Таблица процедур сверяется с декораторами в обе стороны, право — вместе с именем.** Иначе
-  процедура, которую домен обслуживает, но забыл описать, видна только в
-  декораторе, а право, разошедшееся со спеком, — нигде.
-- **Код отказа принимается, только если он в домене бросается.** Коды выписывались по
-  замыслу, и на одном пути обещанный отказ не бросал никто.
-- **Префикс сценариев в спеке один, и по всему дереву он занят им одним.** Второй префикс
-  внутри спека означает, что предмет описан дважды; занятый чужим — что по номеру не видно,
-  чей это сценарий. Договорённость о продукте — исключение: она нумеруется вместе со спеком, в
-  который вольётся, и занятым префикс от неё не становится.
-- **Номер сценария выдаётся один раз и повторно не используется.** Новый сценарий берёт
-  следующий свободный номер, а не вставляется в середину и не занимает номер удалённого: на
-  месте удалённого номер так и остаётся пустым. Номер — единственное, чем сценарий связан с
-  тестом, и отданный второй раз он оставляет старую ссылку правильной на вид и ведущей не туда.
-  Пересчитать номера подряд особенно дёшево на вид: тесты зелёные и до, и после.
+  процедура, которую домен обслуживает, но забыл описать, видна только в декораторе, а право,
+  разошедшееся со спеком, — нигде.
+- **Код отказа принимается, только если он в домене бросается.** Коды выписывались по замыслу, и
+  на одном пути обещанный отказ не бросал никто.
+- **Префикс сценариев в спеке один, и по всему дереву он занят им одним.** Второй префикс внутри
+  спека означает, что предмет описан дважды; занятый чужим — что по номеру не видно, чей это
+  сценарий. Договорённость о продукте нумеруется вместе со спеком, в который вольётся, и занятым
+  префикс от неё не становится.
+- **Номер сценария выдаётся один раз и повторно не используется.** Новый берёт следующий
+  свободный, а не вставляется в середину и не занимает номер удалённого — на месте удалённого
+  номер остаётся пустым. Номер связывает сценарий с тестом, и отданный второй раз он оставляет
+  старую ссылку верной на вид; пересчёт подряд дёшев обманчиво — тесты зелёные и до, и после.
 - **Сценарий и заголовок его теста правятся одним изменением.** Изменилось обещание — номер тот
   же, а заголовок теста правится тем же коммитом; удалён сценарий — удаляется и тест.
   Разъехавшись, они оставляют прогон зелёным, хотя проверяет он уже не то.
@@ -126,7 +127,7 @@ flowchart TD
   привязывать не к чему, а требование правила заставило бы завести его с якорями в
   несуществующие места. Признак стоит строкой статуса в самом законе, а не в списке исключений
   рядом с проверкой.
-- **Закон, назвавший файл проекта, — отказ.** Путям и привязкам место в правиле: иначе закон
+- **Закон, назвавший файл проекта, — отказ.** Путям и привязкам место в правиле, иначе закон
   нельзя ни прочитать без знания дерева, ни применить на другом приложении.
 - **Описание правила не длиннее трёхсот знаков и отвечает на один вопрос — брать это правило
   или нет.** Описание едет в системный промпт каждого захода целиком, и платит его заход, чем бы
@@ -271,18 +272,16 @@ flowchart TD
 что текст судится не слабее своей копии, что невыбранная редакция судится наравне с выбранной и
 что набор разделов объявлен отдельно от образца, исполняются там, где эти тексты пишут, — в
 наборе того пакета, который их везёт. В дереве-потребителе лежат разложенные копии, и краснеть
-у него на промахе, который правится не у него, проверка не должна. Согласие двух текстов между
-собой не считается нигде и ни у кого: оно ищется чтением.
+у него на чужом промахе проверка не должна. Согласие двух текстов ищется чтением.
 
 Форму сжатой статьи не проверяет ничто, и проверки на неё не будет: машине видно число знаков,
 но не то, принимается ли по сжатой статье прежнее решение. Довод, вырезанный вместе с границей
-утверждения, короче правильного и проходит любой счёт знаков. Стережёт это одно — предел длины
-текста: он говорит, что правило переросло, и молчит о том, что именно из него резать. Судится
-сжатие пересказом, и судит его тот, кто правит по сжатой статье следующим.
+утверждения, короче правильного и проходит любой счёт знаков. Стережёт это один предел длины
+текста: он говорит, что правило переросло, и молчит, что именно резать. Судится сжатие
+пересказом — тем, кто правит по сжатой статье следующим.
 
 Долю довода в правиле не считает ничто. Замер, на котором стоит форма, сделан разовым проходом
-и в дерево не поехал: он отвечает на вопрос «где вес», а не «сошлось ли», и повторяют его тогда,
-когда снова спрашивают о весе.
+и в дерево не поехал: он отвечает на «где вес», а не на «сошлось ли».
 
 ## Паттерны
 

package/assets/rules/turn-conduct.md

@@ -173,7 +173,7 @@ flowchart TD
   Страж читает прежний номер этапа из истории ветки и не выпускает ход, в котором номер вырос, а
   команда не запускалась: через заход отмеченное по памяти неотличимо от проверенного.
 - **Слово об остановке страж читает у владельца, а не у исполнителя.** Иначе остановку объявляет
-  тот, кому она в эту минуту удобна, и запрет держится ровно до первого неудобства.
+  тот, кому она удобна, и запрет держится до первого неудобства.
 - **Утверждение о состоянии дерева стережёт гард утверждения, а не память исполнителя.** Всё, что
   ответ владельцу говорит о дереве, несёт команду и её вывод: сказанное без команды утверждением
   не считается — ни «проверено», ни «снято», ни «готово». Гард читает текст, сказанный владельцу
@@ -259,24 +259,22 @@ flowchart TD
   проверяется деревом. Порядок входа — четыре шага в паттерне возвращения; стережёт его гард, а не
   память.
 - **Состояние незаконченной работы приходит в контекст на запуске сессии.** Замысел и ход работы
-  отдаются целиком, разбор просьбы — путём. Ветка вида `<КЛЮЧ>-*` без папки даёт предупреждение с
-  готовой командой, но сессию не рвёт.
+  отдаются целиком, разбор просьбы — путём. Ветка вида `<КЛЮЧ>-*` без папки предупреждает готовой
+  командой, но сессию не рвёт.
 - **Заполненное окно кончает ход только там, где сжатия нет.** Где оно объявлено, окно —
   продолжение хода: заход сжимается и работает дальше, а порог остановки срабатывает лишь тогда,
-  когда сжатие не пришло. Ход, закрытый ниже порога, теряет остаток окна, за
-  который дерево заплатило настройкой, и ловит это один владелец.
+  когда сжатие не пришло. Ход, закрытый ниже порога, теряет остаток окна, за который дерево
+  заплатило настройкой, и ловит это один владелец.
 - **Заполнение окна захода стережёт гард, а не память исполнителя.** На первом пороге он
-  напоминает выбирать точку остановки, на втором отбивает всё, кроме записи хода работы, передачи
-  и команд поставки. Размер окна и оба порога дерево задаёт само; не задавшее размера стража не
-  получает.
+  напоминает выбирать точку остановки, на втором отбивает всё, кроме передачи, команд поставки и
+  папки задачи — папки целиком: на закрытии правят и решение по ходу, и пересмотр этапа. Размер окна и оба порога дерево задаёт само; не задавшее размера стража не получает.
 - **Порог сжатия контекста дерево задаёт само, и стоит он НИЖЕ порога остановки.** Совпавшие
-  пороги согласием не бывают: это гонка, и выигрывает её страж — он стоит на вызове, а сжатие
-  приходит между ходами. Расстояние объявляется числом, а не выводится разницей; сведены пороги
-  или нет, говорит разбор состояния раскладки.
-- **Заход закрывается передачей, которая лежит вне дерева.** Состояние работы коммитится ходом
-  работы, а передача его пересказывает для вставки в новый заход: рабочее дерево, ветка,
-  сделанное, следующий шаг и особенности захода. В историю она не едет — иначе рядом с ходом
-  работы заводится вторая запись об одном и том же.
+  пороги — гонка, и выигрывает её страж: он стоит на вызове, а сжатие приходит между ходами. Расстояние объявляется числом, а не выводится разницей; сведены
+  ли пороги, говорит разбор состояния раскладки.
+- **Заход закрывается передачей, и лежит она разделом хода работы.** Он коммитится и едет в
+  ветку — значит передача переживает переход на другую машину, а второй записи об одном и том
+  же не заводится. В ней дерево, ветка, сделанное, следующий шаг и особенности захода; у работы
+  без папки задачи она уезжает файлом вне дерева.
 
 - **Вариант, глушащий проверку, в меню не ставится вовсе.** Выключенное правило линтера, строка
   в списке известного, выведенный из-под проверки файл — все они чинят показание, а не то, на что

package/assets/rules/turn-entry.md

@@ -17,7 +17,7 @@ description: Правило под «Закон о ведении работы»
 | В законе                   | Здесь                                                                         |
 | -------------------------- | ----------------------------------------------------------------------------- |
 | вход в заход               | то, что хук старта кладёт в контекст до первой реплики                        |
-| переданное прошлым заходом | файл по имени ветки в каталоге передач; пишет его хук перед сжатием контекста |
+| переданное прошлым заходом | раздел «Передача захода» в ходе работы этой ветки, а у работы без папки задачи — файл по имени ветки в каталоге передач; пишет его хук перед сжатием контекста |
 | порядок ведения работы     | карта хода — состояния с обязательными действиями и четыре выхода хода        |
 | запуск                     | первый запуск, возобновление, сжатие контекста, очистка                       |
 
@@ -32,9 +32,11 @@ description: Правило под «Закон о ведении работы»
 
 ```mermaid
 flowchart TD
-    A[Запуск захода] --> B{Есть передача по имени текущей ветки}
-    B -->|Да| C[Передача кладётся в контекст целиком]
-    B -->|Нет| D[О передаче не говорится ничего]
+    A[Запуск захода] --> B{Есть раздел передачи в ходе работы этой ветки}
+    B -->|Да| C[Раздел кладётся в контекст целиком, файл вне дерева не читается]
+    B -->|Нет| B2{Есть файл передачи по имени ветки}
+    B2 -->|Да| C
+    B2 -->|Нет| D[О передаче не говорится ничего]
     C --> E{Разложен ресурс карты хода}
     D --> E
     E -->|Да| F[Карта кладётся следом: состояния, действия, четыре выхода]

package/assets/rules/typescript-conventions.md

@@ -80,6 +80,13 @@ flowchart TD
   молча, а компилируется из них только одна.
       <!-- rt-when: *.ts -->
 
+- **Значение, объявленное одной стороной обмена, второй стороной не пересчитывается, а берётся
+  у первой.** Два счёта одного значения расходятся молча: признак дерева считали и отправка, и
+  отметка — каждая своей копией, — копии разошлись, и отметка не нашла ни одной своей записи ни
+  разу. Обе стороны при этом отвечали как обычно, и промах нашёлся только с третьей стороны:
+  чтением того, что легло на самом деле.
+      <!-- rt-when: *.ts -->
+
 - **Двухступенчатое приведение `as unknown as` запрещено правилом линтера.** Вместо него —
   честный тип, сужение проверкой или чтение поля формой (`Reflect.get`); место, где иначе
   нельзя, помечается точечным отключением с причиной в той же строке.

package/assets/skills/agent-kit-extend.md

@@ -62,6 +62,17 @@ awk '/^```/ { fence = !fence } !fence && /^## / { print }' <файл ресур
 От ресурса целиком отказываются не здесь, а списком `skip` в конфиге: надстройка правит текст,
 `skip` отменяет файл.
 
+## Надстройку карты гейта не проверяет ничто
+
+Сценарии пакета гоняют его умолчание и веток дерева не касаются: своих проб у надстройки нет, и
+места для них тоже. Карта решает, какое правило грузится под каждую правку, то есть чем заход
+руководствуется в работе, а держится она прогоном руками и памятью того, кто её правил.
+
+Промах в ней молчит: неверная ветка не отказывает, а тихо отдаёт не то правило — заметен он
+только по объёму загруженного и по тому, что в загруженном не нашлось ответа. Поэтому правка
+карты кончается вызовом гейта на трёх путях: на том, ради которого правили, на соседнем,
+который правка задеть не должна была, и на файле, у которого правила нет вовсе.
+
 ## Гейт: своя ветка решает раньше умолчания
 
 Гейт спрашивает `skill_for` — она печатает имя правила или молчит. Молчание значит «правила на

package/assets/skills/agent-kit.md

@@ -81,8 +81,13 @@ npx agent-kit sync --check  # ничего не писать, отказать
 npx agent-kit stats         # чем пользовались, чем ни разу, обо что спотыкались
 npx agent-kit enroll --code <код>  # завести дерево в приёме и положить его токен
 npx agent-kit propose       # отправить груз в приём: сводку, предложения и разборы
+npx agent-kit adopt [файлы] # отдать пакету свой файл, лежащий на его пути
 ```
 
+Отдача откладывает прежнее содержимое рядом, с пометкой `.before-rt-kit`, и освобождает путь под
+раскладку; без имён отдаются все чужие файлы разом. Названа она здесь потому, что иначе её
+находят по тексту отказа раскладки — то есть в ту минуту, когда работа уже встала.
+
 Часть команд слоя исполняет агент, а не программа: `/feedback` кладёт слово о правилах блоком в
 файл предложений, `/skill-curator` разбирает закрытую задачу, `/next-session` закрывает заход.
 
@@ -227,8 +232,13 @@ npx agent-kit propose       # отправить груз в приём: сво
 2. Снимок того, что говорят проверки дерева, до единой правки. Он и есть мерило.
 3. Ресурс за ресурсом: пакетную редакцию довести до здешней, предметность вынести в
    надстройку, снять отказ, разложить, прогнать сценарии и сверить снимок.
-4. Разложенное поверх своего пакет не пишет: файл без шапки для него чужой. Снять его —
-   решение владельца, и до этого раскладка отказывает поимённо.
+4. Разложенное поверх своего пакет не пишет: файл без шапки для него чужой. Отдаётся он
+   командой `adopt` — прежнее содержимое ложится рядом с пометкой `.before-rt-kit`, и снять его
+   потом решает владелец.
+5. Свои сценарии отданного файла переписываются под пакетное поведение либо снимаются. Чинить
+   пакетную редакцию на месте нельзя: правка разложенной копии живёт до следующей раскладки, а
+   её адрес — источник пакета или надстройка дерева. Сценарий, ждущий поведения снятого файла,
+   краснеет и после верной отдачи: он проверяет то, чего в дереве больше нет.
 
 ## Свойства дерева
 

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;AAqHD;;;;;;GAMG;AACH,wBAAgB,KAAK,CAAC,GAAG,EAAE,YAAY,EAAE,OAAO,EAAE,aAAa,GAAG,iBAAiB,CAuDlF;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;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"}