@rt-tools/agent-kit 0.12.0 → 0.14.0

package/assets/rules/task-flow.md

@@ -55,10 +55,10 @@ description: Правило под «Закон о ведении работы»
 | `задача-взята`            | задача в колонке работы, ветка по номеру, папка | написать замысел                                       | `task-flow-start`  |
 | `замысел-записан`         | замысел лежит и после записи не правится        | делать первый этап                                     | `task-flow-start`  |
 | `этап-идёт`               | этап начат                                      | доделать этап и отметить в ходе работы                 | `task-flow-resume` |
-| `этапы-кончились`         | все этапы отмечены                              | прогнать набор и открыть PR черновиком                 | `task-flow-close`  |
+| `этапы-кончились`         | все этапы отмечены                              | прогнать набор, влить договорённость, привести тексты  | `task-flow-close`  |
+| `разбор-кончился`         | набор зелёный, тексты приведены                 | разобрать папку последним коммитом                     | `task-flow-archive` |
+| `папка-разобрана`         | папки в ветке нет, запись в архиве есть         | открыть PR черновиком                                  | `task-flow-close`  |
 | `работа-отдана`           | PR открыт черновиком                            | взять следующую задачу                                 | `task-flow-resume` |
-| `разбор-кончился`         | прогон зелёный, замечаний нет                   | влить договорённость, привести тексты, разобрать папку | `task-flow-close`  |
-| `папка-разобрана`         | папки в ветке нет, запись в архиве есть         | снять черновик и попросить влить                       | `task-flow-archive` |
 | `влито`                   | PR слит человеком                               | разбор работы правилами и сверка очереди               | `task-flow-archive` |
 
 Ни у одного состояния обязательное действие не звучит как «ждать»: ожидание чужого шага
@@ -72,6 +72,12 @@ description: Правило под «Закон о ведении работы»
 Перечень показывается владельцу в начале работы, и на нём же отмечается, где стоим: иначе после
 шести вопросов не видно ни того, что будет дальше, ни сколько всего впереди.
 
+Последние два состояния объявить на диске уже нечем: ход работы уезжает вместе с папкой, а
+папка разбирается раньше, чем открывается PR. Признак у них поэтому в истории ветки — коммит
+разбора папки, — и читает его гард, а не строка в файле. Цена названа прямо: с этой минуты и до
+слияния состояние работы виду не подлежит, и хвост из четырёх шагов — открыть PR, дождаться
+прогона, снять черновик, попросить влить — держится паттерном, а не объявлением.
+
 ## Ход
 
 Ход работы от просьбы владельца до закрытия: где стоит разбор, что требует гард и куда девается
@@ -93,16 +99,16 @@ flowchart TD
     H --> I{Этап сделан}
     I -->|Да| J[Отметка в ходе работы — единственном месте, где отмечается сделанное]
     J --> I
-    I -->|Этапы кончились| K[PR открывается; исполнитель называет номер, чего ждёт и что сделает следом]
+    I -->|Этапы кончились| T[Набор прогоняется, договорённость вливается в спек домена, тексты приводятся к сделанному]
+    T --> N[Папка задачи разбирается последним коммитом: разбор просьбы — в описание прошлого, находки — к замыслу эпика, замысел — прочь]
+    N --> S[Сверка очереди работ]
+    S --> K[PR открывается черновиком; исполнитель называет номер, чего ждёт и что сделает следом]
     K --> W[Разбор закрытой работы правилами уходит в фон, находки ложатся на диск]
     W --> L[Пока PR ждёт разбора, берётся следующая задача]
     L --> M{Разбор и прогон кончились}
-    M -->|Красный прогон или замечания| V[Чинится в той же ветке: замысел на диске ещё нужен]
+    M -->|Красный прогон или замечания| V[Чинится в той же ветке: замысла на диске уже нет, и признак работы гард берёт из истории ветки]
     V --> M
