@rt-tools/agent-kit 0.13.0 → 0.15.0

package/assets/laws/work-conduct.md

@@ -4,204 +4,215 @@
 длится дольше одной сессии и должна сохранять весь контекст и состояние при переходах из одной сессии в другую.
 
 ## Статьи
-
-- **Работа не начинается раньше, чем исполнитель понял, о чём его просят.** Пробел в
-  понимании сам не закрывается: он всплывает в готовой правке и стоит переделки там, где
-  стоил бы вопроса.
-- **Пробел закрывается вопросом владельцу, а не догадкой.** Догадка неотличима от знания:
-  она попадает в работу молча и обнаруживается только при приёмке, когда переделывать дороже
-  всего.
+- **Работа не начинается раньше, чем исполнитель понял, о чём его просят.** Пробел в понимании сам
+  не закрывается: он всплывает в готовой правке и стоит переделки там, где стоил бы вопроса.
+- **Пробел закрывается вопросом владельцу, а не догадкой.** Догадка неотличима от знания: она
+  попадает в работу молча и обнаруживается только при приёмке, когда переделывать дороже всего.
 - **Работа, которая требует изменений по образцу, начинается с чтения самого образца.** Пересказ
-  образца образцом не является: по нему собирается понимание того, кто пересказывал, и
-  расхождение всплывает на приёмке целой работой, а не строкой. Читается та часть образца,
-  которую работа повторяет, и читается целиком — об устройстве чужого дерева по одному его
-  файлу не судят.
-- **Образец, указанный в ходе работы должен быть доступен каждой сессии во время работы.**
-  Ссылка на образец нужно указывать непосредственно в файле с описанием прогресса работы.
+  образца образцом не является: по нему собирается понимание того, кто пересказывал, и расхождение
+  всплывает на приёмке целой работой, а не строкой. Читается та часть образца, которую работа
+  повторяет, и читается целиком — об устройстве чужого дерева по одному его файлу не судят.
+- **Образец, указанный в ходе работы должен быть доступен каждой сессии во время работы.** Ссылка
+  на образец нужно указывать непосредственно в файле с описанием прогресса работы.
 - **Вопрос, у которого есть очевидный ответ, работу не останавливает.** Исполнитель называет
   допущение, идёт дальше и записывает его туда же, где идёт работа. Останавливает только тот
-  пробел, при котором любая догадка делает работу опасной или бесполезной. Вопрос, заданный
-  вместо работы, выглядит добросовестно, а стоит владельцу захода.
+  пробел, при котором любая догадка делает работу опасной или бесполезной. Вопрос, заданный вместо
+  работы, выглядит добросовестно, а стоит владельцу захода.
 - **Остановка называется первой строкой.** Сообщение, которым исполнитель останавливается,
-  начинается с того, чего он ждёт и что будет, если ответа не будет. Замеры, находки и разбор
-  к этому моменту уже записаны в ход работы — в сообщении владельцу они лишние. Чем подробнее
-  PR, тем надёжнее вопрос в нём тонет, и владелец переспрашивает, почему работа стоит.
-- **Владельцу не задаётся вопрос, ответ на который уже записан.** Записанное читают до
-  разговора, а не вместо ответа: вопрос о том, что уже решено, обесценивает и остальные.
+  начинается с того, чего он ждёт и что будет, если ответа не будет. Замеры, находки и разбор к
+  этому моменту уже записаны в ход работы — в сообщении владельцу они лишние. Чем подробнее PR,
+  тем надёжнее вопрос в нём тонет, и владелец переспрашивает, почему работа стоит.
+- **Владельцу не задаётся вопрос, ответ на который уже записан.** Записанное читают до разговора,
+  а не вместо ответа: вопрос о том, что уже решено, обесценивает и остальные.
 - **Вопрос владельцу задаётся после того, как ответ искали в дереве.** Что лежит в дереве,
-  исполнитель узнаёт сам: имя, путь, наличие файла и устройство репозитория он берёт командой,
-  а не у владельца. Вопрос, ответ на который дала бы одна команда, стоит владельцу захода и
+  исполнитель узнаёт сам: имя, путь, наличие файла и устройство репозитория он берёт командой, а
+  не у владельца. Вопрос, ответ на который дала бы одна команда, стоит владельцу захода и
   обесценивает заданные рядом.
 - **Утверждение о дереве стоит ровно столько, сколько команда, его показавшая.** Отрицание —
   «здесь нет», «этого не заводили», «такого файла не бывает» — произносится только как вывод
   команды. Не проверенное отрицание опаснее вопроса: вопрос владелец поправит, а факт от
   исполнителя примет на веру, потому что тот в дерево смотрит.
-- **Отрицание, полученное одним источником, отрицанием не является.** Ответ «не найдено», отказ
-  в доступе и пустой список говорят о правах спрашивающего, а не о предмете: тот же вопрос,
-  заданный оттуда, где предмет виден, отвечает обратным. Сказать «этого нет» можно только после
-  второго источника — иначе исполнитель называет владельцу собственные права, приняв их за
-  устройство мира.
+- **Отрицание, полученное одним источником, отрицанием не является.** Ответ «не найдено», отказ в
+  доступе и пустой список говорят о правах спрашивающего, а не о предмете: тот же вопрос, заданный
+  оттуда, где предмет виден, отвечает обратным. Сказать «этого нет» можно только после второго
+  источника — иначе исполнитель называет владельцу собственные права, приняв их за устройство
+  мира.
 - **Решение, однажды записанное, действует, пока его не отменили, и читается до того, как
