@rt-tools/agent-kit 0.11.0 → 0.13.0

package/assets/rules/turn-conduct.md

@@ -0,0 +1,210 @@
+---
+name: turn-conduct
+kind: rule
+law: work-conduct
+description: Правило под «Закон о ведении работы» — та его часть, что про один ход. Брать, когда ход заканчивают: чем он кончается и что его концом не бывает, что говорится владельцу о чужом шаге, чем подтверждается утверждение о дереве, что делает страж выходов хода, гард ожидания, гард разговора и гард происшествия, как закрывается заход по заполнению окна. Готовый порядок — в паттерне task-flow-handoff. Ход работы от просьбы владельца до слияния — правило task-flow.
+---
+
+# Ход захода — как это устроено здесь
+
+Правило под закон `docs/constitution/work-conduct.md` — та его часть, что про один ход.
+Закон говорит, что должно быть верно; здесь — чем это стережётся в этом дереве. Ход работы
+от просьбы владельца до слияния, состояния работы и папка задачи — правило `task-flow`
+под тем же законом.
+
+## Как это называется здесь
+
+| В законе                         | Здесь                                                                                          |
+| -------------------------------- | ----------------------------------------------------------------------------------------------- |
+| ход                              | один заход агента: от реплики владельца до ответа ему                                          |
+| выход хода                       | один из четырёх способов кончить ход; чем подтверждается каждый — карта хода                   |
+| страж выходов хода               | гард на завершении хода: читает объявленное состояние работы и то, что за ход сделано в дереве |
+| утверждение о состоянии дерева   | слово ответа владельцу, за которым обязана стоять команда того же хода и её вывод              |
+| передача захода                  | запись вне дерева: она пересказывает ход работы для вставки в новый заход                      |
+| порог сжатия и порог остановки   | два числа заполнения окна; дерево задаёт их само, и первый стоит ниже второго                  |
+
+## Выходы хода
+
+Ход кончается четырьмя способами, и других нет: вопрос владельцу, ответа на который в правилах
+нет; отказ гарда; заполненное окно там, где сжатия нет; отданная работа, за которой начата
+следующая. Чем подтверждается каждый из четырёх, перечисляет карта хода — там, где дерево её
+разложило.
+
+Всё остальное — продолжение хода, а не его конец. Веха ходом не кончается: ни коммит, ни
+прочитанная договорённость, ни граница «прочитал — сейчас правлю», ни зелёная проверка.
+Переход из состояния в состояние — тем более: обязательное действие сделано, и следующее
+делается тем же ходом, а граница состояния выглядит законченным куском лучше всякой другой вехи,
+и отчёт встаёт ровно туда, где должно было стоять следующее действие.
+
+Четыре способа кончить ход выглядят работой и ею не являются: сводка о чужом шаге, меню при
+назначенном порядке, объявление намерения и названная, но не запущенная команда. Что при этом
+должно быть верно — ниже, в статьях о применении закона.
+
+## Где это лежит
+
+В этом дереве — таблица в `implementation.md` рядом. Пути живут там, а не здесь: правило
+переносится между репозиториями, раскладка — нет, и путь, названный в правиле, врёт в первом
+же дереве, которое держит код иначе.
+
+## Ход
+
+Ход одного захода: чем он кончается, что проверяется до его конца и что при этом говорится
+владельцу.
+
+```mermaid
+flowchart TD
+    A[Ход идёт] --> B{Что случилось}
+    B -->|Владельцу задан вопрос| C[За тот же ход читались законы и правила]
+    B -->|Гард отбил правку| D[Отказ назван владельцу, обход не искался]
+    B -->|Окно захода заполнено| E{Дерево объявило сжатие}
+    B -->|Работа отдана заявкой| F[По следующей задаче сделано действие, а не сказано]
+    B -->|Ничего из этого| G[Ход продолжается: веха его концом не бывает]
+    E -->|Да| G
+    E -->|Нет| H[Ход работы дописан, передача написана]
+    C --> I{Ответ владельцу говорит о дереве}
+    D --> I
+    F --> I
+    H --> I
+    I -->|Да| J[Каждое слово несёт команду того же хода и её вывод]
+    I -->|Нет| K[Ход кончен]
+    J --> K
+    G --> A
+```
+
+## Как закон применяется здесь
+
+- **Сводка о чужом шаге.** Прогон, разбор владельцем и слияние идут без исполнителя и от взгляда
+  быстрее не становятся. Ход, кончившийся такой сводкой, владелец читает как работу: она полна,
+  в ней названы номера и состояния, и пустоты за ней не видно. О чужом шаге говорят вместе с
+  начатым своим, а не вместо него. За один заход это было нарушено четырежды, и готовая работа
+  простояла в невлитом PR почти три часа.
+- **Меню при назначенном порядке.** Выбор, предложенный владельцу, пока эпик не кончился, — это
+  просьба назначить порядок заново. Работы в эпике не осталось — так и говорится: эпик
+  кончился, — а не «чем займёмся».
+- **Объявление намерения.** «Беру следующую задачу» — не то же самое, что взять её: фраза живёт
+  до конца хода, а работа не двигается. Названо может быть только сделанное: номер заведённой
+  задачи, имя заведённой ветки, переведённая колонка.
+- **Названная командой работа запускается в том же ходе, где названа.** Строка «сейчас запущу»
+  ходом не кончается: либо запуск уже был, либо ход не кончен. Названная поимённо команда
+  выглядит начатой работой лучше всякого другого обещания — она точна, её видно, и по ней не
+  отличить сделанного от собранного. Ответ владельцу пишется после вызова, а не вместо него:
+  реплика посреди хода отвечается вместе с начатым действием. Дважды за сутки ход кончился
+  ровно такой строкой, и оба раза владелец возвращал работу сам.
+
+- **Прерывание работы владельцем называется вслух.** Пришло задание, останавливающее начатое, —
+  исполнитель говорит, что стоит, на чём остановлено и что будет с прежней работой, и только
+  потом берётся за новое. Молчание об этом владелец читает как «прежнее кончилось».
+- **Остановка называется отдельной репликой.** Не строкой в конце отчёта: там она тонет —
+  владелец читает отчёт как рассказ о сделанном. Называются три вещи: что стоит, чего оно ждёт
+  и что владелец может решить.
+- **Выходы хода стережёт страж, а не память исполнителя.** Он читает объявленное состояние
+  работы и то, что за ход по ней сделано: правку файла или команду, меняющую дерево. Ход, в
+  котором не было ни того ни другого, возвращается исполнителю вместе со следующим шагом из
+  хода работы. Отданную и влитую работу страж не судит: она уже дождалась чужого шага.
+- **Отданную работу страж узнаёт по истории ветки, когда объявить её на диске уже нечем.** Ход
+  работы уезжает вместе с папкой задачи, а папка разбирается до открытия заявки: с этой минуты
+  и до слияния строки состояния нет вовсе. Судимый вторым признаком, такой ход отбивался бы за
+  ожидание чужого прогона — за то самое, что работой не является и правильно им не считается.
+- **Работа без ветки и без папки задачи судится тем же стражем по второму признаку.** Состояния
+  у неё нет, и первый признак взять неоткуда, — но ход, в котором не было ни одной правки
+  дерева, не кончается и здесь. Раньше страж отпускал такую работу молча, и защищена она была
+  меньше всего: просьба владельца «разложи», «обнови», «посмотри» идёт без задачи и без ветки,
+  и именно она чаще всего кончалась объявлением намерения.
+- **Передача пишется и там, где имени у ветки нет.** Всё, что в неё едет, лежит в дереве и на
+  отсоединённой голове доступно целиком; имя нужно одному файлу, и он называется коротким
+  снимком головы. Молчание хука здесь стоит дороже прочего: сжатие приходит без передачи, и
+  следующий заход начинает с пустого места.
+- **Этап замысла объявляется закрытым только после того, как его команда проверки прошла.**
+  Строка «Чем проверяется» несёт команду обратными кавычками и то, что в её выводе означает
+  «сошлось». Страж читает прежний номер этапа из истории ветки и не выпускает ход, в котором
+  номер вырос, а команда не запускалась: через заход отмеченное по памяти неотличимо от
+  проверенного.
+- **Слово об остановке страж читает у владельца, а не у исполнителя.** Иначе остановку
+  объявляет тот, кому она в эту минуту удобна, и запрет держится ровно до первого неудобства.
+- **Утверждение о состоянии дерева стережёт гард утверждения, а не память исполнителя.** Всё,
+  что ответ владельцу говорит о дереве, несёт команду и её вывод: сказанное без команды
+  утверждением не считается — ни «проверено», ни «снято», ни «готово». Гард читает текст,
+  сказанный владельцу за ход, и ищет команду того же хода; у каждого слова назван свой род
+  команды, потому что общий признак «команда была» подтверждал бы одно другим. Прошлый ход не
+  годится: состояние дерева меняется, и вчерашний вывод о нынешнем молчит. Восемь разборов
+  подряд пришлись на этот промах, и каждый раз в правило дописывалась ещё одна статья —
+  держит его теперь машина.
+- **Слово-утверждение гард ловит, неверный вывод — нет.** Об образце, судимом по одному его
+  файлу, и о пути, которым человек не пойдёт, судить нечем: там нет ни слова, ни команды, с
+  которой сверять. Это известная граница гарда, и держат её статьи ниже, а не он.
+- **Ход о чужом шаге стережёт гард ожидания, а не память исполнителя.** Он отбивает завершение
+  хода, в котором о чужом шаге сказано, а по следующей задаче не сделано ни одного действия —
+  ни заведения задачи, ни ветки, ни папки, ни перевода колонки. Чужой шаг он узнаёт по двум
+  признакам: в ходе открыт PR либо в ходе прочитан красный прогон. Оба берутся из самого хода:
+  спросить хостинг было бы точнее, но сетевой вызов на завершении хода падает вместе со связью
+  и отбивал бы работу вместо промаха, а вывод команды о прогоне в записи хода уже лежит. Слова
+  «беру следующую задачу» гард действием не считает — ровно потому, что их и произносят вместо
+  неё.
+- **Конец прогона узнаётся возвратом фоновой команды, а не взглядом на страницу.** Ожидание,
+  запущенное в фоне отдельным ходом, возвращает исполнителя к PR само; до тех пор ход занят
+  следующей задачей. Взгляд на страницу этого не даёт: он либо повторяется вхолостую, либо не
+  повторяется вовсе, и оба исхода со стороны выглядят одинаково — работа не двигается.
+- **Отказ гарда кончает ход.** Другого пути к отбитой правке не ищут: ни командой оболочки, ни
+  соседним инструментом, ни правкой самого гарда. Отбитая правка либо делается после того, как
+  условие отказа выполнено, либо не делается вовсе — и тогда владельцу называется отказ, а не
+  результат. Обход стоит дороже отказа: гард отбивает один файл, а обойдённый гард снимает
+  требование со всего дерева и молчит об этом. Держится это не только памятью — гарды судят и
+  команду оболочки, которая пишет файл.
+- **Ход, в котором владельцу задан вопрос, не заканчивается, пока за этот же ход не читались
+  законы и правила.** Чтением считается любой из трёх путей: загрузка правила, чтение файла
+  законов или правил, поиск по ним. Отбивает гард разговора — на завершении хода, а не на
+  инструменте вопроса: спрашивают чаще прозой, чем меню. Найденное ложится в раздел «Что уже
+  сказано в правилах» разбора.
+- **Действия, которые исполнитель не делает без слова владельца, перечислены в компаньоне
+  правила.** Список у каждого дерева свой — пакет знает только требование, чтобы список был
+  назван. Не названный, он выводится из общих слов, и «делай, что нужно по плану» становится
+  разрешением на пуш и правку общих документов заодно с коммитом. Оценка «это безопасно» списка
+  не заменяет: её назначает тот, кому она в эту минуту удобна, и она плывёт. За один заход одна
+  и та же команда была сначала слишком опасной, чтобы её позвать, а через два хода —
+  достаточно безопасной, чтобы позвать без спроса.
+- **У отказа от необратимого действия есть безопасная часть, и она делается.** Требование
+  спросить владельца относится к действию, а не к ходу: работа, у которой отделима часть без
+  последствий, делится, а не откладывается целиком. Список вариантов, поданный вместо работы,
+  читается как работа — тем полнее, чем аккуратнее он составлен: он пронумерован, в нём названы
+  цифры, и именно поэтому пустота хода за ним не видна. Владельцу называется, что уже сделано и
+  что осталось за его словом, — а не выбор из вариантов вместо и того и другого.
+- **Ход, в котором исполнитель признал промах, не заканчивается, пока записи о происшествии
+  нет.** Отбивает гард происшествия — на завершении хода: к моменту признания промах уже
+  случился, и ловить раньше нечего. Признание ловится набором образцов, а не пониманием смысла;
+  промах, признанный словами вне набора, гард пропускает, и это его известная граница, а не
+  обещание.
+- **Заход, начатый с передачи, входит в работу тем же правилом, что и всякий другой.** Передача
+  лежит вне дерева, её не читает ни одна проверка, и написана она вчера: всё, что в ней стоит,
+  проверяется деревом. Порядок входа — четыре шага в паттерне возвращения; стережёт его гард, а
+  не память: порядок, записанный только словами, исполняется, пока о нём помнят.
+- **Состояние незаконченной работы приходит в контекст на запуске сессии.** Замысел и ход
+  работы отдаются целиком, разбор просьбы — путём. Ветка вида `<КЛЮЧ>-*` без папки даёт
+  предупреждение с готовой командой, но сессию не рвёт.
+- **Заполненное окно кончает ход только там, где сжатия нет.** Где оно объявлено, окно —
+  продолжение хода: заход сжимается и работает дальше, а порог остановки срабатывает лишь тогда,
+  когда сжатие не пришло.
+- **Заполнение окна захода стережёт гард, а не память исполнителя.** На первом пороге он
+  напоминает выбирать точку остановки, на втором отбивает всё, кроме записи хода работы,
+  передачи и команд поставки. Размер окна и оба порога дерево задаёт само; не задавшее размера
+  стража не получает.
+- **Порог сжатия контекста дерево задаёт само, и стоит он НИЖЕ порога остановки.** Совпавшие
+  пороги согласием не бывают: это гонка, и выигрывает её страж — он стоит на вызове, а сжатие
+  приходит между ходами. Расстояние объявляется числом, а не выводится разницей; сведены пороги
+  или нет, говорит разбор состояния раскладки.
+- **Заход закрывается передачей, которая лежит вне дерева.** Состояние работы коммитится ходом
+  работы, а передача его пересказывает для вставки в новый заход: рабочее дерево, ветка,
+  сделанное, следующий шаг и особенности захода. В историю она не едет — иначе рядом с ходом
+  работы заводится вторая запись об одном и том же.
+
+## Чего из закона здесь нет
+
+Полноту сказанного владельцу не проверяет ничто: гард утверждения ловит слово-утверждение и
+ищет команду того же хода, а неверный вывод из верной команды не судит ничем — об образце,
+судимом по одному его файлу, и о пути, которым человек не пойдёт, сверять нечего.
+
+Признание промаха ловится набором образцов, а не пониманием смысла: промах, признанный
+словами вне набора, гард происшествия пропускает. Это его известная граница, а не обещание.
+
+## Паттерны
+
+- `task-flow-handoff` — закрытие захода по заполнению окна: точка остановки и передача.

