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

Оба слова стояли в закрытом словаре правила 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
@@ -108,7 +108,7 @@ capability: незаполненный канон это переходное с
| Агент | Что смотрит | Читает |
| --- | --- | --- |
| `doc-consistency` | смысловой дубль, прямое противоречие между документами, поведение в `architecture.md` вместо спек, ADR без ссылки и парного статуса, число без провенанса, заглушка вместо честной строки | `docs/`, `openspec/` |
| `doc-consistency` | смысловой дубль, прямое противоречие между документами, поведение в `architecture.md` вместо спек, ADR без ссылки и парного статуса, число без происхождения, заглушка вместо честной строки | `docs/`, `openspec/` |
| `doc-code-drift` | протухший факт: имя ветки, команды, пути, зависимости поимённо, настройки с числом, единые точки проекта, capability | весь репозиторий |
Судит **не тот, кто писал**: самопроверка документа слабее всего ровно там, где
+4 -4
View File
@@ -53,7 +53,7 @@ docs/
database.md | database/ схема хранилища; представление данных и настройки
security.md | security/ периметр; недоверенный вход; что вне модели
conventions.md | conventions/ как пишем код; что механизировано
research.md | research/ наблюдения и числа с провенансом
research.md | research/ наблюдения и числа с происхождением
adr.md | adr/ почему решено так; статусы, правило замены
review.md | review/ настройка конвейера под проект + журнал дефектов
<своя тема>.md | <своя тема>/ всё, что проект счёл нужным проверять
@@ -127,7 +127,7 @@ openspec/
**Процессный документ — не документ второго сорта.** `adr/` и `research/`
проверяются наравне с остальными, но **сверкой документации**, а не прогоном
ревью: ADR без ссылки на источник, замена без парного статуса, число
без провенанса — это работа агентов `doc-consistency` и `doc-code-drift`, и она
без происхождения — это работа агентов `doc-consistency` и `doc-code-drift`, и она
осталась там же, где была. Изменилось одно: прогон ревью не открывает их как
критерий и не судит по ним изменение.
@@ -267,7 +267,7 @@ kebab-case.** Причина не эстетическая: имя файла с
Наблюдения за внешним миром: что реально шлёт источник, чем документация формата
расходится с практикой, какие числа сняты с живого потока. **Числа — с
провенансом**, то есть с командой или условиями, которыми получены.
происхождением**, то есть с командой или условиями, которыми получены.
`README.md` — как снималось и индекс тем.
Число без источника проход обязан читать как условие, а не как замер. Число, чей
@@ -318,7 +318,7 @@ kebab-case.** Причина не эстетическая: имя файла с
- **Типовые узлы** — рода узлов проекта и 3–5 проверяемых свойств к каждому;
- **Типовые ложноположительные** — находки, которые здесь выглядят убедительно и
всегда неверны, каждая со строкой «почему здесь это не дефект»;
- **Вопросы по темам** — в форме `<тема>: <вопрос> (<провенанс>)`. **Не по именам
- **Вопросы по темам** — в форме `<тема>: <вопрос> (<откуда>)`. **Не по именам
проходов**: проход уезжает между метками, а тема остаётся, и вопрос,
адресованный проходу, перестал бы задаваться молча в тот день, когда тот уехал
в старшую метку. Задаёт вопрос тот, кто закрывает тему на этом прогоне.
@@ -22,6 +22,37 @@
---
## Версия 4 — 2026-08-13
Слово **провенанс** снято из словаря языка проектных текстов и заменено русским.
Оно стояло в закрытом списке своих терминов с оговоркой «„источник“ рядом
называет саму запись, а не свойство» — верной, но доказывающей лишь то, что не
годится одно русское слово. Годятся два, и по смыслу они разные: **происхождение**
у числа (чем и при каких условиях получено) и **откуда** у вопроса или находки
(кто нашёл, каким проходом, из какой записи журнала).
**Что переехало в проекте.** Скелет `docs/review.md`, подраздел «Вопросы по
темам»: форма вопроса записана как `<тема>: <вопрос> (<откуда>)` вместо
`(<провенанс>)`. Само правило — в [canon.md](canon.md), раздел `review.*`;
требование к числам `research/` не изменилось по существу, изменилось слово.
**Что сделать проекту.**
1. **Поправить форму в `docs/review.md`** — строка «Форма: `<тема>: <вопрос>
(<провенанс>)`» становится «Форма: `<тема>: <вопрос> (<откуда>)`». Уже
записанные вопросы переписывать не надо: слово стояло в шаблоне, а не в них.
2. **Пройти по документам** — `grep -rn "провенанс" docs/`. Найденное в
`research/` и в `adr/` заменяется на **происхождение** (речь о числе) или на
**откуда** (речь о том, из чего вопрос или находка выросли). Ничего не
нашлось — шаг закрыт строкой, это обычный исход.
3. **Поднять версию** — `docs.py bump`, последним шагом.
4. `docs.py check` — до отсутствия дрейфа.
**Чего делать не надо.** Править прошлые записи журналов и архивные change:
слово, верное на день записи, остаётся верным как свидетельство.
---
## Версия 3 — 2026-08-13
Тип записи `goal` и индекс `ROADMAP.md` упразднены; у проекта появилась
+1 -1
View File
@@ -283,7 +283,7 @@
### Вопросы по темам
Форма: `<тема>: <вопрос> (<провенанс>)`. Главный источник — журнал ниже. Вопрос
Форма: `<тема>: <вопрос> (<откуда>)`. Главный источник — журнал ниже. Вопрос
задаёт тот проход, который закрывает эту тему на текущем прогоне, дополнительно
к обязательным.