-  принимается заново.** Отменённое решение следа в работе не оставляет — по результату не
-  видно ни того, что его принимали, ни того, что от него отказались. Принятое заново оно
-  расходится с прежним молча и стоит той же работы второй раз.
-- **Понимание записано там, где идёт работа.** Оставленное в переписке живёт у одного
-  участника и до следующего дня; работу продолжает тот, у кого этой переписки нет.
-- **Сказанное владельцем записывается его словами и задним числом не переписывается.**
-  Пересказ незаметно подгоняется под уже сделанное, и сверять результат становится не с чем.
-- **Договорённость о том, как продукт себя ведёт, записана раньше кода, который её
-  исполняет.** Записанная после, она пишется по коду и повторяет его ошибки: разойтись ей
-  уже не с чем, а значит она ничего не проверяет.
-- **Описание приведено к сделанному прежде, чем работа закрыта.** Договорённость пишется до
-  кода и описывает замысел, а к концу работы приложение отличается и от замысла тоже.
-  Расхождение, отложенное на потом, не находится: назавтра оно уже незаметно, а описание
-  продолжают читать как верное.
-- **Состояние незаконченной работы восстанавливается без участия владельца.** Иначе каждый
-  перерыв стоит ему пересказа, а очередь работ показывает начатое и не говорит, что внутри
-  него сделано.
-- **Заход исполнителя конечен, и его конец не совпадает с концом работы.** Место, где
-  исполнитель помнит ход работы, ограничено; заполнив его, он теряет не последнее, а всё
-  сразу. Заход, доведённый до логической точки заранее, стоит одной записи; оборванный на
-  середине — целого захода на восстановление.
-- **Прерванная работа передаётся следующему заходу готовым текстом, а не пересказом
-  владельца.** Владелец знает, что работа не кончена, но не знает, где именно она стоит;
-  пересказ он даёт по своей памяти, а не по ходу работы, и следующий заход начинает с чужой
-  картины.
+  принимается заново.** Отменённое решение следа в работе не оставляет — по результату не видно ни
+  того, что его принимали, ни того, что от него отказались. Принятое заново оно расходится с
+  прежним молча и стоит той же работы второй раз.
+- **Понимание записано там, где идёт работа.** Оставленное в переписке живёт у одного участника и
+  до следующего дня; работу продолжает тот, у кого этой переписки нет.
+- **Сказанное владельцем записывается его словами и задним числом не переписывается.** Пересказ
+  незаметно подгоняется под уже сделанное, и сверять результат становится не с чем.
+- **Договорённость о том, как продукт себя ведёт, записана раньше кода, который её исполняет.**
+  Записанная после, она пишется по коду и повторяет его ошибки: разойтись ей уже не с чем, а
+  значит она ничего не проверяет.
+- **Описание приведено к сделанному прежде, чем работа закрыта.** Договорённость пишется до кода и
+  описывает замысел, а к концу работы приложение отличается и от замысла тоже. Расхождение,
+  отложенное на потом, не находится: назавтра оно уже незаметно, а описание продолжают читать как
+  верное.
+- **Состояние незаконченной работы восстанавливается без участия владельца.** Иначе каждый перерыв
+  стоит ему пересказа, а очередь работ показывает начатое и не говорит, что внутри него сделано.
+- **Заход исполнителя конечен, и его конец не совпадает с концом работы.** Место, где исполнитель
+  помнит ход работы, ограничено; заполнив его, он теряет не последнее, а всё сразу. Заход,
+  доведённый до логической точки заранее, стоит одной записи; оборванный на середине — целого
+  захода на восстановление.
+- **Прерванная работа передаётся следующему заходу готовым текстом, а не пересказом владельца.**
+  Владелец знает, что работа не кончена, но не знает, где именно она стоит; пересказ он даёт по
+  своей памяти, а не по ходу работы, и следующий заход начинает с чужой картины.
 - **Переданное прошлым заходом приходит в новый заход само, а не кладётся рукой.** Передача,
   написанная и не прочитанная, равна ненаписанной: следующий заход о ней не знает и начинает с
   пустого места — то есть с того же, ради чего её и писали. Кладёт её человек ровно до тех пор,
   пока это не поручено машине; поручённое машине не забывается ночью.
 - **Порядок ведения работы приходит в заход вместе с работой, а не разыскивается им.** Заход,
