@rt-tools/agent-kit 0.8.2 → 0.9.0

package/assets/rules/task-flow.md

@@ -22,7 +22,8 @@ description: Правило под «Закон о ведении работы»
 | замысел                                       | `docs/tasks/<ветка>/plan.md` — след задачи и этапы с признаками готовности; после написания не правится                       |
 | ход работы                                    | `docs/tasks/<ветка>/progress.md` — «Где стоим», решения по ходу, записи заходов; единственное место, где отмечается сделанное |
 | договорённость о продукте, записанная до кода | `docs/specs/<домен>/proposed/<фича>/` — спек фичи; переживает мерж и вливается в спек домена                                  |
-| эпик — работа шире одной ветки                | карточка в очереди работ с меткой эпика и файл замысла рядом: возможность, состав задач и их порядок                          |
+| эпик — работа шире одной ветки                | карточка в очереди работ с меткой эпика и замысел эпика рядом с ней: возможность, состав задач и их порядок                   |
+| замысел эпика                                 | запись вне папки задачи — та умирает с мержем, а эпик её переживает; каталог для неё называет компаньон правила               |
 | папка задачи до заведения задачи              | `docs/tasks/_draft-<slug>/` — вне истории, пока номера нет                                                                    |
 | разведка                                      | заход `Explore` или `general-purpose` до первого вопроса владельцу                                                            |
 | разбор замысла ролями                         | `.claude/workflows/plan.js` — нужность, договорённость, критика, замысел                                                      |
@@ -44,24 +45,72 @@ description: Правило под «Закон о ведении работы»
 | 1   | Разведка по дереву — до первого вопроса владельцу        | `task-flow-start`   |
 | 2   | Разбор просьбы с владельцем, шесть обязательных вопросов | `task-flow-start`   |
 | 3   | Конвейер ролей после разбора                             | `task-flow-start`   |
-| 4   | Задача, ветка, папка задачи                              | `task-flow-start`   |
-| 5   | Шапка замысла и сам замысел                              | `task-flow-start`   |
-| 6   | Возвращение к работе новым заходом                       | `task-flow-resume`  |
-| 7   | Этап замысла делается и отмечается в ходе работы         | `task-flow-resume`  |
-| 8   | Заход закрывается передачей                              | `task-flow-handoff` |
-| 9   | Договорённость вливается в спек домена                   | `task-flow-close`   |
-| 10  | Тексты домена приводятся к сделанному                    | `task-flow-close`   |
-| 11  | Папка задачи разбирается                                 | `task-flow-close`   |
-| 12  | Сверка очереди работ                                     | `task-flow-close`   |
-| 13  | Следующая задача эпика берётся тем же движением          | `task-flow-resume`  |
-
-Шаги 6–8 повторяются, пока этапы замысла не кончатся: первый заход входит в работу шагом 1 и
-доходит до 7, дальше каждый следующий начинается шагом 6. Шаги 9–12 идут один раз, когда работа
-кончена.
+| 4   | Серия задач объявляется эпиком — карточкой и замыслом    | `task-flow-start`   |
+| 5   | Задача, ветка, папка задачи                              | `task-flow-start`   |
+| 6   | Шапка замысла и сам замысел                              | `task-flow-start`   |
+| 7   | Возвращение к работе новым заходом                       | `task-flow-resume`  |
+| 8   | Этап замысла делается и отмечается в ходе работы         | `task-flow-resume`  |
+| 9   | Заход закрывается передачей                              | `task-flow-handoff` |
+| 10  | Работа отдаётся на разбор: PR открыт, ожидание названо   | `task-flow-close`   |
+| 11  | Следующая задача эпика берётся тем же движением          | `task-flow-resume`  |
+| 12  | Договорённость вливается в спек домена                   | `task-flow-close`   |
+| 13  | Тексты домена приводятся к сделанному                    | `task-flow-close`   |
+| 14  | Папка задачи разбирается                                 | `task-flow-close`   |
+| 15  | Сверка очереди работ                                     | `task-flow-close`   |
+| 16  | Работа разбирается правилами — фоном, следом за PR       | `task-flow-close`   |
+| 17  | Находки разбора принимаются одним ходом и ждут владельца | `task-flow-close`   |
+
+Шаги 7–9 повторяются, пока этапы замысла не кончатся: первый заход входит в работу шагом 1 и
+доходит до 8, дальше каждый следующий начинается шагом 7. Шаг 4 идёт только у работы, из которой
+видно серию задач. Шаги 10–17 идут один раз, когда работа кончена.
+
+Порядок в таблице — тот, в каком шаги случаются, а не тот, в каком о них удобно рассказывать.
+Следующая задача берётся раньше уборки за предыдущей: работа, отданная на разбор, ждёт владельца,
+и заход этим ожиданием не занимают. Список, в котором уборка стоит раньше, читается как
+разрешение сидеть над зелёным PR до ответа.
+
+Три шага идут не в очередь, а рядом с работой: прогон конвейера, разбор владельцем и разбор
+закрытой работы правилами. Ни один из них не спрашивает исполнителя, пока идёт, и ни один не
+ускоряется от того, что его ждут, — поэтому шаг 11 случается раньше, чем кончатся 10 и 16, а
+шаг 17 вклинивается в работу следующей задачи ровно на один ход. Порядок номеров говорит, что
+за чем следует, а не что чего дожидается.
 
 Список показывается владельцу в начале работы, и на нём же отмечается, где стоим: иначе после
 шести вопросов не видно ни того, что будет дальше, ни сколько всего впереди.
 
