Compare commits
5
Commits
| Author | SHA1 | Date | |
|---|---|---|---|
 av
|
e5dc0a1a39
|
||
|
av
|
e78a4311a7
|
||
|
av
|
dd7aa22d02
|
||
|
av
|
77cb967d7b
|
||
|
av
|
94fa66b262
|
@@ -69,6 +69,12 @@
|
||||
сценария три, и выбирает сценарий сам скилл, прочитав постановку:**
|
||||
классифицировать задачу до вызова человек всё равно не может — «есть ли
|
||||
очевидный способ решения» и «меняется ли спека» видно после чтения записи.
|
||||
**Форм постановки две, и обе полноправны:** запись каталога и просто текст,
|
||||
переданный вызовом, — так же берёт постановку `opsx:propose`. Текстом идут все
|
||||
три сценария; отпадают ровно те шаги, у которых пропал предмет: `ready` гонять
|
||||
нечего, закрывать нечего, а тип, границы и понимание постановки называются
|
||||
вслух первой репликой — человек, написавший текст, рядом и правит одной фразой.
|
||||
Записи в каталог скилл при этом не заводит ни до работы, ни задним числом.
|
||||
**Решение** идёт циклом SDD с чекпоинтом после ревью дизайна: объяснение
|
||||
человеческим языком, повод скорректировать ход.
|
||||
**Обслуживание** (тип `chore`: тулчейн и сборка, зависимости, гит-хуки,
|
||||
@@ -102,7 +108,7 @@
|
||||
дизайна (`small` — только сверка спек; `medium` — плюс рубрика; `large` — плюс
|
||||
архитектурный проход) и кода (`small` — гейт, спеки, код, триаж; `medium` —
|
||||
плюс приёмник тем; `large` — плюс доказательство: запуск, замер, построенный
|
||||
путь, 5–10% задач). Десять агентов-проходов.
|
||||
путь, 5–10% задач). Каждый проход — свой агент, перечень держит сам скилл.
|
||||
|
||||
### av-dev-git
|
||||
|
||||
@@ -115,10 +121,10 @@
|
||||
|
||||
```mermaid
|
||||
flowchart TB
|
||||
subgraph avdev["av-dev — один плагин, девять скиллов"]
|
||||
subgraph avdev["av-dev — один плагин, весь процесс"]
|
||||
subgraph pipe["работа по задачам; сценарий решения требует OpenSpec"]
|
||||
direction LR
|
||||
tp["code-resolve<br/>3 сценария: разведка,<br/>решение, обслуживание"] --> rp["code-review<br/>10 агентов-проходов"]
|
||||
tp["code-resolve<br/>3 сценария: разведка,<br/>решение, обслуживание"] --> rp["code-review<br/>агенты-проходы"]
|
||||
osp["code-openspec<br/>заводит и проверяет openspec/"]
|
||||
end
|
||||
canon["canon<br/>форма раскладки всего проекта"]
|
||||
|
||||
@@ -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 и происхождение чисел → пустые слоты. Первые ломают решения,
|
||||
которые по документам принимают; последние — только цену чтения.
|
||||
|
||||
```
|
||||
|
||||
@@ -1,6 +1,6 @@
|
||||
---
|
||||
name: doc-wording
|
||||
description: "Вычитка языка документов проекта по информационному стилю — паспорт, архитектура, конвенции, безопасность, решения ADR, записки разведки, CLAUDE.md. Смотрит отглагольные существительные и страдательный залог, оценку без факта, стоп-слова и канцелярит, «одна мысль — одно предложение», англицизм при живом русском слове, жаргон и метафоры вместо прямого называния, термин, которого нет в документах проекта, транслит в имени файла. Отдаёт готовые формулировки на замену и ничего не правит сам. Записи каталога задач вычитывает отдельный агент task-wording, их форму — task-form. Зовётся по названной пачке правленных документов, а не на весь канон: последним шагом синка документации (av-dev:doc-sync), шагом заведения проекта (av-dev:doc-init), сценарием разведки (av-dev:code-resolve), шагами adopt и upgrade скилла av-dev:canon. Скилл healthcheck его не зовёт — там сверка утверждений, а не языка. Только чтение."
|
||||
description: "Вычитка языка документов проекта по информационному стилю — паспорт, архитектура, конвенции, безопасность, решения ADR, записки разведки, CLAUDE.md. Смотрит отглагольные существительные и страдательный залог, оценку без факта, стоп-слова и канцелярит, «одна мысль — одно предложение», англицизм при живом русском слове, жаргон и метафоры вместо прямого называния, термин, которого нет в документах проекта, транслит в имени файла, счёт корпуса числом вместо ссылки («пять ревью», «три capability»). Отдаёт готовые формулировки на замену и ничего не правит сам. Записи каталога задач вычитывает отдельный агент task-wording, их форму — task-form. Зовётся по названной пачке правленных документов, а не на весь канон: последним шагом синка документации (av-dev:doc-sync), шагом заведения проекта (av-dev:doc-init), сценарием разведки (av-dev:code-resolve), шагами adopt и upgrade скилла av-dev:canon. Скилл healthcheck его не зовёт — там сверка утверждений, а не языка. Только чтение."
|
||||
tools: Read, Grep, Glob
|
||||
model: sonnet
|
||||
color: green
|
||||
@@ -100,9 +100,7 @@ color: green
|
||||
|
||||
| Термин | Что называет |
|
||||
| --- | --- |
|
||||
| интейк | заведение записи с фильтром и дедупом: «заведение» называет создание файла, слить их — смешать две операции |
|
||||
| триаж | стадия конвейера, сводящая находки в решение |
|
||||
| провенанс | обязательное свойство числа: чем и при каких условиях получено. «Источник» рядом называет саму запись, а не свойство |
|
||||
| дедуп, дедупликация | сверка нового против уже лежащего |
|
||||
| чек-лист | перечень, по которому идут сверху вниз, называя исход каждой строки |
|
||||
| дифф, `--base` | разница между состояниями в git |
|
||||
@@ -119,9 +117,26 @@ color: green
|
||||
Отсюда же читается снятое. Эти слова из текстов убраны, и возвращать их не
|
||||
надо: **конфляция** (смешение), **декорреляция** (разведённость, разведён с
|
||||
кем-то), **непоймание** (почему не поймали), **эвал-сет** (проверочный
|
||||
набор), **гайд** (руководство), **опиниативный** (проход с мнением). Каждое
|
||||
было латинизмом или калькой при живом русском слове, и каждое к моменту снятия
|
||||
жило в трёх-шести файлах разом — то есть выглядело словарём, не будучи им.
|
||||
набор), **гайд** (руководство), **опиниативный** (проход с мнением),
|
||||
**провенанс** (происхождение числа: чем и при каких условиях получено),
|
||||
**интейк** (заведение записей — из диалога, из ревью: операция зовётся своим
|
||||
источником). Каждое было латинизмом или калькой при живом русском слове, и
|
||||
каждое к моменту снятия жило в трёх-шести файлах разом — то есть выглядело
|
||||
словарём, не будучи им.
|
||||
|
||||
**Провенанс и интейк сняты из самого словаря, и это прецедент.** Оба стояли в
|
||||
нём с оговоркой, и обе оговорки были верны, но доказывали меньше, чем от них
|
||||
брали.
|
||||
|
||||
| Слово | Чем защищалось | Чем заменено |
|
||||
| --- | --- | --- |
|
||||
| провенанс | «источник» рядом называет саму запись, а не свойство | **происхождение** у числа, **откуда** у вопроса и находки: смысла было два, и это же и держало латинизм |
|
||||
| интейк | «заведение» называет создание файла, а не отбор с дедупом | **заведение с названным источником** — «из диалога», «из ревью»: так операция и называется в самом скилле задач |
|
||||
|
||||
Общее у обоих: оговорка отвергала **один** русский вариант, а вывод делался
|
||||
про все. **Латинизм, переживший проверку одним синонимом, — не имя вещи, а
|
||||
непроверенная привычка**, и запись в словаре обязана говорить, чем слово
|
||||
незаменимо, а не чем плох один из кандидатов.
|
||||
|
||||
7. **Жаргон и метафоры заменяются прямым называнием.** Автору образ понятен,
|
||||
читателю — нет.
|
||||
@@ -153,6 +168,34 @@ color: green
|
||||
коммитах и путях, которые набирают руками. Переименование — **перенос ссылок
|
||||
одним проходом**, а не правка одного файла.
|
||||
|
||||
10. **Счёт корпуса не пишется словами.** «Пять ревью», «три capability»,
|
||||
«десять проходов», «четыре документа канона» — это факт о корпусе, а дом у
|
||||
такого факта сам корпус. Переписанный в прозу, он расходится с ним на первом
|
||||
же пополнении, и расходится **молча**: фраза остаётся грамматически исправной
|
||||
и правдоподобной, а проверить её можно только пересчётом, которого никто не
|
||||
делает.
|
||||
|
||||
Сослаться можно двумя способами, и ни один не стареет:
|
||||
|
||||
| Как | Пример |
|
||||
| --- | --- |
|
||||
| на конкретную запись — именем, слагом, датой | «ревью от 3 августа», `adr/0007-queue-as-table.md`, capability `recognition` |
|
||||
| на корпус целиком | «ревью проекта», «capability, объявленные в `openspec/specs/`» |
|
||||
|
||||
Величина нужна читателю редко, а когда нужна — её называет сам корпус в
|
||||
момент чтения: каталог, индекс, команда. Абзац её только запоминает.
|
||||
|
||||
**Замер с названным происхождением — не счёт корпуса.** «Прозаический триггер дал 6
|
||||
записей ADR на 43 изменения» описывает прошлое, а прошлое не пополняется: это
|
||||
факт по правилу 2, и трогать его нельзя. Разница проверяется вопросом
|
||||
«изменится ли число само, без правки текста».
|
||||
|
||||
**Число, стоящее заголовком к перечню, приведённому тут же, правилом не
|
||||
задето.** «Три исхода:» с тремя пунктами под ним — не ссылка на корпус, и
|
||||
расходится оно не втихую, а вместе со списком, который правят в той же
|
||||
строке. Уехал перечень в другой файл — число уезжает с ним, а на его месте
|
||||
остаётся ссылка.
|
||||
|
||||
<!-- /копия: язык-правила -->
|
||||
|
||||
### Что из этих правил докладывается особым образом
|
||||
@@ -170,13 +213,21 @@ color: green
|
||||
ходу. Находка — готовое английское имя на замену плюс напоминание про перенос
|
||||
ссылок одним проходом.
|
||||
|
||||
**Правило 10, счёт корпуса.** Пересчитывать корпус не надо: находка — в самом
|
||||
числе, а не в том, что оно разошлось. Число, совпадающее с действительностью
|
||||
сегодня, — та же находка: завтра оно разойдётся, и молча. Предложение — готовая
|
||||
замена: ссылка на конкретную запись или называние корпуса целиком. Перечень,
|
||||
приведённый тут же под числом, не трогай. Чаще всего счёт заводится в
|
||||
`architecture.md` («три источника», «пять единых точек») и в `review.md`, где
|
||||
пересказывают журнал.
|
||||
|
||||
## Чего ты не проверяешь
|
||||
|
||||
Не своё бывает двух разных родов, и поступают с ними по-разному.
|
||||
|
||||
**Чужому подрядчику — строкой в границах покрытия.** Согласованность документов
|
||||
между собой (факт в двух домах, противоречие, поведение, осевшее в обзоре, ADR
|
||||
без ссылки, число без провенанса) — у `doc-consistency`; соответствие документов
|
||||
без ссылки, число без происхождения) — у `doc-consistency`; соответствие документов
|
||||
коду — у `doc-code-drift`; язык записей каталога задач — у `task-wording`, их
|
||||
форма — у `task-form`. Увидел — назови в конце одной строкой, чтобы находка не
|
||||
пропала, но находкой не оформляй.
|
||||
|
||||
@@ -177,7 +177,7 @@ severity:
|
||||
любой метке и `review-basics`, когда запускается. Пришёл хоть от одного — веди
|
||||
его в сводку отдельной строкой, а не в общий список находок: метку выбирал
|
||||
`review-scope`, а не они и не ты, значит сигнал независим. Пришли оба — это одна
|
||||
строка с двумя провенансами, а не два пункта: согласие проходов приоритет
|
||||
строка с двумя названными проходами, а не два пункта: согласие проходов приоритет
|
||||
повышает, `confidence` нет.
|
||||
|
||||
**Сигнала нет — тоже скажи строкой.** «Корректор метки отработал, возражений
|
||||
|
||||
@@ -1,6 +1,6 @@
|
||||
---
|
||||
name: task-wording
|
||||
description: "Вычитка языка записей каталога задач по информационному стилю — задачи, строки индекса и причины отказа. Смотрит отглагольные существительные и страдательный залог, оценку без факта, стоп-слова и канцелярит, «одна мысль — одно предложение», англицизм при живом русском слове, жаргон и метафоры вместо прямого называния, термин, которого нет в документах проекта, транслит в слаге. Отдаёт готовые формулировки на замену и ничего не правит сам. Форму записи (заголовок по типу, «зачем», границы, оракулы) смотрит отдельный агент task-form, документы проекта вычитывает doc-wording. Использовать после заведения или разбора пачки записей, до взятия в работу и на переоценке беклога. Только чтение."
|
||||
description: "Вычитка языка записей каталога задач по информационному стилю — задачи, строки индекса и причины отказа. Смотрит отглагольные существительные и страдательный залог, оценку без факта, стоп-слова и канцелярит, «одна мысль — одно предложение», англицизм при живом русском слове, жаргон и метафоры вместо прямого называния, термин, которого нет в документах проекта, транслит в слаге, счёт корпуса числом вместо ссылки («три эндпоинта», «четыре миграции»). Отдаёт готовые формулировки на замену и ничего не правит сам. Форму записи (заголовок по типу, «зачем», границы, оракулы) смотрит отдельный агент task-form, документы проекта вычитывает doc-wording. Использовать после заведения или разбора пачки записей, до взятия в работу и на переоценке беклога. Только чтение."
|
||||
tools: Read, Grep, Glob
|
||||
model: sonnet
|
||||
color: green
|
||||
@@ -107,9 +107,7 @@ color: green
|
||||
|
||||
| Термин | Что называет |
|
||||
| --- | --- |
|
||||
| интейк | заведение записи с фильтром и дедупом: «заведение» называет создание файла, слить их — смешать две операции |
|
||||
| триаж | стадия конвейера, сводящая находки в решение |
|
||||
| провенанс | обязательное свойство числа: чем и при каких условиях получено. «Источник» рядом называет саму запись, а не свойство |
|
||||
| дедуп, дедупликация | сверка нового против уже лежащего |
|
||||
| чек-лист | перечень, по которому идут сверху вниз, называя исход каждой строки |
|
||||
| дифф, `--base` | разница между состояниями в git |
|
||||
@@ -126,9 +124,26 @@ color: green
|
||||
Отсюда же читается снятое. Эти слова из текстов убраны, и возвращать их не
|
||||
надо: **конфляция** (смешение), **декорреляция** (разведённость, разведён с
|
||||
кем-то), **непоймание** (почему не поймали), **эвал-сет** (проверочный
|
||||
набор), **гайд** (руководство), **опиниативный** (проход с мнением). Каждое
|
||||
было латинизмом или калькой при живом русском слове, и каждое к моменту снятия
|
||||
жило в трёх-шести файлах разом — то есть выглядело словарём, не будучи им.
|
||||
набор), **гайд** (руководство), **опиниативный** (проход с мнением),
|
||||
**провенанс** (происхождение числа: чем и при каких условиях получено),
|
||||
**интейк** (заведение записей — из диалога, из ревью: операция зовётся своим
|
||||
источником). Каждое было латинизмом или калькой при живом русском слове, и
|
||||
каждое к моменту снятия жило в трёх-шести файлах разом — то есть выглядело
|
||||
словарём, не будучи им.
|
||||
|
||||
**Провенанс и интейк сняты из самого словаря, и это прецедент.** Оба стояли в
|
||||
нём с оговоркой, и обе оговорки были верны, но доказывали меньше, чем от них
|
||||
брали.
|
||||
|
||||
| Слово | Чем защищалось | Чем заменено |
|
||||
| --- | --- | --- |
|
||||
| провенанс | «источник» рядом называет саму запись, а не свойство | **происхождение** у числа, **откуда** у вопроса и находки: смысла было два, и это же и держало латинизм |
|
||||
| интейк | «заведение» называет создание файла, а не отбор с дедупом | **заведение с названным источником** — «из диалога», «из ревью»: так операция и называется в самом скилле задач |
|
||||
|
||||
Общее у обоих: оговорка отвергала **один** русский вариант, а вывод делался
|
||||
про все. **Латинизм, переживший проверку одним синонимом, — не имя вещи, а
|
||||
непроверенная привычка**, и запись в словаре обязана говорить, чем слово
|
||||
незаменимо, а не чем плох один из кандидатов.
|
||||
|
||||
7. **Жаргон и метафоры заменяются прямым называнием.** Автору образ понятен,
|
||||
читателю — нет.
|
||||
@@ -160,6 +175,34 @@ color: green
|
||||
коммитах и путях, которые набирают руками. Переименование — **перенос ссылок
|
||||
одним проходом**, а не правка одного файла.
|
||||
|
||||
10. **Счёт корпуса не пишется словами.** «Пять ревью», «три capability»,
|
||||
«десять проходов», «четыре документа канона» — это факт о корпусе, а дом у
|
||||
такого факта сам корпус. Переписанный в прозу, он расходится с ним на первом
|
||||
же пополнении, и расходится **молча**: фраза остаётся грамматически исправной
|
||||
и правдоподобной, а проверить её можно только пересчётом, которого никто не
|
||||
делает.
|
||||
|
||||
Сослаться можно двумя способами, и ни один не стареет:
|
||||
|
||||
| Как | Пример |
|
||||
| --- | --- |
|
||||
| на конкретную запись — именем, слагом, датой | «ревью от 3 августа», `adr/0007-queue-as-table.md`, capability `recognition` |
|
||||
| на корпус целиком | «ревью проекта», «capability, объявленные в `openspec/specs/`» |
|
||||
|
||||
Величина нужна читателю редко, а когда нужна — её называет сам корпус в
|
||||
момент чтения: каталог, индекс, команда. Абзац её только запоминает.
|
||||
|
||||
**Замер с названным происхождением — не счёт корпуса.** «Прозаический триггер дал 6
|
||||
записей ADR на 43 изменения» описывает прошлое, а прошлое не пополняется: это
|
||||
факт по правилу 2, и трогать его нельзя. Разница проверяется вопросом
|
||||
«изменится ли число само, без правки текста».
|
||||
|
||||
**Число, стоящее заголовком к перечню, приведённому тут же, правилом не
|
||||
задето.** «Три исхода:» с тремя пунктами под ним — не ссылка на корпус, и
|
||||
расходится оно не втихую, а вместе со списком, который правят в той же
|
||||
строке. Уехал перечень в другой файл — число уезжает с ним, а на его месте
|
||||
остаётся ссылка.
|
||||
|
||||
<!-- /копия: язык-правила -->
|
||||
|
||||
### Что из этих правил докладывается особым образом
|
||||
@@ -180,6 +223,14 @@ color: green
|
||||
английский слаг на замену плюс напоминание, что переименование это перенос
|
||||
ссылок одним проходом, а не правка одного файла.
|
||||
|
||||
**Правило 10, счёт корпуса.** Пересчитывать корпус не надо: находка — в самом
|
||||
числе, а не в том, что оно разошлось. Число, верное сегодня, — та же находка. В
|
||||
записях счёт заводится в «Затрагивает» («три эндпоинта», «четыре миграции») и в
|
||||
критериях приёмки, и там он опаснее прочего: критерий, сверяемый по числу,
|
||||
пройдёт на другом составе работ. Предложение — готовая замена: перечислить
|
||||
поимённо или назвать корпус целиком. Перечень, приведённый тут же под числом, не
|
||||
трогай.
|
||||
|
||||
## Чего ты не проверяешь
|
||||
|
||||
Не своё бывает двух разных родов, и поступают с ними по-разному.
|
||||
|
||||
+10
-5
@@ -18,6 +18,7 @@
|
||||
| --- | --- | --- |
|
||||
| стадия проекта | `build` `support` | `task-track/SKILL.md`, «Две стадии» |
|
||||
| тип записи | `feature` `fix` `chore` `research` | `task-track/SKILL.md`, «Тип записи» |
|
||||
| форма постановки | запись каталога · текст | `code-resolve/SKILL.md`, «Вход» |
|
||||
| сценарий | решение · обслуживание · разведка | `code-resolve/SKILL.md`, «Развилка» |
|
||||
| метка | `small` `medium` `large` | `code-review/SKILL.md`, «Метки» |
|
||||
| режим прогона | с меткой · без метки | здесь, ниже |
|
||||
@@ -27,8 +28,8 @@
|
||||
| коды выхода | 0 1 2 3 4 | здесь, ниже |
|
||||
|
||||
Две оси стоят домом **здесь**, и обе по одной причине: владельца у них нет.
|
||||
Коды выхода делят восемь скриптов и три скилла, режим прогона — конвейер, сценарий
|
||||
обслуживания и два устава.
|
||||
Коды выхода делят все скрипты плагина и зовущие их скиллы, режим прогона —
|
||||
конвейер, сценарий обслуживания и уставы вычитки.
|
||||
|
||||
## Что на что влияет
|
||||
|
||||
@@ -42,6 +43,8 @@
|
||||
| стадия проекта | тип записи — **не влияет, и это записано явно** | `task-track/SKILL.md`, «Две стадии» |
|
||||
| стадия проекта | как серьёзность находки ложится в список | `task-track/references/from-review.md` |
|
||||
| стадия проекта | где сценарии кладут свой исход и чем закрывают переходное состояние | `code-resolve/references/research.md`, `task-track/references/adopt.md` |
|
||||
| форма постановки | проверку готовности, кто называет тип, есть ли шаг закрытия | `code-resolve/SKILL.md`, «Постановка текстом» |
|
||||
| форма постановки | сценарий, метку и глубину — **не влияет, и это записано явно** | там же: развилка у обеих форм общая |
|
||||
| тип записи | сценарий — **предлагает**, подтверждает предмет работы | `task-track/SKILL.md`, «Тип записи» |
|
||||
| тип записи | метку и глубину — **не влияет, и это записано явно** | там же |
|
||||
| сценарий | режим прогона: обслуживание идёт без метки | `code-resolve/references/maintain.md` |
|
||||
@@ -70,9 +73,11 @@
|
||||
стройке — обычное дело (первые шаги плана заводят гейт и сборку), и идёт он там
|
||||
так же, как на доработке.
|
||||
|
||||
**Стадия проекта × категория документа и × коды выхода.** Не влияет: категория —
|
||||
свойство документа, коды — общий словарь скриптов. Названо потому, что перечень
|
||||
объявлен полным, и клетка без ответа читается как забытая.
|
||||
**Стадия проекта × категория документа, × коды выхода и × форма постановки.** Не
|
||||
влияет: категория — свойство документа, коды — общий словарь скриптов, а форму
|
||||
постановки выбирает тот, кто зовёт скилл, и на стройке она такая же, как на
|
||||
доработке. Названо потому, что перечень объявлен полным, и клетка без ответа
|
||||
читается как забытая.
|
||||
|
||||
**Режим прогона × severity.** Триаж обязателен всегда, в том числе без метки. Но
|
||||
часть оснований `critical` — построенный путь к отказу, замер — добывается
|
||||
|
||||
@@ -56,7 +56,7 @@ LEGACY_TASKS = ".tasks.json"
|
||||
|
||||
# Версия раскладки — одна на плагин. Журнал версий — references/changelog.md
|
||||
# скилла `canon`, повышает его операция `upgrade`.
|
||||
VERSION = 3
|
||||
VERSION = 4
|
||||
|
||||
VERSION_KEY = "version"
|
||||
|
||||
|
||||
@@ -14,7 +14,7 @@
|
||||
|
||||
| Блок | Что в нём | Кто копирует |
|
||||
| --- | --- | --- |
|
||||
| `язык-правила` | девять правил, по которым судят текст | уставы вычитки |
|
||||
| `язык-правила` | правила, по которым судят текст | уставы вычитки |
|
||||
| `порог-правки` | когда находка не заводится | уставы вычитки, `task-form` |
|
||||
|
||||
`порог-правки` вынесен из правил намеренно: он нужен и тому, кто правил языка не
|
||||
@@ -47,6 +47,35 @@
|
||||
эстетическая: текст, из которого нельзя достать факт, заставляет открывать код,
|
||||
а это и есть цена, которой мы избегаем.
|
||||
|
||||
## Образец: научно-популярная книга
|
||||
|
||||
**Так, как пишут хорошую научно-популярную книгу.** Не спецификация, не статья в
|
||||
блоге, не конспект для себя: текст, который объясняет устройство **точными
|
||||
простыми словами** и понятен с первого прохода тому, кто эту систему не писал.
|
||||
|
||||
Из образца следуют три умолчания, и все три — про плотность, а не про красоту:
|
||||
|
||||
- **воды нет.** Каждая фраза несёт сведение: что устроено так, почему так и что
|
||||
из этого следует. Абзац, из которого ничего нельзя достать, вычёркивается
|
||||
целиком, а не переписывается;
|
||||
- **сложных конструкций нет.** Причастный оборот внутри придаточного, три
|
||||
отрицания подряд, предложение на пять строк — читатель разбирает такую фразу
|
||||
дважды, и второй раз он её уже не разбирает. Причинную связь при этом не
|
||||
режут: «поэтому», «иначе», «раз так» — сведения;
|
||||
- **англицизм — исключение, требующее причины.** Умолчание обратное принятому в
|
||||
разработке: пишем по-русски, а иностранное слово остаётся, только когда оно
|
||||
**имя вещи** или когда русский аналог искажает смысл. Какая причина годится,
|
||||
разбирает правило 5; закрытый список принятых слов — правило 6.
|
||||
|
||||
Термин здесь не запрещён — запрещена **перегрузка**: термин, который вводится
|
||||
одной строкой, дешевле описания в три предложения, а термин, который
|
||||
предполагается известным, дороже обоих (правило 8).
|
||||
|
||||
**Образец находок не порождает.** Он для того, кто пишет; вычитка судит по
|
||||
правилам, и правка без нарушенного правила не делается (раздел «Порог правки»).
|
||||
Иначе «мне кажется, звучит сложно» стало бы находкой, и список замечаний
|
||||
перестали бы читать целиком.
|
||||
|
||||
## Что взято сверх правил вычитки
|
||||
|
||||
Эти три требования судит человек, а не проход вычитки: находка по ним требует
|
||||
@@ -158,9 +187,7 @@
|
||||
|
||||
| Термин | Что называет |
|
||||
| --- | --- |
|
||||
| интейк | заведение записи с фильтром и дедупом: «заведение» называет создание файла, слить их — смешать две операции |
|
||||
| триаж | стадия конвейера, сводящая находки в решение |
|
||||
| провенанс | обязательное свойство числа: чем и при каких условиях получено. «Источник» рядом называет саму запись, а не свойство |
|
||||
| дедуп, дедупликация | сверка нового против уже лежащего |
|
||||
| чек-лист | перечень, по которому идут сверху вниз, называя исход каждой строки |
|
||||
| дифф, `--base` | разница между состояниями в git |
|
||||
@@ -177,9 +204,26 @@
|
||||
Отсюда же читается снятое. Эти слова из текстов убраны, и возвращать их не
|
||||
надо: **конфляция** (смешение), **декорреляция** (разведённость, разведён с
|
||||
кем-то), **непоймание** (почему не поймали), **эвал-сет** (проверочный
|
||||
набор), **гайд** (руководство), **опиниативный** (проход с мнением). Каждое
|
||||
было латинизмом или калькой при живом русском слове, и каждое к моменту снятия
|
||||
жило в трёх-шести файлах разом — то есть выглядело словарём, не будучи им.
|
||||
набор), **гайд** (руководство), **опиниативный** (проход с мнением),
|
||||
**провенанс** (происхождение числа: чем и при каких условиях получено),
|
||||
**интейк** (заведение записей — из диалога, из ревью: операция зовётся своим
|
||||
источником). Каждое было латинизмом или калькой при живом русском слове, и
|
||||
каждое к моменту снятия жило в трёх-шести файлах разом — то есть выглядело
|
||||
словарём, не будучи им.
|
||||
|
||||
**Провенанс и интейк сняты из самого словаря, и это прецедент.** Оба стояли в
|
||||
нём с оговоркой, и обе оговорки были верны, но доказывали меньше, чем от них
|
||||
брали.
|
||||
|
||||
| Слово | Чем защищалось | Чем заменено |
|
||||
| --- | --- | --- |
|
||||
| провенанс | «источник» рядом называет саму запись, а не свойство | **происхождение** у числа, **откуда** у вопроса и находки: смысла было два, и это же и держало латинизм |
|
||||
| интейк | «заведение» называет создание файла, а не отбор с дедупом | **заведение с названным источником** — «из диалога», «из ревью»: так операция и называется в самом скилле задач |
|
||||
|
||||
Общее у обоих: оговорка отвергала **один** русский вариант, а вывод делался
|
||||
про все. **Латинизм, переживший проверку одним синонимом, — не имя вещи, а
|
||||
непроверенная привычка**, и запись в словаре обязана говорить, чем слово
|
||||
незаменимо, а не чем плох один из кандидатов.
|
||||
|
||||
7. **Жаргон и метафоры заменяются прямым называнием.** Автору образ понятен,
|
||||
читателю — нет.
|
||||
@@ -211,6 +255,34 @@
|
||||
коммитах и путях, которые набирают руками. Переименование — **перенос ссылок
|
||||
одним проходом**, а не правка одного файла.
|
||||
|
||||
10. **Счёт корпуса не пишется словами.** «Пять ревью», «три capability»,
|
||||
«десять проходов», «четыре документа канона» — это факт о корпусе, а дом у
|
||||
такого факта сам корпус. Переписанный в прозу, он расходится с ним на первом
|
||||
же пополнении, и расходится **молча**: фраза остаётся грамматически исправной
|
||||
и правдоподобной, а проверить её можно только пересчётом, которого никто не
|
||||
делает.
|
||||
|
||||
Сослаться можно двумя способами, и ни один не стареет:
|
||||
|
||||
| Как | Пример |
|
||||
| --- | --- |
|
||||
| на конкретную запись — именем, слагом, датой | «ревью от 3 августа», `adr/0007-queue-as-table.md`, capability `recognition` |
|
||||
| на корпус целиком | «ревью проекта», «capability, объявленные в `openspec/specs/`» |
|
||||
|
||||
Величина нужна читателю редко, а когда нужна — её называет сам корпус в
|
||||
момент чтения: каталог, индекс, команда. Абзац её только запоминает.
|
||||
|
||||
**Замер с названным происхождением — не счёт корпуса.** «Прозаический триггер дал 6
|
||||
записей ADR на 43 изменения» описывает прошлое, а прошлое не пополняется: это
|
||||
факт по правилу 2, и трогать его нельзя. Разница проверяется вопросом
|
||||
«изменится ли число само, без правки текста».
|
||||
|
||||
**Число, стоящее заголовком к перечню, приведённому тут же, правилом не
|
||||
задето.** «Три исхода:» с тремя пунктами под ним — не ссылка на корпус, и
|
||||
расходится оно не втихую, а вместе со списком, который правят в той же
|
||||
строке. Уехал перечень в другой файл — число уезжает с ним, а на его месте
|
||||
остаётся ссылка.
|
||||
|
||||
<!-- /дом: язык-правила -->
|
||||
|
||||
## Порог правки
|
||||
|
||||
@@ -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 проверяемых свойств к каждому;
|
||||
- **Типовые ложноположительные** — находки, которые здесь выглядят убедительно и
|
||||
всегда неверны, каждая со строкой «почему здесь это не дефект»;
|
||||
- **Вопросы по темам** — в форме `<тема>: <вопрос> (<провенанс>)`. **Не по именам
|
||||
- **Вопросы по темам** — в форме `<тема>: <вопрос> (<откуда>)`. **Не по именам
|
||||
проходов**: проход уезжает между метками, а тема остаётся, и вопрос,
|
||||
адресованный проходу, перестал бы задаваться молча в тот день, когда тот уехал
|
||||
в старшую метку. Задаёт вопрос тот, кто закрывает тему на этом прогоне.
|
||||
@@ -464,6 +464,12 @@ kebab-case.** Причина не эстетическая: имя файла с
|
||||
| что уже механизировано правилом | `conventions.*`, раздел «Механизировано» |
|
||||
<!-- /дом: карта-домов -->
|
||||
|
||||
**Сколько чего в корпусе — тоже факт, и дом у него сам корпус.** «Пять ревью»,
|
||||
«три capability», «четыре документа» в прозе — второй дом, расходящийся с первым
|
||||
на ближайшем пополнении и молча. Правило и оба законных способа сослаться —
|
||||
`av-dev/shared/language.md`, правило 10; здесь оно названо потому, что счёт
|
||||
корпуса выглядит не копией, а собственным наблюдением документа.
|
||||
|
||||
## Пустое называется пустым
|
||||
|
||||
Скелет канона заводится **целиком** с первого дня. Незаполненный документ держит
|
||||
|
||||
@@ -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 @@
|
||||
|
||||
### Вопросы по темам
|
||||
|
||||
Форма: `<тема>: <вопрос> (<провенанс>)`. Главный источник — журнал ниже. Вопрос
|
||||
Форма: `<тема>: <вопрос> (<откуда>)`. Главный источник — журнал ниже. Вопрос
|
||||
задаёт тот проход, который закрывает эту тему на текущем прогоне, дополнительно
|
||||
к обязательным.
|
||||
|
||||
|
||||
@@ -1,6 +1,6 @@
|
||||
---
|
||||
name: code-resolve
|
||||
description: "Взять одну задачу и довести её до закрытия. Одна точка входа, три сценария, и выбирает сценарий сам скилл, прочитав постановку. Способ известен и меняется поведение — сценарий решения: цикл Spec Driven Development (opsx propose → разметка → ревью дизайна → чекпоинт с объяснением человеческим языком → opsx apply → ревью кода → archive → синк документации → коммит → закрытие). Способ известен, а спека не меняется (тип chore: тулчейн, зависимости, сборка, гит-хуки, перенос, чистка) — сценарий обслуживания: правка → гейт со сверкой состава проверок → ревью фиксированным планом без change (autotests, operations, плюс conventions, если тронут код) → синк документации → коммит → закрытие; планового стопа нет, change не заводится. Нашлась дельта-спека — задача оказалась шире своего типа: стоп с объяснением простым языком и двумя решениями человека, переформулировать запись в fix или feature и решать её процессом того типа следующим прогоном либо прекратить работу. Способа нет, постановка мутная, тип research — сценарий разведки: вопрос и рамки → чтение документов, кода и внешних источников (можно opsx:explore) → чекпоинт вариантов: 2–4 способа решить, цена каждого, что становится невозможным, рекомендация → ответ уезжает в документы канона, исход — в задачи → вычитка написанного → коммит → закрытие. Разведка кода не пишет и change не заводит, а выбранный способ реализуется следующим прогоном. На входе путь к файлу задачи, её слаг или просто текст. Использовать, когда просят взять, сделать или решить задачу, обновить зависимости или сборку, разобраться, изучить, сравнить подходы, проработать сырую идею, ответить на вопрос из беклога."
|
||||
description: "Взять одну задачу и довести её до закрытия. Одна точка входа, три сценария, и выбирает сценарий сам скилл, прочитав постановку. Способ известен и меняется поведение — сценарий решения: цикл Spec Driven Development (opsx propose → разметка → ревью дизайна → чекпоинт с объяснением человеческим языком → opsx apply → ревью кода → archive → синк документации → коммит → закрытие). Способ известен, а спека не меняется (тип chore: тулчейн, зависимости, сборка, гит-хуки, перенос, чистка) — сценарий обслуживания: правка → гейт со сверкой состава проверок → ревью фиксированным планом без change (autotests, operations, плюс conventions, если тронут код) → синк документации → коммит → закрытие; планового стопа нет, change не заводится. Нашлась дельта-спека — задача оказалась шире своего типа: стоп с объяснением простым языком и двумя решениями человека, переформулировать запись в fix или feature и решать её процессом того типа следующим прогоном либо прекратить работу. Способа нет, постановка мутная, тип research — сценарий разведки: вопрос и рамки → чтение документов, кода и внешних источников (можно opsx:explore) → чекпоинт вариантов: 2–4 способа решить, цена каждого, что становится невозможным, рекомендация → ответ уезжает в документы канона, исход — в задачи → вычитка написанного → коммит → закрытие. Разведка кода не пишет и change не заводит, а выбранный способ реализуется следующим прогоном. На входе путь к файлу задачи, её слаг или просто текст постановки: размеченная запись не обязательна — текст берётся так же, как его берёт opsx:propose, и текстом идут все три сценария. Использовать, когда просят взять, сделать или решить задачу — хоть записью из каталога, хоть описанием прямо в разговоре, — обновить зависимости или сборку, разобраться, изучить, сравнить подходы, проработать сырую идею, ответить на вопрос из беклога."
|
||||
---
|
||||
|
||||
# Работа над одной задачей
|
||||
@@ -114,7 +114,13 @@ description: "Взять одну задачу и довести её до за
|
||||
Ничего из этого не задано — попроси у вызывающего и остановись; сам в беклог не
|
||||
лезь и приоритеты не интерпретируй: что делать дальше, решает не этот скилл.
|
||||
|
||||
**Запись из каталога сперва проверяется на готовность, и проверяет её машина.**
|
||||
**Форм постановки две, и обе полноправны:** запись каталога задач и текст,
|
||||
переданный вызовом. Форма — не сценарий: развилка ниже у них общая, и текст
|
||||
принимают все три сценария.
|
||||
|
||||
### Запись из каталога
|
||||
|
||||
**Запись сперва проверяется на готовность, и проверяет её машина.**
|
||||
Вызови Skill `av-dev:task-track` и попроси прогнать `ready <слаг>`: он смотрит
|
||||
тип, пустой ли раздел вопросов и собраны ли разделы схемы типа. Судить это глазами нельзя — ровно тот случай, где машина дешевле и точнее,
|
||||
а цена ошибки отложенная: недостающие критерии приёмки обнаружатся на приёмке,
|
||||
@@ -127,9 +133,43 @@ description: "Взять одну задачу и довести её до за
|
||||
**Отказ `ready` сценарий не выбирает.** Запись `research` без раздела «Вопрос»
|
||||
(сырьё) — отказ и здесь: у неё нет вопроса, и разведывать нечего.
|
||||
|
||||
Каталога задач в проекте нет или задача пришла текстом — прогонять
|
||||
нечего. Тогда прочитай постановку сам и скажи строкой, что готовность машиной не
|
||||
проверялась; работу при этом не останавливай.
|
||||
Каталога задач в проекте нет — прогонять нечего, и постановка приходит текстом
|
||||
по построению: дальше по разделу ниже.
|
||||
|
||||
### Постановка текстом
|
||||
|
||||
**Текст — вход, а не урезанный режим.** Ровно так берёт постановку
|
||||
`opsx:propose`: предложение делается из фразы человека, а не из заранее
|
||||
размеченной записи. Требовать записи там, где работа уместилась в разговор,
|
||||
значит заводить учёт ради учёта — след у прогона остаётся и без неё: коммит, а у
|
||||
решения ещё и заархивированный change.
|
||||
|
||||
**Первой репликой покажи, как ты понял постановку** — рядом с названным
|
||||
сценарием, одной-двумя фразами: что считаешь предметом работы и где проводишь
|
||||
границу. Запись толкуется по разделам, текст — молча, и расходится он с замыслом
|
||||
ровно там, где его никто не показал. Человек, написавший текст, сидит в этом же
|
||||
разговоре и поправляет одной фразой; автора записи, написанной месяц назад,
|
||||
рядом нет, и потому текстовая постановка проверяется дешевле, а не хуже.
|
||||
|
||||
Что несёт запись и чем это заменяется, когда её нет:
|
||||
|
||||
| Что несёт запись | Чем заменяется у текста |
|
||||
| --- | --- |
|
||||
| готовность, проверенную машиной | читаешь постановку сам и говоришь строкой, что `ready` не гонялся |
|
||||
| тип, объявленный автором | тип называешь ты — вслух, первой репликой, вместе со сценарием |
|
||||
| критерии приёмки с оракулами | те, что есть в тексте; недостающие [решение](references/solve.md) добирает на чекпоинте, [обслуживание](references/maintain.md) объявляет строкой отсутствующими |
|
||||
| адрес, куда ляжет ответ разведки | назначаешь сам и по канону, а не по удобству — [research.md](references/research.md), шаг 1 |
|
||||
| закрытие как след работы | закрывать нечего, и шаг закрытия отпадает вместе с записью |
|
||||
|
||||
**Записи в каталог этот скилл не заводит — ни перед работой, ни задним числом
|
||||
ради закрытия.** Граница «беклогом не владеет» действует и здесь. Работа не
|
||||
уместилась в прогон, её надо ставить в очередь или из неё выросла пачка — скажи
|
||||
это строкой и предложи `av-dev:task-track`: заводит он и по своим правилам.
|
||||
|
||||
**Похожую запись в беклоге не ищешь.** Человек назвал работу текстом — значит,
|
||||
предмет прогона этот текст, а не строка индекса, которая на него похожа.
|
||||
Наткнулся на такую строку по ходу — скажи о ней строкой доклада и не закрывай:
|
||||
закрытие записи это приёмка, и поручали её не тебе.
|
||||
|
||||
## Развилка: какой сценарий
|
||||
|
||||
@@ -211,14 +251,18 @@ description: "Взять одну задачу и довести её до за
|
||||
```mermaid
|
||||
flowchart TD
|
||||
in["вход: файл, слаг или текст"]
|
||||
form{"форма постановки"}
|
||||
ready["ready: готовность записи<br/>av-dev:task-track"]
|
||||
plain["понимание, тип и границы —<br/>первой репликой; ready не гонится,<br/>закрывать потом нечего"]
|
||||
fork{"есть очевидный<br/>способ решения?"}
|
||||
fork2{"меняется ли<br/>спека?"}
|
||||
solve["сценарий решения<br/>references/solve.md<br/>код, ревью, архив, коммит"]
|
||||
main["сценарий обслуживания<br/>references/maintain.md<br/>правка, ревью, синк, коммит"]
|
||||
res["сценарий разведки<br/>references/research.md<br/>ответ в документы и задачи"]
|
||||
|
||||
in --> ready --> fork
|
||||
in --> form
|
||||
form -->|"запись каталога"| ready --> fork
|
||||
form -->|"текст"| plain --> fork
|
||||
fork -->|"да"| fork2
|
||||
fork -->|"нет"| res
|
||||
fork2 -->|"да"| solve
|
||||
@@ -348,6 +392,8 @@ change, у второго — сверенный состав гейта и си
|
||||
он;
|
||||
- **исход** одним из четырёх слов своего сценария и, если он не благополучный,
|
||||
чем ограничен результат;
|
||||
- **постановка пришла текстом** — сказать это прямо: как она понята, что `ready`
|
||||
не гонялся и что закрывать было нечего;
|
||||
- что сделано, какие вопросы записаны и куда;
|
||||
- чего проверить или узнать **не удалось**.
|
||||
|
||||
|
||||
@@ -49,6 +49,24 @@
|
||||
либо отправил бы в полный цикл ради пустого change, либо принял бы как
|
||||
исключение, а исключения не исполняются.
|
||||
|
||||
### Постановка текстом — тип называешь ты, и называешь вслух
|
||||
|
||||
Первый признак приходит от автора записи; **текст типа не несёт** (SKILL.md,
|
||||
«Постановка текстом»). Оба признака тогда твои, и связка выродилась бы в одно
|
||||
суждение — то самое, ради разведения которого она и заведена.
|
||||
|
||||
Разведённость здесь восстанавливается местом, а не вторым автором: **тип и
|
||||
предмет работы называются до начала работы, первой репликой** — «иду
|
||||
обслуживанием: считаю это `chore`, потому что …; спека не меняется, потому что
|
||||
…». Человек, написавший текст, читает это раньше первой правки и поправляет
|
||||
одной фразой. Названный **после** работы тип не признак, а объяснение уже
|
||||
сделанного: к этому моменту у тебя есть готовый дифф, и он всегда подтверждает
|
||||
тот тип, под который писался.
|
||||
|
||||
Не назвал — признака нет вовсе, и сценарий выбрал сам себя. Это ровно тот
|
||||
случай, где «самый частый способ соврать этим сценарием» (раздел «Тонкости»)
|
||||
ничего не стоит: автора, чей тип можно было бы опровергнуть, здесь нет.
|
||||
|
||||
## Дельта нашлась по ходу — стоп, и у него свой порядок
|
||||
|
||||
Признак тот же, что на шаге 7 сценария решения: **меняется ли то, что записано в
|
||||
@@ -96,7 +114,11 @@
|
||||
**процессом своего типа**: сценарием решения, следующим прогоном. Формат записи
|
||||
правит `av-dev:task-track`, а не ты: у нового типа своя схема разделов, и
|
||||
готовность её проверит `ready` — той же машиной, что и на входе. Прогон
|
||||
обслуживания на этом кончается, исход — «меняется спека»;
|
||||
обслуживания на этом кончается, исход — «меняется спека».
|
||||
**Постановка пришла текстом — переформулировать нечего:** человек либо
|
||||
запускает следующий прогон тем же текстом, и он пойдёт решением, либо заводит
|
||||
запись через `av-dev:task-track`, если работа должна пережить разговор. Выбор
|
||||
между этими двумя — его, не твой: заводить запись сам этот скилл не вправе;
|
||||
- **прекратить работу** — человек не готов расширять задачу сейчас. Исход тот
|
||||
же, запись остаётся как была, вопрос записывается там, где проект держит
|
||||
вопросы.
|
||||
@@ -214,10 +236,19 @@ ADR: список источников канон закрыл двумя — а
|
||||
(конфиг и его образцы, версия зависимости, команда сборки, файл CI), и
|
||||
**«Критерии приёмки»** — с оракулами.
|
||||
|
||||
**Постановка пришла текстом — этих двух разделов нет, и оба нужны тебе тем же
|
||||
составом.** Границы назови сам и покажи в первой реплике, вместе с типом:
|
||||
обслуживание чаще прочих сценариев расползается, а границы у него лежат не в
|
||||
коде, и невидимая граница расползание не удержит. Критериев приёмки в тексте
|
||||
может не быть вовсе — тогда скажи строкой, что их нет и приёмка идёт по докладу.
|
||||
Сочинить их себе здесь нельзя даже так, как это делает решение: чекпоинта, на
|
||||
котором человек их утвердит, у обслуживания нет.
|
||||
|
||||
Здесь же обе проверки признака: тип предлагает, отсутствие дельт подтверждает
|
||||
(раздел «Признак — связка»). И здесь же — проверка на незнакомое: если форма
|
||||
правки не известна до начала, а нащупывается по ходу, объявляй исход **нужна
|
||||
разведка** и не начинай.
|
||||
(раздел «Признак — связка»); постановка текстом типа не объявляла — тогда
|
||||
называешь его ты, и вслух (раздел «Постановка текстом»). И здесь же — проверка
|
||||
на незнакомое: если форма правки не известна до начала, а нащупывается по ходу,
|
||||
объявляй исход **нужна разведка** и не начинай.
|
||||
|
||||
**Проверка на «заодно».** Обслуживание любит склеиваться в пачку — обновить
|
||||
зависимости, переписать сборку и убрать мёртвый код одной задачей. Не мерджится
|
||||
@@ -376,6 +407,9 @@ Change ты не передаёшь — его нет.
|
||||
`закрыта задача <slug>`. Каталога задач в проекте нет — ничего не выдумывай:
|
||||
скажи, что учёт остаётся за владельцем, и назови исход.
|
||||
|
||||
**Постановка пришла текстом — шага нет вовсе**: записи не было, закрывать нечего,
|
||||
след работы — коммит шага 6. Заводить запись задним числом ради закрытия нельзя.
|
||||
|
||||
## Границы: чего обслуживание не делает
|
||||
|
||||
- **Не меняет поведения.** Обнаружилось, что меняет, — стоп с исходом «меняется
|
||||
@@ -401,6 +435,8 @@ Change ты не передаёшь — его нет.
|
||||
Общее ядро доклада — в SKILL.md; сверх него сценарий обязан назвать:
|
||||
|
||||
- **что подтвердило признак** — тип записи и то, что дельта-спек не нашлось;
|
||||
постановка пришла текстом — **тип назвал ты**, и это говорится прямо, вместе с
|
||||
границами, которые ты объявил себе сам;
|
||||
дельта нашлась — **какой тип предложен, с причиной, и что человек выбрал**:
|
||||
переформулировать или прекратить;
|
||||
- **что стало иначе для разработчика** — одной фразой, адресуясь ему, а не
|
||||
|
||||
@@ -52,7 +52,10 @@
|
||||
|
||||
**Разведка пришла текстом — сформулируй вопрос сам одной фразой и покажи
|
||||
формулировку в первой же реплике.** Разведка, чей вопрос не назван вслух,
|
||||
признаётся удавшейся любым результатом.
|
||||
признаётся удавшейся любым результатом. Это частный случай общего правила
|
||||
(SKILL.md, «Постановка текстом»): у разведки показать надо не только предмет
|
||||
работы, но и сам вопрос, потому что предмет разведки — он и есть. Вместе с
|
||||
вопросом называются рамки и адрес ответа (шаг 1).
|
||||
|
||||
## Ход работы
|
||||
|
||||
@@ -102,7 +105,7 @@ git и читается диффом, а второй стоп на каждой
|
||||
требующий кода, — это отдельная задача, и её нужно назвать, а не написать по
|
||||
ходу. Исключение ровно одно и оно не про изменение системы: одноразовый
|
||||
**читающий** прогон (запрос, замер, скрипт в песочнице), чей результат уезжает
|
||||
в ответ с провенансом и который ничего не оставляет в репозитории.
|
||||
в ответ с происхождением и который ничего не оставляет в репозитории.
|
||||
- **Местом в списке.** Заведённая задача встаёт в конец своей секции; куда её
|
||||
поставить, решает человек — на доработке грумингом (`av-dev:task-groom`), на
|
||||
стройке сразу же, по зависимости. Разведка, сама ставящая свой исход первым,
|
||||
@@ -142,7 +145,7 @@ git и читается диффом, а второй стоп на каждой
|
||||
1. **ответ записан по адресу, который назвала задача** — раздел «Куда ляжет
|
||||
ответ». Адреса не было, а вопрос был — ты назначил адрес сам и сказал об этом
|
||||
строкой;
|
||||
2. **у каждого числа провенанс** — команда или условия, которыми оно получено.
|
||||
2. **у каждого числа названо происхождение** — команда или условия, которыми оно получено.
|
||||
Число без источника проход ревью обязан читать как условие, а не как замер, и
|
||||
разведка, оставившая голые числа, вредна: по ним будут решать;
|
||||
3. **отвергнутые варианты названы с причиной**. Отвергнутое без причины
|
||||
@@ -173,7 +176,7 @@ git и читается диффом, а второй стоп на каждой
|
||||
|
||||
| Что узнали | Дом ответа |
|
||||
| --- | --- |
|
||||
| наблюдение о внешнем мире, замер с провенансом | `docs/research/` |
|
||||
| наблюдение о внешнем мире, замер с происхождением | `docs/research/` |
|
||||
| решение с ценой: намеренный отказ, дорогой откат | `docs/adr/` |
|
||||
| факт об устройстве системы | тема `architecture` (или своя тема проекта) |
|
||||
| граница домена, «чем проект **не** является» | `passport` |
|
||||
@@ -196,7 +199,7 @@ git и читается диффом, а второй стоп на каждой
|
||||
2. **код и его история** — `git log` по узлу отвечает на «почему так» чаще, чем
|
||||
кажется;
|
||||
3. **внешние источники** — документация формата, чужой опыт, спецификации;
|
||||
4. **замер** — если вопрос про числа. Числа снимаются с провенансом, иначе они
|
||||
4. **замер** — если вопрос про числа. Числа снимаются с происхождением, иначе они
|
||||
бесполезны на следующем шаге.
|
||||
|
||||
**Скилл `opsx:explore`** — законный инструмент этого шага, если плагин в проекте
|
||||
@@ -250,7 +253,7 @@ git и читается диффом, а второй стоп на каждой
|
||||
### 4. Ответ в документы канона
|
||||
|
||||
**Вызови Skill `av-dev:doc-sync`**: он владеет содержимым документов канона.
|
||||
Передай ему ответ, адрес из шага 1 и провенанс каждого числа — писать содержание
|
||||
Передай ему ответ, адрес из шага 1 и происхождение каждого числа — писать содержание
|
||||
за тебя он не будет, но дом и форму держит он. Вычитка языка — тоже его агент, но
|
||||
момент её назван отдельно, шагом 6: пачка собирается из шагов 4 и 5 и до конца
|
||||
пятого не полна.
|
||||
@@ -368,6 +371,13 @@ git и читается диффом, а второй стоп на каждой
|
||||
учёт, а не про работу: `закрыта задача <slug>`. Правило «одна разведка — один
|
||||
коммит» про работу, а учёт — не работа.
|
||||
|
||||
**Разведка пришла текстом — шага нет вовсе**: записи не было, закрывать нечего.
|
||||
Следом работы здесь служит не код, а **записанный по названному адресу ответ** —
|
||||
он уехал в коммит шагом 7, и потому отсутствие записи разведке ничем не грозит.
|
||||
Ответ записать было некуда и он остался в докладе — вот это как раз тот случай,
|
||||
когда от прогона не осталось ничего: скажи об этом прямо, а не одной строкой
|
||||
среди прочих.
|
||||
|
||||
Каталога задач в проекте нет — **ничего не выдумывай**: скажи в докладе, что
|
||||
учёт задач остаётся за владельцем, и назови исход.
|
||||
|
||||
|
||||
@@ -90,6 +90,14 @@ flowchart TD
|
||||
в `tasks.md` change. Файл задачи может быть удалён до коммита, а критерии обязаны
|
||||
его пережить.
|
||||
|
||||
**Постановка пришла текстом** (SKILL.md, «Постановка текстом») — записи нет,
|
||||
читаешь сам текст. Критерии в нём бывают редко: выпиши то, что там есть, а
|
||||
недостающие **предложи на чекпоинте шага 5** и считай их данными только после
|
||||
ответа человека. Сам себе критерии не проставляешь — правило то же, что и с
|
||||
записью: они приходят снаружи, и подсунуть их себе значит назначить себе приёмку.
|
||||
Человек критериев не назвал — скажи строкой, что задача идёт без них и приёмка
|
||||
пойдёт по объяснению чекпоинта.
|
||||
|
||||
Здесь же проверка на «крупнее задачи»: видно, что одним заходом это не
|
||||
мерджится, — объявляй исход **до** заведения change.
|
||||
|
||||
@@ -193,7 +201,11 @@ flowchart TD
|
||||
- **чего мы намеренно не делаем** и почему — граница scope ловится хуже всего;
|
||||
- **чем рискуем и что осталось нерешённым** — сюда съезжаются развилки,
|
||||
накопленные до этого места, и находки ревью с пометкой `развилка`;
|
||||
- **что дальше**, если возражений нет.
|
||||
- **что дальше**, если возражений нет;
|
||||
- **критерии приёмки, если постановка пришла текстом и не назвала их** —
|
||||
предложенными, а не принятыми: человек их подтверждает или правит здесь же.
|
||||
Это единственное место, где исполнитель вообще может их предложить, и работает
|
||||
оно только потому, что решает всё равно человек.
|
||||
|
||||
Проверка на «простой язык» одна и механическая, и она общая у чекпоинтов всех
|
||||
трёх сценариев — поэтому её дом здесь, а у соседей помеченные копии:
|
||||
@@ -277,7 +289,7 @@ flowchart TD
|
||||
**Сверь план прогона с исходом, прежде чем коммитить.** Отчёт начинается планом
|
||||
разметчика — таблицей «тема → дом → глубина → кто закрывает», — и против каждой
|
||||
темы обязан стоять исход. Тема без отчёта и тема без дома — разные вещи, и обе
|
||||
должны быть названы. Реестр короткий (шесть тем ядра плюс свои) — сверка стоит
|
||||
должны быть названы. Реестр короткий — темы ядра плюс свои проекта, — и сверка стоит
|
||||
одного взгляда.
|
||||
|
||||
#### Отработка, и здесь появляется одно новое правило
|
||||
@@ -304,7 +316,7 @@ flowchart TD
|
||||
|
||||
**Урожай — списком, не задачами.** Отложенные находки (реальный `major` не для
|
||||
этого мерджа, развилка, решённая «потом», пачка `nit`) собери в секцию доклада
|
||||
`Урожай`: формулировка, оракул, провенанс. Задачи из него **заводит не этот
|
||||
`Урожай`: формулировка, оракул, откуда взялась. Задачи из него **заводит не этот
|
||||
скилл** — их заводит `av-dev:task-track` своим сценарием «задачи из ревью и
|
||||
аудита»: своя нарезка, свой формат, свои правила дублей. Твоя обязанность — не
|
||||
потерять и передать.
|
||||
@@ -371,6 +383,12 @@ flowchart TD
|
||||
работу: `закрыта задача <slug>`. Это второй коммит осознанно: правило «одна задача
|
||||
— один осмысленный коммит» про работу, а учёт — не работа.
|
||||
|
||||
**Постановка пришла текстом — шага нет вовсе, и это не пропуск.** Записи не
|
||||
существовало, закрывать нечего, а следом работы служат коммит и заархивированный
|
||||
change. Заводить запись задним числом, чтобы её тут же закрыть, нельзя: учёт
|
||||
получил бы задачу, которой никто не ставил, и закрытие без единой минуты
|
||||
открытого состояния. Скажи это строкой и переходи к докладу.
|
||||
|
||||
Каталога задач в проекте нет — **ничего не выдумывай**: скажи в докладе, что
|
||||
учёт задач остаётся за владельцем, и назови исход.
|
||||
|
||||
@@ -383,7 +401,7 @@ flowchart TD
|
||||
- ссылка на архивный change и хеш коммита;
|
||||
- по каждому критерию приёмки, если они были: **оракул и наблюдаемый исход** —
|
||||
это доклад приёмщику, а не отметка «принято»;
|
||||
- **`Урожай`** — отложенные находки списком (формулировка, оракул, провенанс);
|
||||
- **`Урожай`** — отложенные находки списком (формулировка, оракул, откуда взялась);
|
||||
- **одна строка границ покрытия**: какая метка и режим гонялись, какие проходы не
|
||||
запускались и что проверить было невозможно. Доклад без неё сообщает
|
||||
«проверено», не сообщая, что именно.
|
||||
|
||||
@@ -337,8 +337,8 @@ charter'а, а модель потом двигает калибровка, и
|
||||
изменения нет двух разных «глубин проверки»: величина, из которой выводится
|
||||
состав, — одна и та же пара «размер × сложность», посчитанная один раз.
|
||||
|
||||
**Метка не меняет список тем — она меняет их дом и глубину.** Все шесть тем
|
||||
ядра названы при любой метке; разница в том, против чего их смотрят (дом темы
|
||||
**Метка не меняет список тем — она меняет их дом и глубину.** Все темы ядра
|
||||
названы при любой метке; разница в том, против чего их смотрят (дом темы
|
||||
или только инварианты) и как (чтением, рассуждением или запуском).
|
||||
|
||||
Ревью кода:
|
||||
@@ -1043,7 +1043,7 @@ flowchart TD
|
||||
останавливается: он урезает изменение до остатка и доводит его.
|
||||
- Находка не для этого мерджа, но реальная (отложенный `major`, развилка,
|
||||
решённая «потом»), — не теряется, но **и не заводится здесь**. Конвейер отдаёт
|
||||
её **списком урожая** в отчёте: формулировка, оракул, провенанс (какой проход,
|
||||
её **списком урожая** в отчёте: формулировка, оракул, откуда взялась (какой проход,
|
||||
какой change). Заведение задач принадлежит `av-dev:task-track` — зови его со
|
||||
списком урожая, у него на этот вход отдельный сценарий «задачи из ревью и
|
||||
аудита»: свой формат, кластеризация по причине, дедуп против беклога и
|
||||
|
||||
@@ -125,7 +125,7 @@
|
||||
|
||||
- **Читай в источнике, не по памяти.** Документы правятся по ходу работы, в том
|
||||
числе этой же задачей.
|
||||
- **Число без провенанса — условие, а не утверждение.** Число, чей источник по
|
||||
- **Число без происхождения — условие, а не утверждение.** Число, чей источник по
|
||||
ссылке не подтвердился, читается как условие и **называется расходящимся**, а
|
||||
не подменяется догадкой.
|
||||
- **Пустое, названное пустым, — это факт.** «Внешних зависимостей нет — смотри
|
||||
|
||||
@@ -1,6 +1,6 @@
|
||||
---
|
||||
name: doc-healthcheck
|
||||
description: "Проверка здоровья документации проекта судом, а не машиной: не разошлись ли документы между собой и с кодом. Зовёт двух агентов на весь канон разом — doc-consistency (один факт в двух домах, прямое противоречие, поведение в architecture.md вместо спек, ADR без парного статуса, число без провенанса) и doc-code-drift (протухший факт: имя ветки, команды, пути, зависимости поимённо, настройки с числом, единые точки, capability). Разбирает урожай порциями: строка на замену идёт в документ сразу, работа больше абзаца становится задачей. Использовать, когда с прошлой сверки сделан десяток задач, когда вернулись к проекту после перерыва, перед тем как опереться на документ в решении, а также шагом adopt и upgrade. Дорого — не на каждой задаче. Раскладку и версию раскладки проверяет скилл av-dev:canon, язык документов — агент doc-wording."
|
||||
description: "Проверка здоровья документации проекта судом, а не машиной: не разошлись ли документы между собой и с кодом. Зовёт двух агентов на весь канон разом — doc-consistency (один факт в двух домах, прямое противоречие, поведение в architecture.md вместо спек, ADR без парного статуса, число без происхождения) и doc-code-drift (протухший факт: имя ветки, команды, пути, зависимости поимённо, настройки с числом, единые точки, capability). Разбирает урожай порциями: строка на замену идёт в документ сразу, работа больше абзаца становится задачей. Использовать, когда с прошлой сверки сделан десяток задач, когда вернулись к проекту после перерыва, перед тем как опереться на документ в решении, а также шагом adopt и upgrade. Дорого — не на каждой задаче. Раскладку и версию раскладки проверяет скилл av-dev:canon, язык документов — агент doc-wording."
|
||||
---
|
||||
|
||||
# Здоровье документации
|
||||
@@ -89,7 +89,7 @@ check` и его скрипт; здесь начинается там, где к
|
||||
|
||||
| Агент | Что смотрит | Читает | Модель |
|
||||
| --- | --- | --- | --- |
|
||||
| `doc-consistency` | смысловой дубль, прямое противоречие между документами, поведение в `architecture.md` вместо спек, ADR без ссылки и парного статуса, число без провенанса, заглушка вместо честной строки | `docs/`, `openspec/` | `opus` |
|
||||
| `doc-consistency` | смысловой дубль, прямое противоречие между документами, поведение в `architecture.md` вместо спек, ADR без ссылки и парного статуса, число без происхождения, заглушка вместо честной строки | `docs/`, `openspec/` | `opus` |
|
||||
| `doc-code-drift` | протухший факт: имя ветки, команды, пути, зависимости поимённо, настройки с числом, единые точки проекта, capability | весь репозиторий | `sonnet` |
|
||||
|
||||
**`doc-code-drift` обязан получить раздел запретов `CLAUDE.md`.** Он гоняет
|
||||
|
||||
@@ -135,7 +135,7 @@ description: Вести содержимое документов канона
|
||||
## Запись в `research/`
|
||||
|
||||
Наблюдение о внешнем мире: что реально шлёт источник, чем документация формата
|
||||
расходится с практикой. **Требование провенанса и правило про расходящееся
|
||||
расходится с практикой. **Требование происхождения и правило про расходящееся
|
||||
число — в [каноне](../canon/references/canon.md), раздел `research/`.**
|
||||
|
||||
Твоя часть — заметить, что по ходу задачи узналось новое о внешних данных, и не
|
||||
|
||||
@@ -72,8 +72,8 @@ description: "Груминг беклога — интерактивный ра
|
||||
**Зовёт человек.** Скилл сам себя не назначает, но обязан **напоминать**, и
|
||||
признак наблюдаемый, а не календарный:
|
||||
|
||||
- в беклоге появились записи, которых человек ещё не видел (заведены интейком по
|
||||
ходу работы, урожаем ревью, разбором находок);
|
||||
- в беклоге появились записи, которых человек ещё не видел (заведены по ходу
|
||||
работы, урожаем ревью, разбором находок);
|
||||
- на верхних строках очереди есть задача с открытым вопросом — очередь
|
||||
показывает то, что взять нельзя;
|
||||
- `tasks.py check` печатает «готово к взятию: 0 из N» — брать сегодня нечего.
|
||||
|
||||
@@ -64,10 +64,10 @@
|
||||
решение>"`. Задача закрывается не только коммитом.
|
||||
3. **Проверь пересечения.** Две задачи об одном — содержимое в одну, вторую
|
||||
`close <slug> --reason "слита с <другой-слаг>"`. Смотри **шире порции**:
|
||||
интейк дедуплицирует новое против существующего, но никогда не пересматривает
|
||||
заведение сверяет новое против уже лежащего, но никогда не пересматривает
|
||||
уже лежащее, и две задачи с одной причиной могут лежать рядом месяцами.
|
||||
4. **Пере-кластеризуй по общей причине.** Несколько задач, оказавшихся симптомами
|
||||
одного дефекта, сливаются в одну — это находка, которую интейк дать не мог.
|
||||
одного дефекта, сливаются в одну — это находка, которую заведение дать не могло.
|
||||
5. **Гигиена полей** — протухшее «зачем», вопрос в прозе, снятый ответ, свойство
|
||||
репозитория в рамках, предписание процесса в теле, тип, разошедшийся с
|
||||
задачей, границы вместо реализации в разделе «Затрагивает». Список и правила —
|
||||
|
||||
@@ -724,7 +724,7 @@ python3 $tk adopt scan --from … --stage S | apply --plan … # разова
|
||||
- **Не больше трёх вопросов за раз.** Пачка длиннее трёх тяжела для ответа;
|
||||
решений больше — веди **несколько итераций** диалога по ≤3, а не один
|
||||
перегруженный запрос. Между итерациями применяй уже решённое.
|
||||
- **Границы покрытия в отчёте.** Любая сессия разбора, штурма или интейка
|
||||
- **Границы покрытия в отчёте.** Любая сессия разбора, штурма или заведения записей
|
||||
заканчивается строкой «просмотрено N из M, не трогали — …». Отчёт без неё
|
||||
сообщает «беклог разобран», не сообщая, какая его часть осталась нетронутой.
|
||||
- **Ничего не удаляем молча.** Файл исчезает только через `close` — `--reason`
|
||||
|
||||
@@ -18,7 +18,7 @@
|
||||
|
||||
1. **Сперва карта, потом файлы.** Человеку показывается, что найдено, в каком
|
||||
порядке разложилось и **что не разложилось**, — и только после подтверждения
|
||||
пишется хоть один файл. Это то же правило, что у интейка находок ревью:
|
||||
пишется хоть один файл. Это то же правило, что у заведения задач из ревью:
|
||||
массовое заведение записей без подтверждения — самый дорогой отказ, потому
|
||||
что разгребает его потом переоценка.
|
||||
2. **Ничего не терять.** Исходный текст переезжает в тело, «зачем» и причина
|
||||
|
||||
@@ -2,10 +2,13 @@
|
||||
|
||||
Ревью и аудиты — код-ревью, архитектурный проход, аудит безопасности, любой
|
||||
разбор другим агентом — порождают находки, часть которых становится задачами.
|
||||
Это отдельный интейк со своей опасностью, **зеркальной** интейку из диалога.
|
||||
Это отдельное **заведение записей** со своей опасностью, **зеркальной**
|
||||
заведению из диалога. Операция зовётся по источнику, потому что источник и
|
||||
задаёт опасность.
|
||||
|
||||
- Интейк из диалога грешит переполнением: из одной мысли рождается пять файлов.
|
||||
- Интейк из ревью грешит сваливанием: сорок сырых находок превращаются в сорок
|
||||
- Заведение из диалога грешит переполнением: из одной мысли рождается пять
|
||||
файлов.
|
||||
- Заведение из ревью грешит сваливанием: сорок сырых находок превращаются в сорок
|
||||
файлов. Беклог раздувается, а следующая переоценка склеивает их обратно.
|
||||
|
||||
Защита от сваливания — та же, что в самом ревью: **кластеризация по причине, а
|
||||
@@ -14,7 +17,7 @@
|
||||
|
||||
**Штатный отправитель — `av-dev:code-review`** (и `av-dev:code-resolve`, который
|
||||
его вызывает): задач он не заводит сам, а отдаёт отложенные находки **списком
|
||||
урожая** — формулировка, оракул, провенанс — и хранит отчёт триажа вместе с
|
||||
урожая** — формулировка, оракул, откуда взялась — и хранит отчёт триажа вместе с
|
||||
изменением. Приходит и любой другой разбор, вплоть до пересказа человеком; тогда
|
||||
триажа нет и шаг 1 порядка делается руками.
|
||||
|
||||
@@ -56,9 +59,9 @@
|
||||
«заказать или убрать». Выноси такую пользователю отдельно от прочих.
|
||||
5. **Покажи карту до создания файлов.** Кластер → задача / сырьё / строка в
|
||||
пакетный файл / уже заведено / отброшено — пачкой через
|
||||
`AskUserQuestion`. Это тот же барьер, что и «три кандидата» в интейке из
|
||||
диалога: массовое заведение файлов без подтверждения — ровно тот отказ, ради
|
||||
которого интейк из ревью и выделен. Дешёвая мелочь по явному согласию может
|
||||
`AskUserQuestion`. Это тот же барьер, что и «три кандидата» при заведении
|
||||
из диалога: массовое заведение файлов без подтверждения — ровно тот отказ,
|
||||
ради которого заведение из ревью и выделено. Дешёвая мелочь по явному согласию может
|
||||
заводиться и без поштучного вопроса — но карта пользователю предъявляется
|
||||
всё равно.
|
||||
6. **Заводи утверждённое** через `tasks.py add`, с тремя добавками:
|
||||
@@ -70,7 +73,7 @@
|
||||
`research`. Тип, розданный оптом, врёт ровно там, где по нему потом
|
||||
отбирают, **и требует не тех разделов**: каждому `fix` придётся заполнить
|
||||
`Воспроизведение`, а у находки без свидетельства его нет;
|
||||
- **провенанс в теле** — кто нашёл, каким проходом, с каким свидетельством.
|
||||
- **откуда взялась — в теле**: кто нашёл, каким проходом, с каким свидетельством.
|
||||
Без него через месяц не отличить проверенную находку от догадки.
|
||||
7. `tasks.py check`.
|
||||
|
||||
@@ -79,7 +82,7 @@
|
||||
Уровня серьёзности в записи нет — но **выкидывать её нельзя**: серьёзность
|
||||
отображается **в позицию в очереди**, потому что приоритет и есть порядок строк
|
||||
в беклоге (правило 4 [SKILL.md](../SKILL.md)). Отображается через довод, а не
|
||||
напрямую: своей шкалы у интейка нет, доводы расстановки перечислены в
|
||||
напрямую: своей шкалы у заведения нет, доводы расстановки перечислены в
|
||||
[скилле груминга](../../task-groom/SKILL.md#приоритет-как-его-расставляют), и
|
||||
серьёзность попадает ровно в один из них.
|
||||
|
||||
@@ -103,7 +106,7 @@
|
||||
(`--reason`). Позицию назначит человек на ближайшем груминге, сравнив её с
|
||||
верхом очереди; без записанного довода сравнивать он будет с нуля;
|
||||
- **находка, которая не ждёт груминга вовсе** (необратимый ущерб, покраснела
|
||||
проверка, которую проект назвал сломанным), — не интейк: это работа прямо
|
||||
проверка, которую проект назвал сломанным), — не заведение записи: это работа прямо
|
||||
сейчас, а в беклог она падает, только если ждать всё-таки можно;
|
||||
- **низкая уверенность или нет свидетельства** → сырьё (`research` с пустым
|
||||
разделом «Вопрос»): его место в очереди производно от типа — конец секции;
|
||||
@@ -115,7 +118,7 @@
|
||||
|
||||
## Поимённая сверка
|
||||
|
||||
Интейк считается выполненным, только если **каждая** находка триажа получила
|
||||
Заведение считается выполненным, только если **каждая** находка триажа получила
|
||||
исход: слаг заведённой задачи, ссылку на существующую, строку пакетного файла
|
||||
или запись «не заведена: причина». Нулевой урожай при непустом отчёте триажа
|
||||
виден сразу — и это единственный способ отличить «находок не было» от «не стал
|
||||
|
||||
@@ -33,8 +33,8 @@
|
||||
**Шов — там, где падает метка ревью.** Раздел «Затрагивает» перечисляет
|
||||
границы; если одна строка перечня поднимает метку выше остальных, эта часть и
|
||||
режется отдельно. Пример: задача перекладывает несколько узлов разом и заодно
|
||||
добавляет два поля в существующий ответ. Целиком это `large` — семь проходов по
|
||||
всему диффу, включая два, что держат машину и идут цепочкой. Разрезанная по шву,
|
||||
добавляет два поля в существующий ответ. Целиком это `large` — полный состав проходов по
|
||||
всему диффу, включая те, что держат машину и идут цепочкой. Разрезанная по шву,
|
||||
она даёт `large` на маленькой переложенной части и `medium` на остатке.
|
||||
|
||||
**Считай костяк, а не файлы.** У каждой задачи есть несокращаемые четыре прохода
|
||||
|
||||
@@ -64,7 +64,7 @@
|
||||
3. **Ограничить рамками**, если разведка может утечь: сколько времени, какие
|
||||
источники, что заведомо вне.
|
||||
4. **Провести разведку** и **записать ответ по названному адресу**. Числа — с
|
||||
провенансом: с командой или условиями, которыми получены. Число без источника
|
||||
происхождением: с командой или условиями, которыми получены. Число без источника
|
||||
проход ревью обязан читать как условие, а не как замер. Проводит её конвейер
|
||||
проекта — скилл `av-dev:code-resolve`, сценарий разведки; этот скилл её
|
||||
только заводит и закрывает.
|
||||
|
||||
@@ -0,0 +1,93 @@
|
||||
# 68. Постановка текстом — вторая полноправная форма входа (2026-08-13)
|
||||
|
||||
## Что было
|
||||
|
||||
`code-resolve` объявлял вход широким: «путь к файлу, имя файла, слаг или просто
|
||||
текст». Дальше текст жил на правах исключения. Разведка своё исключение
|
||||
проработала — вопрос формулируется самим скиллом, адрес ответа назначается им
|
||||
же, и оба показываются в первой реплике. У решения и обслуживания не было
|
||||
ничего: шаг «прочитать задачу» читал разделы записи, шаг закрытия закрывал
|
||||
запись, признак обслуживания опирался на тип, объявленный автором записи, а
|
||||
критерии приёмки приходили «от проекта». Что со всем этим делать, когда записи
|
||||
нет, не говорилось нигде, кроме одной строки про непрогнанный `ready`.
|
||||
|
||||
Владелец назвал случай: задачу часто нужно решить прямо по описанию в разговоре,
|
||||
без файла в каталоге, — так же, как её берёт `opsx:propose`, которому размеченная
|
||||
запись тоже не нужна.
|
||||
|
||||
## Решено
|
||||
|
||||
**Р245. Форм постановки две, и они равноправны: запись каталога и текст.** Это
|
||||
ось, а не оговорка о вырожденном случае: по ней ветвятся три вещи в трёх местах
|
||||
скилла. Дом перечня осей — `av-dev/shared/axes.md`, и строка там заведена вместе
|
||||
с этим решением.
|
||||
|
||||
**Р246. Форма постановки не влияет ни на сценарий, ни на метку, ни на глубину.**
|
||||
Развилка «есть ли очевидный способ» и «меняется ли спека» у обеих форм общая,
|
||||
текстом идут все три сценария. Иначе текст стал бы четвёртым сценарием — коротким
|
||||
путём, выбираемым по форме вызова, то есть ровно той лазейкой, против которой
|
||||
написан весь [Р223](63-maintenance-third-scenario.md).
|
||||
|
||||
**Р247. Отпадают ровно те шаги, у которых пропал предмет.** `ready` гонять
|
||||
нечего — записи нет; закрывать нечего — записи нет. Ни один шаг, у которого
|
||||
предмет остался, не выпадает: гейт, ревью, синк, коммит и чекпоинт идут как
|
||||
обычно. Тот же приём, которым сложено обслуживание ([Р222](63-maintenance-third-scenario.md)
|
||||
и соседи): шаг без предмета выпадает, шаг с предметом — никогда.
|
||||
|
||||
**Р248. Запись задним числом не заводится.** Ни перед работой, ни ради того,
|
||||
чтобы было что закрыть. Учёт получил бы задачу, которой никто не ставил, и
|
||||
закрытие без единой минуты открытого состояния; граница «скилл беклогом не
|
||||
владеет» действует и здесь. Работа не уместилась в прогон или должна пережить
|
||||
разговор — скилл говорит это строкой и предлагает `av-dev:task-track`.
|
||||
|
||||
**Р249. Понимание постановки показывается первой репликой.** Рядом с названным
|
||||
сценарием, одной-двумя фразами: что считается предметом работы и где проходит
|
||||
граница. Запись толкуется по разделам, текст — молча, и расходится он с замыслом
|
||||
там, где его никто не показал. Обоснование то же, что у названного вслух
|
||||
сценария: поправка стоит одной фразы, пока работа не пошла.
|
||||
|
||||
**Р250. Тип у текстовой постановки называет исполнитель, и это делает его
|
||||
признаком только вслух и только до работы.** Связка обслуживания стоит на двух
|
||||
источниках — тип от автора, отсутствие дельт от исполнителя ([Р222](63-maintenance-third-scenario.md)),
|
||||
— а текст типа не несёт, и оба признака оказываются в одних руках. Разведённость
|
||||
восстанавливается **местом**: тип и предмет объявляются до первой правки, когда
|
||||
автор текста ещё в разговоре и опровергает их одной фразой. Названный после
|
||||
работы тип — не признак, а объяснение уже сделанного: готовый дифф всегда
|
||||
подтверждает тот тип, под который писался.
|
||||
|
||||
**Р251. Критерии приёмки исполнитель по-прежнему себе не проставляет, но у
|
||||
решения появилось место их предложить.** Чекпоинт: предложенные там критерии
|
||||
человек подтверждает или правит, и данными они становятся только после ответа. У
|
||||
обслуживания такого места нет — чекпоинта нет вовсе, — и там отсутствие критериев
|
||||
называется строкой доклада: приёмка идёт по докладу. Правило «критерии приходят
|
||||
снаружи» не ослаблено ни там, ни там; ослаблением было бы молчаливое сочинение
|
||||
себе оракулов.
|
||||
|
||||
**Р252. У обслуживания вместе с критериями текст не даёт и границ**, а раздел
|
||||
«Затрагивает» у него не украшение: границы обслуживания лежат не в коде — конфиг,
|
||||
версия зависимости, команда сборки, файл CI. Поэтому границы называются в той же
|
||||
первой реплике, что и тип. Невидимая граница расползание не удержит, а
|
||||
обслуживание расползается чаще прочих сценариев.
|
||||
|
||||
## Следствия
|
||||
|
||||
**С237. Стоп «нашлась дельта» получил третий вариант ответа — и не получил
|
||||
третьего решения.** Решений по-прежнему два ([Р226](63-maintenance-third-scenario.md)),
|
||||
но «переформулировать запись» у текстовой постановки переформулировывать нечего:
|
||||
человек либо запускает следующий прогон тем же текстом, и тот пойдёт решением,
|
||||
либо заводит запись через `av-dev:task-track`. Выбор между этими двумя — его, не
|
||||
исполнителя, потому что заводить запись скилл не вправе — Р248 выше.
|
||||
|
||||
**С238. Похожая запись в беклоге не разыскивается.** Человек назвал работу
|
||||
текстом — предмет прогона этот текст, а не строка индекса, которая на него
|
||||
похожа. Замеченная по ходу называется строкой доклада и не закрывается:
|
||||
закрытие — это приёмка, и поручали её не исполнителю.
|
||||
|
||||
**С239. У разведки отсутствие записи безопаснее, чем кажется, но ровно по одной
|
||||
причине.** Её след — не код, а записанный по названному адресу ответ, и он уезжает
|
||||
в коммит. Если ответ записать было некуда и он остался в докладе, от прогона не
|
||||
осталось ничего — и это говорится прямо, а не строкой среди прочих.
|
||||
|
||||
**С240. Доклад называет форму постановки.** Пришла текстом — сказано, как она
|
||||
понята, что `ready` не гонялся и что закрывать было нечего. Иначе пропуск двух
|
||||
шагов неотличим от их молчаливого обхода на задаче, у которой запись была.
|
||||
@@ -0,0 +1,68 @@
|
||||
# 69. Счёт корпуса в прозе не пишется (2026-08-13)
|
||||
|
||||
## Что было
|
||||
|
||||
Правила языка судили слово и фразу: залог, оценку без факта, стоп-слова,
|
||||
англицизм, жаргон, неизвестный термин, транслит в имени. Числа среди них не
|
||||
было, и текст свободно писал «пять ревью», «три capability», «десять
|
||||
проходов» — фразу, которая читается как сведение, а живёт ровно до ближайшего
|
||||
пополнения корпуса.
|
||||
|
||||
Расхождение это молчаливое вдвойне. Устаревшее число остаётся грамматически
|
||||
исправным и правдоподобным, диффом не ловится (правят не эту строку, а
|
||||
корпус), а проверяется только пересчётом, которого никто не делает.
|
||||
|
||||
Репозиторий плагина показал это на себе: таблица блоков в `language.md`
|
||||
объявляла «девять правил» — и это же решение сделало их десять. Так же жили
|
||||
«десять агентов-проходов» и «девять скиллов» в README, «восемь скриптов» в
|
||||
перечне осей, «шесть тем ядра» в сценарии решения, «семь проходов» в правилах
|
||||
нарезки.
|
||||
|
||||
## Решено
|
||||
|
||||
**Р253. Счёт корпуса — правило 10 языка проектных текстов.** Число, называющее
|
||||
размер корпуса, в прозе не пишется. Корпус — то, что пополняется: документы,
|
||||
capability, ревью, проходы, скиллы, записи журнала, эндпоинты, миграции.
|
||||
|
||||
**Р254. Законных способов сослаться два, и оба не стареют.** На **конкретную
|
||||
запись** — именем, слагом, датой — или на **корпус целиком**. Величина, когда
|
||||
она нужна, снимается с самого корпуса в момент чтения: каталог, индекс,
|
||||
команда отвечают на «сколько сейчас», а абзац это число только запоминает.
|
||||
|
||||
**Р255. Число, стоящее заголовком к перечню, приведённому тут же, правилом не
|
||||
задето.** «Три исхода:» с тремя пунктами под ним — не ссылка на корпус:
|
||||
расходится оно не втихую, а вместе со списком, который правят в той же строке.
|
||||
Отсюда и обязанность при переезде: уехал перечень в другой файл — число уезжает
|
||||
с ним, а на его месте остаётся ссылка. Без этой оговорки правило запретило бы
|
||||
форму, которой держится половина процессных текстов, и потому не исполнялось бы
|
||||
вовсе.
|
||||
|
||||
**Р256. Замер с провенансом счётом корпуса не считается.** «Прозаический триггер
|
||||
дал 6 записей ADR на 43 изменения» описывает прошлое, а прошлое не
|
||||
пополняется — это факт по правилу 2, и трогать его нельзя. Разделяет их
|
||||
проверяемый вопрос: **изменится ли число само, без правки текста**.
|
||||
|
||||
**Р257. Дом правила — `shared/language.md`, а не канон.** Судит его вычитка,
|
||||
пофразно, вместе с прочими правилами языка, и уезжает оно теми же помеченными
|
||||
копиями в уставы `doc-wording` и `task-wording`. В `canon.md`, рядом с картой
|
||||
домов, стоит ссылка: счёт корпуса — тоже факт с домом, но выглядит он не копией,
|
||||
а собственным наблюдением документа, и потому его там называют отдельно.
|
||||
|
||||
## Следствия
|
||||
|
||||
**С241. Пересчитывать корпус вычитке не надо.** Находка — в самом числе, а не в
|
||||
том, что оно разошлось; число, верное сегодня, — та же находка, потому что
|
||||
разойдётся завтра и молча. Это делает правило машинно дешёвым: проверяется
|
||||
фраза, а не корпус.
|
||||
|
||||
**С242. У каждого прохода вычитки названо своё частое место.** У документов —
|
||||
`architecture.md` и `review.md`, где пересказывают журнал; у записей — раздел
|
||||
«Затрагивает» и критерии приёмки. Критерий, сверяемый по числу, опаснее прочего:
|
||||
он пройдёт на другом составе работ.
|
||||
|
||||
**С243. Собственная проза репозитория приведена к правилу.** Счёт корпуса снят в
|
||||
README, перечне осей, `language.md`, сценарии решения, конвейере ревью и правилах
|
||||
нарезки. Сами темы журнала не правятся: они описывают прошлые состояния, и число
|
||||
в них — часть записанного тогда факта. Правится только указатель журнала, где
|
||||
перечисление занятых номеров сменилось называнием схемы: диапазон `Р1–Р252`
|
||||
устаревал на каждой теме и требовал правки в файле, которого тема не касается.
|
||||
@@ -0,0 +1,51 @@
|
||||
# 70. «Провенанс» снят из словаря: одного синонима мало для проверки (2026-08-13)
|
||||
|
||||
## Что было
|
||||
|
||||
Слово стояло в закрытом списке своих терминов правила 6 — там, где слова **не
|
||||
трогают**, — с оговоркой: «„источник“ рядом называет саму запись, а не
|
||||
свойство». Оговорка верна: в ADR «источник» это архивный `design.md` либо
|
||||
записка разведки, и занимать его вторым смыслом нельзя.
|
||||
|
||||
Доказывала она, однако, только одно — что не годится **одно** конкретное русское
|
||||
слово. Из этого был сделан вывод про все, и латинизм прожил в словаре до дня,
|
||||
когда его перечитали: к тому моменту он стоял в живой прозе плагина сорок раз.
|
||||
|
||||
## Решено
|
||||
|
||||
**Р258. «Провенанс» заменяется русским и уходит в список снятого** — туда же, где
|
||||
уже лежат конфляция, декорреляция, непоймание, эвал-сет, гайд и опиниативный.
|
||||
|
||||
**Р259. Слов на замену два, потому что смысла было два.** У числа —
|
||||
**происхождение**: чем и при каких условиях получено (`research/`, замеры
|
||||
разведки, числа в документах). У вопроса и находки — **откуда**: кто нашёл, каким
|
||||
проходом, из какой записи журнала (урожай ревью, вопросы по темам в `review.*`).
|
||||
Именно эта двусмысленность и держала латинизм: слово, накрывавшее оба смысла,
|
||||
выглядело незаменимым, а по-русски они называются разными словами и потому
|
||||
разъезжаются.
|
||||
|
||||
**Р260. Прецедент для закрытого словаря: латинизм, переживший проверку одним
|
||||
синонимом, — не имя вещи, а непроверенная привычка.** Запись в словаре обязана
|
||||
объяснять, чем слово незаменимо, а не чем плох один из кандидатов. Правило 6
|
||||
охраняет термины от вкусовой правки, и цена этой охраны — что негодная запись в
|
||||
нём живёт до тех пор, пока её не перечитают целиком.
|
||||
|
||||
## Следствия
|
||||
|
||||
**С244. Раскладка повысилась до версии 4.** Слово стояло не только в прозе
|
||||
плагина, но и в скелете `docs/review.md`, а тот уезжает в репозиторий проекта:
|
||||
форма вопроса записана как `<тема>: <вопрос> (<откуда>)`. Запись журнала версий
|
||||
называет оба шага — правку формы и проход `grep` по `docs/`. Повышение из-за
|
||||
одного слова выглядит дорого ровно до вопроса «а как иначе», ответ на который —
|
||||
«канон предписывает писать слово, запрещённое языком».
|
||||
|
||||
**С245. Живая проза плагина вычищена целиком, журналы — нет.** Употребления
|
||||
заменены по смыслу: «число без происхождения», «замер с происхождением»,
|
||||
«формулировка, оракул, откуда взялась». Журнал решений и журналы
|
||||
версий канона остались как были: они описывают прошлые состояния, и слово,
|
||||
верное на день записи, там свидетельство, а не употребление.
|
||||
|
||||
**С246. Описания агентов правились вместе с телом.** `doc-consistency` и
|
||||
`doc-healthcheck` называют «число без происхождения» в самих описаниях — по ним
|
||||
скилл выбирают, и отставшее описание уводит в сторону раньше, чем кто-нибудь
|
||||
дочитает до тела.
|
||||
@@ -0,0 +1,56 @@
|
||||
# 71. Образец языка назван прямо; «интейк» снят вслед за «провенансом» (2026-08-13)
|
||||
|
||||
## Что было
|
||||
|
||||
Документ языка объяснял, откуда взяты правила (информационный стиль, взятый не
|
||||
целиком) и зачем они здесь (проектный текст читают, выбирая задачу и возвращаясь
|
||||
через квартал). Чего в нём не было — **образца**: на что должен быть похож
|
||||
готовый текст. Без образца правила читаются как список запретов, а запреты
|
||||
исполняют буквально и не переносят на случай, которого в списке нет.
|
||||
|
||||
Заодно в закрытом словаре правила 6 обнаружился второй латинизм с той же
|
||||
защитой, что и у снятого днём раньше «провенанса»: **интейк** стоял там с
|
||||
оговоркой «„заведение“ называет создание файла, а не отбор с дедупом».
|
||||
|
||||
## Решено
|
||||
|
||||
**Р261. Образец — научно-популярная книга.** Не спецификация, не статья в блоге,
|
||||
не конспект для себя: текст, который объясняет устройство точными простыми
|
||||
словами и понятен с первого прохода тому, кто эту систему не писал. Образец
|
||||
записан в `shared/language.md` отдельным разделом, перед правилами.
|
||||
|
||||
**Р262. Из образца выведены три умолчания, и все три про плотность.** Воды нет —
|
||||
абзац, из которого нечего достать, вычёркивается целиком, а не переписывается.
|
||||
Сложных конструкций нет — фразу, которую надо разбирать дважды, второй раз не
|
||||
разбирают. **Англицизм — исключение, требующее причины**, и это умолчание
|
||||
обратное принятому в разработке: пишем по-русски, иностранное слово остаётся
|
||||
только как имя вещи или там, где русский аналог искажает смысл.
|
||||
|
||||
**Р263. Образец находок не порождает.** Он для того, кто пишет; вычитка судит по
|
||||
правилам, и порог правки не тронут. Иначе «мне кажется, звучит сложно» стало бы
|
||||
находкой, а список замечаний, наполовину вкусовой, перестают читать целиком —
|
||||
вместе с настоящими находками.
|
||||
|
||||
**Р264. «Интейк» снят; операция зовётся заведением с названным источником** —
|
||||
«заведение из диалога», «заведение из ревью». Оговорка защищала слово от
|
||||
**голого** «заведения», и в этом была права; но в паре с источником
|
||||
двусмысленности нет, а сам скилл задач уже называет операцию так же — «Завести
|
||||
запись из диалога».
|
||||
|
||||
## Следствия
|
||||
|
||||
**С247. У записи в словаре появилось требование.** Она обязана говорить, чем
|
||||
слово незаменимо, а не чем плох один из кандидатов: оговорка, отвергающая один
|
||||
русский вариант, доказывает только про него. Оба снятых слова держались ровно на
|
||||
такой оговорке — [тема 70](70-provenance-word-removed.md) и Р264 здесь.
|
||||
|
||||
**С248. Остальной словарь не пересматривался, и это сказано прямо.** В правиле 6
|
||||
остались триаж, дедуп, чек-лист, дифф, промпт, чекпоинт, синк, имена вещей
|
||||
OpenSpec и роды проходов ревью. Каждое из них по новому требованию придётся
|
||||
защищать заново — но не задним числом и не молча: пересмотр словаря это своя
|
||||
работа, и делать её попутно значит менять язык всего корпуса без разбора.
|
||||
|
||||
**С249. Раскладка не повышалась.** «Интейк» жил только в прозе плагина —
|
||||
в скилле задач, в груминге и в правилах разбора находок, — и в скелеты, уезжающие
|
||||
в репозитории проектов, не попадал. Тем и отличается от «провенанса», который
|
||||
стоил версии 4.
|
||||
+6
-2
@@ -6,8 +6,8 @@
|
||||
Три сквозные нумерации, и они не пересекаются:
|
||||
|
||||
- **Т** — требование: вход, который обязан быть удовлетворён. Живут здесь, ниже.
|
||||
- **Р** — решение: что согласовано и почему. Р1–Р244 по темам в порядке журнала.
|
||||
- **С** — следствие: что из решения вытекает. С1–С236, тоже сквозным счётом.
|
||||
- **Р** — решение: что согласовано и почему. По темам в порядке журнала.
|
||||
- **С** — следствие: что из решения вытекает.
|
||||
|
||||
Номер закреплён за записью навсегда: журнал описывает прошлые состояния и задним
|
||||
числом не переписывается. Отсюда и разнобой формы — ранние темы держат решения
|
||||
@@ -119,3 +119,7 @@
|
||||
| 65 | [Перечень осей получил дом; две оси жили без владельца](65-axes-registry-home.md) | 2026-08-13 |
|
||||
| 66 | [`doc-canon` → `canon`: скилл формы вышел из семейства документов](66-canon-without-prefix.md) | 2026-08-13 |
|
||||
| 67 | [Цель упразднена, у проекта появилась стадия](67-goal-removed-project-stages.md) | 2026-08-13 |
|
||||
| 68 | [Постановка текстом — вторая полноправная форма входа](68-task-from-plain-text.md) | 2026-08-13 |
|
||||
| 69 | [Счёт корпуса в прозе не пишется](69-corpus-count-not-written.md) | 2026-08-13 |
|
||||
| 70 | [«Провенанс» снят из словаря: одного синонима мало для проверки](70-provenance-word-removed.md) | 2026-08-13 |
|
||||
| 71 | [Образец языка назван прямо; «интейк» снят вслед за «провенансом»](71-language-model-popular-science.md) | 2026-08-13 |
|
||||
|
||||
Reference in New Issue
Block a user