@rt-tools/agent-kit 0.8.1 → 0.8.2

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

@@ -21,7 +21,7 @@ description: Правило под «Закон о поставке» для д
 | задача                           | issue проекта, заголовок `[<КЛЮЧ>-<номер>] <Что не так>`, исполнитель — учётная запись машинной работы; MR прикрепляется к нему строкой `Closes #<номер>` в описании                                  |
 | очередь работ                    | доска задач проекта — Issue Board. Задача попадает на неё меткой списка, а не самим фактом заведения: доска показывает те issue, чью метку знает                                                      |
 | состояние задачи в очереди работ | список доски, за которым стоит метка: заведённая, взятая в работу, ждущая разбора. Имена меток — в `implementation.md`; закрытая задача уходит из очереди слиянием, а не переносом в последний список |
-| отчёт о задаче                   | заголовок MR `[<КЛЮЧ>-<номер>] <Что сделано>` — тот же номер, что у задачи, и её название, переведённое в сделанное; тип и область коммита сюда не идут                                               |
+| PR о задаче                      | заголовок MR `[<КЛЮЧ>-<номер>] <Что сделано>` — тот же номер, что у задачи, и её название, переведённое в сделанное; тип и область коммита сюда не идут                                               |
 | обсуждение правки                | разбор MR: ревьювер — владелец проекта, исполнитель — учётная запись машинной работы, метки — те же, что у задачи                                                                                     |
 | попадание правки в главную ветку | слияние MR; оно же запускает выкатку — `.gitlab-ci.yml`                                                                                                                                               |
 | образ того коммита               | `IMAGE_TAG=<sha>` в командах `docker compose` на сервере                                                                                                                                              |
@@ -47,6 +47,11 @@ description: Правило под «Закон о поставке» для д
   вершина главной ветки не стала предком текущей, и называет расхождение числом коммитов. MR с
   разошедшейся ветки показывает ревьюверу свою правку вперемешку с чужой, а всё, что автор
   проверил до публикации, он проверил от основания, которого в главной ветке уже нет.
+- **Заведённая задача подтверждается ответом очереди работ, а не выводом команды заведения.**
+  Команда отвечает за свои вызовы: она может завести задачу и не довести её до доски, и её
+  собственный разбор ошибок этот случай называет. Напечатанный номер значит «вызов прошёл», а не
+  «задача видна тому, кто по ней работает». Спрашивается очередь — по номеру, одним вызовом, — и
+  ответ читается присутствием задачи на доске, её списком и исполнителем.
 - **Номер ветки и номер в заголовке MR сверяются на месте, а состояние задачи — по доске.**
   Формат читается из текста команды и работает без сети; существование задачи, её метка
   списка, исполнитель и то, что она ещё открыта, — только когда есть чем спросить. Нет сети
@@ -56,14 +61,14 @@ description: Правило под «Закон о поставке» для д
   переставляется во взятые в работу, MR открыт — в ждущие разбора; делает это команда
   перевода, а не набор вызовов по памяти. Перевод идёт сразу за шагом, который его вызвал:
   очередь работ читают между шагами, а не после них.
-- **Отставший список находится сверкой очереди, а не глазами.** Сверка судит список по отчёту
+- **Отставший список находится сверкой очереди, а не глазами.** Сверка судит список по PR
   в обе стороны: открытый MR при задаче не в разборе и разбор без открытого MR — оба
   расхождения. Момента, когда задачу берут в работу, ей не видно: ветки на доске нет.
 - **Задачи, чинящиеся одной правкой, сливаются до слияния ветки.** Вторая стирается вместе с
   номером, а недостающее из неё дописывается в первую. После слияния слить уже нельзя: ветка
   въехала, и откатывается она целиком.
 - **Работа, которую одним заходом не закрыть, помечена в двух местах, и они сверяются.** Метка
-  на доске и строка о заходах с передачей в линии работ говорят одно и то же двум читателям:
+  на доске и строка о заходах с передачей в замысле эпика говорят одно и то же двум читателям:
   исполнитель открывает карточку раньше, чем линию, а планирует по линии. Одна пометка без
   другой лжёт молча, поэтому сверка очереди судит пару в обе стороны. Помечается только то, что
   законно не делится: пометка объёма правом делить не становится.
@@ -88,9 +93,9 @@ description: Правило под «Закон о поставке» для д
   там кончается. Прогон команд задания на своей машине его не покрывает: он проверяет команды,
   а не файл конвейера, — верность самого файла читается только по списку конвейеров после
   пуша, и синтаксис отдельно судит проверка `.gitlab-ci.yml` в проекте.
-- **Отчёт проверяется до слияния тем же конвейером, что и главная ветка.** Проверки и сборки
+- **PR проверяется до слияния тем же конвейером, что и главная ветка.** Проверки и сборки
   образов идут на конвейере запроса слияния, выкатка — нет: её держит правило по главной ветке
