старший долг: развилка тремя основаниями, вопросы тем, версия раскладки 5
Третий заход по находкам ревью — то, что старше темы 78 и тянулось с тем 74–77. Оснований у развилки три во всех местах: конвейер называл два, а устав триажа, контракт находок, сценарий решения и журнал — три. Там же сказано, чем третье отличается: по первым двум оркестратор урезает изменение до остатка, третье отменяет одобрение и возвращает на чекпоинт. Вопросы проекта по темам достались проходам, которые эти темы закрывают: review-code, review-specs и review-autotests получили обязанность отвечать дословно и строку в блоке покрытия. Прежде конвейер обещал их каждому проходу, а знал о них только приёмник тем. Глубокое ревью приведено к уставам, которые зовёт: глубина у проходов разная — доказательство у тех двоих, что держат машину, разбор у architecture и code; у триажа три вызывающих, а не два режима, и потолка в 7 пунктов там нет. Версия раскладки поднята до 5 с записью журнала: скелет docs/review.md потерял подраздел «Триггеры метки» ещё темой 77, а миграции проектам никто не дал. Сняты остатки меток в task-track и в config-skeleton, уезжающем в чужой проект. Перечень осей досчитал три оси: глубина темы, разметка действия, род правки. Журнал — тема 81.
This commit is contained in:
@@ -340,7 +340,12 @@ kebab-case.** Причина не эстетическая: имя файла с
|
||||
проекте нет дома, сюда не пишется: её и так называет план каждого прогона.
|
||||
|
||||
**Журнал дефектов:** запись на каждый воспроизведённый дефект с пометкой
|
||||
**проскочил / пойман ревью**. Проскочившие — проверочный набор для калибровки конвейера,
|
||||
**проскочил / пойман ревью**. Запись — новое, и заводится она по слову человека
|
||||
(`av-dev:doc-sync`, «Два рода правок»): «на каждый» задаёт **обязанность
|
||||
предложить**, а не право записать молча. Человек отказал — записи нет, и
|
||||
калибровка конвейера по этому дефекту не состоится; это его решение и его цена.
|
||||
|
||||
Проскочившие — проверочный набор для калибровки конвейера,
|
||||
выборка по пометке. Пойманные с оракулом — лучшая опора для прохода: проектные,
|
||||
воспроизводимые, однажды оказавшиеся правдой.
|
||||
|
||||
|
||||
@@ -22,6 +22,44 @@
|
||||
|
||||
---
|
||||
|
||||
## Версия 5 — 2026-08-23
|
||||
|
||||
**Метка задачи снята из процесса целиком**, и вместе с ней — подраздел «Триггеры
|
||||
метки» в `docs/review.md`. Состав прогона ревью стал постоянным: он один и тот же
|
||||
на всякой задаче, выбирать нечего, и признаки, по которым метка поднималась,
|
||||
перестали что-либо решать. На месте подраздела — **«Когда звать глубокое ревью»**:
|
||||
те же наблюдения проекта, но адресованные другому решению — звать ли
|
||||
`av-dev:code-deep-review` по области кода.
|
||||
|
||||
**Что переехало в проекте.** Скелет `docs/review.md`, раздел настройки конвейера:
|
||||
подраздел «Триггеры метки» заменён подразделом «Когда звать глубокое ревью» —
|
||||
**двумя списками**: области, которые смотрят целиком (узлы с частым возвратом,
|
||||
места с историей инцидентов, код под дорогое решение), и **необратимое здесь** —
|
||||
что в этом проекте после мерджа не откатывается обратной правкой. Второй список
|
||||
работает и в цикле задачи: находка в таком месте уходит человеку развилкой, а не
|
||||
чинится молча. Само правило — в [canon.md](canon.md), раздел `review.md`.
|
||||
|
||||
**Что сделать проекту.**
|
||||
|
||||
1. **Переписать подраздел в `docs/review.md`.** Заголовок «Триггеры метки»
|
||||
становится «Когда звать глубокое ревью», содержимое — два списка выше.
|
||||
Признаки, годные только для выбора метки («больше N файлов», «затронуто больше
|
||||
одного слоя»), выбрасываются: состава прогона они не меняют. Что из прежнего
|
||||
списка называло **необратимое место** — переносится во второй список дословно.
|
||||
2. **Пройти по документам** — `grep -rniE "small|medium|large|метк" docs/`.
|
||||
Найденное в `review.md`, `conventions/` и `adr/` правится по смыслу: описание
|
||||
прошлого решения остаётся как свидетельство, действующая инструкция —
|
||||
переписывается или снимается.
|
||||
3. **Поднять версию** — `docs.py bump`, последним шагом.
|
||||
4. `docs.py check` — до отсутствия дрейфа.
|
||||
|
||||
**Чего делать не надо.** Заводить ключ `[docs] healthcheck_last` руками: он
|
||||
необязательный и появится сам первым прогоном `av-dev:doc-healthcheck`. Править
|
||||
прошлые записи журналов и архивные change — тоже: метка, стоявшая в них, верна
|
||||
как свидетельство о том дне.
|
||||
|
||||
---
|
||||
|
||||
## Версия 4 — 2026-08-13
|
||||
|
||||
Слово **провенанс** снято из словаря языка проектных текстов и заменено русским.
|
||||
|
||||
Reference in New Issue
Block a user