@rt-tools/agent-kit 0.22.0 → 0.23.0

package/assets/hooks/grill-gate.sh

@@ -165,6 +165,68 @@ verdict="$(tail -n 400 "$transcript" 2>/dev/null | jq -s -r --arg re "$read_re"
     | if ($asked_prose or $asking_now) and ($read | not) then "ask" else "pass" end
 ' 2>/dev/null)"
 
+# Второй признак того же гарда: на этот вопрос владелец уже отвечал.
+#
+# Первый признак судит, читались ли правила, и на разрешённой работе молчит. А промах бывает
+# другой: владелец дал указание прямой репликой, исполнитель нашёл факт, который меняет цену
+# указания, но не его смысл, — и вместо строки о цене задал меню, где два варианта из трёх
+# предлагали отменить решение владельца. Работа встала до ответа, разрешённая минутой раньше.
+#
+# Судится пересечение слов: вопрос, который сейчас уходит, против последней реплики владельца —
+# и только там, где в записи уже был вызов инструмента вопроса, то есть владелец на вопрос
+# отвечал. Понимания текста здесь нет и не нужно: три общих значимых слова означают тот же
+# предмет, а разбор из шести вопросов идёт по разным предметам и порога не набирает.
+#
+# ОТКАЗ В ПОЛЬЗУ РАБОТЫ: нет вопроса в вызове, нет реплики владельца, нет прошлого вопроса —
+# признак молчит.
+if [ -n "$tool" ]; then
+    asked_json="$(printf '%s' "$input" | jq -r '(.tool_input.questions // []) | tostring' 2>/dev/null)"
+    seen="$(tail -n 400 "$transcript" 2>/dev/null | jq -s -r --arg now "$asked_json" '
+        def is_input:
+            .type == "user"
+            and ((.isCompactSummary // false) | not)
+            and (((.message.content // []) | if type == "array"
+                    then ([.[] | select(.type == "tool_result")] | length)
+                    else 0 end) == 0);
+
+        def words: [splits("[^\\p{L}\\p{N}]+")] | map(select(length >= 5)) | unique;
+
+        (map(is_input) | rindex(true)) as $i
+        | if $i == null then "нет" else
+            (.[$i] | (.message.content // []) | if type == "array"
+                then ([.[] | select(.type == "text") | .text] | join(" "))
+                else (. // "") end) as $said
+            | ([.[:$i][] | select(.type == "assistant") | (.message.content // [])[]
+                 | select(.type == "tool_use") | select(.name == "AskUserQuestion")] | length) as $before
+            | if $before == 0 or ($said | length) == 0 then "нет" else
+                (($now | words) - (($now | words) - ($said | words))) as $common
+                | if ($common | length) >= 3 then "было" else "нет" end
+              end
+          end
+    ' 2>/dev/null)"
+
+    if [ "$seen" = "было" ]; then
+        reason="BLOCKED by grill-gate: на этот вопрос владелец уже отвечал в этом разговоре — продолжай работу, а не переспрашивай.
+
+Указание владельца действует до его отмены. Новый факт против действующего указания — это строка в ответе о цене, а не новый вопрос: переспрашивают только то, чего указание не покрывает. Промах здесь не в форме вопроса, а в остановке работы, которая уже разрешена.
+
+Вопрос всё-таки о другом предмете — назови в нём то, чего в прежнем ответе владельца нет: признак судит общие слова вопроса и последней реплики владельца, а не смысл."
+
+        # Общий хвост отказа: два законных хода и законная форма обхода, если она у отказа есть.
+        # shellcheck disable=SC1090
+        [ -f "$rt_hooks_dir/deny-tail.sh" ] && . "$rt_hooks_dir/deny-tail.sh" 2>/dev/null
+        command -v rt_deny_tail >/dev/null 2>&1 || rt_deny_tail() { :; }
+        deny_tail_text="$(rt_deny_tail "")"
+        [ -n "$deny_tail_text" ] && reason="${reason}
+
+${deny_tail_text}"
+
+        jq -n --arg r "$reason" '{hookSpecificOutput:{hookEventName:"PreToolUse",permissionDecision:"deny",permissionDecisionReason:$r}}' 2>/dev/null \
+            || printf '{"hookSpecificOutput":{"hookEventName":"PreToolUse","permissionDecision":"deny","permissionDecisionReason":"grill-gate: на этот вопрос уже отвечали."}}\n'
+        exit 0
+    fi
+fi
+
 [ "$verdict" = "ask" ] || exit 0
 
 if [ -n "$tool" ]; then

package/assets/laws/autonomous-work.md

@@ -0,0 +1,30 @@
+# Закон об автономном заходе
+
+Заход, в котором владельца нет рядом. Он не отвечает на вопросы, не нажимает кнопок и не видит
+работы до утра: всё, что исполнитель сделал за ночь, читается им разом и уже случившимся.
+
+## Статьи
+
+- **Автономный заход объявляет владелец, и кончается он его словом либо названной границей.**
+  Сам себя заход не продлевает: работа без конца — это работа, о которой владелец не просил.
+- **Развилка закрывается умолчанием, а не ожиданием.** Вопрос, который некому задать, не
+  останавливает работу: исполнитель берёт умолчание, записывает его вместе с ценой ошибки и идёт
+  дальше. Стоящий заход не отвечает ни на один вопрос и стоит ровно столько же, сколько
+  отвеченный неверно.
+- **Задача, упирающаяся в слово владельца, откладывается целиком.** Наполовину сделанная
+  выглядит сделанной: следующий заход читает её как закрытую и не возвращается к ней.
+- **Действие, которое видно снаружи, в автономном заходе не делается.** Отправка чужой стороне,
+  публикация, слияние, письмо: их последствия отменяет человек, а его нет. Отмена стоит дороже
+  ожидания.
+- **Работа, которую нечем подтвердить, не берётся.** Признак готовности автономного захода —
+  команда с известным выводом, а не взгляд исполнителя: подтвердить его некому.
+- **Каждый шаг кончается следом на диске.** Заход обрывается без предупреждения — по окну, по
+  отказу, по сети, — и всё, что не записано, исчезает вместе с ним.
+- **Работы идут чередой, а не веером из одного основания.** Каждая следующая ветвится от
+  предыдущей: расхождение тогда всплывает у того, у кого обе правки под рукой, а не у владельца,
+  у которого нет ни одной.
+- **Заход кончается списком, а не итогом.** Владелец читает ночь целиком: по каждой работе видно,
+  что сделано, где лежит, чем подтверждено и чего она ждёт. Итог «сделано много» не говорит ни о
+  чём из четырёх.
+- **Отказ стража автономный заход не кончает.** Он называет пропущенный шаг, и шаг делается;
+  заход, вставший на отказе до утра, теряет ночь целиком.

package/assets/laws/project-documentation.md

@@ -43,6 +43,14 @@
 - **Число в тексте пересчитывается тем же изменением, которым пишется, и за этим тоже следит
   автор.** Устаревшее число выглядит так же, как свежее, а машине их не различить: дата, версия и
   номер — такие же числа, и проверка, которая знает один способ записи, на другом ошибается молча.
+- **Слово, значащее в дереве что-то определённое, записано в словаре дерева.** Слова, которого
+  там нет, у читателя нет тоже: оно вводится в словарь тем же изменением, которым впервые
+  употреблено, либо заменяется тем, что уже есть. Словарь читается до того, как текст написан, а
+  не сверяется после: сверка после находит слово, вокруг которого уже построен абзац.
+- **Документ, собираемый из нескольких источников, правится в источнике.** Правка собранного вида
+  живёт до следующей сборки и пропадает молча — а выглядит она ровно так же, как правка, которая
+  осталась. Собранный документ обязан называть свой источник в себе самом: сказанное о нём где-то
+  ещё до читателя может не доехать, а собранный вид доезжает всегда.
 - **Отказ от слова распространяется на всё, что уже прочитано снаружи, а не только на файлы.**
   Название работы, её описание и запись о правке живут вне дерева: поиск по файлам их не видит,
   проверки текстов на них не смотрят, и отказ выглядит сделанным ровно до того, как читатель

package/assets/patterns/autonomous-work-run.md

@@ -0,0 +1,105 @@
+---
+name: autonomous-work-run
+kind: pattern
+rule: autonomous-work
+description: Паттерн правила autonomous-work. Брать, когда владелец ушёл и работа идёт ночь напролёт — готовый цикл одной работы, ветвление чередой, запись умолчания вместо вопроса, список к утру, разбор отказа стража. Не брать для обычного хода работы — это паттерны task-flow-start и task-flow-resume.
+---
+
+# Ночь без владельца
+
+Паттерн правила `autonomous-work`. Что при этом должно быть верно — закон
+`docs/constitution/autonomous-work.md`.
+
+## Когда брать
+
+- Владелец сказал, что уходит, и просил работать самостоятельно.
+- За заход берётся больше одной задачи подряд, и отдать их наружу нельзя.
+- Работа упёрлась в вопрос, а спросить некого.
+
+## Череда веток
+
+Первая работа ветвится от главной, каждая следующая — от предыдущей:
+
+```bash
+git checkout -b <КЛЮЧ>-<номер-1>-<slug> main           # первая за ночь
+git checkout -b <КЛЮЧ>-<номер-2>-<slug> <КЛЮЧ>-<номер-1>-<slug>
+git checkout -b <КЛЮЧ>-<номер-3>-<slug> <КЛЮЧ>-<номер-2>-<slug>
+```
+
+Порядок вливания — снизу вверх, и он называется в списке к утру номерами. Ветка, заведённая от
+главной посреди череды, столкнётся с соседкой в общих файлах — указателях, счётчиках, журналах —
+и разбирать это будет владелец.
+
+```bash
+git log --oneline --graph --decorate main..HEAD | head -20   # чем стоит череда сейчас
+git branch --list '<КЛЮЧ>-*' --format='%(refname:short) %(upstream:short)'
+```
+
+## Цикл одной работы
+
+```bash
+npm run task:move -- <номер> in-progress                 # взята
+git checkout -b <КЛЮЧ>-<номер>-<slug> <прошлая ветка>    # череда, а не веер
+cp -r docs/tasks/_template docs/tasks/<КЛЮЧ>-<номер>-<slug>
+# разбор просьбы с умолчаниями, замысел, состояние «этап-идёт»
+git add docs/tasks/<КЛЮЧ>-<номер>-<slug> && git commit    # папка едет в историю сразу
+# работа этапами: каждый кончается коммитом и прогоном признака готовности
+# папка разбирается в описание прошлого последним коммитом
+```
+
+Наружу за ночь не уходит ничего: ни `git push`, ни `gh pr create`, ни публикация, ни отметка
+груза. Ветка остаётся местной, и утром владелец сам решает, что из неё отдавать.
+
+## Умолчание вместо вопроса
+
+Пишется в разбор просьбы, в раздел решений, — там же, где записался бы ответ владельца:
+
+```markdown
+- **<что принято>** — <довод>. Спросить было некого: заход автономный. Цена ошибки:
+  <что придётся переделать, если владелец решит иначе>.
+```
+
+Цена ошибки — не вежливость, а признак: она отделяет умолчание, которое можно переиграть за
+десять минут, от того, ради которого работу лучше отложить целиком.
+
+## Отложенная задача
+
+Задача, которой нужно слово владельца, не берётся: состояние на борде остаётся прежним, а в
+список к утру идёт строка.
+
+```markdown
+- **RT-<номер> — <заголовок>.** Отложена: <какой вопрос и почему умолчания у него нет>.
+```
+
+## Список к утру
+
+Дописывается по ходу, после каждой закрытой работы, а не собирается в конце.
+
+```markdown
+| Работа | Ветка | Чем подтверждена | Чего ждёт |
+| ------ | ----- | ---------------- | --------- |
+| RT-… — <что сделано> | `<ветка>` (на `<предыдущей>`) | `<команда>` — <вывод> | заявки и слияния |
+```
+
+Порядок строк — порядок вливания. Ниже списка — отложенные задачи с их вопросами.
+
+## Отказ стража
+
+Отказ называет пропущенный шаг: шаг делается, вызов повторяется, работа идёт дальше. Ночь
+кончается работой, а не спором со стражем.
+
+- Отказ требует того, что делать нельзя (пуш, заявка), — работа доводится до места, где
+  требование исполнимо утром, и уходит в список к утру строкой «ждёт заявки».
+- Отказ повторяется на том же месте дважды — значит пропущенный шаг понят неверно: читается
+  правило, названное в отказе, а не переписывается формулировка.
+
+## Частые промахи
+
+- **Ветка заведена от главной по привычке.** Череда рвётся молча, и цена всплывает у владельца
+  на втором вливании.
+- **Умолчание принято и не записано.** Утром оно неотличимо от знания, и владелец узнаёт о нём,
+  только когда работа сделана не так.
+- **Задача взята и отложена наполовину.** На борде она в работе, в ветке — половина правки;
+  следующий заход читает её как начатую и не начинает заново.
+- **Список к утру собран по памяти в последнюю минуту.** К этому часу окно уже сжималось, и
+  половина ночи в него не попала.

package/assets/patterns/browser-verification-stand.md

@@ -169,7 +169,7 @@ done
 
 - **Одиночная сборка проекта серверы переживают, и отказываться от неё незачем.** Замерено
   ответом до и после: все порты остались за своими процессами. Осторожность здесь стоит дороже
-  проверки — целая команда паттерна `seo-verify` осталась незапущенной ровно потому, что сборку
+  проверки — целый набор проверок разметки остался незапущенным ровно потому, что сборку
   сочли опасной, не замерив. Сборка из кэша замером не является: она не собирает вовсе, и видно
   это по её длительности.
 - Свой дев-сервер не поднимать: сайт на {{sitePort}}, админка на {{adminPort}}, API на {{apiPort}} уже подняты

package/assets/patterns/doc-style-write.md

@@ -104,6 +104,22 @@ description: Паттерн правила doc-style. Брать при напи
 его вместе со смыслом. Считается это грепом по тексту, и число само по себе отказом не бывает:
 судит его тот, кто правит следующим.
 
+## Новое слово в словаре
+
+Слово, значащее в дереве что-то определённое, живёт в словаре. Порядок — четыре шага, и первый
+из них не пропускается: словарь читается до того, как текст написан, а не сверяется после.
+
+1. **Поиск по собранному словарю целиком**, включая раздел отвергнутых слов. Слово, от которого
+   дерево отказалось, стоит там же — и вводить его заново значит отменять чужое решение молча.
+2. **Выбор своего раздела.** Раздел надстройки замещает одноимённый раздел набора целиком:
+   название берётся такое, какого в наборе нет.
+3. **Строка парой — слово и что это.** Без второй половины слово не введено: оно названо.
+4. **Раскладка тем же изменением**, и сверка при этом зелёная. Слово, введённое в надстройку и не
+   разложенное, у читателя ещё не появилось.
+
+Слово, от которого дерево отказывается, заводится там же и с заменой в той же строке: отказ без
+замены исполнить нечем — пишущий видит запрет и не видит, чем его закрыть.
+
 ## Факт проверяется, а не вспоминается
 
 Перед тем как написать, что код делает X, — открыть код и посмотреть. Пересказ по памяти

package/assets/patterns/git-workflow-pr-ready.md

@@ -0,0 +1,93 @@
+---
+name: git-workflow-pr-ready
+kind: pattern
+rule: git-workflow
+description: Паттерн правила git-workflow. Брать, когда заявки уже открыты: снятие черновика, разбор красного прогона, доведение череды до готовности, порядок «сначала довести отданное, потом брать новое». Открытие одной заявки — паттерн git-workflow-pr, порядок череды — git-workflow-stack.
+---
+
+# Доведение заявки до готовности
+
+Паттерн правила `git-workflow`. Что при этом должно быть верно — закон
+`docs/constitution/delivery.md`. Открытие заявки — паттерн `git-workflow-pr`, порядок череды —
+`git-workflow-stack`, разбор одного конфликта — `git-workflow-merge`.
+
+## Когда брать
+
+- Заявка открыта черновиком, и прогон по ней кончился.
+- Открыто несколько заявок разом, и надо решить, что делать раньше — доводить их или брать
+  следующую задачу.
+- Прогон заявки красный, а правка в ветке зелёная у себя.
+
+## Черновик — состояние работы, а не её вид
+
+Черновик говорит одно: работу нельзя вливать. Кнопка слияния у него заблокирована хостингом, и
+владелец, открывший список, видит не «сделано», а «делается». Заявка с зелёным прогоном и
+неснятым черновиком — сделанная работа, выглядящая незаконченной, и поправить это может только
+тот, кто её отдал.
+
+Отсюда порядок: **черновик снимается тем же ходом, которым прочитан зелёный прогон.** Не
+следующим, не после соседней задачи.
+
+```bash
+gh pr ready <номер>
+```
+
+Снятие черновика — последний шаг отдачи работы, а не отдельное дело. Пока он не сделан, работа
+не отдана, сколько бы коммитов ни лежало в ветке.
+
+## Сначала довести отданное, потом брать новое
+
+Открытая заявка — работа в полёте: её прогон стареет, её ветка отстаёт от главной, её тело
+описывает дерево на день написания. Всё это чинится дёшево сегодня и дорого через три задачи.
+
+Очередь поэтому такая:
+
+1. Прогоны открытых заявок прочитаны, черновики с зелёных сняты.
+2. Красные разобраны и починены.
+3. И только потом берётся следующая задача.
+
+Взять новую задачу, оставив позади десяток заявок черновиками, — значит отчитаться о работе,
+которой у владельца нет: он видит список «делается», а не список «готово».
+
+## Состояние читается разом
+
+Чем оно читается и как разбирается каждое поле — паттерн `git-workflow-freshness`; здесь
+только то, что делают с прочитанным. Пустой прогон разбирается наравне с красным: у заявки
+череды база не главная ветка, и фильтр по базе такое событие до конвейера не пропускает.
+
+## Красный прогон разбирается по шагу, а не по заявке
+
+```bash
+gh pr checks <номер>
+```
+
+Ответ называет упавший прогон и ссылку на него. Дальше у хостинга спрашивается имя упавшего
+шага — `gh api` по этому прогону, отбором `select(.conclusion=="failure")` по его шагам.
+
+Имя шага и есть диагноз. Правка идёт в ту ветку череды, где причина возникла, а не в ту, где
+прогон покраснел: у череды красным становится всё, что стоит выше причины.
+
+## Правка причины — в нижнюю ветку, оттуда волной вверх
+
+Причина, общая для всей череды, чинится один раз в самой нижней ветке. Наверх она едет
+вливанием, а не перебазированием: перебазирование переписывает историю уже отданных веток, и
+хостинг закрывает заявки верхних как слитые, хотя в главной их правок нет.
+
+Волна идёт снизу вверх, по одной ветке, и каждый шаг — три отдельных вызова: переключение на
+следующую ветку череды, вливание предыдущей в неё, отправка. Одной строкой их не пишут: гард
+поставки такую команду отбивает, и правильно — набор проверок гоняется по тому дереву, какое
+лежит на момент разбора команды, то есть по прежней ветке.
+
+Пропущенная посередине ветка оставляет свою заявку красной и ломает порядок вливания, поэтому
+волна проходит череду целиком.
+
+## Частые промахи
+
+- Черновик не снят, потому что «ещё гоняется прогон». Прогон кончился час назад; читается его
+  состояние, а не память о том, что он шёл.
+- Взята следующая задача, а десяток заявок остался черновиками. Для владельца сделанного нет.
+- Красное чинится в той ветке, где покраснело. У череды это верхняя, а причина — в нижней, и
+  починка сверху оставляет красным всё под собой.
+- Причина разослана по веткам перебазированием. Отданные ветки переписаны, заявки закрыты как
+  слитые, правок в главной нет.
+- Пустой прогон принят за зелёный. Событие до конвейера не дошло, и заявка не проверена вовсе.

package/assets/patterns/git-workflow-pr.azure.md

@@ -180,7 +180,7 @@ npm run task:move -- 86 in-review
 8. **Правка вёрстки подтверждена замером**, а не взглядом, и снята при узком экране — паттерн
    `browser-verification-measure`.
 9. **Правка разметки публичного сайта проверена на прод-сборке по всем локалям перевода** —
-   паттерн `seo-verify`.
+   правило видимости в поиске того дерева, где оно есть.
 10. **PR привязан к рабочему элементу**, ревьювер и исполнитель стоят, а тело собрано по
     образцу — разделы «Что сделано», «Чем подтверждено» и «Оставшийся шаг». Раздел оставшегося
     шага к этому моменту говорит, что шагов не осталось: черновик снимается после разбора

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

@@ -242,7 +242,7 @@ npm run task:move -- 86 in-review
 8. **Правка вёрстки подтверждена замером**, а не взглядом, и снята при узком экране — паттерн
    `browser-verification-measure`.
 9. **Правка разметки публичного сайта проверена на прод-сборке по всем локалям перевода** — паттерн
-   `seo-verify`.
+   правило видимости в поиске того дерева, где оно есть.
 10. **Тело PR собрано по образцу** — начинается строкой `Closes #<номер>`, несёт разделы «Что
     сделано», «Чем подтверждено» и «Оставшийся шаг», а метки, ревьювер и исполнитель стоят.
     Раздел оставшегося шага к этому моменту говорит, что шагов не осталось: черновик снимается

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

@@ -194,7 +194,7 @@ npm run task:move -- 86 in-review
 8. **Правка вёрстки подтверждена замером**, а не взглядом, и снята при узком экране — паттерн
    `browser-verification-measure`.
 9. **Правка разметки публичного сайта проверена на прод-сборке по всем локалям перевода** —
-   паттерн `seo-verify`.
+   правило видимости в поиске того дерева, где оно есть.
 10. **Описание MR собрано по образцу** — начинается строкой `Closes #<номер>`, несёт разделы
     «Что сделано», «Чем подтверждено» и «Оставшийся шаг», а метки, ревьювер и исполнитель
     стоят. Раздел оставшегося шага к этому моменту говорит, что шагов не осталось: черновик

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

@@ -34,16 +34,15 @@ Agent(subagent_type: "Explore", prompt: "<тема просьбы>: что по
 
 Находки складываются в раздел «Что уже есть в дереве» разбора.
 
-Дерево — не единственное место, где может лежать ответ. Решение, принятое прошлым заходом и
-никуда не записанное, живёт только в записи того захода: записи заходов лежат в каталоге заходов
-агента, и поиск по ним словом темы стоит одной команды. Найденное там ответом не остаётся на
-месте — тем же ходом оно переписывается в дерево: в замысел эпика, если связывает задачи, и в
-ход работы, если касается одной.
+Дерево — не единственное место, где лежит ответ. Решение прошлого захода, никуда не записанное,
+живёт только в записи того захода: поиск по ним словом темы стоит одной команды. Найденное тем же
+ходом переписывается в дерево — в замысел эпика, если связывает задачи, и в ход работы, если
+касается одной.
 
-Разведка, не нашедшая ничего, разрешением спрашивать не становится. Сначала называется, где
-искали, потом добираются места, которых в списке не было: замысел эпика, описание прошлого,
-записи прошлых заходов. Одно место отрицанием не является: «в таком-то месте не нашёл» говорит о
-месте, а не о дереве, и вопрос называет оба способа, которыми искали.
+Разведка, не нашедшая ничего, разрешением спрашивать не становится: сначала называется, где
+искали, потом добираются места, которых в списке не было — замысел эпика, описание прошлого,
+записи прошлых заходов. «В таком-то месте не нашёл» говорит о месте, а не о дереве, и вопрос
+называет оба способа, которыми искали.
 
 Разведка кончается не ощущением, а выводом команд. До первого вопроса владельцу исполнитель знает:
 как устроен репозиторий (корневая памятка), что лежит в каталоге, о котором пойдёт речь (`ls`), и
@@ -52,11 +51,22 @@ Agent(subagent_type: "Explore", prompt: "<тема просьбы>: что по
 дереву не запускается ни одной команды.
 
 Разведка по заведённой задаче кончается воспроизведённым симптомом, а не найденным файлом. Тело
-задачи описывает дерево на день заведения, и чужие правки въезжают в главную ветку между
-заведением и работой: разведка по именам из тела подтверждает, что файлы на месте, — и отпавшая
-задача от живой не отличается ничем. Прежде первой своей правки разведка повторяет то, на что
-задача жалуется: зовёт процедуру, читает ответ, гоняет молчавшую проверку. Симптом не
-воспроизвёлся — задача закрывается отпавшей, и это законный её исход.
+задачи описывает дерево на день заведения, и разведка по именам из тела подтверждает лишь то, что
+файлы на месте: отпавшая задача от живой этим не отличается. Прежде первой правки разведка
+повторяет то, на что задача жалуется, — зовёт процедуру, читает ответ, гоняет молчавшую
+проверку; симптом не воспроизвёлся — задача закрывается отпавшей, и это законный исход.
+
+Дерево, названное образцом, читается раскладкой целиком — обходом каталогов на два уровня, — и
+только потом идут вопросы о приёмах. Ответ на «как здесь делают вот это» даёт одну папку, а
+обобщённая до карты дерева она врёт: соседняя семья каталогов в неё не попадает, и пропажу
+находит владелец.
+
+Выведенное помечается прямо в списке, вместе с тем, чем его подтвердить. Догадка по соседнему
+случаю стоит в одном списке с проверенным, и владелец читает список целиком как проверенный.
+
+Шесть вопросов задаются за вычетом тех, на которые ответила разведка: вместо вопроса с готовым
+ответом в разбор идёт строка «беру такой-то ответ, вот откуда». Признак один — есть ли ответ в
+дереве; «задача кажется понятной» им не является ни в ту, ни в другую сторону.
 
 **Следующее движение:** находки ложатся в разбор, и тем же ходом владельцу уходит первый из
 шести вопросов. Разведка кончилась — состояние осталось прежним, ход тоже.
@@ -77,18 +87,14 @@ Agent(subagent_type: "Explore", prompt: "<тема просьбы>: что по
 | Чем будет видно, что задача закрыта          | «работает» признаком не является                         |
 | Есть ли образец, с которого снимается подход | разведка найдёт похожее, а не то                         |
 
-Список шести — набор того, что должно быть закрыто к началу работы, а не набор реплик, которые
-надо произнести. Обязательный вопрос, ответ на который владелец уже дал, отмечается закрытым, а
-не задаётся: ответ ищется в двух местах — в документации и в том, что владелец сказал в этом же
-заходе, включая исходную просьбу. Слово, повторённое в просьбе несколько раз, ответом является.
-Закрытый вопрос отмечается в разборе просьбы вместе с тем, чем он закрыт.
-
-Закрыть его можно и допущением, когда ответ очевиден: в разборе стоит строка «вопрос закрыт
-допущением: <что принято>». Неверное допущение стоит правки, вопрос ради очевидного — захода.
+Список шести — набор того, что закрыто к началу работы, а не набор реплик, которые надо
+произнести. Вопрос, ответ на который владелец уже дал, отмечается закрытым вместе с тем, чем он
+закрыт: ответ ищется в документации и в сказанном этим же заходом, включая исходную просьбу.
+Закрыть его можно и допущением, когда ответ очевиден, — строкой «вопрос закрыт допущением:
+<что принято>»: неверное допущение стоит правки, вопрос ради очевидного — захода.
 
 Объём работы основанием для вопроса о границах не бывает: «это большая работа» решает
-исполнитель, «делать ли её целиком» — владелец, и решает раньше, чем работа началась. Вопрос о
-границах задаётся, когда владелец их не назвал, а не когда названные оказались широкими.
+исполнитель, «делать ли её целиком» — владелец, и решает раньше, чем работа началась.
 
 Форму вопроса задают настройки владельца: где требуют меню, спрашивается меню, и к каждому
 вопросу добавляется свободный вариант — у закрытого набора нет строки «вопрос не тот».
@@ -135,16 +141,14 @@ Workflow(name: "plan", args: "docs/tasks/_draft-<slug>")
 (`spec-critic`) → замысел и разбивка (`project-manager`). Пробелы, которые роли не смогли
 закрыть, возвращаются владельцу — их относит главный агент.
 
-Договорённость, вышедшая из конвейера, сверяется с `grill.md` построчно до того, как по ней
-пойдёт работа. Роль пишет текст, не видя владельца, и способна развернуть его ответ в
-противоположный: очередь этапов оказалась перевёрнута, а два пункта из входящих переехали в
-«не входит». Находка критика, расходящаяся с ответом владельца, относится владельцу — она не
-исполняется молча и не считается закрытой правкой текста.
+Договорённость, вышедшая из конвейера, сверяется с `grill.md` построчно до работы по ней: роль
+пишет текст, не видя владельца, и способна развернуть его ответ в противоположный — очередь
+этапов оказывалась перевёрнутой, а входящие пункты переезжали в «не входит». Находка критика,
+расходящаяся с ответом владельца, относится владельцу, а не исполняется молча.
 
-Ход на этой границе не кончается. Закрытый разбор выглядит законченным куском: ответы владельца
-лежат на диске, файл закоммичен, отчитаться есть чем — и отчёт встаёт ровно на то место, которое
-должна была занять договорённость. Пишется она тем же ходом, конвейером ролей или рукой
-исполнителя, и разницы между этими двумя случаями для конца хода нет.
+Ход на этой границе не кончается: закрытый разбор выглядит законченным куском — ответы на диске,
+файл закоммичен, отчитаться есть чем, — и отчёт встаёт на место договорённости. Пишется она тем
+же ходом, конвейером ролей или рукой исполнителя.
 
 **Следующее движение:** сверенная с разбором договорённость коммитится, и тем же ходом
 заводятся задача, ветка и папка — а вышла из разбора серия, сперва объявляется эпик.
@@ -179,12 +183,10 @@ Workflow(name: "plan", args: "docs/tasks/_draft-<slug>")
 таблицы, с меткой эпика. Выданные номера возвращаются в ту же таблицу — колонкой или приставкой
 к названию, — и с этой минуты «взять следующую» отвечает номером, а не названием.
 
-Задача, заведённая под эпик, называет его в своём теле: номер карточки эпика и путь к замыслу —
-одной строкой. Замысел называет задачу со своей стороны, и односторонняя привязка выглядит целой
-ровно так же, как двусторонняя — читатель приходит то от линии работ, то от карточки, и вторая
-сторона существует только для одного из них. Держалась она подражанием: пока тело писалось с
-образца соседней задачи того же эпика, строка копировалась вместе с формой, а задача, заведённая
-посреди работы находкой сверки, писалась не с образца.
+Задача под эпиком называет его в своём теле — номер карточки и путь к замыслу одной строкой, — а
+замысел называет задачу со своей стороны. Односторонняя привязка выглядит целой так же, как
+двусторонняя: читатель приходит то от линии работ, то от карточки, и вторая сторона есть только
+для одного из них.
 
 **Следующее движение:** объявленный эпик коммитится вместе с номерами задач, и тем же ходом
 берётся первая его задача — заведением ветки и папки.
@@ -197,19 +199,17 @@ git checkout -b <КЛЮЧ>-<номер>-<slug>
 npm run task:move -- <номер> in-progress
 ```
 
-Тело приходит файлом и пустым не бывает: заведённая пустой задача не говорит ничего ни
-исполнителю, ни владельцу, а дописать её потом можно только со слова владельца — и заводится
-пустое молча, номером наравне с полным.
+Тело приходит файлом и пустым не бывает: пустая задача не говорит ничего ни исполнителю, ни
+владельцу, а дописать её потом можно только со слова владельца.
 
 `task:new` переименовывает `_draft-<slug>` в `<КЛЮЧ>-<номер>-<slug>` и проставляет шапку замысла.
 Ветка заводится вторым вызовом: составную «завести и сразу коммитить» гард главной ветки
 отклоняет целиком.
 
-Номер уже выдан — черновика нет и не заводится: папка открывается сразу под именем ветки, а
-разбор пишется в неё же. Так начинается половина работ: номер приходит прошлым заходом,
-замеченным дефектом или соседней задачей, и шаг с черновиком тогда неисполним — переименовывать
-нечего. Ловушка «номер не бывает первым» сюда не относится: она про то, что задачу не заводят до
-разбора, а не про то, что с уже заведённой нельзя работать.
+Номер уже выдан — черновика нет и не заводится: папка открывается сразу под именем ветки. Так
+начинается половина работ: номер приходит прошлым заходом, замеченным дефектом или соседней
+задачей, и переименовывать нечего. Ловушка «номер не бывает первым» сюда не относится — она про
+то, что задачу не заводят до разбора.
 
 Остальные два файла пишутся, а не кладутся образцом впрок: пустой `plan.md` неотличим от
 замысла без этапов, а следующий заход доверяет папке задачи. Образец открывается тем же

package/assets/patterns/ts-procedure.md

@@ -2,7 +2,7 @@
 name: ts-procedure
 kind: pattern
 rule: typescript-conventions
-description: Паттерн правила typescript-conventions. Брать при заведении или правке процедуры Connect на бэкенде: готовый класс с полем метода и обработчиком, зависимости конструктором, имена файла и класса. Доступ к процедуре — паттерн permissions-procedure.
+description: Паттерн правила typescript-conventions. Брать при заведении или правке процедуры Connect на бэкенде: готовый класс с полем метода и обработчиком, зависимости конструктором, имена файла и класса. Доступ к процедуре описывает правило доступа того дерева, где оно есть.
 ---
 
 # Процедура Connect
@@ -41,7 +41,8 @@ export class PingProcedure implements IConnectProcedure<typeof HealthService.met
 }
 ```
 
-Объявление доступа обязательно, и оно ровно одно — паттерн `permissions-procedure`.
+Объявление доступа обязательно, и оно ровно одно; чем оно объявляется, говорит правило
+доступа того дерева, где такое правило есть.
 
 ## Почему форма такая