@rt-tools/agent-kit 0.5.1 → 0.5.2

package/assets/patterns/git-workflow-commit.github.md

@@ -264,30 +264,34 @@ npm run task:move -- 86 in-review
 Проверок на самом PR нет: выкатка запускается пушем в главную ветку, и до мержа никто не
 гоняет ничего. Линтеры, юниты и сценарии хуков снимает гейт пуша — ниже то, чего он не знает.
 
-1. **В ветке только та правка, за которой её заводили** — `git diff main...HEAD --stat`. Чужой
+1. **Главная ветка влита в эту ветку** — `git fetch origin && git merge origin/main`.
+   Всё, что проверяется ниже, проверяется от этого основания: PR с разошедшейся ветки
+   показывает ревьюверу правку вперемешку с чужой. Порядок и разбор конфликта — паттерн
+   `git-workflow-merge`.
+2. **В ветке только та правка, за которой её заводили** — `git diff main...HEAD --stat`. Чужой
    домен в списке файлов означает, что правка расползлась, и её надо вернуть в свои границы.
-2. **Ни мока, ни подменённого ответа, ни отладочной строки** — `git diff main...HEAD` читается
+3. **Ни мока, ни подменённого ответа, ни отладочной строки** — `git diff main...HEAD` читается
    целиком, а не по именам файлов. На прод они уезжают молча и портят настоящие данные.
-3. **Документ едет тем же коммитом.** Пару называет `docs-guard`, но спек домена и правку его
+4. **Документ едет тем же коммитом.** Пару называет `docs-guard`, но спек домена и правку его
    поведения он не знает — это остаётся за автором.
-4. **Проверки текстов и раскладки зелёные** — те, что дерево завело в `tools/`: сверка
+5. **Проверки текстов и раскладки зелёные** — те, что дерево завело в `tools/`: сверка
    сценариев с тестами, путей в документах, раскладки либ, повторов и классов без правила.
    Какие именно есть здесь — `implementation.md` правила.
-5. **Все приложения дерева собираются** — `nx build` по каждому. Гейт пуша сборку не гоняет:
+6. **Все приложения дерева собираются** — `nx build` по каждому. Гейт пуша сборку не гоняет:
    она длиннее всего, что он успевает сделать между командой и пушем.
-6. **Видимый текст заведён во всех локалях перевода** — тестом полноты словарей, если дерево
+7. **Видимый текст заведён во всех локалях перевода** — тестом полноты словарей, если дерево
    переводится.
-7. **Правка вёрстки подтверждена замером**, а не взглядом, и снята при узком экране — паттерн
+8. **Правка вёрстки подтверждена замером**, а не взглядом, и снята при узком экране — паттерн
    `browser-verification-measure`.
-8. **Правка разметки публичного сайта проверена на прод-сборке по всем локалям перевода** — паттерн
+9. **Правка разметки публичного сайта проверена на прод-сборке по всем локалям перевода** — паттерн
    `seo-verify`.
-9. **Тело PR начинается строкой `Closes #<номер>`**, а метки, ревьювер и исполнитель стоят.
-10. **Заголовок PR несёт номер задачи и называет её сделанной:** `[<КЛЮЧ>-<номер>] <Что сделано>`,
+10. **Тело PR начинается строкой `Closes #<номер>`**, а метки, ревьювер и исполнитель стоят.
+11. **Заголовок PR несёт номер задачи и называет её сделанной:** `[<КЛЮЧ>-<номер>] <Что сделано>`,
     тем же номером, что стоит у задачи и в имени ветки. Инфинитив из задачи в него не
     переносится, тип и область коммита — тоже.
-11. **Очередь работ сходится** — `npm run check:board`. Задача на борде, с исполнителем и
+12. **Очередь работ сходится** — `npm run check:board`. Задача на борде, с исполнителем и
     номером в заголовке; PR один на задачу, и закрывает он её целиком.