package/assets/rules/typescript-conventions.md

@@ -50,15 +50,23 @@ flowchart TD
 
 - **Род объявления виден по префиксу имени, и это держат три правила линтера.** У интерфейса,
   у типа и у перечисления свои; все три подняты для всех `.ts`.
+      <!-- rt-when: *.ts -->
+
 - **Источник, за которым следят, назван суффиксом.** Субъект и наблюдаемое, поднятое из него,
   различаются в месте использования, а не переходом к объявлению.
+      <!-- rt-when: *.ts -->
+
 - **Суффикс имени файла находит в нём обещанное объявление.** Список суффиксов закрыт: слово,
   которого в нём нет, суффиксом не считается, и такой файл правило не судит.
+      <!-- rt-when: *.ts -->
+
 - **Файл не длиннее 500 строк, и считаются все строки — пустые и комментарии тоже.** Файл,
   который не влезает на экран целиком, читают по частям, и правку в нём делают, не увидев
   остального. Для `.ts` это держит правило линтера; файлы обвязки — сценарии и скрипты — до
   него не доходят и судятся отдельной проверкой дерева. Накопленное к дню включения
   перечислено поимённо, и строка оттуда снимается вместе с делением своего файла.
+      <!-- rt-when: *.ts -->
+
 - **Значение из закрытого набора приходит перечислением `E<Имя>`, а не строкой или числом в
   месте использования.** Ключ переводимого поля, имя вкладки, слот обложки, вид записи — всё
   это наборы: их называют форма, стор, разметка и сравнение черновиков, и написанное на месте
