@rt-tools/agent-kit 0.22.0 → 0.24.0

package/assets/hooks/rule-source-guard.sh

@@ -107,6 +107,17 @@ while IFS= read -r candidate; do
     resource="$(head -12 "$candidate" 2>/dev/null | sed -nE 's/.*rt-kit v[^ ]+ · ([^ ]+) · [0-9a-f]+.*/\1/p' | head -1)"
     [ -z "$resource" ] && continue
 
+    # Файл в конфликте пропускается наравне со снятым. Разрешение конфликта содержания копии не
+    # меняет — раскладка кладёт её заново, — а отбитый здесь исполнитель остаётся с наполовину
+    # слитой веткой и без законного хода: источник править нечего, надстройка конфликта не
+    # снимает. Признаков два, и хватает любого: запись индекса о неслитом файле и маркеры
+    # слияния в самом файле — второй нужен там, где слияние ведёт не git, а сторонний
+    # инструмент, оставляющий маркеры без записи в индексе.
+    if [ -n "$(git -C "$root" ls-files -u -- "$candidate" 2>/dev/null)" ] \
+        || grep -qE '^(<<<<<<< |>>>>>>> )' "$candidate" 2>/dev/null; then
+        continue
+    fi
+
     if [ -n "$sources" ] && [ -f "$root/$sources/$resource" ]; then
         deny "BLOCKED by rule-source-guard: «${candidate#"$root"/}» разложен пакетом, и правка на его месте теряется на следующей раскладке — а до тех пор раскладка отказывает по этому файлу целиком, и цену платит тот, кто в этот день правит соседний ресурс. Ресурс — «${resource}». Правь источник: ${sources}/${resource} — потом собери пакет и разложи." \
             "правка, верная только этому дереву, идёт в надстройку .claude/rt-kit/overrides/${resource} — она сливается по разделу «## » и раскладку переживает"

package/assets/hooks/stand-login-guard.sh