-12. **Состояние PR прочитано, а не выведено из кодов возврата** — автор `<бот>`,
+13. **Состояние PR прочитано, а не выведено из кодов возврата** — автор `<бот>`,
     ревьювер — владелец, метки те же, что у задачи. Владельцу называют прочитанное.
 
 Сразу после публикации задача переставляется в разбор — `npm run task:move -- <номер>

package/assets/patterns/git-workflow-commit.gitlab.md

@@ -232,26 +232,30 @@ npm run task:move -- 86 in-review
 Проверок на самом MR нет ровно до тех пор, пока конвейер не запущен, а запускается он пушем.
 Линтеры, юниты и сценарии хуков снимает гейт пуша — ниже то, чего он не знает.
 
-1. **В ветке только та правка, за которой её заводили** — `git diff main...HEAD --stat`. Чужой
+1. **Главная ветка влита в эту ветку** — `git fetch origin && git merge origin/main`.
+   Всё, что проверяется ниже, проверяется от этого основания: MR с разошедшейся ветки
+   показывает ревьюверу правку вперемешку с чужой. Порядок и разбор конфликта — паттерн
+   `git-workflow-merge`.
+2. **В ветке только та правка, за которой её заводили** — `git diff main...HEAD --stat`. Чужой
    домен в списке файлов означает, что правка расползлась, и её надо вернуть в свои границы.
-2. **Ни мока, ни подменённого ответа, ни отладочной строки** — `git diff main...HEAD` читается
+3. **Ни мока, ни подменённого ответа, ни отладочной строки** — `git diff main...HEAD` читается
    целиком, а не по именам файлов. На прод они уезжают молча и портят настоящие данные.
-3. **Документ едет тем же коммитом.** Пару называет `docs-guard`, но спек домена и правку его
+4. **Документ едет тем же коммитом.** Пару называет `docs-guard`, но спек домена и правку его
    поведения он не знает — это остаётся за автором.
-4. **Проверки текстов и раскладки зелёные** — те, что дерево завело в `tools/`. Какие именно
+5. **Проверки текстов и раскладки зелёные** — те, что дерево завело в `tools/`. Какие именно
    есть здесь — `implementation.md` правила.
-5. **Все приложения дерева собираются** — `nx build` по каждому. Гейт пуша сборку не гоняет.
-6. **Видимый текст заведён во всех локалях перевода** — тестом полноты словарей, если дерево
+6. **Все приложения дерева собираются** — `nx build` по каждому. Гейт пуша сборку не гоняет.
+7. **Видимый текст заведён во всех локалях перевода** — тестом полноты словарей, если дерево
    переводится.
-7. **Правка вёрстки подтверждена замером**, а не взглядом, и снята при узком экране — паттерн
+8. **Правка вёрстки подтверждена замером**, а не взглядом, и снята при узком экране — паттерн
    `browser-verification-measure`.
-8. **Правка разметки публичного сайта проверена на прод-сборке по всем локалям перевода** —
+9. **Правка разметки публичного сайта проверена на прод-сборке по всем локалям перевода** —
    паттерн `seo-verify`.
-9. **Описание MR начинается строкой `Closes #<номер>`**, а метки, ревьювер и исполнитель стоят.
-10. **Заголовок MR несёт номер задачи и называет её сделанной:** `[<КЛЮЧ>-<номер>] <Что
+10. **Описание MR начинается строкой `Closes #<номер>`**, а метки, ревьювер и исполнитель стоят.
+11. **Заголовок MR несёт номер задачи и называет её сделанной:** `[<КЛЮЧ>-<номер>] <Что
 сделано>`, тем же номером, что стоит у задачи и в имени ветки.
-11. **Очередь работ сходится** — `npm run check:board`.
-12. **Состояние MR прочитано, а не выведено из кодов возврата.**
+12. **Очередь работ сходится** — `npm run check:board`.
+13. **Состояние MR прочитано, а не выведено из кодов возврата.**
 
 Сразу после публикации задача переставляется в разбор, и сверка очереди прогоняется ещё раз: до
 открытия MR список она не судит, а после открытия расхождение видит.

package/assets/patterns/task-flow-resume.md

@@ -10,6 +10,8 @@ description: Паттерн правила task-flow. Брать при возв
 Паттерн правила `task-flow`. Что при этом должно быть верно — закон
 `docs/constitution/work-conduct.md`.
 
+**Требует:** `hooks/task-context-load.sh`
+
 ## Когда брать
 
 - Сессия начата на ветке `<КЛЮЧ>-*`, работа в ней уже шла.
@@ -57,6 +59,16 @@ git log --oneline origin/main..HEAD
 - **Следующий шаг:** сценарии обоих хуков, затем подключение в настройках
 - **Незакоммиченное:** всё, ветка пока без коммитов
 - **Ждём владельца:** нет