-  у своего задания, а образ отчёта в реестр не уезжает.
+  у своего задания, а образ PR в реестр не уезжает.
 - **Расхождение прода с главной веткой видно сверкой очереди работ.** Задача уходит из очереди
   слиянием, но слияние — ещё не прод: отказавшая выкатка не трогает ни задачу, ни её список, и
   заметить её неоткуда. Сверка спрашивает последний конвейер главной ветки и судит только
@@ -144,7 +149,7 @@ description: Правило под «Закон о поставке» для д
 
 Гард поставки стоит на командах агента, поэтому ветку, заведённую руками в редакторе, он не
 видит: имя такой ветки держится памятью. Требование от этого не слабеет — просто отдельной
-проверки под него не заводится: работа опознаётся заголовком задачи и отчёта, а это сверяется
+проверки под него не заводится: работа опознаётся заголовком задачи и PR, а это сверяется
 у всех. Сверка очереди имя ветки не судит вовсе: у открытого MR его не переименовать.
 
 Взятие задачи в работу не стережёт ничто: доска ветки не видит, а гард поставки её видит, но
@@ -188,7 +193,7 @@ description: Правило под «Закон о поставке» для д
 - **Учётная запись для пуша и автор MR выбираются отдельно.** Если пушить пришлось из-под другой
   записи, на следующий вызов это не переносится: MR открывают токеном учётной записи машинной
   работы, и от того, чьей записью он открыт, зависит, кого можно назначить ревьювером. Однажды
-  смена записи ради пуша утекла в публикацию — отчёт вышел от владельца.
+  смена записи ради пуша утекла в публикацию — PR вышел от владельца.
 - **Невалидный файл конвейера виден отказом сразу после пуша, а не упавшим заданием.** Конвейер
   на такой файл не заводится вовсе: в списке стоит запись об ошибке разбора, а внутри нет ни
   задания, ни лога. Поэтому список конвейеров ветки смотрится тем же движением, что и пуш —

package/assets/rules/spec-driven.md

@@ -113,6 +113,10 @@ description: Правило под «Закон о документации пр
   паттерны, и поиск по имени правила таких не видит: сверка ищет их полем, человек — разделом
   «Паттерны» самого правила. Счёт паттернов, собранный приставками, выходит меньше настоящего, а
   число потом уезжает в деление работы.
+- **Решение из спека уходит в слой, а не в описание прошлого.** Что сверяется у спека, машина
+  знает; куда девается принятое решение — не знает и не узнает: отличить действующее требование
+  от рассказа о состоявшемся может только тот, кто спросит «останется ли это верным завтра».
+  Держится это шагом разбора закрытой работы и признаком отбора, записанным там заранее.
 - **Якорь сверяется по сырому тексту файла, и комментарий засчитывается наравне с кодом.**
   Существование символа проверка ищет словом по всему файлу, не вычищая комментарии, а живость
   считает только у объявленного в коде. Имя, стоящее в одном лишь пояснении, проходит мимо обеих

package/assets/rules/task-flow.md

@@ -22,7 +22,7 @@ description: Правило под «Закон о ведении работы»
 | замысел                                       | `docs/tasks/<ветка>/plan.md` — след задачи и этапы с признаками готовности; после написания не правится                       |
 | ход работы                                    | `docs/tasks/<ветка>/progress.md` — «Где стоим», решения по ходу, записи заходов; единственное место, где отмечается сделанное |
 | договорённость о продукте, записанная до кода | `docs/specs/<домен>/proposed/<фича>/` — спек фичи; переживает мерж и вливается в спек домена                                  |
-| работа шире одной ветки                       | файл в `docs/plans/`, один на линию работ: порядок задач и зависимости между ними                                             |
+| эпик — работа шире одной ветки                | карточка в очереди работ с меткой эпика и файл замысла рядом: возможность, состав задач и их порядок                          |
 | папка задачи до заведения задачи              | `docs/tasks/_draft-<slug>/` — вне истории, пока номера нет                                                                    |
 | разведка                                      | заход `Explore` или `general-purpose` до первого вопроса владельцу                                                            |
 | разбор замысла ролями                         | `.claude/workflows/plan.js` — нужность, договорённость, критика, замысел                                                      |
@@ -53,6 +53,7 @@ description: Правило под «Закон о ведении работы»
 | 10  | Тексты домена приводятся к сделанному                    | `task-flow-close`   |
 | 11  | Папка задачи разбирается                                 | `task-flow-close`   |
 | 12  | Сверка очереди работ                                     | `task-flow-close`   |
+| 13  | Следующая задача эпика берётся тем же движением          | `task-flow-resume`  |
 
 Шаги 6–8 повторяются, пока этапы замысла не кончатся: первый заход входит в работу шагом 1 и
 доходит до 7, дальше каждый следующий начинается шагом 6. Шаги 9–12 идут один раз, когда работа