-    M -->|Зелено и замечаний нет| T[Договорённость вливается в спек домена, тексты приводятся к сделанному]
-    T --> N[Папка задачи разбирается последним коммитом: разбор просьбы — в описание прошлого, находки — к замыслу эпика, замысел — прочь]
-    N --> S[Сверка очереди работ]
-    S --> O[Черновик снимается, слияние нажимает человек]
+    M -->|Зелено и замечаний нет| O[Черновик снимается, слияние нажимает человек]
 ```
 
 ## Как закон применяется здесь
@@ -112,9 +118,11 @@ flowchart TD
   в ходе работы состояние и названную в замысле договорённость о продукте.
 - **Гард судит объявленный переход, а не наличие файлов.** Артефакт на диске не говорит, дошла
   ли работа до правки кода: пустой замысел, положенный ради снятия отказа, лежит так же, как
-  написанный. Отказ снимает объявленное состояние, и снимают его четыре — `этап-идёт`,
-  `этапы-кончились`, `работа-отдана` и `разбор-кончился`: прогон бывает красным, а разбор — с
-  замечаниями, и починка идёт в ту же ветку.
+  написанный. Отказ снимает объявленное состояние, и снимают его три — `этап-идёт`,
+  `этапы-кончились` и `разбор-кончился`. Четвёртый путь у отказа не состояние, а история ветки:
+  папка, разобранная её коммитом, означает отданную работу, и правка по замечаниям разбора идёт
+  без замысла на диске — объявить состояние после уборки уже нечем. Прогон бывает красным, а
+  разбор — с замечаниями, и починка идёт в ту же ветку.
 - **Отказ по состоянию называет обязательное действие того состояния, которое объявлено.**
   Исполнитель, которому сказано только «не в том состоянии», перепишет строку состояния вместо
   того, чтобы сделать шаг.
@@ -136,13 +144,20 @@ flowchart TD
   дважды стало поводом обойти отказ гарда, вместо того чтобы завести папку и пойти дальше.
   Заводится она всегда и до первой правки; сколько заходов уйдёт на работу, заранее не знает
   никто.
+- **Папка задачи разбирается последним коммитом до открытия PR, а не после одобрения.** Прежде
+  она стояла после: пока идёт разбор, замысел нужен на диске, иначе правку по замечаниям
+  отбивает гард. Но кнопку слияния нажимает человек на хостинге, куда гард не достаёт, и
+  вливает он, как только видит зелёное, — закрывающему коммиту места не остаётся вовсе. Трижды
+  подряд папка уехала в главную ветку неразобранной, и разобрать её было уже некому: работа
+  перешла к следующей задаче, а PR закрылся. Цена перестановки названа прямо: замысла с этой
+  минуты на диске нет, и признак отданной работы гард берёт из истории ветки.
 - **Открыв PR, исполнитель называет владельцу три вещи: номер, чего ждёт и что сделает
   следом.** Ждёт он прогона — до его конца о работе ничего не известно, кроме того, что она
-  запушена. Следом идёт уборка: разбор папки задачи последним коммитом. Сказанное так владелец
-  читает однозначно, а зелёный прогон на странице — нет: он говорит, что не сломано, и молчит
-  о том, что ветка ждёт ещё одного коммита. Трижды подряд PR был влит внутри этого молчания.
-- **Просьба о слиянии — отдельный ход, и раньше уборки её не бывает.** Порядок один: PR открыт
-  черновиком → прогон зелёный → папка задачи разобрана и запушена → черновик снят →
+  запушена. Следом идёт снятие черновика. Сказанное так владелец читает однозначно, а зелёный
+  прогон на странице — нет: он говорит, что не сломано, и молчит о том, что кнопка слияния у
+  черновика заблокирована.
+- **Просьба о слиянии — отдельный ход, и раньше зелёного прогона её не бывает.** Порядок один:
+  папка задачи разобрана и запушена → PR открыт черновиком → прогон зелёный → черновик снят →
   исполнитель просит влить, называя номер. До этой просьбы работа не готова, сколько бы зелёного
   на её странице ни было.
 - **PR открывается черновиком, а не в конце работы.** Пока правка кода не выложена в PR,
@@ -161,7 +176,9 @@ flowchart TD
   целиком, поэтому «не читал» основанием не бывает.
 - **Папка задачи заводится черновиком и получает номер командой.** До конца разбора
   неизвестно, сколько задач из него выйдет, поэтому номер не может быть первым;
-  `npm run task:new` переименовывает черновик и проставляет шапку замысла.
+  `npm run task:new` переименовывает черновик и проставляет шапку замысла. Папку он и собирает —
+  с образца, снимая с копий шапку раскладки: оставленная в копии, она отбивает первую же правку
+  разбора просьбы, а отказ уводит править образец пакета вместо копии под задачу.
 - **Брошенный разбор виден.** Черновик старше недели перечисляет сверка очереди работ —
   задачи за ним ещё нет, и спросить о нём некого.
 - **Замысел эпика лежит там, где его найдут без сети и после мержа.** Карточка в очереди работ
@@ -192,21 +209,22 @@ flowchart TD
   это заготовка правки чужого дерева, и часть заготовок отпадает при первом же чтении; уехавшая
   без разбора, она становится работой того, кто её не заказывал. Сводка наблюдений уезжает
   всегда: она говорит, чем пользовались и чем нет, и мнением не является.
-- **Договорённость вливается в спек домена последним коммитом PR.** К этому моменту код
-  написан, привязки известны, и в главной ветке директория `proposed/` не появляется вовсе.
+- **Договорённость вливается в спек домена одним из последних коммитов ветки, до открытия
+  PR.** К этому моменту код написан, привязки известны, и в главной ветке директория
+  `proposed/` не появляется вовсе.
   Готовые к вливанию перечисляет `npm run check:specs`.
 - **Папка закрытой задачи разбирается, а не переносится целиком.** В `docs/archive/` уезжает
   то, что объясняет состоявшееся решение; остальное удаляется. Неразобранную ловит сверка
   очереди работ.
-- **Слияние отбивается, пока ветка везёт папку своей задачи.** Требование стоит на слиянии, а
-  не на открытии PR: до слияния папка ещё нужна — правка по замечаниям разбора идёт в ту
-  же ветку, а без замысла на диске её отбивает гард хода работы. На открытии PR о лежащей
-  папке говорится вслух, и только. Судится содержимое ветки, а не рабочее дерево: снесённая,
-  но не закоммиченная папка въехала бы вместе с веткой.
+- **Открытие PR отбивается, пока ветка везёт папку своей задачи.** Требование стоит здесь, а
+  не на слиянии: слияние нажимает человек на хостинге, где гардов нет вовсе, и его отказ до
+  владельца не доходит. На слиянии та же проверка остаётся вторым рубежом — она ловит слияние,
+  идущее командой. Судится содержимое ветки, а не рабочее дерево: снесённая, но не
+  закоммиченная папка въехала бы вместе с веткой.
 - **Ветка, снёсшая папку, обязана прибавить запись в архив.** Снести дешевле, чем разобрать, и
   первым уходит разбор просьбы — единственная запись слов владельца. Что именно увезено,
   требование не судит: это судит владелец.
-- **Обход — строка `Task-folder-skip: <причина>` в PR или в самой команде слияния.**
+- **Обход — строка `Task-folder-skip: <причина>` в PR или в самой команде.**
   Работа, вливаемая частями, папку до конца не разбирает. Чтение из команды работает и без
   сети: единственный сетевой путь отбивал бы оффлайн то самое слияние, причина которого
   написана в PR. Пустая причина обходом не считается, а сам обход снимает отказ, но не

package/assets/rules/turn-conduct.md

@@ -101,6 +101,13 @@ flowchart TD
   работы и то, что за ход по ней сделано: правку файла или команду, меняющую дерево. Ход, в
   котором не было ни того ни другого, возвращается исполнителю вместе со следующим шагом из
   хода работы. Отданную и влитую работу страж не судит: она уже дождалась чужого шага.
+- **Снятая папка задачи снимает требование состояния, а ход не кончает.** Ход работы уезжает
+  вместе с папкой, а папка разбирается до открытия заявки: с этой минуты и до слияния строки
+  состояния нет вовсе, и первый признак стражу взять неоткуда. Отпускать по этому признаку ход
+  нельзя — снятая папка означает середину отдачи, а не её конец: между уборкой и заявкой работу
+  не видит никто, кроме того, кто её сделал. Дальше ход судится вторым признаком, как всякий
+  другой; ход, в котором заявку открыли или прочитали, второй признак пропускает сам. Прежде
+  страж выходил здесь молча — и ход, которому до отдачи оставался один шаг, закрывался пустым.
 - **Работа без ветки и без папки задачи судится тем же стражем по второму признаку.** Состояния
   у неё нет, и первый признак взять неоткуда, — но ход, в котором не было ни одной правки
   дерева, не кончается и здесь. Раньше страж отпускал такую работу молча, и защищена она была
@@ -125,6 +132,13 @@ flowchart TD
   годится: состояние дерева меняется, и вчерашний вывод о нынешнем молчит. Восемь разборов
   подряд пришлись на этот промах, и каждый раз в правило дописывалась ещё одна статья —
   держит его теперь машина.
+- **Гард утверждения ждёт текст ответа, а не судит запись, какой застал.** Текст ложится в
+  запись хода не раньше, чем хост зовёт хук, и гард, прочитавший файл первым, видит ход, в
+  котором владельцу не сказано ничего. Молчит он при этом честно — и снаружи неотличим от гарда,
+  который посмотрел и пропустил: одним таким ходом мимо прошли сразу трое. Не дождавшись текста,
+  гард возвращает ход: пустая запись означает не «сказать было нечего», а «прочитать нечего».
+  Отказ этот принадлежит одному гарду: печатай своё решение все трое, вывод перестал бы
+  разбираться целиком.
 - **Слово-утверждение гард ловит, неверный вывод — нет.** Об образце, судимом по одному его
   файлу, и о пути, которым человек не пойдёт, судить нечем: там нет ни слова, ни команды, с
   которой сверять. Это известная граница гарда, и держат её статьи ниже, а не он.
@@ -136,6 +150,17 @@ flowchart TD
   и отбивал бы работу вместо промаха, а вывод команды о прогоне в записи хода уже лежит. Слова
   «беру следующую задачу» гард действием не считает — ровно потому, что их и произносят вместо
   неё.
+- **Ход, отдавший работу, доводит её до снятого черновика.** Черновик читается владельцем как
+  «работа не кончена»: кнопка слияния у него заблокирована самим хостингом, а по списку заявок
+  готовое от недоделанного не отличить — серое и там и там. Следующая задача берётся сверх этого,
+  а не вместо: требование взять её исполняется буквально и оставляет отданное невидимым. Две
+  готовые заявки простояли так, пока владелец не вернул исполнителя сам. Стережёт это гард
+  ожидания: ход, открывший заявку, не кончается, пока состояние отданной работы не спрошено
+  командой того же хода.
+- **«Жду прогона» — утверждение о чужом шаге, а не состояние работы.** Прогон бывает зелёным
+  час, а бывает не встав вовсе — и второе само не чинится. Слово это требует команды того же
+  хода, которая прогон показывает, и без неё не говорится: сказанное без команды владелец читает
+  как «работа ещё идёт» и ждёт напрасно. Держит это гард утверждения, а не память исполнителя.
 - **Конец прогона узнаётся возвратом фоновой команды, а не взглядом на страницу.** Ожидание,
   запущенное в фоне отдельным ходом, возвращает исполнителя к PR само; до тех пор ход занят
   следующей задачей. Взгляд на страницу этого не даёт: он либо повторяется вхолостую, либо не
@@ -164,6 +189,14 @@ flowchart TD
   читается как работа — тем полнее, чем аккуратнее он составлен: он пронумерован, в нём названы
   цифры, и именно поэтому пустота хода за ним не видна. Владельцу называется, что уже сделано и
   что осталось за его словом, — а не выбор из вариантов вместо и того и другого.
+- **Признак необратимости берётся из списка, а не выводится доводом.** Список составлен тем, кто
+  обратимость уже взвесил: необратимое в нём осталось, обратимое из него снято. Довод «действие
+  уходит наружу и не откатывается» приходит в контекст всегда, а список — только когда его
+  прочитали, и применённый поверх списка довод отменяет список целиком. Отменяет молча: со
+  стороны это выглядит осторожностью, а не пропуском шага. Действия, которого в списке нет,
+  исполнитель на слово владельца не гейтит, даже если оно уходит наружу. Шаг, снятый из списка
+  разбором прошлого промаха, тем более: довод, которым его туда возвращают, уже разобран и
+  отклонён — и дважды подряд готовая работа вставала перед снятым шагом.
 - **Ход, в котором исполнитель признал промах, не заканчивается, пока записи о происшествии
   нет.** Отбивает гард происшествия — на завершении хода: к моменту признания промах уже
   случился, и ловить раньше нечего. Признание ловится набором образцов, а не пониманием смысла;

package/assets/skills/agent-kit.md

@@ -9,6 +9,9 @@ description: Переносимый слой правил агента — за
 настраивает надстройками. Разложенный файл несёт шапку и правке не подлежит — правится либо
 пакет, либо надстройка.
 
+**Холодная часть:** `pitfalls.md` рядом — ловушки, грабли, на которые уже наступали. Грузится по
+требованию, а не вместе со скилом.
+
 ## Когда брать
 
 - В файле, который собираешься править, стоит шапка
@@ -44,6 +47,20 @@ description: Переносимый слой правил агента — за
 разложенного хуже целого. Правится либо надстройка здесь, либо сам ресурс — а это работа того
 дерева, где пакет живёт исходниками, и здесь о ней не сказано ничего.
 
+**Держит это гард места правки, а не память.** Правку файла с шапкой раскладки он отбивает в
+минуту правки и называет адрес: источник, если дерево его держит, иначе надстройку. Прежде об
+этом знал один `sync --check`, и говорил он на следующей раскладке — то есть в чужой ветке и
+чужим ходом: отказ приходил тому, кто в этот день правил соседний ресурс. Правит копию не
+только рука: форматтер дерева, дошедший до разложенного файла, переписывает его по-своему, и
+раскладка читает это ровно как правку руками. Снятие копии гард пропускает: снятый файл
+раскладка кладёт заново, и так эту поломку и чинят.
+
+**Надстройка правится по разделу, а не кладётся целиком.** Разделы в неё дописывают разные ветки
+и разные заходы, и положенная целиком она уносит все, которых эта правка не касалась: на их место
+молча возвращается пакетный текст, раскладка после этого сходится, а сказанного деревом о себе
+больше нет. Держит это второй гард — он отбивает запись поверх непустой надстройки и называет
+размер того, что затрут: строки и число разделов. Дописывание в конец и правка по месту проходят.
+
 ## Команды
 
 ```bash