+- **Отчёт:** ещё не открыт
+```
+
+Строка про отчёт обязательна с той минуты, как этапы кончились: между открытием отчёта и
+слиянием проходит день и больше, и заход обрывается там чаще всего. Без неё следующий заход
+читает «этап последний, всё зелено» и об открытом отчёте узнаёт только из истории ветки или у
+владельца — то есть ровно тем пересказом, ради отмены которого всё и заведено:
+
+```markdown
+- **Отчёт:** #1396, ждёт разбора · отвечено 3 замечания из 5 · не сделано: разбор папки задачи
 ```
 
 Решение, принятое по ходу, — вместе с причиной и с тем, что было альтернативой:

package/assets/patterns/task-flow-start.md

@@ -33,6 +33,13 @@ Agent(subagent_type: "Explore", prompt: "<тема просьбы>: что по
 
 Находки складываются в раздел «Что уже есть в дереве» разбора.
 
+Разведка кончается не ощущением, а выводом команд. До первого вопроса владельцу исполнитель
+знает: как устроен репозиторий (корневая памятка), что лежит в каталоге, о котором пойдёт речь
+(`ls`), и есть ли уже написанное по теме (поиск по документации и правилам). Вопрос называет,
+где искали: «в таком-то месте не нашёл» — проверяемо, «не знаю» — нет. Без списка того, что
+считается сделанным, разведка исполняется как настроение: прочитанный переданный текст сходит
+за неё, и по текущему дереву не запускается ни одной команды.
+
 ### 2. Разбор с владельцем
 
 Ведёт главный агент: субагент до владельца не достучится. Команда — `/grill-me`, один вопрос
@@ -53,6 +60,24 @@ Agent(subagent_type: "Explore", prompt: "<тема просьбы>: что по
 каждому вопросу добавляется свободный вариант — у закрытого набора нет строки «вопрос не тот».
 Выбор слова, имени и термина уточняется прозой в любом случае.
 
+**Рамка переданного текста на текущее дерево не переносится.** Передача захода, файл
+предложений и спек описывают то дерево, в котором писались. Про текущее знает только текущее:
+прежде чем принять из такого текста утверждение о раскладке, оно проверяется командой здесь.
+Подтверждение при этом находится само — признаки дерева, только ставящего пакет, стоят и у
+дерева, которое пакет и пишет, и ставит.
+
+Сообщение, которым исполнитель останавливается, начинается с того, чего он ждёт:
+
+```
+Стою на выборе <что решается>. Без ответа <что будет: пойду допущением таким-то / работа стоит>.
+<Вопрос>
+```
+
+Замеры, находки ролей и список решений к этому моменту уже записаны в ход работы, и в
+сообщении владельцу они лишние. Отчёт, в конце которого стоит вопрос, выглядит добросовестно
+ровно настолько, насколько надёжно вопрос в нём тонет: владелец трижды переспрашивал, почему
+работа стоит, и каждый круг стоил захода обоим.
+
 Ответы пишутся в `docs/tasks/_draft-<slug>/grill.md` — папка ещё черновик, номера нет.
 
 ```bash
@@ -90,10 +115,19 @@ npm run task:move -- <номер> in-progress
 Ветка заводится вторым вызовом: составную «завести и сразу коммитить» гард главной ветки
 отклоняет целиком.
 
-Остальные два файла — с образца:
+Номер уже выдан — черновика нет и не заводится: папка задачи открывается сразу под именем
+ветки, а разбор пишется в неё же. Так начинается половина работ: номер приходит прошлым
+заходом, замеченным дефектом или соседней задачей, и шаг с черновиком в этом случае неисполним
+целиком — переименовывать нечего, `task:new` звать незачем. Ловушка «номер не бывает первым»
+сюда не относится: она про то, что задачу не заводят до разбора, а не про то, что с уже
+заведённой нельзя работать.
+
+Остальные два файла пишутся, а не кладутся образцом впрок: пустой `plan.md` на диске
+неотличим от замысла, у которого нет этапов, — а следующий заход читает папку задачи первым
+делом и доверяет ей. Образец открывается тем же движением, которым заполняется:
 
 ```bash
-cp docs/tasks/_template/plan.md docs/tasks/<КЛЮЧ>-<номер>-<slug>/plan.md
+cp docs/tasks/_template/plan.md docs/tasks/<КЛЮЧ>-<номер>-<slug>/plan.md      # и сразу пишется
 cp docs/tasks/_template/progress.md docs/tasks/<КЛЮЧ>-<номер>-<slug>/progress.md
 ```
 

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

@@ -44,6 +44,10 @@ description: Правило под «Закон о поставке» для д
   `az repos pr create` с такой ветки: локально она законна, но правка из неё — это выкатка, за
   которой в очереди работ ничего не стоит. Заводится рабочий элемент, и работа переносится в
   ветку с его номером.
