язык: сняты «провенанс» и «интейк», назван образец стиля

Оба слова стояли в закрытом словаре правила 6 с оговоркой, и обе оговорки
отвергали один русский вариант, а вывод из них делался про все. Отсюда общее
требование к записи словаря: она обязана говорить, чем слово незаменимо, а не
чем плох один из кандидатов. Латинизм, переживший проверку одним синонимом, —
не имя вещи, а непроверенная привычка.

Провенанс заменён двумя словами, потому что смысла было два, и это же его и
держало: происхождение у числа (чем и при каких условиях получено) и откуда у
вопроса и находки (кто нашёл, каким проходом, из какой записи журнала). Слово
стояло и в скелете docs/review.md, уезжающем в репозитории проектов, поэтому
раскладка повышена до версии 4 с записью журнала: правка формы вопроса и
проход grep по docs/.

Интейк заменён заведением с названным источником — «из диалога», «из ревью».
Оговорка защищала слово от голого «заведения» и в этом была права, но в паре с
источником двусмысленности нет, а скилл задач уже называет операцию так же.
Раскладку это не двигает: слово жило только в прозе плагина.

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

Журнал решений: темы 70 и 71, Р258–Р264 и С244–С249. Остальной словарь —
триаж, дедуп, чек-лист, дифф, промпт, чекпоинт, синк — не пересматривался, и
это сказано записью: пересмотр меняет язык всего корпуса и делается своей
работой, а не попутно.
This commit is contained in:
av
2026-08-13 19:43:08 +03:00
parent e78a4311a7
commit e5dc0a1a39
26 changed files with 279 additions and 62 deletions
@@ -105,7 +105,7 @@ git и читается диффом, а второй стоп на каждой
требующий кода, — это отдельная задача, и её нужно назвать, а не написать по
ходу. Исключение ровно одно и оно не про изменение системы: одноразовый
**читающий** прогон (запрос, замер, скрипт в песочнице), чей результат уезжает
в ответ с провенансом и который ничего не оставляет в репозитории.
в ответ с происхождением и который ничего не оставляет в репозитории.
- **Местом в списке.** Заведённая задача встаёт в конец своей секции; куда её
поставить, решает человек — на доработке грумингом (`av-dev:task-groom`), на
стройке сразу же, по зависимости. Разведка, сама ставящая свой исход первым,
@@ -145,7 +145,7 @@ git и читается диффом, а второй стоп на каждой
1. **ответ записан по адресу, который назвала задача** — раздел «Куда ляжет
ответ». Адреса не было, а вопрос был — ты назначил адрес сам и сказал об этом
строкой;
2. **у каждого числа провенанс** — команда или условия, которыми оно получено.
2. **у каждого числа названо происхождение** — команда или условия, которыми оно получено.
Число без источника проход ревью обязан читать как условие, а не как замер, и
разведка, оставившая голые числа, вредна: по ним будут решать;
3. **отвергнутые варианты названы с причиной**. Отвергнутое без причины
@@ -176,7 +176,7 @@ git и читается диффом, а второй стоп на каждой
| Что узнали | Дом ответа |
| --- | --- |
| наблюдение о внешнем мире, замер с провенансом | `docs/research/` |
| наблюдение о внешнем мире, замер с происхождением | `docs/research/` |
| решение с ценой: намеренный отказ, дорогой откат | `docs/adr/` |
| факт об устройстве системы | тема `architecture` (или своя тема проекта) |
| граница домена, «чем проект **не** является» | `passport` |
@@ -199,7 +199,7 @@ git и читается диффом, а второй стоп на каждой
2. **код и его история**`git log` по узлу отвечает на «почему так» чаще, чем
кажется;
3. **внешние источники** — документация формата, чужой опыт, спецификации;
4. **замер** — если вопрос про числа. Числа снимаются с провенансом, иначе они
4. **замер** — если вопрос про числа. Числа снимаются с происхождением, иначе они
бесполезны на следующем шаге.
**Скилл `opsx:explore`** — законный инструмент этого шага, если плагин в проекте
@@ -253,7 +253,7 @@ git и читается диффом, а второй стоп на каждой
### 4. Ответ в документы канона
**Вызови Skill `av-dev:doc-sync`**: он владеет содержимым документов канона.
Передай ему ответ, адрес из шага 1 и провенанс каждого числа — писать содержание
Передай ему ответ, адрес из шага 1 и происхождение каждого числа — писать содержание
за тебя он не будет, но дом и форму держит он. Вычитка языка — тоже его агент, но
момент её назван отдельно, шагом 6: пачка собирается из шагов 4 и 5 и до конца
пятого не полна.
@@ -316,7 +316,7 @@ flowchart TD
**Урожай — списком, не задачами.** Отложенные находки (реальный `major` не для
этого мерджа, развилка, решённая «потом», пачка `nit`) собери в секцию доклада
`Урожай`: формулировка, оракул, провенанс. Задачи из него **заводит не этот
`Урожай`: формулировка, оракул, откуда взялась. Задачи из него **заводит не этот
скилл** — их заводит `av-dev:task-track` своим сценарием «задачи из ревью и
аудита»: своя нарезка, свой формат, свои правила дублей. Твоя обязанность — не
потерять и передать.
@@ -401,7 +401,7 @@ change. Заводить запись задним числом, чтобы её
- ссылка на архивный change и хеш коммита;
- по каждому критерию приёмки, если они были: **оракул и наблюдаемый исход**
это доклад приёмщику, а не отметка «принято»;
- **`Урожай`** — отложенные находки списком (формулировка, оракул, провенанс);
- **`Урожай`** — отложенные находки списком (формулировка, оракул, откуда взялась);
- **одна строка границ покрытия**: какая метка и режим гонялись, какие проходы не
запускались и что проверить было невозможно. Доклад без неё сообщает
«проверено», не сообщая, что именно.