@rt-tools/agent-kit 0.19.0 → 0.21.0

package/assets/patterns/testing-unit.md

@@ -106,6 +106,19 @@ globalThis.fetch = (): Promise<Response> => Promise.resolve(Response.json({ succ
 заголовке и едет в ветке. Признак временного файла — его заголовок не называет ни одного
 сценария.
 
+## Зелёное, которое ничего не проверяет
+
+**Проба, ждущая молчания, идёт в паре с пробой, ждущей отказа.** Молчание наступает и тогда,
+когда проверять было нечем: приставка перед командой в конвейере действует на одно звено, и
+хук, получивший пустое значение, молчит ровно так же, как хук, которому нечего отбивать. Две
+пробы из трёх при этом зелены — они и ждали молчания, — и промах виден только по третьей,
+которая ждёт отказа.
+
+**Проба на мину, которая не срабатывает, зелена и без починки.** Сценарий на таблицу кодов
+отказа у спека без процедур проходил бы и до правки: читать эту таблицу сверке не приходится
+вовсе. Проверяется такая проба обеими сторонами — прежнее состояние возвращается на минуту и
+прогоняется: не покраснело, значит проба ничего не сторожит.
+
 ## Частые промахи
 
 - Либа без своего `vitest.config.mts`: `nx test <проект>` пройдёт зелёным, не запустив ни

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

@@ -193,7 +193,7 @@
   же, чего гард и добивается.
 - **Свои черновики судятся все разом.** Уход в соседнюю ветку выключал гард целиком: за один
   заход так разошлись с главной четыре заявки подряд, и заметил это владелец, а не проверка.
-  Разбор — `docs/postmortems/2026-08-25-run-left-unwatched.md`.
+  Разбор — запись «2026-08-25-run-left-unwatched» в приёме.
 - **Подпись машинной записи на каждом коммите вклада.** Пять коммитов одной стопки уехали
   подписанными владельцем, который правки не делал: гард судит только коммит, назвавшийся
   машинной записью, и ищет расхождение в числе служебного адреса.
@@ -219,3 +219,21 @@
   ни статус, ни сверка, а команда, прошедшая между прятаньем и возвратом, пишет в те же файлы —
   и возврат встаёт конфликтом. Так ушли в прятанье восемь незакоммиченных файлов при живом
   запрете на эту команду: запрет читался в начале захода, а команда набиралась через сорок ходов.
+- **Вывод команды, которой нужен репозиторий, собирается в каталоге репозитория.**
+  Перенаправление создаёт файл раньше, чем команда успевает отказать: клиент хостинга, позванный
+  из каталога временных файлов, падает строкой о том, что это не репозиторий, а пустой файл к
+  этой минуте уже записан. Уехав дальше — в тело заявки, в замысел, в правило, — он стирает
+  написанное, и восстанавливается это только историей правок на стороне хостинга. Файл вывода
+  поэтому кладётся в дереве, а записанное проверяется до того, как его куда-то отправят.
+
+- **Очередь конвейера, заведённая на всё дерево, снимает ждущего чужим пушем.** Группа
+  одновременности с отменой уже идущего экономит машину ровно до первого соседа: его пуш снимает
+  прогон чужой ветки, и та остаётся с вершиной без единого прогона — заявка при этом выглядит
+  непроверенной, а прогонять её заново некому. Группа поэтому заводится своя на ветку, и общей
+  остаётся только у шагов, которым нужен стенд: их и правда нельзя гнать вдвоём на одной машине.
+
+- **Команды дерева зовутся из его корня, а не из каталога пакета.** В подкаталоге со своим
+  манифестом запуск берёт его, а не корневой, и отвечает «такой команды нет» — при том что в
+  дереве она есть и написана верно. Читается это как поломка команды, а лечится каталогом: путь
+  до неё называется от корня, и звать её оттуда.
+

package/assets/pitfalls/spec-driven.md

@@ -34,6 +34,14 @@
   его привязка перестают находиться друг по другу. После разрешения гоняется
   `npm run check:specs` — конфликт в спеке кода не задевает, и ни сборка, ни линтеры его не
   увидят.
+- **Сложение отвечает на две дописи, а не на снятие: сторона, у которой текста нет вовсе, тоже
+  правка.** Раздел, вынесенный в описание прошлого или свёрнутый в правило, сложением
+  возвращается обратно — один абзац встаёт в двух редакциях, и снятая читается как
+  действующая. Случай не редкий: он приходит ровно тогда, когда снятия потребовал сам слой
+  правил, а ветки, начатые раньше, несут прежнюю редакцию. Признак прямой — у одной стороны
+  текста нет; тогда конфликт решается тем, что с разделом сделали, а не сложением. Снятое
+  остаётся снятым, а допись второй стороны переезжает туда, куда уехал раздел, — или не
+  переезжает вовсе, если уехал он потому, что стал правилом.
 
 - **Строку требования к соседнему ресурсу не проверяет ничто, и расхождение видно только
   счётом.** Правило без неё выглядит целым: разделы на месте, привязки сходятся, сверка
@@ -50,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,6 +84,43 @@
   задание, он даёт заходу работу, которой владелец не просил. То же с любой репликой без
   глагола: спросить, что с этим делать, дешевле, чем написать полсотни файлов мимо просьбы.
 
+- **Признак готовности этапа пишется о своей половине вывода, а не обо всём выводе.** Проверка
+  считает всё дерево, а этап правит его часть: «вывод без единой строки долга» не сходится не
+  потому, что этап не сделан, а потому, что три строки принадлежат невлитой соседней ветке.
+  Признак называет свои строки и своё число, а сказанное обо всём выводе держится до первого
+  соседа.
+
+- **Копия образца папки задачи несёт шапку раскладки, и первая же правка отбивается гардом.**
+  Образец разложен пакетом наравне с остальным разложенным, а гард места правки судит по шапке:
+  копия под задачу выглядит разложенным файлом, и отказ называет адрес источника пакета — то
+  есть уводит править образец вместо своей копии. Команда заведения задачи шапку снимает сама,
+  копирование руками — нет. Правится такая копия только записью заново: правку по месту гард
+  отбивает и её.
+- **Имя проекта в признаке готовности этапа спрашивается у сборщика, а не пишется по памяти.**
+  На неизвестное имя сборщик отвечает «задач не запущено» и выходит нулём: команда признака не
+  прогнала ни одной пробы и промолчала так же, как зелёный прогон. Видно это только по числу
+  прогнанных задач, а его никто не читает.
+
+- **Этап, закрытый без пуша, гоняет проверки гейта своим последним движением.** Признак этапа
+  зовёт свои команды и общих не знает, а гейт краснеет только на отправке: ветка без пушей копит
+  красное до первой из них, и промах уезжает на два этапа от места, где его сделали.
+
+- **У признака закрытия спрашивают, может ли исполнитель подтвердить его сам.** Признак,
+  требующий человека — пароля, кнопки в чужой панели, взгляда владельца, — останавливает работу
+  на последнем шаге: сделано всё, а сказать «закрыто» нечем. Спрашивается это при разборе
+  просьбы.
+
+- **Признак закрытия проверяет исход у той стороны, которая его хранит, а не ответ вызова.**
+  Вызов отвечает о себе: ушёл, принят, код нулевой — и всё это верно при том, что записанного
+  нет. Восемь задач подряд считали отметку работающей по ответу команды, а она не двигала
+  ничего.
+
+- **Своё временное кладётся вне дерева кода — иначе его снятие судится как правка приложения.**
+  Признак записи считает записью и удаление, и это в нём нарочно: снятое без замысла не
+  оставляет следа. Отличить свой временный каталог от каталога домена признаку нечем — путь у
+  обоих под тем же корнем, — и гард требует замысла за уборку черновика. Каталог называет
+  профиль дерева, и лежит он вне дерева кода.
+
 - **Тело задачи, написанное вперёд замысла, называет способ, и способ стареет раньше дефекта.**
   Задача серии заводится за недели до того, как её берут, и к этому дню предложенный ход бывает
   уже неверен: привезённое пакетом умеет то, что задача звала написать, названного места в
@@ -116,10 +156,15 @@
   подряд не пересилили одну строку на диске. Снимается она тем же ходом, которым владелец
   ответил, — а не тем, в котором о ней вспомнили.
 
-- **У меню с закрытым набором нет строки «вопрос не тот».** Вариантами вопрос выглядит
-  разобранным, и владельцу, чтобы отвергнуть саму постановку, приходится выходить из набора
-  руками. Спрашивают меню то, где выбор действительно закрыт; там, где под сомнением сама
-  уместность вопроса, его сперва проверяют по репликам владельца — и чаще всего не задают.
+- **Очередь работ эпиком не кончается.** Занятый другими исполнителями или законченный эпик
+  означает следующую задачу из очереди, а не остановку: «свободных задач эпика нет» ответом на
+  «чем заняться» не бывает, потому что отвечает на этот вопрос не эпик, а очередь. Спрашивается
+  она командой, а не вспоминается по передаче: утверждение переданного текста описывает то
+  дерево и тот день, в котором его писали.
+- **Шаг закрытия работы за взятие следующей задачи не считается.** Перевод закрываемой задачи в
+  колонку разбора и снятие её папки — обязательные шаги закрытия, и оба случаются тем же ходом,
+  которым открывается заявка. Ход, в котором больше ничего нет, работу не двигает, сколько бы
+  команд в нём ни стояло.
 
 ## Поведение исполнителя — по разборам происшествий
 
@@ -175,29 +220,27 @@
   Отказ при этом уводит править образец пакета вместо копии под задачу.
 - **Правка по замечаниям идёт без замысла на диске.** Папка разобрана коммитом ветки раньше
   открытия заявки, и состояния у работы с этой минуты нет: судит её история ветки.
-- **Прогон, поставленный раньше дешёвых шагов, съел окно захода.** Потративший его на прогон
-  упирался в порог заполнения на четырёх строках привязки — то есть на работе минут на пять.
-- **Граница состояния выглядит законченным куском лучше всякой вехи.** Владельцу отчёт о взятой
-  задаче неотличим от остановки: названы номер, ветка и колонка, и всё названное правда.
+- **Граница состояния выглядит законченным куском лучше всякой вехи.** Отчёт о взятой задаче
+  владельцу неотличим от остановки: номер, ветка и колонка названы, и всё названное правда.
 - **Заявка на чужом языке.** В дереве, где заявки пишутся на другом языке, чужой заголовок
   дважды уехал на хостинг, и оба раза до него добрались глазами.
-- **Вопрос, утонувший в отчёте.** Владелец трижды переспрашивал, почему работа стоит, и каждый
-  круг стоил захода обоим.
-- **Чужой эпик в списке очереди.** Дважды подряд следующей была взята первая задача чужого
-  эпика — по списку она выглядела ровно как своя.
+- **Вопрос, утонувший в отчёте.** Владелец трижды переспрашивал, почему работа стоит.
+- **Чужой эпик в списке очереди.** Дважды подряд следующей брали первую задачу чужого эпика:
+  по списку она выглядит своей.
 
 - **Некоммиченная папка задачи отказывает там, где чинить уже нечего.** Гард спрашивает её с
-  диска, поэтому все правки проходят без единого отказа, а признак отданной работы берётся из
-  истории ветки. Отказ приходит на открытии заявки — в минуту, когда папка разобрана своими
-  руками: замысел снят, и собирать его приходится заново по памяти. Владелец при этом всю
-  работу видит ветку без единого следа того, что в ней делается, а следующий заход находит
-  пустоту вместо «Где стоим».
+  диска, поэтому все правки проходят без отказа, а признак отданной работы берётся из истории
+  ветки. Отказ приходит на открытии заявки — когда папка разобрана своими руками: замысел снят,
+  и собирать его приходится по памяти. Владелец при этом всю работу видит ветку без следа того,
+  что в ней делается.
 - **Прогон, поставленный первым шагом закрытия, съедает окно захода.** Он стоит дороже всех
-  остальных шагов вместе, и потративший его на прогон упирался в порог заполнения на четырёх
-  строках привязки — то есть на работе, которая стоила бы минуты, если бы шла первой.
+  остальных шагов вместе: потративший его упирался в порог заполнения на четырёх строках
+  привязки — на работе, которая шла бы минуту, будь она первой.
 - **Разрешение работать вне назначенного эпика принадлежит рабочему дереву, а не ветке.**
   Записанное в файл репозитория, оно уезжает вместе с веткой: из соседней его не видно, и гард
-  эпика отбивает ровно ту работу, которую владелец разрешил. За один заход это случилось дважды
-  — сперва на отказе конца хода, потом на переводе колонки, и оба раза номер дописывался заново.
-  Место такому разрешению там же, где передача захода: оно не откатывается вместе с правкой и не
-  принадлежит ни одной задаче.
+  эпика отбивает ровно ту работу, которую владелец разрешил — за один заход дважды. Место ему
+  там же, где передача захода: оно не откатывается с правкой и не принадлежит ни одной задаче.
+- **Задача, вынесенная в другой эпик, снимается из состава прежнего тем же ходом.** Вынос — два
+  движения, и сделанное наполовину оставляет задачу в двух составах сразу: эпик выглядит
+  незакрытым при всех сделанных работах. Итог вписывается там же, где правится состав:
+  отложенный, он пишется по памяти о том, сколько задач было, а не сколько осталось.

package/assets/pitfalls/testing.md

@@ -38,6 +38,15 @@
 - **Первому прогону сразу после установки браузера верить нельзя.** Два падения сквозного
   набора не повторились ни при отдельном прогоне тех же тестов, ни при втором полном. Такой
   прогон повторяют, а выводы делают по второму.
+- **Повторный прогон через гейт пуша повторяет весь набор, а не упавший тест.** Гейт гоняет то,
+  что перечислил профиль дерева, целиком и с нуля: у сквозного набора это минуты, и каждая
+  попытка пуша стоит их заново. Соседняя ловушка верна ровно до этого места: повторить дёшево —
+  через гейт уже нет, и «повторить» превращается в «пушить, пока не пройдёт». Полный набор
+  поэтому гоняется руками до вызова пуша, а гейт только подтверждает уже известное. Тест,
+  упавший в полном наборе и прошедший при отдельном прогоне, зелёным не считается: это
+  нестабильный тест, и он заводится задачей тем же ходом. Прогон до зелёного уносит признак
+  вместе с падением, и следующий заход встречает то же самое как новость — а отличить чужую
+  нестабильность от своей регрессии ему нечем: оба случая выглядят одинаково.
 - Сквозная спека, которой нужен вход, без учётных данных в окружении пропускается молча — в
   отчёте она значится `skipped`, и прогон выглядит успешным. Имена переменных — при дереве.
 - **Справочник флоу вторых сценариев не заводит.** В `docs/E2E_<ДОМЕН>_FLOWS.md` кладут то,

package/assets/pitfalls/turn-conduct.md

@@ -80,3 +80,11 @@
   в него, встаёт целиком там, где мимо него шло ещё несколько ходов дела. Делается всё, что от
   разрешения не зависит, а несделанное называется в теле заявки, разделом об оставшемся шаге:
   он ровно про это и написан.
+- **Ответ на реплику владельца, пришедшую посреди хода, ход не кончает.** Выход «вопрос
+  владельцу» — про вопрос ОТ исполнителя; обратный случай под него не подходит вовсе, и
+  прочитанный так, он превращает каждую реплику владельца в конец захода. За один заход это
+  стоило трёх остановок подряд: владелец спрашивал, исполнитель отвечал и вставал.
+- **Работа не гейтится на подтверждение, которого владелец не обещал.** «Скажи — и я сделаю»
+  переносит ход к владельцу без его согласия: он не просил, чтобы у него спрашивали, и ответа с
+  него никто не ждал. Выглядит это вежливостью, а не остановкой, и потому не читается как
+  остановка ни исполнителем, ни им.

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` закрывает заход.
 
@@ -103,7 +108,11 @@ npx agent-kit propose       # отправить груз в приём: сво
     cp -r node_modules/@rt-tools/agent-kit/assets /tmp/agent-kit-assets-<прежняя версия>
     ```
 
-2. **Установка и раскладка.** Обычным порядком.
+2. **Установка и раскладка.** Обычным порядком. Раскладка кладёт ту редакцию, которая **установлена**,
+   а не ту, что объявило дерево: перепутать их легко — установленная остаётся от соседней ветки,
+   где её как раз поднимали, и ложится целиком, молча, с тем же успешным выходом. Расхождение
+   точного номера раскладка отбивает сама и называет обе редакции; починка — поставить
+   зависимости и повторить вызов.
 3. **Сверка замещённых разделов по снимку.** Какие разделы замещены, называет `doctor` — строкой
    «замещено надстройками разделов» и перечнем «ресурс · заголовок». Каждый из них читается в
    снимке и в новой редакции: что пакет дописал, дописывается в надстройку руками.
@@ -223,8 +232,13 @@ npx agent-kit propose       # отправить груз в приём: сво
 2. Снимок того, что говорят проверки дерева, до единой правки. Он и есть мерило.
 3. Ресурс за ресурсом: пакетную редакцию довести до здешней, предметность вынести в
    надстройку, снять отказ, разложить, прогнать сценарии и сверить снимок.
-4. Разложенное поверх своего пакет не пишет: файл без шапки для него чужой. Снять его —
-   решение владельца, и до этого раскладка отказывает поимённо.
+4. Разложенное поверх своего пакет не пишет: файл без шапки для него чужой. Отдаётся он
+   командой `adopt` — прежнее содержимое ложится рядом с пометкой `.before-rt-kit`, и снять его
+   потом решает владелец.
+5. Свои сценарии отданного файла переписываются под пакетное поведение либо снимаются. Чинить
+   пакетную редакцию на месте нельзя: правка разложенной копии живёт до следующей раскладки, а
+   её адрес — источник пакета или надстройка дерева. Сценарий, ждущий поведения снятого файла,
+   краснеет и после верной отдачи: он проверяет то, чего в дереве больше нет.
 
 ## Свойства дерева