+## Ход
+
+Ход работы от просьбы владельца до закрытия: где стоит разбор, что требует гард и куда девается
+папка задачи.
+
+```mermaid
+flowchart TD
+    A[Просьба владельца] --> B[Разведка по дереву — до первого вопроса]
+    B --> C[Разбор просьбы: шесть обязательных вопросов, ответы ложатся на диск]
+    C --> D{Правка задевает код приложения}
+    D -->|Да| E[Пишется договорённость о продукте — до кода]
+    D -->|Нет| F[В замысле стоит причина, по которой её нет]
+    E --> Z{Из разбора вышло несколько задач}
+    F --> Z
+    Z -->|Да| Y[Серия объявляется эпиком: карточкой и замыслом, до первой задачи]
+    Z -->|Нет| G[Задача, ветка, папка задачи по имени ветки]
+    Y --> G
+    G --> H[Замысел с этапами; после записи он не правится]
+    H --> I{Этап сделан}
+    I -->|Да| J[Отметка в ходе работы — единственном месте, где отмечается сделанное]
+    J --> I
+    I -->|Этапы кончились| K[PR открывается; исполнитель называет номер, чего ждёт и что сделает следом]
+    K --> W[Разбор закрытой работы правилами уходит в фон, находки ложатся на диск]
+    W --> L[Пока PR ждёт разбора, берётся следующая задача]
+    L --> M{Разбор и прогон кончились}
+    M -->|Красный прогон или замечания| V[Чинится в той же ветке: замысел на диске ещё нужен]
+    V --> M
+    M -->|Зелено и замечаний нет| T[Договорённость вливается в спек домена, тексты приводятся к сделанному]
+    T --> N[Папка задачи разбирается последним коммитом: разбор просьбы — в описание прошлого, находки — к замыслу эпика, замысел — прочь]
+    N --> S[Сверка очереди работ]
+    S --> O[Черновик снимается, слияние нажимает человек]
+```
+
 ## Как закон применяется здесь
 
 - **Правка кода приложения отбивается, пока на диске нет замысла.** Гард требует папку задачи
@@ -86,12 +135,49 @@ description: Правило под «Закон о ведении работы»
   читает однозначно, а зелёный прогон на странице — нет: он говорит, что не сломано, и молчит
   о том, что ветка ждёт ещё одного коммита. Трижды подряд PR был влит внутри этого молчания.
 - **Просьба о слиянии — отдельный ход, и раньше уборки её не бывает.** Порядок один: PR открыт