@@ -103,13 +120,24 @@ npx agent-kit propose       # отправить груз в приём: сво
 сам агент: до неё такое слово адреса не получало вовсе и умирало вместе с сессией. Оба пути
 пишут в один файл дня и в одной форме; в сеть не ходит ни один — увозит их отправка.
 
-Каждая запись несёт три строки: **место** — куда правка встаёт в ресурсе, **повод** — что пошло
-не так без неё, и **чем закрывается** — какие надстройки и добавки этого дерева снимаются, когда
-правка приедет редакцией пакета. Третья пишется затем, что предложение уезжает наружу, а
+Каждая запись несёт четыре строки: **место** — куда правка встаёт в ресурсе, **повод** — что
+пошло не так без неё, **ближайшее** — точная цитата той строки ресурса, к которой это ближе
+всего, и чего она не покрывает, и **чем закрывается** — какие надстройки и добавки этого дерева
+снимаются, когда правка приедет редакцией пакета.
+
+Третья строка — единственная, которую проверяет машина: цитата ищется в ресурсе, и ненайденная
+отбивает блок. Ближайшего нет вовсе — так и пишется: «нет». Стоит она затем, чтобы ресурс был
+прочитан: разбор происшествия кончается предложением дописать статью в тот же ресурс, который
+промах уже описывал, и вторая статья о том же дороже, чем её отсутствие. Похожесть текстов сюда
+не годится — замер показал, что законное соседство двух статей одного правила и законный перенос
+удачной статьи на соседнее место дают одно и то же число. Отбитый блок остаётся лежать с
+отметкой «отбито» и причиной: видно, что разбор был, и видно, почему он не стал правкой.
+
+Четвёртая пишется затем, что предложение уезжает наружу, а
 надстройка остаётся лежать здесь: без неё дерево не может сказать, какие из его надстроек
 исправленная редакция закрыла, — снять наугад страшно, оставить дёшево, и надстройка остаётся
 навсегда, молча замещая исправленный раздел пакета. Снимать нечего — так и пишется; пустой