@@ -66,14 +74,21 @@ flowchart TD
   домена, чей это набор, а общее нескольким приложениям — в общей либе. Одиночный адрес,
   разделитель и знак-подпись перечислением не становятся: закрытого набора у них нет, и они
   объявляются константой файла с говорящим именем.
+      <!-- rt-when: *.ts -->
+
 - **Тип берётся из того пакета, где объявлен.** Своя копия чужого типа расходится с оригиналом
   молча, а компилируется из них только одна.
+      <!-- rt-when: *.ts -->
+
 - **Двухступенчатое приведение `as unknown as` запрещено правилом линтера.** Вместо него —
   честный тип, сужение проверкой или чтение поля формой (`Reflect.get`); место, где иначе
   нельзя, помечается точечным отключением с причиной в той же строке.
+      <!-- rt-when: *.ts -->
+
 - **Отметка об устаревании ставится вместе с обходом потребителей.** Все правила
   `eslint-plugin-sonarjs` подняты до отказа разом, и пометка на типе красит каждое место, где
   его ещё зовут: один `@deprecated` на файл дал семнадцать замечаний в чужих доменах.
+      <!-- rt-when: *.ts -->
 
 ## Чего из закона здесь нет
 

package/assets/skills/agent-kit.md

@@ -9,6 +9,9 @@ description: Переносимый слой правил агента — за
 настраивает надстройками. Разложенный файл несёт шапку и правке не подлежит — правится либо
 пакет, либо надстройка.
 