-  → прогон зелёный → папка задачи разобрана и запушена → исполнитель просит влить, называя
-  номер. До этой просьбы работа не готова, сколько бы зелёного на её странице ни было.
+  черновиком → прогон зелёный → папка задачи разобрана и запушена → черновик снят →
+  исполнитель просит влить, называя номер. До этой просьбы работа не готова, сколько бы зелёного
+  на её странице ни было.
+- **PR открывается черновиком, а не в конце работы.** Пока правка кода не выложена в PR,
+  владелец её не видит вовсе: ветка не приходит ему во входящие и обсуждения не имеет.
+  Открытый PR при этом читается как приглашение влить — поэтому незаконченная работа идёт
+  черновиком, и владельцу не приходится спрашивать, кончилась ли она. Черновик снимается тем
+  ходом, которым исполнитель говорит, что решение готово.
+- **Открытый PR остановкой не является.** Отданное на разбор ждёт владельца, а не исполнителя:
+  следующая задача берётся тем же движением, которым предыдущая ушла на разбор. Заход,
+  закрытый на готовой задаче, стоил владельцу целого захода на то, чтобы вернуть работу в
+  движение, — при том что порядок был назначен и лежал записанным в замысле эпика.
+- **Владельцу не предлагается выбор, чем заняться дальше, пока эпик не кончился.** Меню при
+  назначенном порядке — это просьба назначить его заново. Если работы в эпике не осталось, так
+  и говорится: эпик кончился, — а не «чем займёмся».
+- **Гард замысла — нижняя граница требования, а не его предел.** Он требует папку только под
+  правку кода приложения, и работа, которая туда не доходит, проходит мимо него — но папку
+  заводит всё равно: статья правила говорит «под любую работу, без исключений». Прочитанный
+  как признак, гард становится разрешением работать без замысла везде, куда он не смотрит.
+- **Ход, сообщающий владельцу о чужом шаге, называет своё следующее действие и начинает его.**
+  Прогон, разбор владельцем и слияние идут без исполнителя и быстрее от взгляда не становятся,
+  поэтому сообщение о них — не работа, а сводка. Ход, кончившийся такой сводкой, владелец
+  читает как работу: она полна, в ней названы номера и состояния, и пустоты за ней не видно.
+  Открытый PR, красный прогон и ожидание слова владельца — случаи одного и того же, и правило
+  у них одно: о чужом шаге говорят вместе с начатым своим, а не вместо него. За один заход это
+  было нарушено четырежды, и готовая работа простояла в невлитом PR почти три часа, пока
+  исполнитель отвечал владельцу сводками о её состоянии.
 - **Пока PR ждёт разбора, исполнитель берёт следующую задачу.** Ожидание чужого шага заходом
   не занимают: работа уходит на разбор, и тем же движением берётся следующая. Готовым к
   слиянию прежний PR становится не сам — его доводит до готовности исполнитель, вернувшись к
   нему тем же ходом, которым прочитал конец прогона.
+- **Ход о чужом шаге стережёт гард ожидания, а не память исполнителя.** Он отбивает завершение
+  хода, в котором о чужом шаге сказано, а по следующей задаче не сделано ни одного действия —
+  ни заведения задачи, ни ветки, ни папки, ни перевода колонки. Чужой шаг он узнаёт по двум
+  признакам: в ходе открыт PR либо в ходе прочитан красный прогон. Оба берутся из самого хода:
+  спросить хостинг было бы точнее, но сетевой вызов на завершении хода падает вместе со связью
+  и отбивал бы работу вместо промаха, а вывод команды о прогоне в записи хода уже лежит. Слова
+  «беру следующую задачу» гард действием не считает — ровно потому, что их и произносят вместо
+  неё.
+- **Конец прогона узнаётся возвратом фоновой команды, а не взглядом на страницу.** Ожидание,
+  запущенное в фоне отдельным ходом, возвращает исполнителя к PR само; до тех пор ход занят
+  следующей задачей. Взгляд на страницу этого не даёт: он либо повторяется вхолостую, либо не
+  повторяется вовсе, и оба исхода со стороны выглядят одинаково — работа не двигается.
 - **Отказ гарда кончает ход.** Другого пути к отбитой правке не ищут: ни командой оболочки, ни
   соседним инструментом, ни правкой самого гарда. Отбитая правка либо делается после того, как
   условие отказа выполнено, либо не делается вовсе — и тогда владельцу называется отказ, а не