@@ -0,0 +1,101 @@
+#!/usr/bin/env bash
+# rt-hook: Stop
+# Требует: hooks/deny-tail.sh
+# Гард входа на стенд. Событие Stop. Не даёт завершить ход, в котором исполнитель просит
+# владельца войти на стенд или ввести пароль.
+#
+# Зачем. Стенд, вход и учётные записи для проверки готовит агент. Это требование держалось только на
+# памяти исполнителя и не сработало: за один заход просьба «войди сам» или «введи пароль»
+# прозвучала четыре раза подряд, каждый раз с новой причиной — поле не принимает ввод, в браузере
+# стоит чужое расширение, профиль отключился. Причина настоящая, поэтому просьба выглядит
+# уместной; но снимать препятствие всё равно должен агент.
+#
+# Гард стоит на завершении хода, а не на вызове инструмента: просьба пишется текстом ответа, и
+# до конца хода её не видно.
+#
+# Граница. Гард проверяет набор образцов: глагол просьбы рядом со словом о пароле, входе или
+# форме. Просьбу другими словами или через меню вариантов гард не распознаёт. Набор пополняется
+# правкой; его полнота не гарантируется.
+#
+# Что разрешено: просьба переключить обычный режим работы вместо автоматического. Ввод делает
+# агент, у владельца просят только режим — гард различает эти просьбы.
+#
+# При ошибке гард пропускает: при сбое, отсутствии записи хода и повторном заходе ход
+# разрешается. Сломанный гард не должен блокировать разговор.
+
+# Имя гарда для наблюдений: его пишет общий хвост отказа.
+RT_GUARD_NAME=stand-login-guard
+
+. "$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)/utf8.sh" 2>/dev/null || true
+. "$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)/hook-input.sh" 2>/dev/null || true
+
+rt_hook_read
+input="$RT_HOOK_INPUT"
+[ -z "$input" ] && exit 0
+
+command -v jq >/dev/null 2>&1 || exit 0
+
+# Повторный заход по тому же ходу не проверяется: гард сообщает отказ один раз.
+active="$(printf '%s' "$input" | jq -r '.stop_hook_active // false' 2>/dev/null)"
+[ "$active" = "true" ] && exit 0
+
+transcript="$(printf '%s' "$input" | jq -r '.transcript_path // empty' 2>/dev/null)"
+[ -z "$transcript" ] && exit 0
+[ -f "$transcript" ] || exit 0
+
+# Образцы просьбы. Первая группа — просьба сделать ввод за агента, вторая — просьба войти
+# самому. Слово о режиме работы в набор не входит: его просить разрешено.
+asked_re='(введи|введите|набери|наберите|вбей|вбейте|заполни|заполните|подставь|вставь)[^.!?\n]{0,40}(пароль|учётн|учетн|логин|креды|форму входа)'
+asked_re="$asked_re"'|(войди|войдите|залогинься|залогиньтесь|авторизуйся|авторизуйтесь)[^.!?\n]{0,40}(сам|сами|рукой|руками|за меня|вместо меня|пожалуйста)?'
+asked_re="$asked_re"'|(нужно|надо|прошу)[^.!?\n]{0,20}(чтобы ты|чтобы вы)?[^.!?\n]{0,20}(ввёл|ввел|ввели|вошёл|вошел|вошли)[^.!?\n]{0,30}(пароль|вход|систему)'
+
+# Ход — всё, что записано после последнего настоящего ввода владельца. Ответ инструмента
+# приходит с той же ролью, поэтому строки с `tool_result` вводом не считаются.
+#
+# Читаются последние 400 строк: запись растёт весь заход, а проверяется только последний ход.
+verdict="$(tail -n 400 "$transcript" 2>/dev/null | jq -s -r --arg re "$asked_re" '
+    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);
+
+    (map(is_input) | rindex(true)) as $i
+    | (if $i == null then . else .[$i + 1:] end) as $turn
+    | [$turn[] | select(.type == "assistant") | (.message.content // [])[] | select(.type == "text") | .text] as $texts
+    # Регистр игнорируется флагом, а не приведением к нижнему: приведение работает только для
+    # латиницы, и «Введи пароль» с заглавной буквы не совпало бы с образцом.
+    | if (($texts | join("\n")) | test($re; "i")) then "asked" else "pass" end
+' 2>/dev/null)"
+
+[ "$verdict" = "asked" ] || exit 0
+
+reason="BLOCKED by stand-login-guard: исполнитель просит владельца войти или ввести пароль. Стенд, вход и учётные записи для проверки готовит агент. Препятствие перед просьбой — поле не принимает ввод, чужое расширение в браузере, отключившийся профиль — снимает агент.
+
+Как снять препятствие самостоятельно:
+
+    подставить значение инструментом формы по ссылке на элемент
+    выключить мешающее расширение в профиле браузера
+    поднять стенд на другом адресе
+    войти парой из засева местной базы вместо боевой учётной записи
+
+У владельца просят режим работы, а не ввод: обычный режим вместо автоматического; вход в нём делает агент и возвращает автоматический режим тем же ходом.
+
+Гард проверяет один ход: следующий заход не блокируется."
+
+# Общий хвост отказа: два допустимых шага. Файл может быть не разложен — тогда хвоста нет,
+# причина отказа остаётся.
+# shellcheck disable=SC1090
+[ -f "$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)/deny-tail.sh" ] \
+    && . "$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)/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" '{decision:"block",reason:$r}' 2>/dev/null \
+    || printf '{"decision":"block","reason":"stand-login-guard: вход на стенд делает агент, а не владелец."}\n'
+
+exit 0

package/assets/hooks/write-targets.sh

@@ -26,6 +26,15 @@
 rt_write_targets() {
     rt_wt_text="$(cat)"
 
+    # Перенаправление в пустое устройство и в поток ошибок снимается до разбора — тем же приёмом,
+    # каким его снимает признак записи оболочкой. Без этого заглушённый вывод внутри тела
+    # интерпретатора читается признаком записи, и тело, которое ничего не пишет, снова отдаёт все
+    # свои пути: команда с правкой одного файла и запуском проверки рядом запрещалась по пути
+    # этой проверки. Настоящая запись рядом с заглушённым потоком остаётся видной: снимается
+    # перенаправление, а не команда целиком.
+    rt_wt_text="$(printf '%s' "$rt_wt_text" \
+        | sed -E 's#(&|[0-9]*)>>?[[:space:]]*/dev/(null|stderr)##g; s#[0-9]*>&[0-9-]##g')"
+
     {
         printf '%s' "$rt_wt_text" \
             | tr "\"'\`" '   ' \
@@ -49,17 +58,38 @@ rt_write_targets() {
                     if (parts[i] ~ /\// && parts[i] ~ /\.[A-Za-z0-9]+$/) { print parts[i] }
                 }
             }
+            # Пишет ли тело хоть что-нибудь. Тело, в котором нет ни одного вызова записи, своих
+            # путей не отдаёт: команда, подключившая разложенный помощник и напечатавшая его
+            # ответ, запрещалась как правка этого помощника — за один заход трижды подряд.
+            # Внутри тела, которое пишет, пути по-прежнему берутся все: путь и вызов записи
+            # стоят там разными строками, и связать их нечем.
+            function writes(s) {
+                return s ~ /open[ \t]*\([^)]*[\047\"](w|a|r\+|w\+|a\+)[\047\"]/ \
+                    || s ~ /writeFileSync|writeFile|appendFile|write_text|write_bytes|\.write\(|\.save\(|savefig|to_csv|json\.dump|\.dump\(/ \
+                    || s ~ /makedirs|mkdir|rename|replace[ \t]*\(|unlink|rmtree|copyfile|copy2|shutil\./ \
+                    || s ~ />[ \t]*[A-Za-z0-9_.~$\/-]/ \
+                    || s ~ /(^|[|;&(]|[ \t])(tee|cp|mv|rm|touch|install|truncate)([ \t]|$)/
+            }
             function trim(s) { sub(/^[ \t]+/, "", s); sub(/[ \t]+$/, "", s); return s }
+            function flush_body() {
+                if (wrote) { emit(body) }
+                body = ""
+                wrote = 0
+            }
             tag != "" {
-                if (trim($0) == tag) { tag = ""; next }
-                if (keep) { emit($0) }
+                if (trim($0) == tag) { flush_body(); tag = ""; next }
+                if (keep) {
+                    body = body " " $0
+                    if (writes($0)) { wrote = 1 }
+                }
                 next
             }
             {
                 # Код доводом: всё, что стоит за `-c` или `-e` у интерпретатора.
                 if ($0 ~ /(^|[|;&(]|[ \t])(python3?|node|ruby|perl|php|deno|bun)([ \t]|$)/ \
                     && match($0, /[ \t]-[ce][ \t]/)) {
-                    emit(substr($0, RSTART + RLENGTH))
+                    rest = substr($0, RSTART + RLENGTH)
+                    if (writes(rest)) { emit(rest) }
                 }
                 # Тело heredoc: путь записи интерпретатора стоит именно там.
                 if (match($0, /<<-?[ \t]*[\047\"]?[A-Za-z_][A-Za-z0-9_]*/)) {
@@ -67,7 +97,10 @@ rt_write_targets() {
                     sub(/^<<-?[ \t]*[\047\"]?/, "", t)
                     tag = t
                     keep = ($0 ~ /(^|[|;&(]|[ \t])(python3?|node|ruby|perl|php|deno|bun)([ \t]|$)/)
+                    body = ""
+                    wrote = 0
                 }
-            }'
+            }
+            END { if (tag != "") { flush_body() } }'
     } | sort -u
 }

package/assets/laws/autonomous-work.md

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

package/assets/laws/project-documentation.md

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

package/assets/laws/verifiability.md

@@ -5,6 +5,13 @@
 который «должен работать», и код, который проверили, в истории выглядят одинаково.
 
 ## Статьи
+- **Тест пишется до кода и до правки падает.** Написанный после, он проверяет не обещание, а то,
+  что получилось: автор читает свой же код и подгоняет ожидание под него, поэтому такой тест
+  зелен с первого прогона и не ловит ничего. Падение до правки — единственное доказательство, что
+  тест смотрит туда, куда надо; тест, ни разу не показанный красным, покрытием не считается.
+- **Правка, которую нечем показать красным, называет это словом и говорит, чем закрыта.** Так
+  бывает: оформление, которого не видит спека, конфигурация, чужая служба. Молчаливый пропуск шага
+  выглядит в истории так же, как пройденный, и отличить их потом нечем.
 - **Обещанное поведение названо сценарием, а сценарий назван в тесте, который его проверяет.**
   Иначе связь между обещанием и проверкой держится только на памяти автора.
 - **Сценарий без теста помечен как непокрытый и виден в сводке.** Молчаливый пропуск выглядит так
@@ -81,8 +88,11 @@
   род события и версия одинаковы везде, где стоит слой правил; путь, домен и имя дерева
   принадлежат одному дереву и в чужом месте не значат ничего, кроме утечки. Держится это проверкой
   на выносящей стороне, а не памятью того, кто пишет.
-- **Проверка, которая сама сломалась, работу не останавливает.** Отказ инструмента не является
-  найденным нарушением, и остановленная им работа стоит до того, как его починят.
+- **Проверка, которая сама сломалась, работу не останавливает.** Отказ инструмента не считается
+  найденным нарушением, и остановленная им работа стоит, пока его не починят. Выход один, и он
+  назван в самом отказе: исполнитель разбирает отказы поимённо, показывает владельцу разбор —
+  сколько строк, какого рода, чем доказана их ложность — и чинит саму проверку. Список известного
+  для этого не используется: он хранит принятое, а не результаты сломанной проверки.
 - **Решение, зависящее от текущего момента, получает момент снаружи.** Иначе проверить его можно
   только подкруткой часов, а подкрученные часы действуют и на всё, что оказалось рядом: проверка
   начинает зависеть от того, что к ней отношения не имеет.

package/assets/laws/work-conduct.md

@@ -9,55 +9,48 @@
 - **Пробел закрывается вопросом владельцу, а не догадкой.** Догадка неотличима от знания: она
   попадает в работу молча и обнаруживается только при приёмке, когда переделывать дороже всего.
 - **Работа, которая требует изменений по образцу, начинается с чтения самого образца.** Пересказ
-  образца образцом не является: по нему собирается понимание того, кто пересказывал, и расхождение
-  всплывает на приёмке целой работой, а не строкой. Читается та часть образца, которую работа
-  повторяет, и читается целиком — об устройстве чужого дерева по одному его файлу не судят.
+  образцом не считается: расхождение всплывает на приёмке целой работой, а не строкой. Читается та
+  часть образца, которую работа повторяет, и читается целиком — об устройстве чужого дерева по
+  одному его файлу не судят.
 - **Образец, указанный в ходе работы должен быть доступен каждой сессии во время работы.** Ссылка
   на образец нужно указывать непосредственно в файле с описанием прогресса работы.
 - **Вопрос, у которого есть очевидный ответ, работу не останавливает.** Исполнитель называет
   допущение, идёт дальше и записывает его туда же, где идёт работа. Останавливает только тот
-  пробел, при котором любая догадка делает работу опасной или бесполезной. Вопрос, заданный вместо
-  работы, выглядит добросовестно, а стоит владельцу захода.
+  пробел, при котором любая догадка делает работу опасной или бесполезной.
 - **Остановка называется первой строкой.** Сообщение, которым исполнитель останавливается,
   начинается с того, чего он ждёт и что будет, если ответа не будет. Замеры, находки и разбор к
-  этому моменту уже записаны в ход работы — в сообщении владельцу они лишние. Чем подробнее PR,
-  тем надёжнее вопрос в нём тонет, и владелец переспрашивает, почему работа стоит.
+  этому моменту уже записаны в ход работы — в сообщении владельцу они лишние.
 - **Владельцу не задаётся вопрос, ответ на который уже записан.** Записанное читают до разговора,
   а не вместо ответа: вопрос о том, что уже решено, обесценивает и остальные.
 - **Вопрос владельцу задаётся после того, как ответ искали в дереве.** Что лежит в дереве,
   исполнитель узнаёт сам: имя, путь, наличие файла и устройство репозитория он берёт командой, а
-  не у владельца. Вопрос, ответ на который дала бы одна команда, стоит владельцу захода и
-  обесценивает заданные рядом.
+  не у владельца.
 - **Утверждение о дереве стоит ровно столько, сколько команда, его показавшая.** Отрицание —
   «здесь нет», «этого не заводили», «такого файла не бывает» — произносится только как вывод
   команды. Не проверенное отрицание опаснее вопроса: вопрос владелец поправит, а факт от
   исполнителя примет на веру, потому что тот в дерево смотрит.
 - **Пустой вывод утверждением не бывает.** Он значит либо «ноль строк», либо «спрошено не то», и
-  различает эти два только повторный вызов — без конвейера и без глушения потока ошибок: в
-  конвейере код возврата принадлежит последнему звену, а заглушённый поток уносит текст промаха.
-  Пока такой вызов не сделан, о дереве не сказано ничего, а «ничего нет» — самая дорогая из
-  возможных ошибок: она отменяет работу, которую владелец велел сделать.
-- **Отрицание, полученное одним источником, отрицанием не является.** Ответ «не найдено», отказ в
-  доступе и пустой список говорят о правах спрашивающего, а не о предмете: тот же вопрос, заданный
-  оттуда, где предмет виден, отвечает обратным. Сказать «этого нет» можно только после второго
-  источника — иначе исполнитель называет владельцу собственные права, приняв их за устройство
-  мира.
+  различает эти два только повторный вызов — без конвейера и без глушения потока ошибок. Пока
+  такой вызов не сделан, о дереве не сказано ничего, а «ничего нет» отменяет работу, которую
+  владелец велел сделать.
+- **Отрицание, полученное одним источником, отрицанием не считается.** Ответ «не найдено», отказ в
+  доступе и пустой список говорят о правах спрашивающего, а не о предмете. Сказать «этого нет»
+  можно только после второго источника — иначе исполнитель называет владельцу собственные права,
+  приняв их за устройство мира.
 - **Решение, однажды записанное, действует, пока его не отменили, и читается до того, как
   принимается заново.** Отменённое решение следа в работе не оставляет — по результату не видно ни
   того, что его принимали, ни того, что от него отказались. Принятое заново оно расходится с
   прежним молча и стоит той же работы второй раз.
 - **Решение, которое переживёт задачу, записывается там, где оно переживёт.** Ход работы умирает
   вместе с папкой задачи, а имя, адрес и выбранный способ, названные владельцем посреди серии
-  работ, нужны следующим её задачам. Не переехавшее решение существует только в переписке того
-  захода, в котором принято: следующий заход делает разведку честно, не находит ничего — и
-  задаёт владельцу вопрос, на который тот уже отвечал.
+  работ, нужны следующим её задачам. Не переехавшее решение живёт только в переписке своего
+  захода: следующий делает разведку честно, не находит ничего — и спрашивает владельца о том, на
+  что тот уже отвечал.
 - **Инструмент, названный в просьбе, входит в просьбу.** Замена его на свой — отступление от
   просьбы, даже когда свой даёт тот же ответ: равноценность инструментов решает тот, кто просит.
-  Одинаковый результат равноценностью не является — у названного инструмента бывает видно то,
-  чего у заменителя нет вовсе.
 - **Случившаяся подмена называется в том же докладе.** Чем сделано вместо названного и почему —
   двумя словами, рядом с ответом на просьбу. Без этой строки владелец узнаёт о подмене, повторяя
-  указание: к той минуте работа по нему уже сделана не тем, и заплачено за неё дважды.
+  указание, и платит за работу дважды.
 - **Понимание записано там, где идёт работа.** Оставленное в переписке живёт у одного участника и
   до следующего дня; работу продолжает тот, у кого этой переписки нет.
 - **Сказанное владельцем записывается его словами и задним числом не переписывается.** Пересказ
@@ -79,9 +72,8 @@
   Владелец знает, что работа не кончена, но не знает, где именно она стоит; пересказ он даёт по
   своей памяти, а не по ходу работы, и следующий заход начинает с чужой картины.
 - **Переданное прошлым заходом приходит в новый заход само, а не кладётся рукой.** Передача,
-  написанная и не прочитанная, равна ненаписанной: следующий заход о ней не знает и начинает с
-  пустого места — то есть с того же, ради чего её и писали. Кладёт её человек ровно до тех пор,
-  пока это не поручено машине; поручённое машине не забывается ночью.
+  написанная и не прочитанная, равна ненаписанной: следующий заход начинает с пустого места — с
+  того же, ради чего её и писали. Поручённое машине не забывается ночью.
 - **Порядок ведения работы приходит в заход вместе с работой, а не разыскивается им.** Заход,
   знающий задачу и не знающий, что с ней делают дальше, первым движением читает правило целиком —
   и тратит место, ради которого его и начали заново. Приходит короткая выжимка: состояния,
@@ -100,7 +92,7 @@
   документа, — делается по слову владельца, и слово это даётся на действие, а не на работу
   целиком. Не названная списком граница выводится из общих слов: «делай, что нужно по плану»
   прочитывается как разрешение на всё, что в плане подразумевалось.
-- **Признак закрытия работы назван до её начала и проверяем.** «Работает» признаком не является:
+- **Признак закрытия работы назван до её начала и проверяем.** «Работает» признаком не считается:
   под ним каждый заход понимает своё, и работа закрывается тогда, когда надоела.
 - **Начатая и брошенная работа видна.** Брошенное на середине выглядит так же, как нетронутое, и
   второй заход начинает его заново.
@@ -110,14 +102,13 @@
   уже никто не следит: работа перешла к следующей задаче, а правки, которой это убрали бы заодно,
   больше нет.
 - **Достаточность понимания судит тот, кто просил.** Машине видно наличие записи, но не то, что в
-  ней закрыты все пробелы: запись из одной строки проходит так же, как разбор на сто. Признак
-  достаточности, выведенный из объёма или числа вопросов, сам становится целью — исполнитель
-  добирает его, не приближаясь к пониманию.
+  ней закрыты все пробелы. Признак достаточности, выведенный из объёма или числа вопросов, сам
+  становится целью — исполнитель добирает его, не приближаясь к пониманию.
 - **Незаданный вопрос замечает только тот, кто знает, чего хотел.** Вопрос, которого не задали,
   следа не оставляет: работа выглядит понятой ровно до приёмки, и вывести отсутствие вопроса не из
   чего.
 - **Происшествие названо признаком, а не оценкой заднего числа.** Происшествие — заход, в котором
-  исполнитель сделал не то, а слой правил этого не отбил. Дефект в коде происшествием не является:
+  исполнитель сделал не то, а слой правил этого не отбил. Дефект в коде происшествием не считается:
   его объясняет договорённость о продукте. Признак записан один раз, а не выводится каждым заходом
   заново — иначе его назначает тот, кому он мешает.
 - **Происшествие кончается записью, и запись делается в тот же заход.** Через день механизм
@@ -128,9 +119,9 @@
   предложения, ни правки закона, правила или паттерна, — жалоба: он объясняет случившееся и ничего
   не меняет, а значит повторится.
 - **Закрытая работа оставляет то, что узнала о правилах, там, откуда это возьмёт машина.**
-  Понимание, добытое одной работой, всего дороже соседней — и живёт оно ровно до конца захода,
-  если осталось в разговоре. Записанное свободным пересказом лежит не хуже, но переносить его
-  приходится руками, и переносится оно ровно до первой занятой недели.
+  Понимание, добытое одной работой, всего дороже соседней — и живёт оно до конца захода, если
+  осталось в разговоре. Записанное свободным пересказом переносится руками, то есть до первой
+  занятой недели.
 - **У предложенной правки правил назван адрес: сам слой правил, имена этого дерева или его
   надстройка.** Без адреса правку кладут туда, где она видна автору, — то есть в своё дерево, — и
   общее оседает в одном месте, оставаясь неизвестным всем остальным.
@@ -138,7 +129,7 @@
   отправленное лежит в дереве неотличимо от отправленного: своей записи в слое правил у него нет,
   и владелец читает работу сделанной, пока не спросит прямо. Слово владельца о предложении —
   «отправь», «заведи», «напиши» — распоряжение, а не тема разговора; показ того, что уехало бы,
-  отправкой не является и следа наружу не оставляет.
+  отправкой не считается и следа наружу не оставляет.
 - **Неудобство отправки — повод сказать о нём, а не повод не отправить.** Довод исполнителя против
   уже принятого решения владельца остаётся доводом: он называется вслух, работа при этом идёт.
   Отложить исполненное решение может только владелец; отложенное собственным доводом выглядит для
@@ -148,19 +139,17 @@
   в голове того, кто её задумал: следующий заход видит разрозненные задачи, порядка между ними не
   находит и берёт ту, что ближе лежит.
 - **Замысел эпика называет разрабатываемую возможность, состав задач и их порядок.** Состав без
-  порядка порядком не является: две задачи, у которых порядок держался пониманием, ушли в работу
+  порядка порядком не считается: две задачи, у которых порядок держался пониманием, ушли в работу
   наоборот, и вторая переделывалась под первую. Возможность, названная одним словом, через неделю
   читается каждым по-своему.
 - **Порядок задач эпика назначается на планировании и держится до его конца.** Пересмотр по ходу —
   решение владельца, записанное там же, где идёт работа. Порядок, назначаемый заново перед каждой
   задачей, назначает тот, кому ближе, и эпик кончается там, где надоел.
 - **Каждая задача объявленного эпика получает свою карточку в очереди работ сразу, а не в день,
-  когда за неё берутся.** Замысел эпика держит порядок для того, кто работу ведёт; очередь работ —
-  для того, кто на неё смотрит, и эпик, у которого заведена одна карточка из десяти, выглядит там
-  работой на один шаг. Незаведённый объём не виден ни владельцу, ни соседней работе, которая берёт
-  уже назначенную задачу. Номер карточки встаёт в замысел той же правкой: замысел, называющий
-  задачу словами, на «взять следующую» отвечает названием, и карточку заводят заново — с другим
-  номером.
+  когда за неё берутся.** Замысел эпика держит порядок для того, кто ведёт работу; очередь работ —
+  для того, кто на неё смотрит, и эпик с одной карточкой из десяти выглядит там работой на один
+  шаг. Номер карточки встаёт в замысел той же правкой: иначе на «взять следующую» замысел
+  отвечает названием, и карточку заводят заново с другим номером.
 - **Заход исполнителя не кончается вместе с задачей.** Конец задачи — не признак остановки:
   остановиться позволяет только предел заполнения окна. Заход, закрытый на готовой задаче,
   оставляет владельцу пустое место и стоит целого захода на возвращение к тому, что и так было под
@@ -177,9 +166,8 @@
   удовлетворяет, а работу не спасает.
 - **Переход из состояния в состояние исполнителя не останавливает.** Обязательное действие сделано
   — следующее начинается тем же движением, без отчёта владельцу и без его слова. Граница между
-  состояниями выглядит законченным куском лучше всякой другой вехи: сделанное названо, отчитаться
-  есть чем, — и отчёт встаёт ровно на то место, где должно было стоять следующее действие.
-  Владелец читает такой отчёт как сделанную работу, а работа стоит.
+  состояниями выглядит законченным куском, и отчёт встаёт на место следующего действия: владелец
+  читает его как сделанную работу, а работа стоит.
 - **Текст, ведущий состояние работы, называет, что делается сразу за ним.** Дочитанный до
   последнего приёма, он кончается ничем: следующего движения в нём нет, и исполнитель выводит его
   из пустоты — то есть останавливается. Названное движение стоит там же, где приёмы, и своими
@@ -187,13 +175,12 @@
 - **Работа, отданная на разбор, освобождает исполнителя, а не останавливает его.** Отданное на
   разбор ждёт владельца, а не машину: следующая задача эпика берётся тем же движением, которым
   предыдущая ушла на разбор.
-- **Ожидание машины работой не занимают.** Проверка, идущая на стороне, не спрашивает исполнителя
-  ни о чём и не идёт быстрее оттого, что он на неё смотрит. Пока она идёт, работа продолжается:
-  берётся следующая задача, а к проверке возвращаются тем ходом, которым читают её конец. Заход,
-  проведённый в ожидании, стоит ровно столько же, сколько заход, в котором сделана задача, — и не
-  даёт ничего.
-- **Ожидание, которое всё-таки останавливает работу, называется владельцу отдельно и прямо.** Есть
-  случаи, где дальше и вправду не пройти: следующая задача стоит на неразобранной, или правка ждёт
+- **Ожидание машины работой не занимают.** Проверка на стороне не идёт быстрее оттого, что на неё
+  смотрят. Пока она идёт, берётся следующая задача, а к проверке возвращаются тем ходом, которым
+  читают её конец. Заход, проведённый в ожидании, стоит столько же, сколько заход со сделанной
+  задачей, и не даёт ничего.
+- **Ожидание, которое всё-таки останавливает работу, называется владельцу отдельно и прямо.** Иногда
+  дальше не пройти: следующая задача стоит на неразобранной, или правка ждёт
   решения, которого нет ни у кого, кроме владельца. Тогда исполнитель говорит три вещи — что
   стоит, чего ждёт и что владелец может с этим сделать. Сказанное вперемешку с отчётом не
   читается: остановка называется отдельно.
@@ -207,8 +194,8 @@
   за собой» от «готово, забирай». Не названное, оно не существует, и владелец действует по тому,
   что видит.
 - **Работа не считается готовой, пока исполнитель не сказал этого прямо.** Готовность объявляет
-  тот, кто работу вёл, — отдельной просьбой и про эту работу. Зелёные проверки готовностью не
-  являются: они говорят, что не сломано, и молчат о том, осталось ли что-то сделать. Молчание
+  тот, кто работу вёл, — отдельной просьбой и про эту работу. Зелёные проверки — не
+  готовность: они говорят, что не сломано, и молчат о том, осталось ли что-то сделать. Молчание
   исполнителя владелец читает как готовность, и между двумя прочтениями теряется всё, что стояло
   после разбора.
 - **Уборка за работой идёт до того, как о готовности сказано.** Всё, что работа обязана убрать за
@@ -217,12 +204,21 @@
 - **Постоянное указание среды исполнения слабее правила дерева.** Среда описывает своё
   умолчание и о дереве не знает; дерево вправе его отменить и отменяет молча — тем, что говорит
   иначе. Расхождение разрешается в пользу дерева, а не того из двух текстов, который строже
-  сформулирован или ближе стоит к делу. Опознаётся оно чтением обоих, а не проверкой: указание
-  среды приходит в заход текстом, и сличить его с правилом машине не по чему.
+  сформулирован или ближе стоит к делу. Опознаётся оно чтением обоих: сличить указание среды с
+  правилом машине нечем.
 
 - **Пока эпик не кончился, следующая работа не выбирается, а берётся.** Выбор, предложенный
   владельцу при назначенном порядке, — это просьба назначить его заново: он уже назначен, и
   предлагать его повторно значит отменять собственное планирование.
+- **Перечень работ, разрешённых вне эпика, повторяет слово владельца, а не заменяет его.** Номер
+  попадает туда после того, как владелец назвал эту работу, и только для того, чтобы гард её
+  пропускал. Исполнитель, вписавший номер сам, разрешил работу себе сам, и по записи это потом
+  не отличить от разрешения владельца.
+- **Назначение эпика принадлежит рабочему дереву, а не ветке, и объявляется в главной ветке
+  прежде, чем под новый эпик заводится первая задача.** Запись о назначении лежит в файле, а файл
+  принадлежит ветке, где его правили: записанная в ветку первой задачи, она действует только в
+  этой ветке. При первом переключении ветки исполнитель работает по новому порядку, а гард читает
+  прежний, и отказ приходит в конце хода, когда работа уже сделана и отдана.
 - **Берётся следующая задача из замысла эпика, а не из списка очереди работ.** Список отсортирован
   номером и показывает свежие задачи сверху; порядок эпика он не держит и держать не может — там
   лежат задачи всех эпиков сразу. Замысел эпика открывается перед взятием и отвечает за один
@@ -232,10 +228,9 @@
   для обоих. Исполнитель, взявший работу вне кончившегося эпика и промолчавший, оставляет
   владельца в уверенности, что эпик продолжается.
 - **Эпик не закрывается, пока хоть один признак его конца подтверждён только чтением.** Признак,
-  проверяемый глазами, закрывает работу лишь после того, как его назвали проверенным вслух —
-  командой или замером с их выводом. Пометка «подтверждается живым замером» проверкой не является:
-  это обещание её сделать, и висит оно ровно до того, как кто-нибудь спросит. Закрытый по двум
-  признакам из трёх, эпик уносит третий в описание прошлого, где его уже никто не ищет.
+  проверяемый глазами, закрывает работу после того, как его проверили командой или замером с их
+  выводом. Пометка «подтверждается живым замером» — обещание проверить, а не проверка. Закрытый по
+  двум признакам из трёх, эпик уносит третий в описание прошлого, где его никто не ищет.
 - **Замеченное по ходу и к эпику не относящееся становится задачей в очереди работ, а не работой
   сейчас.** Отвлечение выглядит дешёвым ровно до того, как окажется, что вместе с ним уехала
   правка соседнего домена: эпик при этом стоит, а откатывать приходится обе работы.
@@ -243,10 +238,9 @@
   Непонятно бывает от того, что замысел не открыли: он лежит и держит решения, которых в коде не
   видно.
 - **Положение эпика показывается владельцу таблицей — в передаче и при остановке за его
-  решением.** Это два момента, когда владелец смотрит на работу снаружи: в первый он забирает её в
-  новый заход, во второй решает, куда её вести. Порядок задач при этом лежит в замысле, а замысел
-  ни там, ни там не открывают — передача пересказывает один заход, вопрос называет одну развилку,
-  и по обоим не видно ни сделанного, ни оставшегося.
+  решением.** В эти два момента владелец смотрит на работу снаружи: забирает её в новый заход или
+  решает, куда её вести. Замысел с порядком задач при этом не открывают, а по передаче и вопросу
+  не видно ни сделанного, ни оставшегося.
 - **Таблица показывает все задачи эпика разом — закрытые, текущую и назначенные.** Строка на
   задачу: место по порядку, задача, состояние; текущая отличается от остальных на вид. Порядок у
   закрытых фактический, у будущих назначенный, и расхождение между ними тоже утверждение. Перечень