-  знающий задачу и не знающий, что с ней делают дальше, первым движением идёт читать правило
-  целиком — и тратит на это ту часть места, ради которой заход и начали заново. Приходит
-  короткая выжимка: состояния, обязательное действие каждого и то, чем ход кончается. Правило
-  она не заменяет и заменить не может — она отвечает на вопрос «что делать», а не «почему».
-- **Замысел и ход работы — разные записи.** Замысел — то, с чем сверяют результат при
-  приёмке; правленный по ходу, он перестаёт отличаться от PR, и приёмке сверять нечего.
-- **Сделанное отмечается в одном месте.** Две записи об одном разъезжаются молча, и после
-  этого ни по одной не видно, что осталось.
-- **Решение, принятое по ходу работы, записывается вместе с причиной.** Без причины оно
-  читается как случайное и отменяется следующим заходом, а отменённое возвращается третьим.
+  знающий задачу и не знающий, что с ней делают дальше, первым движением читает правило целиком —
+  и тратит место, ради которого его и начали заново. Приходит короткая выжимка: состояния,
+  обязательное действие каждого и чем ход кончается. Правило она не заменяет: отвечает на «что
+  делать», а не «почему».
+- **Замысел и ход работы — разные записи.** Замысел — то, с чем сверяют результат при приёмке;
+  правленный по ходу, он перестаёт отличаться от PR, и приёмке сверять нечего.
+- **Сделанное отмечается в одном месте.** Две записи об одном разъезжаются молча, и после этого ни
+  по одной не видно, что осталось.
+- **Решение, принятое по ходу работы, записывается вместе с причиной.** Без причины оно читается
+  как случайное и отменяется следующим заходом, а отменённое возвращается третьим.
 - **Граница работы названа до её начала.** Не названная вслух граница не существует: правка
   расползается на соседнее, и снимать её приходится вручную.
-- **Действия, которые исполнитель не делает сам, названы списком.** Всё, что уходит за
-  пределы рабочего дерева или не откатывается — запись в общий репозиторий, публикация, PR,
-  правка общего документа, — делается по слову владельца, и слово это даётся на действие, а не
-  на работу целиком. Не названная списком граница выводится из общих слов: «делай, что нужно
-  по плану» прочитывается как разрешение на всё, что в плане подразумевалось.
-- **Признак закрытия работы назван до её начала и проверяем.** «Работает» признаком не
-  является: под ним каждый заход понимает своё, и работа закрывается тогда, когда надоела.
-- **Начатая и брошенная работа видна.** Брошенное на середине выглядит так же, как
-  нетронутое, и второй заход начинает его заново.
-- **Записи о законченной работе не лежат среди записей о текущей.** Закрытое, лежащее рядом
-  с действующим, читается как действующее — тем убедительнее, чем оно старше.
-- **Законченная работа убирает за собой до того, как войдёт в общее дерево.** Потом за
-  оставленным уже никто не следит: работа перешла к следующей задаче, а правки, которой это
-  убрали бы заодно, больше нет.
-- **Достаточность понимания судит тот, кто просил.** Машине видно наличие записи, но не то,
-  что в ней закрыты все пробелы: запись из одной строки проходит так же, как разбор на сто.
-  Признак достаточности, выведенный из объёма или числа вопросов, сам становится целью —
-  исполнитель добирает его, не приближаясь к пониманию.
-- **Незаданный вопрос замечает только тот, кто знает, чего хотел.** Вопрос, которого не
-  задали, следа не оставляет: работа выглядит понятой ровно до приёмки, и вывести отсутствие
-  вопроса не из чего.
-- **Происшествие названо признаком, а не оценкой заднего числа.** Происшествие — заход, в
-  котором исполнитель сделал не то, а слой правил этого не отбил. Дефект в коде происшествием
-  не является: его объясняет договорённость о продукте. Признак записан один раз, а не
-  выводится каждым заходом заново — иначе его назначает тот, кому он мешает.
+- **Действия, которые исполнитель не делает сам, названы списком.** Всё, что уходит за пределы
+  рабочего дерева или не откатывается — запись в общий репозиторий, публикация, PR, правка общего
+  документа, — делается по слову владельца, и слово это даётся на действие, а не на работу
+  целиком. Не названная списком граница выводится из общих слов: «делай, что нужно по плану»
+  прочитывается как разрешение на всё, что в плане подразумевалось.
+- **Признак закрытия работы назван до её начала и проверяем.** «Работает» признаком не является:
+  под ним каждый заход понимает своё, и работа закрывается тогда, когда надоела.
+- **Начатая и брошенная работа видна.** Брошенное на середине выглядит так же, как нетронутое, и
+  второй заход начинает его заново.
+- **Записи о законченной работе не лежат среди записей о текущей.** Закрытое, лежащее рядом с
+  действующим, читается как действующее — тем убедительнее, чем оно старше.
+- **Законченная работа убирает за собой до того, как войдёт в общее дерево.** Потом за оставленным
+  уже никто не следит: работа перешла к следующей задаче, а правки, которой это убрали бы заодно,
+  больше нет.
+- **Достаточность понимания судит тот, кто просил.** Машине видно наличие записи, но не то, что в
+  ней закрыты все пробелы: запись из одной строки проходит так же, как разбор на сто. Признак
+  достаточности, выведенный из объёма или числа вопросов, сам становится целью — исполнитель
+  добирает его, не приближаясь к пониманию.
+- **Незаданный вопрос замечает только тот, кто знает, чего хотел.** Вопрос, которого не задали,
+  следа не оставляет: работа выглядит понятой ровно до приёмки, и вывести отсутствие вопроса не из
+  чего.
+- **Происшествие названо признаком, а не оценкой заднего числа.** Происшествие — заход, в котором
+  исполнитель сделал не то, а слой правил этого не отбил. Дефект в коде происшествием не является:
+  его объясняет договорённость о продукте. Признак записан один раз, а не выводится каждым заходом
+  заново — иначе его назначает тот, кому он мешает.
 - **Происшествие кончается записью, и запись делается в тот же заход.** Через день механизм
   промаха пересказывается уже приглаженно: остаются выводы, а из выводов правило не выводится.
   Запись называет механизм промаха по шагам, что было доступно до него, чем ловилось и что из
   этого ушло в слой правил.
 - **Запись без правки слоя правил закрытой не считается.** Разбор, из которого не вышло ни
