задачи: починена смена стадии, разобраны находки ревью плагина

Команда stage была дефектна по шести пунктам, и все шесть подтверждены
прогоном: не звала raw_last (переход оставлял каталог красным), не
переписывала шапку беклога (индекс продолжал объявлять прежнюю стадию),
шла в обход write_config, молча пропускала файлы с непересобираемой метой,
ломалась на беклоге без заголовков и схлопывала полки при первом
объявлении стадии.

Объявление и смена разведены: объявление беклога не трогает вовсе, смена
трогает состав секций только по явному --sections, а слить полки скрипт
не берётся ни в одном случае. Абзац шапки размечен парой «стадия», и
расхождение с конфигом стало обычным дрейфом.

Отказ по недостающей строке индекса запирал запись, пережившую упразднение
роадмапа: edit, close и reopen теперь заводят или пропускают строку сами.
Прочее: регистр stage нормализуется при чтении; --fix снимает мёртвые теги
и у неразобранных записей; move отказывает переставлять сырьё; adopt
держит место сырья; docs.py bump двигает одну запись журнала за раз;
tasks.py получил перечень упразднённых адресов, и гейт наконец видит
собственное упразднение ROADMAP.md.

Запись «Версия 3» переписана по прогону на игрушечном проекте: прежний
порядок шагов был неисполним. Закрыты дыры модели стадий (пересмотр плана
стройки стал сценарием, приёмка отвязана от груминга, from-review,
research и adopt получили развилку по стадии, перечень осей пересчитан) и
находки, старшие этой сессии: review-triage получил режим без метки, три
списка проектных копий сведены к дому с проверяемыми копиями, пять
пересказов правил стали помеченными копиями или ссылками, language.md
перестал объявлять юрисдикцию над чужим плагином.
This commit is contained in:
av
2026-08-13 15:08:29 +03:00
parent 8d8c1656e5
commit ed83ec7dc0
28 changed files with 678 additions and 259 deletions
+14 -2
View File
@@ -38,7 +38,10 @@
| --- | --- | --- |
| стадия проекта | что значит порядок строк беклога: зависимость или важность | `task-track/SKILL.md`, «Две стадии» |
| стадия проекта | сколько у беклога секций, как его пополняют, применим ли груминг | там же и `task-groom/SKILL.md`, «Груминг — операция доработки» |
| стадия проекта | метку, глубину и тип**не влияет, и это записано явно** | `task-track/SKILL.md`, «Тип записи» |
| стадия проекта | метку и глубину — **не влияет, и это записано явно** | `task-track/SKILL.md`, «Тип записи» |
| стадия проекта | тип записи — **не влияет, и это записано явно** | `task-track/SKILL.md`, «Две стадии» |
| стадия проекта | как серьёзность находки ложится в список | `task-track/references/from-review.md` |
| стадия проекта | где сценарии кладут свой исход и чем закрывают переходное состояние | `code-resolve/references/research.md`, `task-track/references/adopt.md` |
| тип записи | сценарий — **предлагает**, подтверждает предмет работы | `task-track/SKILL.md`, «Тип записи» |
| тип записи | метку и глубину — **не влияет, и это записано явно** | там же |
| сценарий | режим прогона: обслуживание идёт без метки | `code-resolve/references/maintain.md` |
@@ -48,7 +51,7 @@
| категория документа | заводит ли документ направление проверки | `canon.md`, «Три категории» |
| severity | что с находкой делают дальше | `code-review/SKILL.md`, «Что происходит с находками» |
**Три клетки пусты, и это сказано намеренно, а не забыто.**
**Пять клеток пусты, и это сказано намеренно, а не забыто.**
**Категория документа × режим прогона.** На прогоне **с меткой** своя тема
проекта закрыта при любом значении: `review-basics` — приёмник проектных тем и
@@ -62,6 +65,15 @@
неё не входит. Заманчивая мысль «на стройке всё `small`, потому что приложения
ещё нет» разбивается о первый же шаг, кладущий схему хранилища.
**Стадия проекта × режим прогона и × стадия ревью.** Не влияет ни на одну:
режим выбирает сценарий, стадию ревью — наличие дизайна. Прогон обслуживания на
стройке — обычное дело (первые шаги плана заводят гейт и сборку), и идёт он там
так же, как на доработке.
**Стадия проекта × категория документа и × коды выхода.** Не влияет: категория —
свойство документа, коды — общий словарь скриптов. Названо потому, что перечень
объявлен полным, и клетка без ответа читается как забытая.
**Режим прогона × severity.** Триаж обязателен всегда, в том числе без метки. Но
часть оснований `critical` — построенный путь к отказу, замер — добывается
проходами, которые без метки не запускаются. Значит ли это, что `critical` на
+14 -5
View File
@@ -21,9 +21,18 @@
проверяет вовсе, — а вложенных блоков разметка не знает, и внутри `язык-правила`
его было бы не забрать отдельно.
Правила — для всего, что пишется словами: задачи и цели, документы канона,
решения ADR, записки разведки, сообщения коммитов. Не для кода и не для
сообщений программы пользователю — там свои конвенции проекта.
Правила — для всего, что пишется словами **в этом плагине**: задачи, документы
канона, решения ADR, записки разведки. Не для кода и не для сообщений программы
пользователю — там свои конвенции проекта.
**Сообщения коммитов сюда не входят, и это названо намеренно.** Их форму держит
отдельный плагин `av-dev-git`, скилл `commit`, и она с этими правилами
расходится по существу: там предписан результат страдательным залогом
(«добавлены», «обновлено»), здесь — действие активным. Расхождение осознанное:
строка коммита отвечает на «что стало», а не на «что я сделал», и читают её в
`git log` подряд сотнями. Объявлять юрисдикцию над чужим плагином, до которого
отсюда нет и ссылки, значило бы завести правило, нарушение которого никто не
увидит.
Основа — **информационный стиль** Максима Ильяхова ([учебник
бюро](https://bureau.ru/projects/book-text/), книга «Пиши, сокращай»). Он
@@ -228,8 +237,8 @@
## Доклад вычитки
Не правило языка, а **контракт прохода**: форма, в которой находка приходит к
человеку. Живёт здесь потому, что проходов вычитки несколько — по одному на
плагин, — и разойтись формой они не должны.
человеку. Живёт здесь потому, что проходов вычитки два — `doc-wording` по документам и
`task-wording` по записям задач, — и разойтись формой они не должны.
<!-- дом: вычитка-доклад -->