+- **Главная ветка влита в ветку рабочего элемента до открытия PR.** Гард поставки отбивает
+  открытие, пока вершина главной ветки не стала предком текущей, и называет расхождение числом
+  коммитов. PR с разошедшейся ветки показывает ревьюверу свою правку вперемешку с чужой, а всё,
+  что автор проверил до публикации, он проверил от основания, которого в главной ветке уже нет.
 - **Номер ветки и номер в заголовке PR сверяются на месте, а состояние — по доске.** Формат
   читается из текста команды и работает без сети; существование рабочего элемента, его
   состояние, исполнитель и то, что он ещё открыт, — только когда есть чем спросить. Нет сети
@@ -107,6 +111,12 @@ description: Правило под «Закон о поставке» для д
 работу вместо промаха. Держится это памятью и подсказкой, которую печатает команда заведения
 задачи. Отставшее состояние находит сверка очереди — но уже после того, как PR открыт.
 
+Свежесть самой вершины главной ветки гард не проверяет: он судит по тому, что лежит в дереве, и
+вершину недельной давности от сегодняшней не отличает. Сетевой вызов сюда не заводится по той же
+причине, что и выше, — он падал бы вместе со связью. Поэтому гард ловит ветку, отставшую
+заведомо, а `git fetch` перед вливанием стоит первым пунктом чеклиста и держится тем же, чем
+держатся остальные его пункты.
+
 ## Паттерны
 
 - `git-workflow-commit` — рабочий элемент, ветка, коммит, пуш и PR от учётной записи машинной
@@ -138,3 +148,8 @@ description: Правило под «Закон о поставке» для д
   записи, на следующий вызов это не переносится: PR открывают токеном учётной записи машинной
   работы, и от того, чьей записью он открыт, зависит, кого можно назначить ревьювером. Однажды
   смена записи ради пуша утекла в публикацию — отчёт вышел от владельца.
+- **Новое рабочее дерево получает только то, что лежит в индексе.** `git worktree add`
+  разворачивает коммит, а настройки, ключи, локальные разрешения и зависимости в коммит не
+  входят: свежее дерево выглядит готовым и упирается в нехватку не сразу, а на первом гарде,
+  которому нужен ключ. Что именно переносится руками, названо списком в компаньоне правила, и
+  список пополняется тем же движением, которым заводится новый файл вне индекса.

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

@@ -44,6 +44,10 @@ description: Правило под «Закон о поставке» для д
 - **Ветка без номера задачи PR не открывает.** Гард поставки отбивает `gh pr create` с такой
   ветки: локально она законна, но правка из неё — это выкатка, за которой в очереди работ
   ничего не стоит. Заводится задача, и работа переносится в ветку с её номером.
+- **Главная ветка влита в ветку задачи до открытия PR.** Гард поставки отбивает открытие, пока
+  вершина главной ветки не стала предком текущей, и называет расхождение числом коммитов. PR с
+  разошедшейся ветки показывает ревьюверу свою правку вперемешку с чужой, а всё, что автор
+  проверил до публикации, он проверил от основания, которого в главной ветке уже нет.
 - **Ключ задач задаётся один раз, и все три формы имени выводятся из него.** Заголовок задачи,
   имя ветки и заголовок отчёта строит один и тот же ключ: команда заведения задачи собирает по
   нему заголовок, гард поставки достаёт по нему номер из имени ветки, сверка очереди — из
@@ -115,6 +119,12 @@ description: Правило под «Закон о поставке» для д
 работу вместо промаха. Держится это памятью и подсказкой, которую печатает команда заведения
 задачи. Отставшую колонку находит сверка очереди — но уже после того, как PR открыт.
 
+Свежесть самой вершины главной ветки гард не проверяет: он судит по тому, что лежит в дереве, и
+вершину недельной давности от сегодняшней не отличает. Сетевой вызов сюда не заводится по той же
+причине, что и выше, — он падал бы вместе со связью. Поэтому гард ловит ветку, отставшую
+заведомо, а `git fetch` перед вливанием стоит первым пунктом чеклиста и держится тем же, чем
+держатся остальные его пункты.
+
 ## Паттерны
 
 - `git-workflow-commit` — задача, ветка, коммит, пуш и PR от учётной записи машинной работы.
@@ -144,3 +154,8 @@ description: Правило под «Закон о поставке» для д
   записи, на следующий вызов это не переносится: PR открывают токеном учётной записи машинной
   работы, и от того, чьей записью он открыт, зависит, кого можно назначить ревьювером. Однажды
   смена записи ради пуша утекла в публикацию — отчёт вышел от владельца.
