язык: сняты «провенанс» и «интейк», назван образец стиля
Оба слова стояли в закрытом словаре правила 6 с оговоркой, и обе оговорки отвергали один русский вариант, а вывод из них делался про все. Отсюда общее требование к записи словаря: она обязана говорить, чем слово незаменимо, а не чем плох один из кандидатов. Латинизм, переживший проверку одним синонимом, — не имя вещи, а непроверенная привычка. Провенанс заменён двумя словами, потому что смысла было два, и это же его и держало: происхождение у числа (чем и при каких условиях получено) и откуда у вопроса и находки (кто нашёл, каким проходом, из какой записи журнала). Слово стояло и в скелете docs/review.md, уезжающем в репозитории проектов, поэтому раскладка повышена до версии 4 с записью журнала: правка формы вопроса и проход grep по docs/. Интейк заменён заведением с названным источником — «из диалога», «из ревью». Оговорка защищала слово от голого «заведения» и в этом была права, но в паре с источником двусмысленности нет, а скилл задач уже называет операцию так же. Раскладку это не двигает: слово жило только в прозе плагина. Образец стиля назван прямо и отдельным разделом: научно-популярная книга, не спецификация и не конспект для себя. Три умолчания — воды нет, сложных конструкций нет, англицизм исключение с причиной. Находок образец не порождает: он для того, кто пишет, а вычитка судит по правилам, иначе «звучит сложно» стало бы находкой и порог правки перестал бы работать. Журнал решений: темы 70 и 71, Р258–Р264 и С244–С249. Остальной словарь — триаж, дедуп, чек-лист, дифф, промпт, чекпоинт, синк — не пересматривался, и это сказано записью: пересмотр меняет язык всего корпуса и делается своей работой, а не попутно.
This commit is contained in:
@@ -114,7 +114,7 @@ color: green
|
||||
судит ревью, а не сверка.
|
||||
|
||||
**Согласованность документов между собой** — у `doc-consistency`: факт в двух
|
||||
домах, противоречие между документами, поведение в обзоре, ADR и провенанс.
|
||||
домах, противоречие между документами, поведение в обзоре, ADR и происхождение чисел.
|
||||
Увидел — строкой в границы покрытия, находкой не оформляй.
|
||||
|
||||
**Язык документов** — у `doc-wording`, **язык записей задач** — у
|
||||
|
||||
@@ -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 и происхождение чисел → пустые слоты. Первые ломают решения,
|
||||
которые по документам принимают; последние — только цену чтения.
|
||||
|
||||
```
|
||||
|
||||
@@ -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`. Увидел — назови в конце одной строкой, чтобы находка не
|
||||
пропала, но находкой не оформляй.
|
||||
|
||||
@@ -177,7 +177,7 @@ severity:
|
||||
любой метке и `review-basics`, когда запускается. Пришёл хоть от одного — веди
|
||||
его в сводку отдельной строкой, а не в общий список находок: метку выбирал
|
||||
`review-scope`, а не они и не ты, значит сигнал независим. Пришли оба — это одна
|
||||
строка с двумя провенансами, а не два пункта: согласие проходов приоритет
|
||||
строка с двумя названными проходами, а не два пункта: согласие проходов приоритет
|
||||
повышает, `confidence` нет.
|
||||
|
||||
**Сигнала нет — тоже скажи строкой.** «Корректор метки отработал, возражений
|
||||
|
||||
@@ -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, и трогать его нельзя. Разница проверяется вопросом
|
||||
«изменится ли число само, без правки текста».
|
||||
|
||||
Reference in New Issue
Block a user