+**Холодная часть:** `pitfalls.md` рядом — ловушки, грабли, на которые уже наступали. Грузится по
+требованию, а не вместе со скилом.
+
 ## Когда брать
 
 - В файле, который собираешься править, стоит шапка
@@ -40,9 +43,23 @@ description: Переносимый слой правил агента — за
 
 ## Порядок
 
-Правка ресурса доезжает до дерева только через сборку пакета: строка запуска читает собранное,
-а не исходники ресурсов. Порядок один и тот же всегда — правка, сборка, `sync`. Отказ хотя бы
-по одному файлу не пишет ничего: половина разложенного хуже целого.
+Раскладка кладёт всё или ничего: отказ хотя бы по одному файлу не пишет ничего — половина
+разложенного хуже целого. Правится либо надстройка здесь, либо сам ресурс — а это работа того
+дерева, где пакет живёт исходниками, и здесь о ней не сказано ничего.
+
+**Держит это гард места правки, а не память.** Правку файла с шапкой раскладки он отбивает в
+минуту правки и называет адрес: источник, если дерево его держит, иначе надстройку. Прежде об
+этом знал один `sync --check`, и говорил он на следующей раскладке — то есть в чужой ветке и
+чужим ходом: отказ приходил тому, кто в этот день правил соседний ресурс. Правит копию не
+только рука: форматтер дерева, дошедший до разложенного файла, переписывает его по-своему, и
+раскладка читает это ровно как правку руками. Снятие копии гард пропускает: снятый файл
+раскладка кладёт заново, и так эту поломку и чинят.
+
+**Надстройка правится по разделу, а не кладётся целиком.** Разделы в неё дописывают разные ветки
+и разные заходы, и положенная целиком она уносит все, которых эта правка не касалась: на их место
+молча возвращается пакетный текст, раскладка после этого сходится, а сказанного деревом о себе
+больше нет. Держит это второй гард — он отбивает запись поверх непустой надстройки и называет
+размер того, что затрут: строки и число разделов. Дописывание в конец и правка по месту проходят.
 
 ## Команды
 