@@ -106,7 +192,16 @@ description: Правило под «Закон о ведении работы»
 - **Действия, которые исполнитель не делает без слова владельца, перечислены в компаньоне
   правила.** Список у каждого дерева свой — пакет знает только требование, чтобы список был
   назван. Не названный, он выводится из общих слов, и «делай, что нужно по плану» становится
-  разрешением на пуш и правку общих документов заодно с коммитом.
+  разрешением на пуш и правку общих документов заодно с коммитом. Оценка «это безопасно» списка
+  не заменяет: её назначает тот, кому она в эту минуту удобна, и она плывёт. За один заход одна
+  и та же команда была сначала слишком опасной, чтобы её позвать, а через два хода —
+  достаточно безопасной, чтобы позвать без спроса.
+- **У отказа от необратимого действия есть безопасная часть, и она делается.** Требование
+  спросить владельца относится к действию, а не к ходу: работа, у которой отделима часть без
+  последствий, делится, а не откладывается целиком. Список вариантов, поданный вместо работы,
+  читается как работа — тем полнее, чем аккуратнее он составлен: он пронумерован, в нём названы
+  цифры, и именно поэтому пустота хода за ним не видна. Владельцу называется, что уже сделано и
+  что осталось за его словом, — а не выбор из вариантов вместо и того и другого.
 - **Ход, в котором исполнитель признал промах, не заканчивается, пока записи о происшествии
   нет.** Отбивает гард происшествия — на завершении хода: к моменту признания промах уже
   случился, и ловить раньше нечего. Признание ловится набором образцов, а не пониманием смысла;
@@ -133,6 +228,41 @@ description: Правило под «Закон о ведении работы»
   `npm run task:new` переименовывает черновик и проставляет шапку замысла.
 - **Брошенный разбор виден.** Черновик старше недели перечисляет сверка очереди работ —
   задачи за ним ещё нет, и спросить о нём некого.
+- **Замысел эпика лежит там, где его найдут без сети и после мержа.** Карточка в очереди работ
+  говорит, что эпик есть, но порядка задач не держит; папка задачи держала бы его ровно до
+  слияния первой из них. Каталог для замысла называет компаньон правила: у пакета своего пути
+  нет, а замысел, положенный каждым заходом заново, теряет решения предыдущих.
+- **Сборка по образцу начинается с чтения самого образца, а не пересказа о нём.** Пересказ
+  лежит в разборе просьбы и в замысле эпика; читаются они оба, но образцом не считаются. Часть
+  образца, которую работа повторяет, открывается целиком — обходом каталогов, а не одним файлом,
+  за которым пришли. Расхождение, не найденное так, находит владелец на приёмке целой работой.
+- **Путь к образцу лежит вне дерева и приходит в заход хуком запуска сессии.** Имя чужого
+  дерева в файлы репозитория не пишется, поэтому ни замысел эпика, ни разбор просьбы его не
+  держат: там законна ссылка без имени — «путь к образцу лежит вне дерева». Каталог для записи
+  — тот же, где лежит передача захода; называет его компаньон правила. Не записанный так,
+  образец теряется на первой же чистке контекста, и следующий заход собирает по памяти
+  предыдущего.
+- **Закрытая работа разбирается правилами, и это шаг закрытия, а не отдельная просьба.** Что
+  грузилось, что помогло и чего не хватило, видно только тому заходу, который работу вёл; через
+  сутки этого нет ни у кого. Разбор кончается правкой слоя правил или предложением наружу —
+  разбор, из которого не вышло ни того ни другого, объясняет случившееся и ничего не меняет.
+  Ведёт его роль разбора закрытой задачи, если дерево её разложило; не разложившее ведёт разбор
+  само, и требование от этого не слабеет.
+- **Разбор закрытой работы уходит в фон, а исполнитель берёт следующую задачу.** Роль работает
+  своим ходом и у исполнителя ничего не спрашивает; держать ради неё заход незачем. Сводку для
+  неё собирают до запуска — пока задача ещё в голове, — а вернувшиеся находки принимают одним
+  ходом: записать и продолжить прежнее. Порядок и место записи — паттерн закрытия работы.
+- **Находки разбора ждут владельца, а в пакет уезжает только сводка наблюдений.** Предложение —
+  это заготовка правки чужого дерева, и часть заготовок отпадает при первом же чтении; уехавшая
+  без разбора, она становится работой того, кто её не заказывал. Сводка наблюдений уезжает
+  всегда: она говорит, чем пользовались и чем нет, и мнением не является.
+- **Ожидание прогона работой не занимают.** Прогон идёт на стороне и быстрее от взгляда на него
+  не становится. Пока он идёт, берётся следующая задача, а к прогону возвращаются тем ходом,
+  которым читают его конец. Это верно и для разбора владельцем: оба ожидания — не повод стоять.
+- **Остановка, если она всё-таки случилась, называется владельцу отдельной репликой.** Не
+  строкой в конце отчёта: там она тонет — владелец читает отчёт как рассказ о сделанном.
+  Называются три вещи: что стоит, чего оно ждёт и что владелец может решить — разобрать работу
+  первой или сказать, что прогона можно не ждать. Всё остальное идёт после.
 - **Договорённость вливается в спек домена последним коммитом PR.** К этому моменту код
   написан, привязки известны, и в главной ветке директория `proposed/` не появляется вовсе.
   Готовые к вливанию перечисляет `npm run check:specs`.