-третья строка не бывает.
+четвёртая строка не бывает.
 
 Каждому предложению ставится адрес: «пакет», «компаньон» или «дерево». Выгружаются они файлом в `.claude/rt-kit/proposals/`
 (форма — шаблон `proposal.md`), а `agent-kit propose` увозит в приём те, что адресованы
@@ -205,76 +233,3 @@ npx agent-kit propose       # отправить груз в приём: сво
 - **Выключение живёт в настройке дерева, а не в настройке агента.** Строка, вырезанная из
   настроек агента руками, теряется на первой же правке того файла, и вернуть роль будет нечем.
   Здесь оно объявлено в одном месте и видно всякому, кто читает настройку дерева.
-
-## Ловушки
-
-- **Набор, проверяющий гард, читает настройку того дерева, из которого его запустили.** Помощник
-  берёт настройку по каталогу проекта, а его агент выставляет своим — и `cd` в прогонщике этого
-  не перебивает. Набор, не заведший своего одноразового дерева, зеленеет от строки в чужой
-  настройке: шесть сценариев гарда экзамена прошли ровно так, потому что роль была выключена в
-  дереве, где их гоняли. Своё дерево объявляется на каждый сценарий, а не один раз на файл.
-
-- **Надстройка замещает раздел целиком, и пакетные пункты в нём приходится держать копией.**
-  Дописать в раздел одну статью нечем: слияние идёт по заголовку `## `. Дерево, которому нужен
-  один свой пункт, копирует к нему все пакетные — и с этого дня правка любого из них,
-  приехавшая с новой версией, до этого дерева не доходит. Сверка разложенного молчит: она
-  считает расхождением правку на месте, а не замещённый раздел. Признак виден по самим
-  надстройкам — три из трёх прочитанных кончались абзацем о том, что перенос придётся делать
-  руками. Поэтому надстройкой берут раздел, у которого пакетных пунктов немного, а разросшийся
-  замещённый раздел — повод внести своё в пакет, а не держать его копией. Предложение, которым
-  своё вносят, называет эту надстройку строкой «чем закрывается»: иначе приехавшая редакция и
-  надстройка, которую она закрыла, не сопоставляются ничем, и надстройка остаётся замещать уже
-  исправленный раздел.
-
-- **Готовый код пакета не называет имён одного дерева.** Префикс директив кита, ключи подписей
-  и имена сущностей принадлежат тому дереву, где паттерн писали; разложенные в соседнем, они
-  учат звать то, чего там нет вовсе. Имя директивы при этом отличается от имени в примере: по
-  примеру видно, что он пример, а `<префикс>TableRow` из чужого дерева выглядит рабочим кодом
-  и правится только после того, как продовая сборка упадёт. Тринадцать таких имён простояли в
-  четырёх ресурсах пакета, пока их не нашёл потребитель — и не своей сборкой, а надстройкой,
-  которой перекрыл раздел.
-
-- **Правила и паттерны при отвергнутом законе в отказе не перечисляются.** Их снимает каскад, а
-  строка на них становится выводимой: раскладка называет её лишней вместе с законом, из-за
-  которого она перестала снимать. Отказ мерит слой законов, а не число файлов в пакете.
-
-- **Линтер по следам правки судит файл целиком, а не внесённую правку.** Импорт, добавленный
-  отдельным шагом, отбивается как неиспользуемый ещё до того, как появится строка, которая его
-  зовёт, и работа встаёт на половине. Правка делается одним вызовом либо в порядке «сначала
-  использование, потом импорт».
-- **Прогонять сценарии гардов можно, ничего не раскладывая.** Обвязка набора принимает каталог
-  гардов переменной, и пакетную редакцию гоняют по сценариям дерева до установки. Заход,
-  потраченный на диагноз по последствиям, стоил ровно этой строки.
-- **Отбитая правка не всегда про текст гарда.** Гард зовут по пути, и файл без права на
-  запуск отвечает отказом доступа — ненулевым кодом, который читается как «правка отбита».
-  Набор при этом отбивает подряд всё, включая сборку и тесты, и причины не называет.
-- **Правка shell-скрипта заменой по шаблону сверяется `bash -n` сразу.** Замена границ
-  конструкции не видит: `case` теряет свою `esac`, файл остаётся синтаксически неверным, а
-  гард с ошибкой синтаксиса отвечает ненулевым кодом — то есть «правка отбита». Два раза за
-  заход, и оба раза это выглядело дефектом самого гарда.
-- **Гард, подписанный не на то, что объявляет, выглядит работающим.** Событие и образец вызова
-  гард несёт сам, строкой `# rt-hook:`, а зовёт его образец в настройке агента — и эти двое
-  расходятся молча: путь гарда в настройке назван, файл разложен, набор сценариев зелёный.
-  Набор тут ничего не ловит намеренно — он зовёт гард напрямую с подставленным вводом и
-  объявления не читает вовсе. Так гейт правил и разбирал вызовы браузера веткой, которая не
-  исполнялась ни разу. Расхождение находит сверка раскладки: она сравнивает объявленный образец
-  с тем, под которым гард стоит, называет обе стороны и идёт в счёт расхождений. Правится
-  настройка, а верное значение лежит в гарде — тело его разбирает то, что объявлено.
-- **Разложенный файл узнаётся по шапке, а не по каталогу.** Раскладка ложится в те же
-  `tools/`, `.claude/hooks/` и `.claude/skills/`, где лежит своё, поэтому карта гейта,
-  написанная по путям, требует под него доменное правило — а оно уводит править файл на месте.
-  Правка на месте теряется на следующей раскладке, и до тех пор выглядит применённой. Ветка по
-  шапке ставится в карте первой и решает раньше путей.
-- **Настройки проверок сливаются по ключам, а списки — замещаются.** Объект `checks.json`
-  ложится поверх умолчания ключ за ключом на любой глубине: назвав один ключ борды, дерево не
-  теряет соседних. Список приходит целиком — назвав корни исходников, дерево получает ровно
-  названное, а не умолчание вместе со своим: «дописать в список» и «убрать из списка» в этой
-  записи неразличимы.
-- **Утверждение правила переезжает вместе с кодом.** Вынесенное в надстройку перестаёт
-  находиться по прежнему символу, и привязка в спутнике правила врёт молча — сверка спеков
-  ловит это, но только если её позвать.
-- **Признак по подстроке пути судит и то, что лежит вне дерева.** Гарды отдают в профиль
-  абсолютный путь целиком, и образец вида `*/projects/*` совпадает с домашним каталогом агента
-  ровно так же, как с кодом дерева: запись в файл вне репозитория была отбита гардом хода
-  работы с требованием замысла, к ней не относящегося. Путь в профиле сначала приводится к
-  корню дерева, и всё, что вне корня, признака не получает.

