язык: сняты «провенанс» и «интейк», назван образец стиля
Оба слова стояли в закрытом словаре правила 6 с оговоркой, и обе оговорки отвергали один русский вариант, а вывод из них делался про все. Отсюда общее требование к записи словаря: она обязана говорить, чем слово незаменимо, а не чем плох один из кандидатов. Латинизм, переживший проверку одним синонимом, — не имя вещи, а непроверенная привычка. Провенанс заменён двумя словами, потому что смысла было два, и это же его и держало: происхождение у числа (чем и при каких условиях получено) и откуда у вопроса и находки (кто нашёл, каким проходом, из какой записи журнала). Слово стояло и в скелете docs/review.md, уезжающем в репозитории проектов, поэтому раскладка повышена до версии 4 с записью журнала: правка формы вопроса и проход grep по docs/. Интейк заменён заведением с названным источником — «из диалога», «из ревью». Оговорка защищала слово от голого «заведения» и в этом была права, но в паре с источником двусмысленности нет, а скилл задач уже называет операцию так же. Раскладку это не двигает: слово жило только в прозе плагина. Образец стиля назван прямо и отдельным разделом: научно-популярная книга, не спецификация и не конспект для себя. Три умолчания — воды нет, сложных конструкций нет, англицизм исключение с причиной. Находок образец не порождает: он для того, кто пишет, а вычитка судит по правилам, иначе «звучит сложно» стало бы находкой и порог правки перестал бы работать. Журнал решений: темы 70 и 71, Р258–Р264 и С244–С249. Остальной словарь — триаж, дедуп, чек-лист, дифф, промпт, чекпоинт, синк — не пересматривался, и это сказано записью: пересмотр меняет язык всего корпуса и делается своей работой, а не попутно.
This commit is contained in:
@@ -108,7 +108,7 @@ capability: незаполненный канон это переходное с
|
||||
|
||||
| Агент | Что смотрит | Читает |
|
||||
| --- | --- | --- |
|
||||
| `doc-consistency` | смысловой дубль, прямое противоречие между документами, поведение в `architecture.md` вместо спек, ADR без ссылки и парного статуса, число без провенанса, заглушка вместо честной строки | `docs/`, `openspec/` |
|
||||
| `doc-consistency` | смысловой дубль, прямое противоречие между документами, поведение в `architecture.md` вместо спек, ADR без ссылки и парного статуса, число без происхождения, заглушка вместо честной строки | `docs/`, `openspec/` |
|
||||
| `doc-code-drift` | протухший факт: имя ветки, команды, пути, зависимости поимённо, настройки с числом, единые точки проекта, capability | весь репозиторий |
|
||||
|
||||
Судит **не тот, кто писал**: самопроверка документа слабее всего ровно там, где
|
||||
|
||||
@@ -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` упразднены; у проекта появилась
|
||||
|
||||
@@ -283,7 +283,7 @@
|
||||
|
||||
### Вопросы по темам
|
||||
|
||||
Форма: `<тема>: <вопрос> (<провенанс>)`. Главный источник — журнал ниже. Вопрос
|
||||
Форма: `<тема>: <вопрос> (<откуда>)`. Главный источник — журнал ниже. Вопрос
|
||||
задаёт тот проход, который закрывает эту тему на текущем прогоне, дополнительно
|
||||
к обязательным.
|
||||
|
||||
|
||||
Reference in New Issue
Block a user