package/assets/rules/testing.md

@@ -28,6 +28,37 @@ description: Правило под «Закон о проверяемости».
 переносится между репозиториями, раскладка — нет, и путь, названный в правиле, врёт в первом
 же дереве, которое держит код иначе.
 
+## Ход
+
+Ход заведения проверки: что проверяется вызовом, что — сквозным путём и как сценарий связан со
+своим тестом.
+
+```mermaid
+flowchart TD
+    A[Нужна проверка] --> B{Что обещает сценарий}
+    B -->|Человек видит и делает| C[Закрывается сквозным тестом тем же путём, что и пользователь]
+    B -->|Значение, состояние, отказ| D[Закрывается вызовом]
+    D --> E{Решение зашито в компонент или сервис}
+    E -->|Да| F[Выносится в чистую функцию и проверяется вызовом]
+    E -->|Нет| G[Проверяется как есть]
+    F --> H[Момент времени принимается параметром, а не читается с часов машины]
+    G --> H
+    C --> I{Тест погашен переменной окружения}
+    I -->|Да| J[Покрытием не считается: это долг, а отметка при живом тесте — отказ]
+    I -->|Нет| K[В заголовке теста стоит номер сценария]
+    H --> K
+    K --> P{Сценарий с таким номером есть в спеках}
+    P -->|Нет| Q[Проверка краснеет: тест ссылается на несуществующий сценарий]
+    P -->|Да| R{Тест идёт тем же путём, что и пользователь}
+    R -->|Нет| S[Помечается частичным покрытием: в сводку идёт долгом]
+    R -->|Да| L{Сценарий остался без теста}
+    L -->|Да| M[Несёт отметку с причиной: пустая не принимается]
+    L -->|Нет| N[Готово]
+    S --> N
+    M --> N
+    J --> N
+```
+
 ## Как закон применяется здесь
 
 - **Идентификатор сценария стоит в начале заголовка теста, через тире.** Один сценарий
@@ -95,6 +126,19 @@ description: Правило под «Закон о проверяемости».
   сценария в заголовке стоит — сценарий числится покрытым, а что именно утверждается, не
   спрашивает никто. Тело читается вместе с заголовком: обещание в заголовке и утверждение в
   теле — два разных текста, и расходятся они молча.