-  предложения, ни правки закона, правила или паттерна, — жалоба: он объясняет случившееся и
-  ничего не меняет, а значит повторится.
+  предложения, ни правки закона, правила или паттерна, — жалоба: он объясняет случившееся и ничего
+  не меняет, а значит повторится.
 - **Закрытая работа оставляет то, что узнала о правилах, там, откуда это возьмёт машина.**
   Понимание, добытое одной работой, всего дороже соседней — и живёт оно ровно до конца захода,
   если осталось в разговоре. Записанное свободным пересказом лежит не хуже, но переносить его
   приходится руками, и переносится оно ровно до первой занятой недели.
 - **У предложенной правки правил назван адрес: сам слой правил, имена этого дерева или его
-  надстройка.** Без адреса правку кладут туда, где она видна автору, — то есть в своё дерево, —
-  и общее оседает в одном месте, оставаясь неизвестным всем остальным.
+  надстройка.** Без адреса правку кладут туда, где она видна автору, — то есть в своё дерево, — и
+  общее оседает в одном месте, оставаясь неизвестным всем остальным.
 - **Предложение, о котором владелец сказал вслух, уходит наружу в тот же ход.** Написанное и не
-  отправленное лежит в дереве неотличимо от отправленного: своей записи в слое правил у него
-  нет, и владелец читает работу сделанной, пока не спросит прямо. Слово владельца о предложении
-  — «отправь», «заведи», «напиши» — распоряжение, а не тема разговора; показ того, что уехало
-  бы, отправкой не является и следа наружу не оставляет.
-- **Неудобство отправки — повод сказать о нём, а не повод не отправить.** Довод исполнителя
-  против уже принятого решения владельца остаётся доводом: он называется вслух, работа при этом
-  идёт. Отложить исполненное решение может только владелец; отложенное собственным доводом
-  выглядит для него сделанным, и цену этого он узнаёт последним.
+  отправленное лежит в дереве неотличимо от отправленного: своей записи в слое правил у него нет,
+  и владелец читает работу сделанной, пока не спросит прямо. Слово владельца о предложении —
+  «отправь», «заведи», «напиши» — распоряжение, а не тема разговора; показ того, что уехало бы,
+  отправкой не является и следа наружу не оставляет.
+- **Неудобство отправки — повод сказать о нём, а не повод не отправить.** Довод исполнителя против
+  уже принятого решения владельца остаётся доводом: он называется вслух, работа при этом идёт.
+  Отложить исполненное решение может только владелец; отложенное собственным доводом выглядит для
+  него сделанным, и цену этого он узнаёт последним.
 - **Работа, из которой видно серию задач, объявляется эпиком до первой из них.** Объявляется
-  дважды: карточкой в очереди работ и замыслом рядом с ней. Не объявленная серия существует
-  только в голове того, кто её задумал: следующий заход видит разрозненные задачи, порядка между
-  ними не находит и берёт ту, что ближе лежит.
+  дважды: карточкой в очереди работ и замыслом рядом с ней. Не объявленная серия существует только
+  в голове того, кто её задумал: следующий заход видит разрозненные задачи, порядка между ними не
+  находит и берёт ту, что ближе лежит.
 - **Замысел эпика называет разрабатываемую возможность, состав задач и их порядок.** Состав без
   порядка порядком не является: две задачи, у которых порядок держался пониманием, ушли в работу
   наоборот, и вторая переделывалась под первую. Возможность, названная одним словом, через неделю
   читается каждым по-своему.
-- **Порядок задач эпика назначается на планировании и держится до его конца.** Пересмотр по ходу
-  — решение владельца, записанное там же, где идёт работа. Порядок, назначаемый заново перед
-  каждой задачей, назначает тот, кому ближе, и эпик кончается там, где надоел.
+- **Порядок задач эпика назначается на планировании и держится до его конца.** Пересмотр по ходу —
+  решение владельца, записанное там же, где идёт работа. Порядок, назначаемый заново перед каждой
+  задачей, назначает тот, кому ближе, и эпик кончается там, где надоел.
+- **Каждая задача объявленного эпика получает свою карточку в очереди работ сразу, а не в день,
+  когда за неё берутся.** Замысел эпика держит порядок для того, кто работу ведёт; очередь работ —
+  для того, кто на неё смотрит, и эпик, у которого заведена одна карточка из десяти, выглядит там
+  работой на один шаг. Незаведённый объём не виден ни владельцу, ни соседней работе, которая берёт
+  уже назначенную задачу. Номер карточки встаёт в замысел той же правкой: замысел, называющий
+  задачу словами, на «взять следующую» отвечает названием, и карточку заводят заново — с другим
+  номером.
 - **Заход исполнителя не кончается вместе с задачей.** Конец задачи — не признак остановки:
   остановиться позволяет только предел заполнения окна. Заход, закрытый на готовой задаче,
-  оставляет владельцу пустое место и стоит целого захода на возвращение к тому, что и так было
-  под рукой.
+  оставляет владельцу пустое место и стоит целого захода на возвращение к тому, что и так было под
+  рукой.
 - **Предел заполнения окна останавливает заход только там, где инструмент не сжимает контекст
   сам.** Где сжатие объявлено и приходит раньше предела, окно — не конец захода, а его