@@ -67,17 +68,36 @@ description: Правило под «Закон о ведении работы»
   по имени ветки, `plan.md` в ней и названную в его шапке договорённость о продукте.
 - **Влитая договорённость ветку не запирает.** После вливания директории «предложено» на диске
   нет, а замысел на неё ссылается до конца работы: гард отличает влитое от незаведённого по
-  истории ветки и пропускает первое. Иначе последний коммит отчёта закрывал бы дорогу правкам
+  истории ветки и пропускает первое. Иначе последний коммит PR закрывал бы дорогу правкам
   по замечаниям разбора.
 - **Договорённость требуется по путям правки, а не по оценке задачи.** `apps/**` и `libs/**`
   — признак; правила, тексты, обвязка и зависимости под него не подпадают. Обход — строка
   `**Поведение:** не меняется — <причина владельца>` в замысле; пустая причина не
   принимается.
-- **Гард замысла — нижняя граница, а не признак папки задачи.** Он требует её только под правку
-  кода приложения; нужна ли папка работе, которая туда не доходит, решает число заходов, а не
-  путь. Работа в один заход и один коммит целиком помещается в тело отчёта — так закрывается
-  разбор чужой папки. Работа с этапами и передачей папку заводит: между заходами её состояние
-  не держит ничто, кроме хода работы.
+- **Папка задачи заводится под любую работу, без исключений.** Прежде правило судило по числу
+  заходов: работа в один коммит помещалась в тело PR и папки не заводила. Исключение,
+  у которого есть хоть одна законная форма, исполняется как разрешение — за один заход оно
+  дважды стало поводом обойти отказ гарда, вместо того чтобы завести папку и пойти дальше.
+  Заводится она всегда и до первой правки; сколько заходов уйдёт на работу, заранее не знает
+  никто.
+- **Открыв PR, исполнитель называет владельцу три вещи: номер, чего ждёт и что сделает
+  следом.** Ждёт он прогона — до его конца о работе ничего не известно, кроме того, что она
+  запушена. Следом идёт уборка: разбор папки задачи последним коммитом. Сказанное так владелец
+  читает однозначно, а зелёный прогон на странице — нет: он говорит, что не сломано, и молчит
+  о том, что ветка ждёт ещё одного коммита. Трижды подряд PR был влит внутри этого молчания.
+- **Просьба о слиянии — отдельный ход, и раньше уборки её не бывает.** Порядок один: PR открыт
+  → прогон зелёный → папка задачи разобрана и запушена → исполнитель просит влить, называя
+  номер. До этой просьбы работа не готова, сколько бы зелёного на её странице ни было.
+- **Пока PR ждёт разбора, исполнитель берёт следующую задачу.** Ожидание чужого шага заходом
+  не занимают: работа уходит на разбор, и тем же движением берётся следующая. Готовым к
+  слиянию прежний PR становится не сам — его доводит до готовности исполнитель, вернувшись к
+  нему тем же ходом, которым прочитал конец прогона.
+- **Отказ гарда кончает ход.** Другого пути к отбитой правке не ищут: ни командой оболочки, ни
+  соседним инструментом, ни правкой самого гарда. Отбитая правка либо делается после того, как
+  условие отказа выполнено, либо не делается вовсе — и тогда владельцу называется отказ, а не
+  результат. Обход стоит дороже отказа: гард отбивает один файл, а обойдённый гард снимает
+  требование со всего дерева и молчит об этом. Держится это не только памятью — гарды судят и
+  команду оболочки, которая пишет файл.
 - **Ход, в котором владельцу задан вопрос, не заканчивается, пока за этот же ход не читались
   законы и правила.** Чтением считается любой из трёх путей: загрузка правила, чтение файла
   законов или правил, поиск по ним. Отбивает гард разговора — на завершении хода, а не на
@@ -113,24 +133,24 @@ description: Правило под «Закон о ведении работы»
   `npm run task:new` переименовывает черновик и проставляет шапку замысла.
 - **Брошенный разбор виден.** Черновик старше недели перечисляет сверка очереди работ —
   задачи за ним ещё нет, и спросить о нём некого.
-- **Договорённость вливается в спек домена последним коммитом отчёта.** К этому моменту код
+- **Договорённость вливается в спек домена последним коммитом PR.** К этому моменту код
   написан, привязки известны, и в главной ветке директория `proposed/` не появляется вовсе.
   Готовые к вливанию перечисляет `npm run check:specs`.
 - **Папка закрытой задачи разбирается, а не переносится целиком.** В `docs/archive/` уезжает
   то, что объясняет состоявшееся решение; остальное удаляется. Неразобранную ловит сверка
   очереди работ.
 - **Слияние отбивается, пока ветка везёт папку своей задачи.** Требование стоит на слиянии, а