+- **Растр браузера называется явно, иначе кадр не сходится сам с собой.** Профиль цвета, взятый
+  у дисплея машины, ускоритель, считающий растр, и дорисовка кусками — каждый из трёх двигает
+  цвет на единицу-другую по каналу, и видно это только там, где смешение стоит на границе
+  округления: на сглаженных уголках тёмной темы. Ожидание вставшего кадра тут не помогает —
+  страница нарисована, а нарисована она каждый раз чуть иначе; расхождение гуляет по кадру,
+  приходит примерно раз в четыре прогона и на светлых экранах не показывается вовсе, поэтому
+  читается случайным. Все три называются доводами браузеру при запуске и становятся частью
+  эталона.
+- **Маска закрывает содержимое, но не ширину.** Узел под маской занимает своё место в раскладке
+  по-прежнему, и плывущее значение внутри него двигает соседей мимо маски: кадр списка уезжал на
+  пиксель целиком, включая столбцы, где не менялось ничего. Там, где размер узла считается по
+  содержимому — ячейка таблицы, надпись, растягивающая кнопку, — плывущее лечится в данных
+  стенда постоянным значением, и тогда маска не нужна вовсе.
 
 ## Чего из закона здесь нет
 
@@ -155,3 +199,21 @@ description: Правило под «Закон о проверяемости».
   соревнуется за машину с тем, что снимают, и делает исход прогона зависящим от того, чем занят
   сосед. Нагрузка, которую задание создаёт себе само — соседняя витрина, только что законченная
   сборка, — ничем не отличается от чужой.
+- **Свой стенд снимается перед тем, как звать набор.** Прогон переиспользует поднятое на его
+  портах, и стенд, оставленный для замера, отдаёт ему чужую сборку с чужими данными. Красное при
+  этом приходит не строкой про занятый порт, а десятком спек про экраны — то есть выглядит
+  дефектом правки: за один заход так покраснели сначала шесть новых тестов, потом гейт пуша, и
+  оба раза причиной был свой же стенд. Разобранный занятый порт эту сторону не закрывает: он про
+  чужой стенд, а этот — про свой.
+- **Разбор упавшего кадра начинается с чисел, а не с картинки расхождения.** Доля площади
+  говорит, сколько разошлось, и молчит о том, что именно: сдвиг всего кадра на пиксель,
+  переставленные строки и рябь на сглаженных уголках выглядят на картинке одинаково — «стало
+  другим». Читаются координаты разошедшихся точек и величина расхождения по каналу: сдвинутые
+  границы блоков — это раскладка, разошедшийся текст при неподвижных границах — это данные,
+  единица-две по каналу на кривых краях — это цвет. Три расхождения одного набора разобрались
+  ровно так, и ни одно из трёх не оказалось дефектом экрана.
+- **Ожидаемое значение теста не берётся из кода, который тест проверяет.** Вывезенное из
+  проверяемой либы, оно делает тест зелёным при любом значении: «колесо показывает пять строк»
+  сходится и тогда, когда строк стало три. Ожидаемое пишется числом в самой спеке рядом с
+  проверкой, а общий модуль сквозных спек держит приёмы — открыть, дождаться, снять со
+  страницы, — но не то, что от страницы ожидается.

package/assets/rules/translations.md

@@ -28,6 +28,27 @@ description: Правило под «Закон о локалях и перев
 переносится между репозиториями, раскладка — нет, и путь, названный в правиле, врёт в первом
 же дереве, которое держит код иначе.
 
+## Ход
+
+Ход появления видимого текста: откуда он берётся, что делается с непришедшим переводом и чем
+держится полнота словарей.
+
+```mermaid
+flowchart TD
+    A[Появился видимый человеку текст] --> B{Чей он}
+    B -->|Интерфейса| C[Заводится ключом во всех локалях перевода сразу]
+    B -->|Содержимого| D[Владелец пишет на своём языке, остальные локали — производные]
+    C --> E{Перевод пуст}
+    E -->|Да| F[Считается пропуском: подставляется запасной словарь, а прогон краснеет]
+    E -->|Нет| G[Готово]
+    D --> H{Перевод пришёл}
+    H -->|Да| I[Записывается]
+    H -->|Нет| J[Прежнее значение сохраняется, а само сохранение не срывается]
+    I --> G
+    J --> G
+    F --> G
+```
+
 ## Как закон применяется здесь
 
 - **Локаль по умолчанию отдаётся из корня, остальные семь — из-под префикса пути.**

package/assets/rules/typescript-conventions.md

@@ -25,6 +25,27 @@ description: Правило под «Закон об устройстве код
 переносится между репозиториями, раскладка — нет, и путь, названный в правиле, врёт в первом
 же дереве, которое держит код иначе.
 