package/assets/templates/proposal.md

@@ -22,13 +22,26 @@
 имени: файл уезжает в чужой репозиторий целиком. Найденный адрес дерева отбивает отправку с
 номером строки — это проверка, а не напоминание.
 
-Строк при заголовке три, и все три обязательны:
+Строк при заголовке четыре, и все четыре обязательны:
 
     место          — куда правка встаёт в ресурсе
     повод          — что пошло не так без неё
+    ближайшее      — точная цитата той строки ресурса, к которой это ближе всего, и чего она не
+                      покрывает; ближайшего нет вовсе — так и пишется: «нет»
     чем закрывается — какие надстройки и добавки этого дерева снимаются, когда правка приедет
                       редакцией пакета
 
+Третья строка — единственная, которую машина проверяет: цитата ищется в ресурсе, и ненайденная
+отбивает блок. Написана она затем, чтобы ресурс был прочитан. Разбор происшествия кончается
+предложением дописать статью в тот же ресурс, который промах уже описывал, — и снаружи такой
+разбор неотличим от разбора, кончившегося исправлением. Мерить похожесть текстов пробовали
+замером: законное соседство двух статей одного правила даёт 0.345 общих значимых слов, а
+законный перенос удачной статьи на соседнее место — 0.355, и порога между ними нет. Названная
+цитата судится фактом: она в ресурсе либо есть, либо её там нет.
+
+Отбитый блок не пропадает: он остаётся лежать с отметкой «отбито» и причиной. Видно, что разбор
+был, и видно, почему он не стал правкой.
+
 Третья пишется затем, что предложение уезжает наружу, а надстройка, ради которой оно написано,
 остаётся лежать в дереве, и связи между ними нет никакой. Пакет выпускает исправленную редакцию
 — и сказать, какие надстройки она закрыла, дереву нечем: имя ресурса совпадает у десятка