+- **Новое рабочее дерево получает только то, что лежит в индексе.** `git worktree add`
+  разворачивает коммит, а настройки, ключи, локальные разрешения и зависимости в коммит не
+  входят: свежее дерево выглядит готовым и упирается в нехватку не сразу, а на первом гарде,
+  которому нужен ключ. Что именно переносится руками, названо списком в компаньоне правила, и
+  список пополняется тем же движением, которым заводится новый файл вне индекса.

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

@@ -43,6 +43,10 @@ description: Правило под «Закон о поставке» для д
 - **Ветка без номера задачи MR не открывает.** Гард поставки отбивает `glab mr create` с такой
   ветки: локально она законна, но правка из неё — это выкатка, за которой в очереди работ
   ничего не стоит. Заводится задача, и работа переносится в ветку с её номером.
+- **Главная ветка влита в ветку задачи до открытия MR.** Гард поставки отбивает открытие, пока
+  вершина главной ветки не стала предком текущей, и называет расхождение числом коммитов. MR с
+  разошедшейся ветки показывает ревьюверу свою правку вперемешку с чужой, а всё, что автор
+  проверил до публикации, он проверил от основания, которого в главной ветке уже нет.
 - **Номер ветки и номер в заголовке MR сверяются на месте, а состояние задачи — по доске.**
   Формат читается из текста команды и работает без сети; существование задачи, её метка
   списка, исполнитель и то, что она ещё открыта, — только когда есть чем спросить. Нет сети
@@ -105,6 +109,12 @@ description: Правило под «Закон о поставке» для д
 работу вместо промаха. Держится это памятью и подсказкой, которую печатает команда заведения
 задачи. Отставший список находит сверка очереди — но уже после того, как MR открыт.
 
+Свежесть самой вершины главной ветки гард не проверяет: он судит по тому, что лежит в дереве, и
+вершину недельной давности от сегодняшней не отличает. Сетевой вызов сюда не заводится по той же
+причине, что и выше, — он падал бы вместе со связью. Поэтому гард ловит ветку, отставшую
+заведомо, а `git fetch` перед вливанием стоит первым пунктом чеклиста и держится тем же, чем
+держатся остальные его пункты.
+
 ## Паттерны
 
 - `git-workflow-commit` — задача, ветка, коммит, пуш и MR от учётной записи машинной работы.
@@ -134,3 +144,8 @@ description: Правило под «Закон о поставке» для д
   записи, на следующий вызов это не переносится: MR открывают токеном учётной записи машинной
   работы, и от того, чьей записью он открыт, зависит, кого можно назначить ревьювером. Однажды
   смена записи ради пуша утекла в публикацию — отчёт вышел от владельца.
+- **Новое рабочее дерево получает только то, что лежит в индексе.** `git worktree add`
+  разворачивает коммит, а настройки, ключи, локальные разрешения и зависимости в коммит не
+  входят: свежее дерево выглядит готовым и упирается в нехватку не сразу, а на первом гарде,
+  которому нужен ключ. Что именно переносится руками, названо списком в компаньоне правила, и
+  список пополняется тем же движением, которым заводится новый файл вне индекса.

package/assets/rules/spec-driven.md

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

package/assets/rules/task-flow.md

@@ -11,6 +11,8 @@ description: Правило под «Закон о ведении работы»
 про ход работы; здесь — чем это названо в этом дереве, где лежит и что из закона у нас не
 проверяется.
 
+**Требует:** `hooks/task-flow-guard.sh`, `hooks/task-context-load.sh`, `hooks/grill-gate.sh`, `hooks/window-fill-guard.sh`
+
 ## Как это называется здесь
 
 | В законе                                      | Здесь                                                                                                                         |
@@ -76,6 +78,15 @@ description: Правило под «Закон о ведении работы»
   законов или правил, поиск по ним. Отбивает гард разговора — на завершении хода, а не на
   инструменте вопроса: спрашивают чаще прозой, чем меню. Найденное ложится в раздел «Что уже
   сказано в правилах» разбора.