+## Ход
+
+Ход объявления символа: чем задаётся имя, откуда берётся тип и что делается со снятым
+объявлением.
+
+```mermaid
+flowchart TD
+    A[Объявляется символ] --> B[Род виден по префиксу имени, а суффикс файла обещает, что в нём лежит]
+    B --> C{Тип уже объявлен где-то}
+    C -->|Да| D[Берётся из того пакета, где объявлен: своя копия разойдётся с оригиналом молча]
+    C -->|Нет| E[Объявляется здесь]
+    D --> F{Значение приходит не в том виде}
+    E --> F
+    F -->|Да| G[Приведение идёт названным способом; двухступенчатое запрещено]
+    F -->|Нет| H{Объявление снимается}
+    G --> H
+    H -->|Да| I[Отметка об устаревании ставится вместе с обходом всех потребителей]
+    H -->|Нет| J[Файл держится в пределах длины, сложность спрашивается у плагина, а не вспоминается]
+    I --> J
+```
+
 ## Как закон применяется здесь
 
 - **Род объявления виден по префиксу имени, и это держат три правила линтера.** У интерфейса,
@@ -38,6 +59,13 @@ description: Правило под «Закон об устройстве код
   остального. Для `.ts` это держит правило линтера; файлы обвязки — сценарии и скрипты — до
   него не доходят и судятся отдельной проверкой дерева. Накопленное к дню включения
   перечислено поимённо, и строка оттуда снимается вместе с делением своего файла.
+- **Значение из закрытого набора приходит перечислением `E<Имя>`, а не строкой или числом в
+  месте использования.** Ключ переводимого поля, имя вкладки, слот обложки, вид записи — всё
+  это наборы: их называют форма, стор, разметка и сравнение черновиков, и написанное на месте
+  значение ни находится по дереву, ни правится разом. Перечисление живёт в слое `util` того
+  домена, чей это набор, а общее нескольким приложениям — в общей либе. Одиночный адрес,
+  разделитель и знак-подпись перечислением не становятся: закрытого набора у них нет, и они
+  объявляются константой файла с говорящим именем.
 - **Тип берётся из того пакета, где объявлен.** Своя копия чужого типа расходится с оригиналом
   молча, а компилируется из них только одна.
 - **Двухступенчатое приведение `as unknown as` запрещено правилом линтера.** Вместо него —

package/assets/samples/specs/_template/spec.md

@@ -0,0 +1,83 @@
+# <Домен>
+
+**Статус:** действует · **Ревизия:** <дата> · **Префикс сценариев:** `SC-<ПРЕФИКС>`
+**Зависимости:** <домены, без которых этот не работает, или «нет»>
+**Законы:** `<закон>`, `<закон>`
+**Процедуры:** <либы, чьи процедуры домен обслуживает, или «нет»>
+
+Разделы ниже обязательны все: отсутствие раздела — отказ, а «не применимо» — законный ответ.
+Договорённость о продукте, которая пишется до кода, лежит в `proposed/<фича>/` этого же домена
+и вливается сюда последним коммитом PR — с прежними номерами сценариев.
+
+## Зачем
+
+<Что домен решает и чего стоит его отсутствие. Не пересказ реализации.>
+
+## Терминология
+
+| Термин   | Что это    |
+| -------- | ---------- |
+| <термин> | <значение> |
+
+### Как это называется в интерфейсе
+
+| В договорённости | На экране |
+| ---------------- | --------- |
+| <термин>         | <подпись> |
+
+## Правила
+
+- **<утверждение о продукте>.** <Довод: что случится, если этого не держать.> Каждое
+  утверждение получает строку привязки `файл:символ` в `implementation.md` рядом.
+
+## Что не входит
+
+- <соседняя область и куда за ней идти>
+
+## Контракт
+
+<Процедуры домена таблицей: имя, что принимает, что отдаёт. Нет процедур — «не применимо».>
+
+### Коды отказов
+
+| Код   | Когда               |
+| ----- | ------------------- |
+| <код> | <при чём бросается> |
+
+## Данные
+
+<Записи хранилища, которыми домен владеет. Нет своих — «не применимо».>
+
+## Экраны и состояния
+
+<Экраны домена и состояния каждого: пусто, загрузка, отказ, готово. Нет экранов — «не применимо».>
+
+## Сквозные требования
+
+### Локали
+
+<Что переводится и где лежат ключи.>
+
+### SEO
+
+<Заголовки, адреса, разметка. Не применимо — так и пишется.>
+
+### Мобильная раскладка
+
+<Что меняется на узком экране.>
+
+### Мультиобъектность
+
+<Что у домена своё на каждый объект владения.>
+
+## Решения
+
+- **<решение>** — <довод>. Отвергнуто: <альтернатива и почему>.
+
+## Открытые вопросы
+
+- `Q-<номер>` — <вопрос и допущение, с которым идёт работа>.
+
+## История изменений
+
+- <дата> — <что изменилось>.