@@ -45,6 +58,7 @@
 
 - **место:** раздел «<заголовок>», в конец
 - **повод:** что в этой задаче пошло не так без этого правила
+- **ближайшее:** «<точная строка правила, к которой это ближе всего>» — <чего она не покрывает>
 - **чем закрывается:** `.claude/rt-kit/overrides/rules/<правило>.md`, раздел «<заголовок>» —
   снимается целиком, когда правка приедет редакцией пакета
 
@@ -55,6 +69,7 @@
 
 - **место:** ветка `edit`, рядом с соседним родом файлов
 - **повод:** свой род файлов, которого у других деревьев нет
+- **ближайшее:** нет — про этот род файлов карта не говорит вовсе
 - **чем закрывается:** ничего, надстройки под это нет — правка и есть надстройка
 
 > Готовый текст правки.

package/lib/proposals.d.ts

@@ -11,6 +11,8 @@ export interface IProposal {
     readonly body: string;
     /** Ссылка на заведённую запись; пусто — не отправлялось. */
     readonly sent: string;
+    /** Поле ближайшего утверждения, как его написали; пусто — поля нет вовсе. */
+    readonly nearest: string;
     /** Файл, в котором блок лежит, путём от корня дерева. */
     readonly file: string;
     /** Строка заголовка в файле, считая с единицы. */
@@ -43,6 +45,8 @@ export declare function leaksIn(text: string, marks: readonly string[]): readonl
  * встречается чаще, чем путь целиком.
  */
 export declare function marksOf(root: string, remote: string): readonly string[];
+/** Почему блок не уезжает; пустая строка — уезжает. */
+export declare function nearestMissing(proposal: IProposal, assetsDir: string): string;
 /**
  * Пометка об отправке дописывается в блок, а не в конец файла: блоков в файле несколько.
  *
@@ -52,5 +56,5 @@ export declare function marksOf(root: string, remote: string): readonly string[]
  * пятая — на четыре, то есть посреди готового текста правки, а последнему блоку её не достаётся
  * вовсе, и при следующей отправке он уезжает вторым разом.
  */
-export declare function markSent(text: string, proposal: IProposal, url: string): string;
+export declare function markSent(text: string, proposal: IProposal, url: string, field?: string): string;
 //# sourceMappingURL=proposals.d.ts.map

package/lib/proposals.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"proposals.d.ts","sourceRoot":"","sources":["../../../projects/agent-kit/src/lib/proposals.ts"],"names":[],"mappings":"AAeA,mEAAmE;AACnE,eAAO,MAAM,aAAa,EAAE,MAAmC,CAAC;AAEhE,yEAAyE;AACzE,eAAO,MAAM,UAAU,EAAE,MAAgB,CAAC;AAC1C,eAAO,MAAM,YAAY,EAAE,MAAoB,CAAC;AAChD,eAAO,MAAM,OAAO,EAAE,MAAiB,CAAC;AAqCxC,MAAM,WAAW,SAAS;IACtB,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,8DAA8D;IAC9D,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,4DAA4D;IAC5D,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,yDAAyD;IACzD,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,kDAAkD;IAClD,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;CACzB;AAED;;;;;GAKG;AACH,wBAAgB,cAAc,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,SAAS,SAAS,EAAE,CAgC/E;AAED,oDAAoD;AACpD,wBAAgB,aAAa,CAAC,IAAI,EAAE,MAAM,GAAG,SAAS,SAAS,EAAE,CAUhE;AAED,MAAM,WAAW,KAAK;IAClB,mDAAmD;IACnD,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;CACxB;AAKD;;;;;GAKG;AACH,wBAAgB,OAAO,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,SAAS,MAAM,EAAE,GAAG,SAAS,KAAK,EAAE,CAgBhF;AAED;;;GAGG;AACH,wBAAgB,OAAO,CAAC,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,SAAS,MAAM,EAAE,CAIvE;AAED;;;;;;;;GAQG;AACH,wBAAgB,QAAQ,CAAC,IAAI,EAAE,MAAM,EAAE,QAAQ,EAAE,SAAS,EAAE,GAAG,EAAE,MAAM,GAAG,MAAM,CAQ/E"}
+{"version":3,"file":"proposals.d.ts","sourceRoot":"","sources":["../../../projects/agent-kit/src/lib/proposals.ts"],"names":[],"mappings":"AAeA,mEAAmE;AACnE,eAAO,MAAM,aAAa,EAAE,MAAmC,CAAC;AAEhE,yEAAyE;AACzE,eAAO,MAAM,UAAU,EAAE,MAAgB,CAAC;AAC1C,eAAO,MAAM,YAAY,EAAE,MAAoB,CAAC;AAChD,eAAO,MAAM,OAAO,EAAE,MAAiB,CAAC;AA2ExC,MAAM,WAAW,SAAS;IACtB,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,8DAA8D;IAC9D,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,4DAA4D;IAC5D,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,6EAA6E;IAC7E,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,yDAAyD;IACzD,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,kDAAkD;IAClD,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;CACzB;AAED;;;;;GAKG;AACH,wBAAgB,cAAc,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,SAAS,SAAS,EAAE,CAwC/E;AAED,oDAAoD;AACpD,wBAAgB,aAAa,CAAC,IAAI,EAAE,MAAM,GAAG,SAAS,SAAS,EAAE,CAUhE;AAED,MAAM,WAAW,KAAK;IAClB,mDAAmD;IACnD,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;CACxB;AAKD;;;;;GAKG;AACH,wBAAgB,OAAO,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,SAAS,MAAM,EAAE,GAAG,SAAS,KAAK,EAAE,CAgBhF;AAED;;;GAGG;AACH,wBAAgB,OAAO,CAAC,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,SAAS,MAAM,EAAE,CAIvE;AAOD,uDAAuD;AACvD,wBAAgB,cAAc,CAAC,QAAQ,EAAE,SAAS,EAAE,SAAS,EAAE,MAAM,GAAG,MAAM,CAuB7E;AAED;;;;;;;;GAQG;AACH,wBAAgB,QAAQ,CAAC,IAAI,EAAE,MAAM,EAAE,QAAQ,EAAE,SAAS,EAAE,GAAG,EAAE,MAAM,EAAE,KAAK,GAAE,MAAqB,GAAG,MAAM,CAU7G"}