-  продолжение: контекст сжимается, записанное состояние работы возвращается в него, и работа
-  идёт дальше тем же заходом. Останавливаться там незачем, а остановка стоит того же, что и
-  всякая другая: владелец возвращает исполнителя в работу руками.
-- **Порог, на котором заход останавливают, стоит позже порога, на котором его продолжают.**
-  Два порога на одном числе — это не согласие, а гонка, и выигрывает её тот, кто ближе к
-  действию: остановка приходит на вызове, а сжатие — между ходами. Расстояние между ними
-  объявляется, а не выводится разницей: сжатие идёт не мгновенно, и порог, отстоящий на волос,
-  требование «раньше» удовлетворяет, а работу не спасает.
-- **Переход из состояния в состояние исполнителя не останавливает.** Обязательное
-  действие сделано — следующее начинается тем же движением, без отчёта владельцу и без его
-  слова. Граница между состояниями выглядит законченным куском лучше всякой другой вехи:
-  сделанное названо, отчитаться есть чем, — и отчёт встаёт ровно на то место, где должно было
-  стоять следующее действие. Владелец читает такой отчёт как сделанную работу, а работа стоит.
+  продолжение: контекст сжимается, записанное состояние работы возвращается в него, и работа идёт
+  дальше тем же заходом. Останавливаться там незачем, а остановка стоит того же, что и всякая
+  другая: владелец возвращает исполнителя в работу руками.
+- **Порог, на котором заход останавливают, стоит позже порога, на котором его продолжают.** Два
+  порога на одном числе — это не согласие, а гонка, и выигрывает её тот, кто ближе к действию:
+  остановка приходит на вызове, а сжатие — между ходами. Расстояние между ними объявляется, а не
+  выводится разницей: сжатие идёт не мгновенно, и порог, отстоящий на волос, требование «раньше»
+  удовлетворяет, а работу не спасает.
+- **Переход из состояния в состояние исполнителя не останавливает.** Обязательное действие сделано
+  — следующее начинается тем же движением, без отчёта владельцу и без его слова. Граница между
+  состояниями выглядит законченным куском лучше всякой другой вехи: сделанное названо, отчитаться
+  есть чем, — и отчёт встаёт ровно на то место, где должно было стоять следующее действие.
+  Владелец читает такой отчёт как сделанную работу, а работа стоит.
 - **Текст, ведущий состояние работы, называет, что делается сразу за ним.** Дочитанный до
-  последнего приёма, он кончается ничем: следующего движения в нём нет, и исполнитель выводит
-  его из пустоты — то есть останавливается. Названное движение стоит там же, где приёмы, и
-  своими словами: одинаковая на все состояния строка перестаёт замечаться раньше, чем
-  понадобится.
+  последнего приёма, он кончается ничем: следующего движения в нём нет, и исполнитель выводит его
+  из пустоты — то есть останавливается. Названное движение стоит там же, где приёмы, и своими
+  словами: одинаковая на все состояния строка перестаёт замечаться раньше, чем понадобится.
 - **Работа, отданная на разбор, освобождает исполнителя, а не останавливает его.** Отданное на
   разбор ждёт владельца, а не машину: следующая задача эпика берётся тем же движением, которым
   предыдущая ушла на разбор.
-- **Ожидание машины работой не занимают.** Проверка, идущая на стороне, не спрашивает
-  исполнителя ни о чём и не идёт быстрее оттого, что он на неё смотрит. Пока она идёт, работа
-  продолжается: берётся следующая задача, а к проверке возвращаются тем ходом, которым читают
-  её конец. Заход, проведённый в ожидании, стоит ровно столько же, сколько заход, в котором
-  сделана задача, — и не даёт ничего.
-- **Ожидание, которое всё-таки останавливает работу, называется владельцу отдельно и прямо.**
-  Есть случаи, где дальше и вправду не пройти: следующая задача стоит на неразобранной, или
-  правка ждёт решения, которого нет ни у кого, кроме владельца. Тогда исполнитель говорит три
-  вещи — что именно стоит, чего оно ждёт и что владелец может с этим сделать: разобрать работу
-  первой или снять ожидание своим словом. Сказанное вперемешку с отчётом о сделанном не
-  читается: остановка называется отдельно от всего остального.
-- **Разбор закрытой работы идёт своим ходом и работу не задерживает.** Он смотрит на то, что
-  видно только заходу, который работу вёл, поэтому пропустить его нельзя; но и держать ради
-  него следующую задачу незачем — он ничего не спрашивает у исполнителя, пока идёт. Его находки
-  записываются туда, где их найдут после слияния работы, и показываются владельцу целиком, а не
-  уезжают наружу сами: что из них станет правкой, решает он.
-- **Отдав работу на разбор, исполнитель называет, чего ждёт и что сделает следом.** Владелец
-  видит не голову исполнителя, а страницу работы: зелёная проверка и доступное действие
-  читаются как «всё кончено». Названное вслух ожидание — единственное, что отличает «жду
-  проверок, потом уберу за собой» от «готово, забирай». Не названное, оно не существует, и
-  владелец действует по тому, что видит.
+- **Ожидание машины работой не занимают.** Проверка, идущая на стороне, не спрашивает исполнителя
+  ни о чём и не идёт быстрее оттого, что он на неё смотрит. Пока она идёт, работа продолжается:
+  берётся следующая задача, а к проверке возвращаются тем ходом, которым читают её конец. Заход,
+  проведённый в ожидании, стоит ровно столько же, сколько заход, в котором сделана задача, — и не
+  даёт ничего.
+- **Ожидание, которое всё-таки останавливает работу, называется владельцу отдельно и прямо.** Есть
+  случаи, где дальше и вправду не пройти: следующая задача стоит на неразобранной, или правка ждёт
+  решения, которого нет ни у кого, кроме владельца. Тогда исполнитель говорит три вещи — что
+  стоит, чего ждёт и что владелец может с этим сделать. Сказанное вперемешку с отчётом не
+  читается: остановка называется отдельно.
+- **Разбор закрытой работы идёт своим ходом и работу не задерживает.** Он видит то, что видно
+  только заходу, который работу вёл, — пропустить его нельзя; держать ради него следующую задачу
+  незачем. Находки записываются туда, где их найдут после слияния, и показываются владельцу
+  целиком: что станет правкой, решает он.
+- **Отдав работу на разбор, исполнитель называет, чего ждёт и что сделает следом.** Владелец видит
+  не голову исполнителя, а страницу работы: зелёная проверка и доступное действие читаются как
+  «всё кончено». Названное вслух ожидание — единственное, что отличает «жду проверок, потом уберу
+  за собой» от «готово, забирай». Не названное, оно не существует, и владелец действует по тому,
+  что видит.
 - **Работа не считается готовой, пока исполнитель не сказал этого прямо.** Готовность объявляет
   тот, кто работу вёл, — отдельной просьбой и про эту работу. Зелёные проверки готовностью не
   являются: они говорят, что не сломано, и молчат о том, осталось ли что-то сделать. Молчание