package/assets/samples/tasks/_template/grill.md

@@ -0,0 +1,28 @@
+# Разбор просьбы
+
+## Просьба владельца
+
+> <дословно, без пересказа>
+
+## Что уже есть в дереве
+
+<Находки разведки: спеки по теме, законы и правила, которые работа задевает, готовый образец
+рядом. Заполняется до первого вопроса владельцу.>
+
+## Что уже сказано в правилах
+
+<Что нашлось в законах и правилах по теме вопроса. Владельцу не задаётся то, ответ на что уже
+записан.>
+
+## Вопросы и ответы
+
+**<вопрос>**
+<ответ владельца его словами>
+
+## Решения
+
+- **<решение>** — <довод>. Отвергнуто: <что и почему>.
+
+## Что осталось невыясненным
+
+- <вопрос, который не задавали, и почему он не блокирует работу>

package/assets/samples/tasks/_template/plan.md

@@ -0,0 +1,39 @@
+# Замысел
+
+**Задача:** <КЛЮЧ>-<номер> · **Ветка:** <ветка>
+**Драфт:** `<путь к договорённости о продукте>`
+**Поведение:** меняется
+
+Работа, не задевающая код приложения, договорённости не требует — тогда вместо строки драфта
+стоит `**Поведение:** не меняется — <причина владельца>`; пустая причина не принимается.
+
+После написания этот файл не правится. Пересмотр этапа идёт в `progress.md` решением по ходу.
+
+## След задачи
+
+<Что работа задевает. Заполняется разведкой до разбора и подтверждается владельцем. По этой же
+таблице на закрытии смотрят, что из спеков, правил и паттернов устарело: названное здесь
+читают дважды — до работы и после неё.>
+
+| Что     | Где                               |
+| ------- | --------------------------------- |
+| Спеки   | <домены, которых работа касается> |
+| Законы  | <законы по её следу>              |
+| Правила | <правила и их компаньоны>         |
+| Код     | <либы и приложения>               |
+
+## Что считается сделанным
+
+- <утверждение, которое можно проверить>
+
+## Этапы
+
+### 1. <название>
+
+- **Что делается:** <одной фразой>
+- **Признак готовности:** <что должно стать верным>
+- **Чем проверяется:** <команда или приём>
+
+## Чего эта работа не делает
+
+- <соседняя работа, которую сюда не тащим, и куда она заведена>

package/assets/samples/tasks/_template/progress.md

@@ -0,0 +1,23 @@
+# Ход работы
+
+## Где стоим
+
+Перезаписывается каждым заходом, а не дописывается.
+
+- **Этап:** <номер> из <всего> — <название>
+- **Сделано:** <коротко>
+- **Следующий шаг:** <что делается первым в новом заходе>
+- **Незакоммиченное:** <что лежит в дереве вне индекса>
+- **Ждём владельца:** <чего именно, или «нет»>
+- **PR:** <номер и состояние, или «ещё не открыт»>
+
+## Решения по ходу
+
+- **<решение>** — <довод>. Затронутый этап замысла: <номер>.
+
+## Заходы
+
+### <дата>
+
+- <что сделано, числами: файлов, коммитов, что зелёное>
+- <на чём споткнулись и чем поймали>