package/lib/proposals.js

@@ -39,7 +39,40 @@ function headingOf(line) {
     return address && !address.includes(' ') && resource ? { address, resource } : null;
 }
 /** Пометка об отправке. По ней же предложение узнаётся отправленным. */
-const SENT = /^-\s+\*\*отправлено:\*\*\s*(\S+)/m;
+const SENT = /^- +\*\*отправлено:\*\* *(\S+)/m;
+/**
+ * Поле ближайшего утверждения: точная цитата строки ресурса, к которой блок относится, — либо
+ * слово о том, что ближайшего нет вовсе.
+ *
+ * Поле обязательно, и обязательно оно затем, чтобы ресурс был прочитан. Мерить похожесть текстов
+ * пробовали замером: законное соседство двух статей одного правила дало 0.345 общих значимых
+ * слов, а законный перенос удачной статьи на соседнее место — 0.355. Порога между ними нет, и
+ * назначенный наугад он отбивал бы правки вместо повторов. Названная цитата судится фактом: она
+ * в ресурсе либо есть, либо её там нет.
+ */
+const NEAREST = /^- +\*\*ближайшее:\*\* *([^\n]+)/m;
+/**
+ * Слово о том, что ближайшего утверждения в ресурсе нет: цитировать нечего.
+ *
+ * Конец слова здесь проверяется отрицательным просмотром, а не границей слова: границу движок
+ * считает по латинице и цифрам, и между «т» и пробелом её нет вовсе — образец с `\b` не совпал
+ * бы ни с одним русским словом.
+ */
+const NOTHING_NEAR = /^нет(?![а-яё])/i;
+/**
+ * Цитата ближайшего утверждения: кавычки-ёлочки, как в остальных текстах дерева.
+ *
+ * Ищется позициями, а не образцом: образец на «открыть, набрать не-закрывающих, закрыть» линтер
+ * отбивает как ветвящийся, и поводы у него есть — строка без закрывающей кавычки перебирается им
+ * до конца.
+ */
+function quotedIn(text) {
+    const from = text.indexOf('«');
+    const to = from < 0 ? -1 : text.indexOf('»', from + 1);
+    return from >= 0 && to > from ? text.slice(from + 1, to) : '';
+}
+/** Пометка любого рода: по ней считается сдвиг, когда в файл вставляют ещё одну. */
+const MARKED = /^- +\*\*(отправлено|отбито):\*\*/m;
 /**
  * Блоки файла предложений.
  *
@@ -61,7 +94,15 @@ export function parseProposals(text, file) {
             .trim();
         const { address, resource } = heading;
         if (ADDRESSES.includes(address) && !resource.includes('<')) {
-            found.push({ address, resource, body, file, sent: SENT.exec(body)?.[1] ?? '', line: at + 1 });
+            found.push({
+                address,
+                resource,
+                body,
+                file,
+                sent: SENT.exec(body)?.[1] ?? '',
+                nearest: (NEAREST.exec(body)?.[1] ?? '').trim(),
+                line: at + 1,
+            });
         }
         at = -1;
     };
@@ -117,6 +158,32 @@ export function marksOf(root, remote) {
     const name = basename(root);
     return [root, name, remote].filter(Boolean);
 }
+/** Один пробел вместо любой пробельной вереницы: цитата в блоке перенесена по своей ширине. */
+function flat(text) {
+    return text.replace(/\s+/g, ' ').trim();
+}
+/** Почему блок не уезжает; пустая строка — уезжает. */
+export function nearestMissing(proposal, assetsDir) {
+    if (!proposal.nearest) {
+        return 'поля «ближайшее» нет: назови точную строку ресурса, к которой это относится, и то, чего она не покрывает, — либо напиши «нет»';
+    }
+    if (NOTHING_NEAR.test(proposal.nearest)) {
+        return '';
+    }
+    const quoted = quotedIn(proposal.nearest);
+    if (!quoted) {
+        return 'ближайшее названо без цитаты: строка ресурса приводится в кавычках-ёлочках дословно — иначе проверить нечего';
+    }
+    const path = join(assetsDir, proposal.resource);
+    if (!existsSync(path)) {
+        // Ресурса у этого дерева нет — сверять не с чем, и отбивать нечего: блок про ресурс,
+        // которого пакет здесь не держит, судится на приёмной стороне.
+        return '';
+    }
+    return flat(readFileSync(path, 'utf8')).includes(flat(quoted))
+        ? ''
+        : `цитаты нет в «${proposal.resource}»: ${flat(quoted).slice(0, 60)}… — либо ресурс не читали, либо утверждение переписано с тех пор`;
+}
 /**
  * Пометка об отправке дописывается в блок, а не в конец файла: блоков в файле несколько.
  *
@@ -126,12 +193,14 @@ export function marksOf(root, remote) {
  * пятая — на четыре, то есть посреди готового текста правки, а последнему блоку её не достаётся
  * вовсе, и при следующей отправке он уезжает вторым разом.
  */
-export function markSent(text, proposal, url) {
+export function markSent(text, proposal, url, field = 'отправлено') {
     const lines = text.split('\n');
-    const shift = lines.slice(0, proposal.line).filter((line) => SENT.test(line)).length;
+    // Сдвиг считает пометки обоих родов: отбитый блок получает свою, и следующая за ним встала бы
+    // строкой выше своего места, если бы её не посчитали.
+    const shift = lines.slice(0, proposal.line).filter((line) => MARKED.test(line)).length;
     // Пометка встаёт сразу под заголовок: конец блока определяется следующим заголовком, а его
     // может и не быть — тогда «конец» пришлось бы искать по пустым строкам в хвосте файла.
-    lines.splice(proposal.line + shift, 0, `- **отправлено:** ${url}`);
+    lines.splice(proposal.line + shift, 0, `- **${field}:** ${url}`);
     return lines.join('\n');
 }
 //# sourceMappingURL=proposals.js.map