+- **Действия, которые исполнитель не делает без слова владельца, перечислены в компаньоне
+  правила.** Список у каждого дерева свой — пакет знает только требование, чтобы список был
+  назван. Не названный, он выводится из общих слов, и «делай, что нужно по плану» становится
+  разрешением на пуш и правку общих документов заодно с коммитом.
+- **Ход, в котором исполнитель признал промах, не заканчивается, пока записи о происшествии
+  нет.** Отбивает гард происшествия — на завершении хода: к моменту признания промах уже
+  случился, и ловить раньше нечего. Признание ловится набором образцов, а не пониманием смысла;
+  промах, признанный словами вне набора, гард пропускает, и это его известная граница, а не
+  обещание.
 - **Состояние незаконченной работы приходит в контекст на запуске сессии.** Замысел и ход
   работы отдаются целиком, разбор просьбы — путём. Ветка вида `<КЛЮЧ>-*` без папки даёт
   предупреждение с готовой командой, но сессию не рвёт.
@@ -135,6 +146,12 @@ description: Правило под «Закон о ведении работы»
 обязательных вопросов, ни о том, ответил ли на них владелец. Образец разбора перечисляет их
 таблицей, но пустая таблица проходит так же, как заполненная.
 
+Гард разговора судит завершение хода, а не отправку вопроса. К моменту отказа вопрос уже у
+владельца, и владелец видит его вместе с отбитым ходом: требование срабатывает, но исполняется
+задним числом. Прозаический вопрос инструментом не является, и раньше поймать его нечем.
+Отсюда порядок: правило работы читается первым движением захода, до первой реплики владельцу,
+а не по отказу гарда; гард отмечает пропуск, но не отменяет его.
+
 Неизменность замысла не стережёт ничто: `plan.md` правится тем же инструментом, что и
 остальные тексты, и правка по ходу отличима от первоначальной записи только по истории.
 Держится это тем же, чем и порядок разбора.
@@ -170,9 +187,13 @@ description: Правило под «Закон о ведении работы»
   договорённость обязана его пережить: её сценарии получают номера в общей нумерации домена,
   и на них ссылаются заголовки тестов. Обратное тоже верно — ход работы не кладётся в
   `proposed/`: спек, в котором завелись шаги, снова становится планом и умирает после мержа.
-- **Меню вариантов на разборе годится только для выбора значения из закрытого набора.** Пока
-  постановка вопроса не подтверждена, спрашивается прозой: у меню нет строки «вопрос не тот».
-  Выбор слова, имени и термина узким вопросом не является никогда.
+- **У меню нет строки «вопрос не тот».** Меню годится для выбора значения из закрытого набора;
+  пока постановка вопроса не подтверждена, отвергнуть её владельцу нечем — он выбирает из
+  вариантов, выведенных из неверной посылки. Настройки владельца, требующие меню, требование
+  не снимают: тогда к каждому вопросу добавляется свободный вариант, и он же — единственное
+  место, где вопрос отвергается целиком. Три вопроса ушли одним меню, у одного постановка была
+  ложной, и сказать «вопрос не тот» было нечем. Выбор слова, имени и термина узким вопросом не
+  является никогда.
 - **Субагент вопросов владельцу не задаёт.** Ни роли, ни конвейер до него не достучатся —
   они возвращают текст главному агенту. Поэтому разбор ведёт главный агент, а роли стоят по
   обе стороны от него.

package/assets/skills/agent-kit.md

@@ -44,8 +44,35 @@ description: Переносимый слой правил агента — за
 npx agent-kit doctor        # что разложено, что отстало, что лежит от отказанного
 npx agent-kit sync          # разложить
 npx agent-kit sync --check  # ничего не писать, отказать при расхождении