-  не на открытии отчёта: до слияния папка ещё нужна — правка по замечаниям разбора идёт в ту
-  же ветку, а без замысла на диске её отбивает гард хода работы. На открытии отчёта о лежащей
+  не на открытии PR: до слияния папка ещё нужна — правка по замечаниям разбора идёт в ту
+  же ветку, а без замысла на диске её отбивает гард хода работы. На открытии PR о лежащей
   папке говорится вслух, и только. Судится содержимое ветки, а не рабочее дерево: снесённая,
   но не закоммиченная папка въехала бы вместе с веткой.
 - **Ветка, снёсшая папку, обязана прибавить запись в архив.** Снести дешевле, чем разобрать, и
   первым уходит разбор просьбы — единственная запись слов владельца. Что именно увезено,
   требование не судит: это судит владелец.
-- **Обход — строка `Task-folder-skip: <причина>` в отчёте или в самой команде слияния.**
+- **Обход — строка `Task-folder-skip: <причина>` в PR или в самой команде слияния.**
   Работа, вливаемая частями, папку до конца не разбирает. Чтение из команды работает и без
   сети: единственный сетевой путь отбивал бы оффлайн то самое слияние, причина которого
-  написана в отчёте. Пустая причина обходом не считается, а сам обход снимает отказ, но не
+  написана в PR. Пустая причина обходом не считается, а сам обход снимает отказ, но не
   гасит строку сверки очереди — иначе он через месяц становится рабочим путём.
 
 ## Чего из закона здесь нет
@@ -171,7 +191,7 @@ description: Правило под «Закон о ведении работы»
 Что именно перенесли в архив, не проверяется. Гард видит, что папка уезжает в главную ветку и
 что ветка что-то в архив добавила, но не может судить, то ли это и стоило ли переносить именно
 это. Сверять содержимое машине нечем — смотрит владелец на ревью. Отсюда же и обход: если
-работа вливается частями, папку до конца не разбирают, а причина остаётся в отчёте.
+работа вливается частями, папку до конца не разбирают, а причина остаётся в PR.
 
 ## Паттерны
 
@@ -207,16 +227,21 @@ description: Правило под «Закон о ведении работы»
   задаче так ушли две правки подряд: сначала подняли общее число у соседнего узла, потом
   перенесли узел в другое место разметки. Обе владелец отверг, а нужный способ назвал сам.
   Спрашивают до правки, а не показывают замер после.
-- **Линия работ по теме читается до того, как решается раскладка.** Файл линии держит решения,
+- **Эпик по теме читается до того, как решается раскладка.** Замысел эпика держит решения,
   которые пережили десяток задач, и разведка по коду их не находит: снятое решение следа в
-  дереве не оставляет. Домен, заведённый генератором и снесённый через полчаса, стоял в линии
-  прямым запретом — но линию открыли уже после того, как он был заведён во второй раз.
-- **Работа, которая разбирает папку задачи, своей папки не заводит.** Иначе она снимает одну и
-  оставляет вторую, сверка очереди краснеет на неё, и следующая работа повторяет то же — круг
-  не кончается. Так и вышло: разбор папки закрытой работы завёл себе папку, и на неё тут же
-  пришлось заводить третью задачу. Замысел на диске требует гард, и требует он его только под
-  правку кода приложения; разбор папок туда не доходит, а понимание такой работы целиком
-  помещается в тело отчёта.
+  дереве не оставляет. Домен, заведённый генератором и снесённый через полчаса, стоял в замысле
+  прямым запретом — но замысел открыли уже после того, как он был заведён во второй раз.
+- **Работа, которая разбирает чужую папку задачи, разбирает и свою — одним коммитом.** Свою
+  папку она заводит наравне со всеми: исключения из этого требования нет. Круг, которым
+  исключение оправдывали, закрывается не отказом от папки, а порядком разбора: последний
+  коммит снимает обе, и после работы неубранного не остаётся. Однажды такой разбор оставил
+  свою папку, и на неё пришлось заводить третью задачу — лечится это порядком, а не правом
+  работать без замысла на диске. Как разобрать две папки — паттерн `task-flow-close`.
 - **Слово для нового понятия берётся из `docs/GLOSSARY.md` или заводится там же.** Третий файл
   папки задачи называется `progress.md`, а не `journal.md`, ровно поэтому: журнал в этом
   дереве один, и он другой.
+- **Черновик папки задачи называется тем же коротким именем, что и будущая ветка.** Команда
+  заведения ищет черновик по нему и, не найдя, молча собирает папку с образца: работа при этом
+  идёт дальше, а разбор просьбы остаётся лежать в брошенном каталоге, и следующий заход
+  расспрашивает владельца заново. Имя черновику дают словами просьбы, а ветке — терминологией
+  договорённости; те же слова, да не те же.

package/assets/rules/testing.md

@@ -60,6 +60,10 @@ description: Правило под «Закон о проверяемости».
   Сводная цель запускается руками, и проверка, которая живёт только в ней, отвечает тому, кто
   её вспомнил: молчание такой проверки читается как её зелёный ответ. Три проверки простояли
   вне гейта, объявляя в собственных списках известного, что падают на новом.