@@ -56,13 +73,36 @@ npx agent-kit propose       # отправить груз в приём: сво
 
 Строкой запуска слой правил не исчерпывается: часть его команд исполняет агент, а не программа.
 `/feedback` кладёт слово о правилах блоком в файл предложений, `/skill-curator` разбирает
-закрытую задачу, `/next-session` закрывает заход, `/agent-kit-digest` сводит накопленное в правки
-ресурсов, а `/rules-review` читает семью текстов — закон, его правила и паттерны при них — и ищет
-то, чего не считает ни одна проверка: два текста, говорящих об одном разное, и случай, которого
-не назвал ни один. Две последние зовутся в репозитории самого пакета: они правят его ресурсы и
-судят их исходные тексты.
-Считаемое ловит набор полноты текстов, и он же стоит перед пушем; ответ роли не повторяется от
-запуска к запуску и ветку не отбивает.
+закрытую задачу, `/next-session` закрывает заход.
+
+Команд, которыми правят сам пакет, здесь нет: они зовутся там, где лежат его ресурсы, и вместе
+с ними не едут.
+
+## Что пакет везёт, а что остаётся дереву
+
+Пакет ставят чужие деревья, и везёт он им только то, что они исполняют. Ресурс, у которого в
+чужом дереве нет предмета или некому его позвать, ресурсом пакета не бывает — он живёт своим
+ресурсом того дерева, где предмет есть.
+
+Признак — не оценка, а два вопроса к ресурсу:
+
+| Вопрос                                          | «Нет» означает                                 |
+| ----------------------------------------------- | ---------------------------------------------- |
+| Есть ли у потребителя то, о чём ресурс говорит? | предмета нет: заполнить компаньон нечем        |
+| Есть ли у потребителя кому его позвать?         | исполнителя нет: команда у него не запускается |
+
+Ответ «нет» хотя бы на один — ресурс остаётся дереву, которое пакет пишет.
+
+**Перечень отменяемого границу не закрывает.** Строка в `skip` говорит «мне этого не надо» и
+снимает раскладку у себя; ресурс при этом остаётся в пакете и продолжает ехать всем остальным.
+Убирается он из самого пакета, а не из своей раскладки.
+
+**Своё правило дерева объявляется наравне с пакетным:** та же форма, тот же закон сверху,
+компаньон рядом и своя ветка в карте гейта. Читателю не должно быть видно, чем оно младше.
+
+Что при этом должно быть верно, записано договорённостью в том дереве, которое пакет пишет:
+там же живёт и проверка, которая границу держит. Чужому дереву судить ресурсы пакета нечего,
+поэтому проверка сюда не едет.
 
 ## Обратная связь наверх
 
