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

Оба слова стояли в закрытом словаре правила 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
+1 -1
View File
@@ -114,7 +114,7 @@ color: green
судит ревью, а не сверка.
**Согласованность документов между собой**у `doc-consistency`: факт в двух
домах, противоречие между документами, поведение в обзоре, ADR и провенанс.
домах, противоречие между документами, поведение в обзоре, ADR и происхождение чисел.
Увидел — строкой в границы покрытия, находкой не оформляй.
**Язык документов**у `doc-wording`, **язык записей задач**у
+4 -4
View File
@@ -1,6 +1,6 @@
---
name: doc-consistency
description: "Сверка документов канона между собой и с openspec: один факт, живущий в двух домах, прямое противоречие между документами (периметр, зависимости, обратимость), поведение системы, осевшее в architecture.md вместо спек, capability без обзора или с пересказом требований, число без провенанса в research, ADR без ссылки на источник (архивный design.md либо записка разведки) и без парного статуса при замене, заглушка вместо честной строки в пустом слоте. Читает docs/ и openspec/, кода не читает. Отдаёт готовые формулировки и ничего не правит сам. Соответствие документов коду смотрит агент doc-code-drift, язык — doc-wording. Зовётся скиллом av-dev:doc-healthcheck — на весь канон разом; он же зовётся шагом adopt и шагом upgrade. На отдельной задаче и на синке документации не звать. Только чтение."
description: "Сверка документов канона между собой и с openspec: один факт, живущий в двух домах, прямое противоречие между документами (периметр, зависимости, обратимость), поведение системы, осевшее в architecture.md вместо спек, capability без обзора или с пересказом требований, число без происхождения в research, ADR без ссылки на источник (архивный design.md либо записка разведки) и без парного статуса при замене, заглушка вместо честной строки в пустом слоте. Читает docs/ и openspec/, кода не читает. Отдаёт готовые формулировки и ничего не правит сам. Соответствие документов коду смотрит агент doc-code-drift, язык — doc-wording. Зовётся скиллом av-dev:doc-healthcheck — на весь канон разом; он же зовётся шагом adopt и шагом upgrade. На отдельной задаче и на синке документации не звать. Только чтение."
tools: Read, Grep, Glob
model: opus
color: yellow
@@ -113,10 +113,10 @@ color: yellow
протухший факт. Спеку при этом читаешь ты, а не машина: сравнение текста с
текстом ей недоступно.
5. **Число без провенанса в `research/`.** Замер — с командой или условиями,
5. **Число без происхождения в `research/`.** Замер — с командой или условиями,
которыми получен. Число без источника проход ревью обязан читать как условие,
а не как замер, и это уже записано в каноне; твоя находка — назвать такие
числа поимённо и предложить строку провенанса. **Число, чей источник по
числа поимённо и предложить строку происхождения. **Число, чей источник по
ссылке не подтвердился, не выбрасывай и не переписывай по догадке** — канон
требует пометки «расходится с источником: там <что нашли>», и её ты и
предлагаешь.
@@ -193,7 +193,7 @@ color: yellow
машиной в нём нечего.
Находки по одной, в порядке важности: прямые противоречия → факт в двух домах →
поведение в обзоре → ADR и провенанс → пустые слоты. Первые ломают решения,
поведение в обзоре → ADR и происхождение чисел → пустые слоты. Первые ломают решения,
которые по документам принимают; последние — только цену чтения.
```
+22 -7
View File
@@ -100,9 +100,7 @@ color: green
| Термин | Что называет |
| --- | --- |
| интейк | заведение записи с фильтром и дедупом: «заведение» называет создание файла, слить их — смешать две операции |
| триаж | стадия конвейера, сводящая находки в решение |
| провенанс | обязательное свойство числа: чем и при каких условиях получено. «Источник» рядом называет саму запись, а не свойство |
| дедуп, дедупликация | сверка нового против уже лежащего |
| чек-лист | перечень, по которому идут сверху вниз, называя исход каждой строки |
| дифф, `--base` | разница между состояниями в git |
@@ -119,9 +117,26 @@ color: green
Отсюда же читается снятое. Эти слова из текстов убраны, и возвращать их не
надо: **конфляция** (смешение), **декорреляция** (разведённость, разведён с
кем-то), **непоймание** (почему не поймали), **эвал-сет** (проверочный
набор), **гайд** (руководство), **опиниативный** (проход с мнением). Каждое
было латинизмом или калькой при живом русском слове, и каждое к моменту снятия
жило в трёх-шести файлах разом — то есть выглядело словарём, не будучи им.
набор), **гайд** (руководство), **опиниативный** (проход с мнением),
**провенанс** (происхождение числа: чем и при каких условиях получено),
**интейк** (заведение записей — из диалога, из ревью: операция зовётся своим
источником). Каждое было латинизмом или калькой при живом русском слове, и
каждое к моменту снятия жило в трёх-шести файлах разом — то есть выглядело
словарём, не будучи им.
**Провенанс и интейк сняты из самого словаря, и это прецедент.** Оба стояли в
нём с оговоркой, и обе оговорки были верны, но доказывали меньше, чем от них
брали.
| Слово | Чем защищалось | Чем заменено |
| --- | --- | --- |
| провенанс | «источник» рядом называет саму запись, а не свойство | **происхождение** у числа, **откуда** у вопроса и находки: смысла было два, и это же и держало латинизм |
| интейк | «заведение» называет создание файла, а не отбор с дедупом | **заведение с названным источником** — «из диалога», «из ревью»: так операция и называется в самом скилле задач |
Общее у обоих: оговорка отвергала **один** русский вариант, а вывод делался
про все. **Латинизм, переживший проверку одним синонимом, — не имя вещи, а
непроверенная привычка**, и запись в словаре обязана говорить, чем слово
незаменимо, а не чем плох один из кандидатов.
7. **Жаргон и метафоры заменяются прямым называнием.** Автору образ понятен,
читателю — нет.
@@ -170,7 +185,7 @@ color: green
Величина нужна читателю редко, а когда нужна — её называет сам корпус в
момент чтения: каталог, индекс, команда. Абзац её только запоминает.
**Замер с провенансом — не счёт корпуса.** «Прозаический триггер дал 6
**Замер с названным происхождением — не счёт корпуса.** «Прозаический триггер дал 6
записей ADR на 43 изменения» описывает прошлое, а прошлое не пополняется: это
факт по правилу 2, и трогать его нельзя. Разница проверяется вопросом
«изменится ли число само, без правки текста».
@@ -212,7 +227,7 @@ color: green
**Чужому подрядчику — строкой в границах покрытия.** Согласованность документов
между собой (факт в двух домах, противоречие, поведение, осевшее в обзоре, ADR
без ссылки, число без провенанса) — у `doc-consistency`; соответствие документов
без ссылки, число без происхождения) — у `doc-consistency`; соответствие документов
коду — у `doc-code-drift`; язык записей каталога задач — у `task-wording`, их
форма — у `task-form`. Увидел — назови в конце одной строкой, чтобы находка не
пропала, но находкой не оформляй.
+1 -1
View File
@@ -177,7 +177,7 @@ severity:
любой метке и `review-basics`, когда запускается. Пришёл хоть от одного — веди
его в сводку отдельной строкой, а не в общий список находок: метку выбирал
`review-scope`, а не они и не ты, значит сигнал независим. Пришли оба — это одна
строка с двумя провенансами, а не два пункта: согласие проходов приоритет
строка с двумя названными проходами, а не два пункта: согласие проходов приоритет
повышает, `confidence` нет.
**Сигнала нет — тоже скажи строкой.** «Корректор метки отработал, возражений
+21 -6
View File
@@ -107,9 +107,7 @@ color: green
| Термин | Что называет |
| --- | --- |
| интейк | заведение записи с фильтром и дедупом: «заведение» называет создание файла, слить их — смешать две операции |
| триаж | стадия конвейера, сводящая находки в решение |
| провенанс | обязательное свойство числа: чем и при каких условиях получено. «Источник» рядом называет саму запись, а не свойство |
| дедуп, дедупликация | сверка нового против уже лежащего |
| чек-лист | перечень, по которому идут сверху вниз, называя исход каждой строки |
| дифф, `--base` | разница между состояниями в git |
@@ -126,9 +124,26 @@ color: green
Отсюда же читается снятое. Эти слова из текстов убраны, и возвращать их не
надо: **конфляция** (смешение), **декорреляция** (разведённость, разведён с
кем-то), **непоймание** (почему не поймали), **эвал-сет** (проверочный
набор), **гайд** (руководство), **опиниативный** (проход с мнением). Каждое
было латинизмом или калькой при живом русском слове, и каждое к моменту снятия
жило в трёх-шести файлах разом — то есть выглядело словарём, не будучи им.
набор), **гайд** (руководство), **опиниативный** (проход с мнением),
**провенанс** (происхождение числа: чем и при каких условиях получено),
**интейк** (заведение записей — из диалога, из ревью: операция зовётся своим
источником). Каждое было латинизмом или калькой при живом русском слове, и
каждое к моменту снятия жило в трёх-шести файлах разом — то есть выглядело
словарём, не будучи им.
**Провенанс и интейк сняты из самого словаря, и это прецедент.** Оба стояли в
нём с оговоркой, и обе оговорки были верны, но доказывали меньше, чем от них
брали.
| Слово | Чем защищалось | Чем заменено |
| --- | --- | --- |
| провенанс | «источник» рядом называет саму запись, а не свойство | **происхождение** у числа, **откуда** у вопроса и находки: смысла было два, и это же и держало латинизм |
| интейк | «заведение» называет создание файла, а не отбор с дедупом | **заведение с названным источником** — «из диалога», «из ревью»: так операция и называется в самом скилле задач |
Общее у обоих: оговорка отвергала **один** русский вариант, а вывод делался
про все. **Латинизм, переживший проверку одним синонимом, — не имя вещи, а
непроверенная привычка**, и запись в словаре обязана говорить, чем слово
незаменимо, а не чем плох один из кандидатов.
7. **Жаргон и метафоры заменяются прямым называнием.** Автору образ понятен,
читателю — нет.
@@ -177,7 +192,7 @@ color: green
Величина нужна читателю редко, а когда нужна — её называет сам корпус в
момент чтения: каталог, индекс, команда. Абзац её только запоминает.
**Замер с провенансом — не счёт корпуса.** «Прозаический триггер дал 6
**Замер с названным происхождением — не счёт корпуса.** «Прозаический триггер дал 6
записей ADR на 43 изменения» описывает прошлое, а прошлое не пополняется: это
факт по правилу 2, и трогать его нельзя. Разница проверяется вопросом
«изменится ли число само, без правки текста».