-  исполнителя владелец читает как готовность, и между двумя прочтениями теряется всё, что
-  стояло после разбора.
-- **Уборка за работой идёт до того, как о готовности сказано.** Всё, что работа обязана убрать
-  за собой, убирается раньше просьбы включить её в общее дерево, а не после согласия. После
-  включения убирать уже некому: работа перешла к следующей задаче.
+  исполнителя владелец читает как готовность, и между двумя прочтениями теряется всё, что стояло
+  после разбора.
+- **Уборка за работой идёт до того, как о готовности сказано.** Всё, что работа обязана убрать за
+  собой, убирается раньше просьбы включить её в общее дерево, а не после согласия. После включения
+  убирать уже некому: работа перешла к следующей задаче.
 - **Пока эпик не кончился, следующая работа не выбирается, а берётся.** Выбор, предложенный
   владельцу при назначенном порядке, — это просьба назначить его заново: он уже назначен, и
   предлагать его повторно значит отменять собственное планирование.
+- **Берётся следующая задача из замысла эпика, а не из списка очереди работ.** Список отсортирован
+  номером и показывает свежие задачи сверху; порядок эпика он не держит и держать не может — там
+  лежат задачи всех эпиков сразу. Замысел эпика открывается перед взятием и отвечает за один
+  вызов: какая задача следующая и не ушла ли она в соседний эпик.
+- **Кончившийся эпик называется владельцу тем же ходом, которым берётся работа вне его.** Пока
+  эпик идёт, следующая работа берётся молча; кончился — и следующий шаг перестал быть очевидным
+  для обоих. Исполнитель, взявший работу вне кончившегося эпика и промолчавший, оставляет
+  владельца в уверенности, что эпик продолжается.
+- **Эпик не закрывается, пока хоть один признак его конца подтверждён только чтением.** Признак,
+  проверяемый глазами, закрывает работу лишь после того, как его назвали проверенным вслух —
+  командой или замером с их выводом. Пометка «подтверждается живым замером» проверкой не является:
+  это обещание её сделать, и висит оно ровно до того, как кто-нибудь спросит. Закрытый по двум
+  признакам из трёх, эпик уносит третий в описание прошлого, где его уже никто не ищет.
 - **Замеченное по ходу и к эпику не относящееся становится задачей в очереди работ, а не работой
   сейчас.** Отвлечение выглядит дешёвым ровно до того, как окажется, что вместе с ним уехала
   правка соседнего домена: эпик при этом стоит, а откатывать приходится обе работы.
@@ -209,12 +220,11 @@
   Непонятно бывает от того, что замысел не открыли: он лежит и держит решения, которых в коде не
   видно.
 - **Положение эпика показывается владельцу таблицей — в передаче и при остановке за его
-  решением.** Это два момента, когда владелец смотрит на работу снаружи: в первый он забирает её
-  в новый заход, во второй решает, куда её вести. Порядок задач при этом лежит в замысле, а
-  замысел ни там, ни там не открывают — передача пересказывает один заход, вопрос называет одну
-  развилку, и по обоим не видно ни сделанного, ни оставшегося.
+  решением.** Это два момента, когда владелец смотрит на работу снаружи: в первый он забирает её в
+  новый заход, во второй решает, куда её вести. Порядок задач при этом лежит в замысле, а замысел
+  ни там, ни там не открывают — передача пересказывает один заход, вопрос называет одну развилку,
+  и по обоим не видно ни сделанного, ни оставшегося.
 - **Таблица показывает все задачи эпика разом — закрытые, текущую и назначенные.** Строка на
   задачу: место по порядку, задача, состояние; текущая отличается от остальных на вид. Порядок у