@@ -80,13 +120,24 @@ npx agent-kit propose       # отправить груз в приём: сво
 сам агент: до неё такое слово адреса не получало вовсе и умирало вместе с сессией. Оба пути
 пишут в один файл дня и в одной форме; в сеть не ходит ни один — увозит их отправка.
 
-Каждая запись несёт три строки: **место** — куда правка встаёт в ресурсе, **повод** — что пошло
-не так без неё, и **чем закрывается** — какие надстройки и добавки этого дерева снимаются, когда
-правка приедет редакцией пакета. Третья пишется затем, что предложение уезжает наружу, а
+Каждая запись несёт четыре строки: **место** — куда правка встаёт в ресурсе, **повод** — что
+пошло не так без неё, **ближайшее** — точная цитата той строки ресурса, к которой это ближе
+всего, и чего она не покрывает, и **чем закрывается** — какие надстройки и добавки этого дерева
+снимаются, когда правка приедет редакцией пакета.
+
+Третья строка — единственная, которую проверяет машина: цитата ищется в ресурсе, и ненайденная
+отбивает блок. Ближайшего нет вовсе — так и пишется: «нет». Стоит она затем, чтобы ресурс был
+прочитан: разбор происшествия кончается предложением дописать статью в тот же ресурс, который
+промах уже описывал, и вторая статья о том же дороже, чем её отсутствие. Похожесть текстов сюда
+не годится — замер показал, что законное соседство двух статей одного правила и законный перенос
+удачной статьи на соседнее место дают одно и то же число. Отбитый блок остаётся лежать с
+отметкой «отбито» и причиной: видно, что разбор был, и видно, почему он не стал правкой.
+
+Четвёртая пишется затем, что предложение уезжает наружу, а
 надстройка остаётся лежать здесь: без неё дерево не может сказать, какие из его надстроек
 исправленная редакция закрыла, — снять наугад страшно, оставить дёшево, и надстройка остаётся
 навсегда, молча замещая исправленный раздел пакета. Снимать нечего — так и пишется; пустой