+- **Проверка, приехавшая раскладкой, приезжает и со своим местом.** Место — это имя команды,
+  которой её зовут, и строка набора, в котором она стоит. Проверка без места узнаётся только по
+  тому, что раскладка положила новый файл, и статья выше на неё не действует: вставать ей некуда.
+  Так приехала проверка длины — той же редакцией, что и статья о её обязательном месте.
 - **Спека, необратимо меняющая данные стенда, выключена по умолчанию.** `BASE_URL` уводит
   прогон одной переменной, и без выключателя такая спека правила бы данные чужого стенда.
 - **Спеки, которым нужен nginx перед приложением, просыпаются вместе с `BASE_URL`.** Голый
@@ -78,6 +82,10 @@ description: Правило под «Закон о проверяемости».
   принятое остаётся навсегда, долг накоплен к заведению проверки и только сокращается, — либо
   столько ключей, сколько у записей родов. Причина обязательна: снятая проверка без причины
   через месяц неотличима от недосмотра.
+- **Строка в список известного не заводится под красную проверку.** Список набран к дню
+  заведения проверки и с тех пор только сокращается: дописанная строка гасит сигнал, а не
+  причину, и в истории выглядит так же, как починка. Место, где проверка права по букве и не
+  права по существу, разбирает владелец, а до его ответа верна проверка.
 - **Тест, утверждающий отсутствие, зелен и тогда, когда ищет не то.** Совпадения нет ни у
   верного текста, ни у опечатки в образце, ни у переименованного ключа — отличить их по цвету
   прогона нечем. Отрицательное утверждение поэтому идёт в паре с положительным: сначала
@@ -136,3 +144,14 @@ description: Правило под «Закон о проверяемости».
   стенда. Обещанное поведение остаётся сценарием в `scenarios.md`: если списать его во второе
   место, копии разойдутся молча — `npm run check:specs` этого не увидит.
 - `npx nx serve` проверкой не является: это шаг из правила `browser-verification`, а не тест.
+- **Кадр, зависящий от загрузки машины, проверяет машину, а не вёрстку.** Ожидание отсчётом
+  времени этим и кончается: на свободной машине набор зелен целиком, на занятой падает, и какой
+  именно кадр не успел — дело случая. Лечится ожиданием события, а не удлинением отсчёта: шрифты
+  подняты, картинки нарисованы, движение остановлено, положение узла не менялось два кадра
+  подряд. Пока ожидание идёт по времени, «проверено снимками» означает «машина была свободна», и
+  перезапуск, давший зелёное, этого не отменяет, а прячет. Восемь кадров расходились с эталоном
+  на 0,15–0,74 % в задании конвейера и проходили на той же машине вне его.
+- **Стенд, поднятый предыдущим шагом, останавливается перед съёмкой.** Оставленный работать, он
+  соревнуется за машину с тем, что снимают, и делает исход прогона зависящим от того, чем занят
+  сосед. Нагрузка, которую задание создаёт себе само — соседняя витрина, только что законченная
+  сборка, — ничем не отличается от чужой.

package/assets/rules/typescript-conventions.md

@@ -69,6 +69,18 @@ description: Правило под «Закон об устройстве код
 
 ## Ловушки
 
+- **Пределы сложности функции спрашивают у плагина, а не вспоминают.** Там, где дерево подняло
+  правила `sonarjs` разом, до отказа, числа ветвлений и вложенности приходят умолчаниями
+  плагина и своей строкой в конфиге не записаны: они меняются вместе с его версией, а выглядят
+  как договорённость дерева. За одну задачу их спрашивали трижды, каждый раз заново, и дважды
+  называли по памяти — оба раза мимо.
+
+    ```bash
+    node -e 'const s = require("eslint-plugin-sonarjs");
+        for (const n of ["cyclomatic-complexity", "cognitive-complexity", "nested-control-flow"])
+            console.log(n, JSON.stringify(s.rules[n].meta.defaultOptions));'
+    ```
+
 - Приведение через `as Type` в маппере запрещено, но не стережётся ничем: оно принимает любое
   значение и компилируется. Вместо него — `this.typeCast`.
 - Неиспользуемый параметр убирается, а не переименовывается: подчёркивание перед именем прячет

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

@@ -42,6 +42,20 @@ description: Готовые примеры того, как дерево доп
 выглядит собранным. Поэтому заголовок в примере выше свой. Пакетный заголовок берут только
 тогда, когда пакетный текст здесь неверен и его правда надо снять.
 