-  закрытых фактический, у будущих назначенный, и расхождение между ними тоже утверждение — оно
-  говорит, что порядок пересматривали. Перечень одних оставшихся не показывает, чего работа
-  стоила; перечень одних закрытых не показывает, сколько ещё впереди.
+  закрытых фактический, у будущих назначенный, и расхождение между ними тоже утверждение. Перечень
+  одних оставшихся не показывает, чего работа стоила; одних закрытых — сколько ещё впереди.

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

@@ -2,7 +2,7 @@
 name: doc-style-sweep
 kind: pattern
 rule: doc-style
-description: Паттерн правила doc-style. Брать, когда документ накопил список работ и его надо разобрать на действующее и закрытое — признак отбора, обход по утверждениям, сверка с очередью работ, измерение потерь, куда девать доводы за отсрочку и судьба самого файла. Не брать для написания нового текста — это паттерн doc-style-write.
+description: Паттерн правила doc-style. Брать, когда документ накопил список работ и его надо разобрать на действующее и закрытое: признак отбора, обход по утверждениям, сверка с очередью работ, судьба самого файла. Новый текст — паттерн doc-style-write.
 ---
 
 # Разбор документа, накопившего список работ

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

@@ -2,7 +2,7 @@
 name: doc-style-trace
 kind: pattern
 rule: doc-style
-description: Паттерн правила doc-style. Брать, когда полнота текстов проверяется со стороны работы, а не со стороны текста — обратный проход по закрытым задачам: признак отбора машиной, чего он не видит, три исхода по каждой задаче, граница «код не правится». Не брать для разбора документа, накопившего список работ, — это паттерн doc-style-sweep.
+description: Паттерн правила doc-style. Брать, когда полнота текстов проверяется со стороны работы: обратный проход по закрытым задачам, признак отбора машиной, чего он не видит, три исхода по каждой задаче. Разбор одного документа — паттерн doc-style-sweep.
 ---
 
 # Обратный проход: закрытые задачи против текстов

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

@@ -2,7 +2,7 @@
 name: git-workflow-commit
 kind: pattern
 rule: git-workflow
-description: Паттерн правила git-workflow. Брать на заведение рабочего элемента, ветки, коммит и пуш — заведение элемента с областью и итерацией, перевод состояния, слияние двух задач в одну, работа от учётной записи машинной работы, обход требования документа. Не брать на открытие PR — это паттерн git-workflow-pr; не брать для миграций и перезапуска прода — это паттерны git-workflow-migration и git-workflow-restart.
+description: Паттерн правила git-workflow. Брать на заведение рабочего элемента, ветки, коммит и пуш: элемент с областью и итерацией, перевод состояния, слияние двух задач в одну, работа от машинной записи, обход требования документа. Открытие PR — паттерн git-workflow-pr.
 ---
 
 # Задача, ветка и коммит

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

@@ -2,7 +2,7 @@
 name: git-workflow-commit
 kind: pattern
 rule: git-workflow
-description: Паттерн правила git-workflow. Брать на заведение задачи, ветки, коммит и пуш — готовая команда заведения задачи со всеми четырьмя шагами, перевод задачи в колонку работы, слияние двух задач в одну, работа от учётной записи бота, обход требования документа. Не брать на открытие PR — это паттерн git-workflow-pr; не брать для миграций и перезапуска прода — это паттерны git-workflow-migration и git-workflow-restart.
+description: Паттерн правила git-workflow. Брать на заведение задачи, ветки, коммит и пуш: команда заведения со всеми четырьмя шагами, перевод колонки, слияние двух задач в одну, работа от машинной записи, обход требования документа. Открытие PR — паттерн git-workflow-pr.
 ---
 
 # Задача, ветка и коммит
@@ -54,6 +54,12 @@ gh project item-add <номер борды> --owner <владелец> --url <а
 общий, и по одной задаче он не виден. Шестнадцать задач подряд напечатали номер, и ни одна не
 попала в очередь так, чтобы её увидел владелец.
 
+Задача, заведённая по тексту документа, называет в теле проверку в дереве. Цитата основанием не
+бывает: документ говорит о замысле, стареет молча и остаётся верным на вид, а задача заводится
+под то, что в дереве сейчас. В теле стоит файл и символ, где промах виден, либо вывод команды,
+который его показывает. Не нашлось ни того ни другого — задача не заводится, а строка документа
+правится тем ходом, которым её прочитали.
+
 Название тикета говорит, что не так, а не что сделать: PR потом переводит его в сделанное.
 Номер в заголовок руками не пишется — он известен только после создания, и команда дописывает
 его сама.

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

@@ -2,7 +2,7 @@
 name: git-workflow-commit
 kind: pattern
 rule: git-workflow
-description: Паттерн правила git-workflow. Брать на заведение задачи, ветки, коммит и пуш — заведение задачи с меткой списка, перевод по спискам доски, слияние двух задач в одну, работа от учётной записи машинной работы, обход требования документа. Не брать на открытие MR — это паттерн git-workflow-pr; не брать для миграций и перезапуска прода — это паттерны git-workflow-migration и git-workflow-restart.
+description: Паттерн правила git-workflow. Брать на заведение задачи, ветки, коммит и пуш: заведение задачи с меткой списка, перевод по спискам доски, слияние двух задач в одну, работа от машинной записи, обход требования документа. Открытие MR — паттерн git-workflow-pr.
 ---
 
 # Ветка, коммит и MR