-третья строка не бывает.
+четвёртая строка не бывает.
 
 Каждому предложению ставится адрес: «пакет», «компаньон» или «дерево». Выгружаются они файлом в `.claude/rt-kit/proposals/`
 (форма — шаблон `proposal.md`), а `agent-kit propose` увозит в приём те, что адресованы
@@ -104,8 +155,8 @@ npx agent-kit propose       # отправить груз в приём: сво
 сколько записей легло и сколько уже лежало. Строка «принято 0, уже лежало 3» означает, что
 нового не уехало ничего.
 
-Разбираются предложения в репозитории самого пакета — командой `/agent-kit-digest`, там же, где
-лежат правимые ресурсы и видно всех потребителей сразу.
+Разбирают их там, где лежат правимые ресурсы и видно всех потребителей сразу, — а сюда
+приезжает ответ приёма о том, сколько записей легло.
 
 **Имя файла предложения в текстах дерева не называется.** Каталог предложений в историю не едет:
 файл лежит на той машине, где его написали, и адрес на него ведёт в пустоту у всех остальных —
@@ -182,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/pitfalls.md

@@ -0,0 +1,10 @@
+# <О чём правило> — холодная часть
+
+Ловушки: грабли, на которые уже наступали. Грузится не вместе с правилом, а по требованию —
+при обычном решении она не нужна, она нужна тому, кто уже наступил.
+
+Правило — `<имя-правила>`; статьи, которыми держится закон, стоят там.
+
+## Ловушки
+
+- **<Грабли, на которые уже наступали.>** <Чем это кончилось.>

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/assets/templates/rule.md

@@ -11,6 +11,9 @@ description: Правило под закон «<Название закона>
 приёмом это делается. Чем это названо в этом дереве и где лежит — `implementation.md` рядом:
 правило переносится между репозиториями, имена — нет.
 
+**Холодная часть:** `pitfalls.md` рядом — <ловушки и поведение по разборам, если они у правила
+есть>. Строка стоит только у правила, которое такой файл завело: у остального её нет вовсе.
+
 ## Как это называется здесь
 
 <Таблица «в законе — здесь»: закон говорит без имён, дерево называет свои. Правка, по которой
@@ -56,6 +59,5 @@ flowchart TD
 
 - `<имя-правила>-<что>` — <когда брать>.
 
-## Ловушки
-
-- **<Грабли, на которые уже наступали.>** <Чем это кончилось.>
+Ловушек здесь нет: они живут в холодной части — `pitfalls.md` рядом, по образцу холодной
+части. Правило кончается паттернами.

package/bin/agent-kit.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"agent-kit.d.ts","sourceRoot":"","sources":["../../../projects/agent-kit/src/bin/agent-kit.ts"],"names":[],"mappings":";AAeA,OAAO,EAAqC,iBAAiB,EAAqB,MAAM,oBAAoB,CAAC;AA4V7G,wBAAsB,IAAI,CAAC,IAAI,EAAE,SAAS,MAAM,EAAE,GAAG,OAAO,CAAC,iBAAiB,CAAC,CAU9E"}
+{"version":3,"file":"agent-kit.d.ts","sourceRoot":"","sources":["../../../projects/agent-kit/src/bin/agent-kit.ts"],"names":[],"mappings":";AAeA,OAAO,EAAqC,iBAAiB,EAAqB,MAAM,oBAAoB,CAAC;AA8S7G,wBAAsB,IAAI,CAAC,IAAI,EAAE,SAAS,MAAM,EAAE,GAAG,OAAO,CAAC,iBAAiB,CAAC,CAU9E"}