+npx agent-kit stats         # чем пользовались, чем ни разу, обо что спотыкались
+npx agent-kit propose       # отправить предложения, адресованные пакету
 ```
 
+## Обратная связь наверх
+
+Слой правил правится не по памяти, а по тому, как им пользовались. Держится это тремя вещами.
+
+**Наблюдения** пишут сами гарды — в `.claude/rt-kit/observations/`, файлом на день. В строке
+имя ресурса пакета, род события, род правки, версия и признак сессии; путей дерева, имён его
+доменов и его собственного имени там нет. Выключаются ключом `"observe": false` в конфиге.
+
+**Сводка** — `agent-kit stats`. Самая ценная её строка не «чем пользовались», а **что разложено
+и не загружено ни разу**: правило, которого никто не открыл, ничем себя не выдаёт.
+
+**Предложения** приносит разбор закрытой задачи — командой `/skill-curator`. Каждому он ставит
+адрес: «пакет», «компаньон» или «дерево». Выгружаются они файлом в `.claude/rt-kit/proposals/`
+(форма — шаблон `proposal.md`), а `agent-kit propose` отправляет наружу те, что адресованы
+пакету, вместе со сводкой. Текст с адресом этого дерева отбивает отправку целиком.
+
+Разбираются они в репозитории самого пакета — командой `/agent-kit-digest`, там же, где лежат
+правимые ресурсы и видно всех потребителей сразу.
+
+Предложение работу не выправляет. Оно лежит текстом, читается глазами и в контекст сам собой
+не приходит: замечание было прочитано, процитировано владельцу и нарушено в том же ходе —
+цитата не становится правилом от того, что её произнесли. Закрытым предложение считается,
+только войдя в ресурс пакета; до этого на него не ссылаются как на действующее требование и не
+считают дырку закрытой.
+
 ## Установка туда, где уже всё своё
 
 1. `init`, затем `skip` на всё, что дерево держит само. Пустая раскладка — законное начало.
@@ -83,3 +110,8 @@ npx agent-kit sync --check  # ничего не писать, отказать
 - **Утверждение правила переезжает вместе с кодом.** Вынесенное в надстройку перестаёт
   находиться по прежнему символу, и привязка в спутнике правила врёт молча — сверка спеков
   ловит это, но только если её позвать.
+- **Признак по подстроке пути судит и то, что лежит вне дерева.** Гарды отдают в профиль
+  абсолютный путь целиком, и образец вида `*/projects/*` совпадает с домашним каталогом агента
+  ровно так же, как с кодом дерева: запись в файл вне репозитория была отбита гардом хода
+  работы с требованием замысла, к ней не относящегося. Путь в профиле сначала приводится к
+  корню дерева, и всё, что вне корня, признака не получает.

package/assets/templates/postmortem.md

@@ -0,0 +1,32 @@
+# <чем был промах, а не на какой задаче случился>
+
+<дата>. <Одна строка: где шла работа и до чего она дошла.>
+
+## Что произошло
+
+<Что исполнитель сделал и чем это было неверно. Без оценок: разбирается механизм, а не
+намерение.>
+
+## Механизм промаха
+
+1. <что принято за данность>
+2. <откуда взято>
+3. <чем подтверждено — и почему подтверждение оказалось ложным>
+4. <что сделано дальше>
+
+## Что было доступно до промаха
+
+- <файл, команда или уже прочитанное, где лежал ответ>
+
+Отсюда видно, промах это или нехватка данных.
+
+## Чем ловилось
+
+- **Слоем правил —** <что отбило, что промолчало>.
+- **Гардом —** <сработал, не сработал, сработал поздно>.
+- **Владельцем —** <заметил сразу, заметил на приёмке, не заметил>.
+
+## Что ушло в слой правил
+
+<Предложение с адресом либо правка закона, правила, паттерна — с именами. Запись без этого
+раздела закрытой не считается: разбор, из которого ничего не вышло, — жалоба.>

package/assets/templates/proposal.md

@@ -0,0 +1,39 @@
+# Предложения по слою правил
+
+<!--
+Кладёт этот файл главный агент — шагом команды `/skill-curator`, из ответа роли разбора. Роль
+файлов не пишет: правила действуют на все будущие сессии, и менять их молча нельзя.
+
+Читает файл `agent-kit propose`. Форма заголовка — не украшение: по ней команда отбирает то,
+что уезжает в репозиторий пакета.
+
+    ## <адрес> · <ресурс>
+
+Адрес один из трёх, и ставит его роль:
+
+    пакет      — правка ресурса @rt-tools/agent-kit; уезжает наружу
+    компаньон  — implementation.md рядом с правилом: имена этого дерева
+    дерево     — надстройка этого дерева; наружу не уезжает никогда
+
+Ресурс называется идентификатором пакета — `rules/styling-bem.md`, `hooks/skill-gate.sh`, — а у
+адресов «компаньон» и «дерево» путём в дереве.
+
+В тексте предложения не бывает ни путей этого дерева, ни имён его доменов, ни его собственного
+имени: файл уезжает в чужой репозиторий целиком. Найденный адрес дерева отбивает отправку с
+номером строки — это проверка, а не напоминание.
+-->
+
+## пакет · rules/<правило>.md
+
+- **место:** раздел «<заголовок>», в конец
+- **повод:** что в этой задаче пошло не так без этого правила
+
+> Готовый текст правки — ровно то, что вставить, в стиле соседних правил: по-русски,
+> утверждением, без воды.
+
+## дерево · .claude/rt-kit/gate-map.sh
+
+- **место:** ветка `edit`, рядом с соседним родом файлов
+- **повод:** свой род файлов, которого у других деревьев нет
+
+> Готовый текст правки.

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":";AAaA,OAAO,EAAqC,iBAAiB,EAAc,MAAM,oBAAoB,CAAC;AAoKtG,wBAAsB,IAAI,CAAC,IAAI,EAAE,SAAS,MAAM,EAAE,GAAG,OAAO,CAAC,iBAAiB,CAAC,CAqC9E"}
+{"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"}

package/bin/agent-kit.js

@@ -5,12 +5,15 @@
  * спеками — кроме одного, чего команде знать не по чину: откуда взялся выбор законов. У строки
  * запуска это флаг, у терминала — вопрос, у прогона без терминала нет ни того ни другого.
  */