+**Заголовок, стоящий внутри примера, разделом не является.** Разбор пропускает всё, что лежит
+в ограде блока кода: образец документа с собственными заголовками рвал бы ресурс на куски.
+Поэтому надстройка, названная таким заголовком, не замещает ничего — она попадает в строку «нет
+у пакета» и дописывается новым разделом в конец. Правка при этом выглядит сработавшей: файл
+собран, `sync --check` зелёный, а нужный абзац остался прежним.
+
+Дотягиваются до него заголовком того раздела, внутри которого он лежит, — и замещают этот
+раздел целиком, вместе с примером:
+
+````bash
+# какие заголовки у ресурса на самом деле — примеры в ограде сюда не попадают
+awk '/^```/ { fence = !fence } !fence && /^## / { print }' <файл ресурса>
+````
+
 Проверяется раскладкой: `sync`, затем `sync --check` — и глазами по разложенному файлу, на
 месте ли пакетные разделы.
 
@@ -140,6 +154,10 @@ rt_docs_pair_for() {
 - **Правка на месте вместо надстройки.** Разложенный файл узнаётся по шапке, а не по каталогу:
   раскладка ложится в те же `tools/` и `.claude/`, где лежит своё.
 - **Свой пункт дописан к пакетному заголовку** — пакетные пункты этого раздела ушли молча.
+- **Надстройка названа заголовком, который стоит в примере.** Заместить она ничего не может —
+  такого раздела у ресурса нет, — и уезжает новым разделом в конец. Видно это глазами по
+  разложенному файлу: два одинаковых заголовка, один в ограде примера, другой последним
+  разделом; раскладка при этом зелёная, потому что расхождения с пакетом нет.
 - **Функция объявлена заново без вызова `_default`** — вместе со своим случаем потеряны все
   пакетные.
 - **Общая ветка карты стоит выше частной** — частная не выполняется никогда.
@@ -147,3 +165,9 @@ rt_docs_pair_for() {
   отвечает ненулевым кодом, то есть «правка отбита». После правки — `bash -n`.
 - **Правка ресурса пакета без сборки.** Строка запуска читает собранное, а не исходники:
   порядок всегда один — правка, сборка, `sync`.
+- **Форматтер правит ресурс на коммите, и раскладка отстаёт задним числом.** Разложенное
+  сходилось в ту минуту, когда его раскладывали, а ресурс изменился после: пример с оградой
+  внутри примера форматтер переписывает на ограду длиннее, сумма ресурса меняется, и
+  `sync --check` краснеет уже на следующем шаге. Порядок обхода: прогнать форматтер на
+  правленом ресурсе, потом `sync`, потом коммит — либо переразложить и добавить в тот же
+  коммит.

package/assets/skills/agent-kit.md

@@ -27,6 +27,7 @@ description: Переносимый слой правил агента — за
 | какие признаки единообразия дерево берёт       | `checks.json`, ключи `reuse.bundles` и `reuse.signals` |
 | раздел разложенного текста                     | `.claude/rt-kit/overrides/<идентификатор ресурса>`     |
 | что брать, а от чего отказаться                | `.claude/rt-kit.json`, ключи `only` и `skip`           |
+| что у дерева есть: хранилище, админка, пакеты  | `.claude/rt-kit.json`, ключ `has`                      |
 | сам механизм — гард, проверка, текст правила   | ресурс в пакете                                        |
 
 Надстройка объявляет функцию заново и вправе позвать умолчание тем же именем с суффиксом
@@ -49,7 +50,7 @@ npx agent-kit doctor        # что разложено, что отстало,
 npx agent-kit sync          # разложить
 npx agent-kit sync --check  # ничего не писать, отказать при расхождении
 npx agent-kit stats         # чем пользовались, чем ни разу, обо что спотыкались
-npx agent-kit propose       # отправить предложения, адресованные пакету
+npx agent-kit propose       # отправить груз в приём: сводку, предложения и разборы
 ```
 
 ## Обратная связь наверх
@@ -65,11 +66,29 @@ npx agent-kit propose       # отправить предложения, адр
 
 **Предложения** приносит разбор закрытой задачи — командой `/skill-curator`. Каждому он ставит
 адрес: «пакет», «компаньон» или «дерево». Выгружаются они файлом в `.claude/rt-kit/proposals/`
-(форма — шаблон `proposal.md`), а `agent-kit propose` отправляет наружу те, что адресованы
-пакету, вместе со сводкой. Текст с адресом этого дерева отбивает отправку целиком.
-
-Разбираются они в репозитории самого пакета — командой `/agent-kit-digest`, там же, где лежат
-правимые ресурсы и видно всех потребителей сразу.
+(форма — шаблон `proposal.md`), а `agent-kit propose` увозит в приём те, что адресованы
+пакету, вместе со сводкой и разборами происшествий. Адрес дерева в сводке или в тексте
+предложения отбивает отправку целиком.
+
+Приём — закрытая служба: сводка говорит о рабочих привычках команды, и в открытой очереди работ
+это выложено всему свету. Адрес приёма объявляется ключом `intake` в конфиге дерева, токен —
+ключом `token`, и лежит он вне дерева.
+
+**Отметка об отправке в файле предложения — след для человека, а не хранилище состояния.** Файл
+живёт в рабочем дереве, а дерево у каждой ветки своё: отметка, поставленная в одной ветке, в
+соседней не видна, и тот же текст уезжает вторым разом. Второй записью он при этом не
+становится — приём отбирает уже приехавшее по признаку предложения, и его ответ говорит,
+сколько записей легло и сколько уже лежало. Строка «принято 0, уже лежало 3» означает, что
+нового не уехало ничего.
+
+Разбираются предложения в репозитории самого пакета — командой `/agent-kit-digest`, там же, где
+лежат правимые ресурсы и видно всех потребителей сразу.
+
+**Имя файла предложения в текстах дерева не называется.** Каталог предложений в историю не едет:
+файл лежит на той машине, где его написали, и адрес на него ведёт в пустоту у всех остальных —
+проверка путей краснеет в каждом дереве, кроме одного, а читателю ссылка не даёт ничего.
+Написанное в разборе происшествия и в любом другом тексте репозитория говорит, кому предложение
+отправлено и о чём оно; ресурс пакета при этом называть можно — он в истории есть.
 
 Предложение работу не выправляет. Оно лежит текстом, читается глазами и в контекст сам собой
 не приходит: замечание было прочитано, процитировано владельцу и нарушено в том же ходе —
@@ -77,6 +96,14 @@ npx agent-kit propose       # отправить предложения, адр
 только войдя в ресурс пакета; до этого на него не ссылаются как на действующее требование и не
 считают дырку закрытой.
 
+**Слово владельца о предложении — «отправь», «заведи», «напиши пропозал» и любая другая форма
+того же — исполняется отправкой в тот же ход.** Сухой прогон отправкой не является: он
+показывает, что уехало бы, ничего не заводит и следа наружу не оставляет. Неудобна отправка
+ровно в одном месте — она пишет отметки в файлы предложений и делает дерево грязным; при
+открытом PR отметки ложатся вторым коммитом в ту же ветку, и это их место, а не повод
+отложить. Стережёт это гард предложения на завершении хода — там же, где стоит гард
+происшествия, и по той же причине.
+
 ## Установка туда, где уже всё своё
 
 1. `init`, затем `skip` на всё, что дерево держит само. Пустая раскладка — законное начало.
@@ -86,6 +113,27 @@ npx agent-kit propose       # отправить предложения, адр
 4. Разложенное поверх своего пакет не пишет: файл без шапки для него чужой. Снять его —
    решение владельца, и до этого раскладка отказывает поимённо.
 
+## Свойства дерева
+
+Часть правил пакета верна только там, где есть хранилище, админка или приложение. Дерево
+перечисляет, что у него есть, ключом `has`; ресурс называет нужное ему свойство приставкой в
+имени — `observability.needs-app.md`, — и дереву, которое такого свойства не назвало, не
+кладётся вовсе: ни он сам, ни черновик его компаньона.
+
+```json
+{ "has": ["packages", "app"] }
+```
+
+- **Молчание требованию не отвечает.** Дерево с пустым `has` не получает ни одного помеченного
+  ресурса: положенный наугад, он вернётся пустым компаньоном, заполнить который нечем.
+- **Требование — не вид.** Вид отвечает на «какой из трёх» и выбирается один; свойств у дерева
+  сразу несколько, и дерево, которое публикует пакеты и держит приложение, называет оба.
+- **`only` сильнее требования.** Ресурс, названный поимённо, ложится и при неотвеченном
+  требовании; перечень раскладки называет это вслух, а отказ по его пустому компаньону зовёт
+  снять ресурс, а не заполнять черновик.
+- **Свойство, которого пакет не объявлял, роняет раскладку** — что в `has` дерева, что в имени
+  ресурса. Объявлены свойства перечнем при пакете, рядом с осями различия.
+
 ## Ловушки
 
 - **Правила и паттерны при отвергнутом законе в отказе не перечисляются.** Их снимает каскад, а

package/assets/traits.json

@@ -0,0 +1,14 @@
+{
+  "db": {
+    "title": "хранилище: схема, миграции, записи предметной области"
+  },
+  "admin": {
+    "title": "админка: экраны правки записей и роли доступа"
+  },
+  "app": {
+    "title": "приложение: экраны, которыми пользуются люди"
+  },
+  "packages": {
+    "title": "публикуемые пакеты: реестр, версии, журнал изменений"
+  }
+}

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":";AAcA,OAAO,EAAqC,iBAAiB,EAA8B,MAAM,oBAAoB,CAAC;AA6LtH,wBAAsB,IAAI,CAAC,IAAI,EAAE,SAAS,MAAM,EAAE,GAAG,OAAO,CAAC,iBAAiB,CAAC,CAiE9E"}
+{"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;AAqM7G,wBAAsB,IAAI,CAAC,IAAI,EAAE,SAAS,MAAM,EAAE,GAAG,OAAO,CAAC,iBAAiB,CAAC,CAsE9E"}

package/bin/agent-kit.js

@@ -10,10 +10,12 @@ import { readFileSync } from 'node:fs';
 import { dirname, join, resolve } from 'node:path';
 import { fileURLToPath } from 'node:url';
 import process from 'node:process';
+import { unknownFlagsIn } from '../lib/argv.js';
 import { readCatalog, resolveSelection } from '../lib/catalog.js';
-import { adopt, doctor, init, list, propose, stats, sync } from '../lib/commands.js';
+import { adopt, doctor, init, list, stats, sync } from '../lib/commands.js';
+import { httpShip } from '../lib/ship.js';
+import { propose } from '../lib/shipment.js';
 import { DEFAULT_DAYS } from '../lib/observations.js';
-import { ghIssue, repositoryOf } from '../lib/submit.js';
 import { staleBuild } from '../lib/freshness.js';
 import { packageRootFrom } from '../lib/package-root.js';
 import { readAxes } from '../lib/variants.js';
@@ -29,7 +31,7 @@ const USAGE = [
     '  stats           свести наблюдения: чем пользовались, чем ни разу, обо что спотыкались',
     '  stats --days N  за сколько дней; без довода — за три',
     '  stats --json    то же машиночитаемо — этим сводку прикладывают к предложению',
-    '  propose         отправить предложения с адресом «пакет» в очередь работ пакета',
+    '  propose         отправить груз в приём: сводку со снимком надстроек, предложения и разборы',
     '  propose --dry-run   показать, что уехало бы, и ничего не отправлять',
     '  adopt [файлы]   отдать пакету файлы, лежащие на его путях не от него',
     '',
@@ -46,6 +48,17 @@ const USAGE = [
     '  --<ось> <вид>     например `--host gitlab`; оси и виды — из `agent-kit list`',
     '  без флага         спросить; без терминала — отказ, кроме `--all`',
 ];
+/**
+ * Доводы отправки. Довод со значением помечен `<>`: за ним идёт отдельным словом путь, и без
+ * пометки этот путь читался бы как ещё один незнакомый довод.
+ */
+const PROPOSE_FLAGS = ['--dry-run', '--root <>'];
+/** Что печатает отказ на незнакомом доводе: режимы команды, а не весь свод. */
+const PROPOSE_USAGE = [
+    '  propose             отправить груз в приём',
+    '  propose --dry-run   показать, что уехало бы, и ничего не отправлять',
+    '  --root <путь>       корень проекта; по умолчанию текущий каталог',
+];
 /**
  * Единственное место, где пакет узнаёт собственное расположение. `import.meta` живёт только
  * здесь: библиотечные модули получают каталог ресурсов входным значением, и трансформ тестов,
@@ -61,9 +74,6 @@ function environmentOf(root) {
         // Сверка со своими исходниками возможна только отсюда: здесь пакет знает, где лежит сам.
         // У потребителя исходников рядом нет, и сверка молчит.
         stale: staleBuild(pkg, manifest.name),
-        // Куда уезжают предложения. Читается из манифеста: зашитый в код адрес назвал бы чужое
-        // дерево в текстах пакета — и врал бы у всякого, кто пакет форкнул.
-        repository: repositoryOf(manifest.repository?.url ?? ''),
     };
 }
 /** Чем это дерево себя выдаёт снаружи. Нет удалённого репозитория — нечем, и это не отказ. */
@@ -202,19 +212,24 @@ export async function main(argv) {
             });
         }
         case 'propose': {
-            // Сводка едет вместе с предложением: без цифр оно читается как мнение. Берётся тем
-            // же отрезком, что и сводка по умолчанию, — предложение пишут по свежей задаче.
-            const summary = stats(env, {
-                days: DEFAULT_DAYS,
-                today: new Date().toISOString().slice(0, 10),
-                json: false,
-            });
+            // Единственное действие этой команды необратимо и уходит наружу, поэтому незнакомый
+            // довод её кончает, а не пропускается молча: вызов ради списка режимов отправил в
+            // приём всё накопленное, и по выводу это не отличалось от «команда ничего не
+            // сделала». Прочие команды такого разбора не знают — их действие обратимо.
+            const unknown = unknownFlagsIn(argv.slice(1), PROPOSE_FLAGS);
+            if (unknown.length) {
+                return {
+                    code: 1,
+                    lines: [`таких доводов у \`propose\` нет: ${unknown.join(', ')}`, '', ...PROPOSE_USAGE],
+                };
+            }
             return propose(env, {
                 dryRun: argv.includes('--dry-run'),
-                submit: ghIssue,
-                repository: env.repository ?? '',
+                ship: httpShip,
                 remote: remoteOf(env.root),
-                summary: summary.lines,
+                // Отрезок тот же, что у сводки по умолчанию: отправку зовут по свежей задаче.
+                days: DEFAULT_DAYS,
+                today: new Date().toISOString().slice(0, 10),
             });
         }
         case 'doctor':