package/assets/patterns/git-workflow-docker.md

@@ -2,7 +2,7 @@
 name: git-workflow-docker
 kind: pattern
 rule: deploy-flow
-description: Паттерн правила deploy-flow. Брать при работе с образами на своей машине — подъём и перезапуск демона, диагностика «висящей» команды, сборка под платформу прод-сервера, одноразовый контейнер рядом с чужими, вход в реестр из службы. Не брать для команд прод-сервера и выбора образа — это паттерн git-workflow-restart, и не для наката миграций — это git-workflow-migration.
+description: Паттерн правила deploy-flow. Брать при работе с образами на своей машине: подъём и перезапуск демона, диагностика «висящей» команды, сборка под платформу прод-сервера, вход в реестр из службы. Команды прод-сервера — паттерн git-workflow-restart.
 ---
 
 # Образы на своей машине

package/assets/patterns/git-workflow-merge.md

@@ -2,7 +2,7 @@
 name: git-workflow-merge
 kind: pattern
 rule: git-workflow
-description: Паттерн правила git-workflow. Брать, когда главная ветка вливается в ветку задачи и разрешается конфликт — порядок мержа, разбор конфликта по роду файла, сверка дописанного веткой с очередью работ, проверки после разрешения, перечитывание тела уже открытого PR. Не брать для заведения ветки и коммита — это паттерн git-workflow-commit, для PR — git-workflow-pr.
+description: Паттерн правила git-workflow. Брать, когда главная ветка вливается в ветку задачи и разрешается конфликт: порядок мержа, разбор по роду файла, сверка дописанного с очередью работ, перечитывание тела открытой заявки. Заведение ветки и коммит — паттерн git-workflow-commit.
 ---
 
 # Мерж главной ветки в ветку задачи
@@ -20,17 +20,24 @@ description: Паттерн правила git-workflow. Брать, когда
 
 ```bash
 git fetch origin
-git merge origin/main --no-edit
+GIT_AUTHOR_NAME="<бот>" GIT_AUTHOR_EMAIL="<номер>+<бот>@users.noreply.github.com" \
+GIT_COMMITTER_NAME="<бот>" GIT_COMMITTER_EMAIL="<номер>+<бот>@users.noreply.github.com" \
+    git merge origin/main --no-edit
 git diff --name-only --diff-filter=U     # что встало конфликтом
 ```
 
+Подпись стоит в самой команде: коммит слияния заводит она, а не отдельный `git commit`, и
+переставить его подпись потом нечем — ушедший за подписью человека мерж отбивается на отправке
+и чинится перебазированием на главную ветку.
+
 Список конфликтов читается целиком до первого разрешения: род файла решает приём, и разные
 файлы одного мержа разрешаются по-разному.
 
 | Что встало конфликтом            | Как разрешается                                                                    |
 | -------------------------------- | ---------------------------------------------------------------------------------- |
 | код                              | ловушка правила `git-workflow` про сторону-удаление; после — `npm run check:dupes` |
-| спек в `docs/specs/`             | сохранением обеих сторон — правило `spec-driven`; после — `npm run check:specs`    |
+| спек в `docs/specs/`             | сохранением обеих сторон, если обе дописывали; снятый одной стороной раздел остаётся снятым — правило `spec-driven`; после — `npm run check:specs` |
+| компаньон правила рядом со скилом | сохранением обеих сторон — те же две дописи в одну таблицу; после — `npm run check:specs` |
 | список работ (`docs/BACKLOG.md`) | признаком отбора — паттерн `doc-style-sweep`                                       |
 
 ## Что дописала ветка, видно только от точки расхождения
@@ -98,3 +105,7 @@ PR описывал дерево на день, когда его написал
 - Сторона ветки перенесена без сверки с очередью работ: одна работа стала двумя записями.
 - После разрешения прогнана сборка, а проверки текстов — нет: конфликта в них сборке не видно.
 - Тело PR оставлено прежним: ревьювер читает утверждение о дереве, которого больше нет.
+- Раздел, снятый главной веткой, вернулся «сохранением обеих сторон»: в спеке два экземпляра
+  одного абзаца, и снятый читается как действующий.
+- Мерж ушёл за подписью человека: переменных в команде слияния не было, а строка о подписи
+  лежит ниже команды и читается уже после коммита.

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

@@ -2,7 +2,7 @@
 name: git-workflow-pr
 kind: pattern
 rule: git-workflow
-description: Паттерн правила git-workflow. Брать на открытие PR и всё, что с ним связано, — формат заголовка, черновик и его снятие, привязка к рабочему элементу, ревьювер и исполнитель, образец тела с разделом об оставшемся шаге, чтение состояния PR, перевод элемента в состояние разбора, чеклист проверок до снятия черновика. Не брать на заведение элемента, ветки и коммит — это паттерн git-workflow-commit.
+description: Паттерн правила git-workflow. Брать на открытие PR и всё, что с ним связано: формат заголовка, черновик и его снятие, привязка к рабочему элементу, ревьювер, образец тела, чтение состояния PR, чеклист проверок. Заведение элемента и коммит — паттерн git-workflow-commit.
 ---
 
 # Заявка на слияние