+import { execFileSync } from 'node:child_process';
 import { readFileSync } from 'node:fs';
 import { dirname, join, resolve } from 'node:path';
 import { fileURLToPath } from 'node:url';
 import process from 'node:process';
 import { readCatalog, resolveSelection } from '../lib/catalog.js';
-import { adopt, doctor, init, list, sync } from '../lib/commands.js';
+import { adopt, doctor, init, list, propose, stats, sync } from '../lib/commands.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';
@@ -23,6 +26,11 @@ const USAGE = [
     '  sync            разложить ресурсы пакета в дерево проекта',
     '  sync --check    ничего не писать, отказать при расхождении — для гейта пуша',
     '  doctor          рассказать о состоянии раскладки, ничего не меняя',
+    '  stats           свести наблюдения: чем пользовались, чем ни разу, обо что спотыкались',
+    '  stats --days N  за сколько дней; без довода — за три',
+    '  stats --json    то же машиночитаемо — этим сводку прикладывают к предложению',
+    '  propose         отправить предложения с адресом «пакет» в очередь работ пакета',
+    '  propose --dry-run   показать, что уехало бы, и ничего не отправлять',
     '  adopt [файлы]   отдать пакету файлы, лежащие на его путях не от него',
     '',
     '  --root <путь>   корень проекта; по умолчанию текущий каталог',
@@ -53,8 +61,23 @@ function environmentOf(root) {
         // Сверка со своими исходниками возможна только отсюда: здесь пакет знает, где лежит сам.
         // У потребителя исходников рядом нет, и сверка молчит.
         stale: staleBuild(pkg, manifest.name),
+        // Куда уезжают предложения. Читается из манифеста: зашитый в код адрес назвал бы чужое
+        // дерево в текстах пакета — и врал бы у всякого, кто пакет форкнул.
+        repository: repositoryOf(manifest.repository?.url ?? ''),
     };
 }
+/** Чем это дерево себя выдаёт снаружи. Нет удалённого репозитория — нечем, и это не отказ. */
+function remoteOf(root) {
+    try {
+        return execFileSync('git', ['-C', root, 'remote', 'get-url', 'origin'], {
+            encoding: 'utf8',
+            stdio: ['ignore', 'pipe', 'ignore'],
+        }).trim();
+    }
+    catch {
+        return '';
+    }
+}
 function optionOf(argv, name, fallback) {
     const index = argv.indexOf(name);
     return index >= 0 && argv[index + 1] ? argv[index + 1] : fallback;
@@ -168,6 +191,32 @@ export async function main(argv) {
             return list(env);
         case 'sync':
             return sync(env, argv.includes('--check'));
+        case 'stats': {
+            const spoken = Number(optionOf(argv, '--days', ''));
+            return stats(env, {
+                days: Number.isFinite(spoken) && spoken > 0 ? Math.floor(spoken) : DEFAULT_DAYS,
+                // Сегодняшний день берётся здесь: у команды своих часов нет, иначе сводку за
+                // отрезок не проверить спекой — вчерашняя фикстура завтра станет позавчерашней.
+                today: new Date().toISOString().slice(0, 10),
+                json: argv.includes('--json'),
+            });
+        }
+        case 'propose': {
+            // Сводка едет вместе с предложением: без цифр оно читается как мнение. Берётся тем
+            // же отрезком, что и сводка по умолчанию, — предложение пишут по свежей задаче.
+            const summary = stats(env, {
+                days: DEFAULT_DAYS,
+                today: new Date().toISOString().slice(0, 10),
+                json: false,
+            });
+            return propose(env, {
+                dryRun: argv.includes('--dry-run'),
+                submit: ghIssue,
+                repository: env.repository ?? '',
+                remote: remoteOf(env.root),
+                summary: summary.lines,
+            });
+        }
         case 'doctor':
             return doctor(env);
         case 'adopt':