граница: правило стало про раскладку проекта, а не про соседний плагин
Дом shared/plugin-boundary.md переехал в shared/absence.md: отсутствовала всё это время не установка плагина, а часть раскладки проекта, и узнавалась она следом на диске. Перечень внешнего сократился до двух — opsx и av-dev-git. Ветки «плагина нет» переписаны на «этой части в проекте нет»; там, где ветка существовала только ради неразрешимого пути в чужое дерево, она снята вовсе. Внутриплагинные копии языка и словаря сопровождения сняты: два справочника по 213 строк и один по 34 заменены ссылкой на общий дом. Копии остались там, где текст обязан лежать внутри промпта, — в уставах вычитки. Заодно починены пути $CLAUDE_PLUGIN_ROOT и относительные ссылки, разъехавшиеся с новыми именами каталогов.
This commit is contained in:
+10
-12
@@ -1,26 +1,26 @@
|
||||
# Язык проектных текстов
|
||||
|
||||
**Это дом.** Файл не входит ни в один плагин: язык общий для документов канона и
|
||||
для задач, и хранить его внутри одного из них значило бы отдать общее правило во
|
||||
владение половине. Плагины везут **копии**, помеченные разметкой `copies.py`, и
|
||||
расхождение ловит гейт коммита, а не внимание.
|
||||
**Это дом.** Файл не принадлежит ни одному скиллу: язык общий для документов
|
||||
канона, для задач и для решений ADR, и хранить его внутри одного из них значило
|
||||
бы отдать общее правило во владение части. Скиллы читают **этот файл** по
|
||||
ссылке; дословные **копии**, помеченные разметкой `copies.py`, уезжают только в
|
||||
charter'ы вычитки — там текст обязан лежать внутри самого промпта, потому что
|
||||
именно он и есть критерий суждения. Расхождение ловит гейт коммита, а не
|
||||
внимание.
|
||||
|
||||
Правится **здесь**. Копия, поправленная у себя, — расхождение, а не правка.
|
||||
|
||||
Три блока, и делятся они по потребителю, а не по теме:
|
||||
Два блока копируются, и делятся они по потребителю, а не по теме:
|
||||
|
||||
| Блок | Что в нём | Кто копирует |
|
||||
| --- | --- | --- |
|
||||
| `язык-доктрина` | зачем стиль нужен, что взято сверх устава, что отброшено | справочник языка в плагине |
|
||||
| `язык-правила` | девять правил, по которым судят текст | справочник и уставы вычитки |
|
||||
| `порог-правки` | когда находка не заводится | справочник, уставы вычитки, `task-form` |
|
||||
| `язык-правила` | девять правил, по которым судят текст | уставы вычитки |
|
||||
| `порог-правки` | когда находка не заводится | уставы вычитки, `task-form` |
|
||||
|
||||
`порог-правки` вынесен из правил намеренно: он нужен и тому, кто правил языка не
|
||||
проверяет вовсе, — а вложенных блоков разметка не знает, и внутри `язык-правила`
|
||||
его было бы не забрать отдельно.
|
||||
|
||||
<!-- дом: язык-доктрина -->
|
||||
|
||||
Правила — для всего, что пишется словами: задачи и цели, документы канона,
|
||||
решения ADR, записки разведки, сообщения коммитов. Не для кода и не для
|
||||
сообщений программы пользователю — там свои конвенции проекта.
|
||||
@@ -81,8 +81,6 @@
|
||||
значит называть состояние и остаток, а не пересказывать, как было интересно
|
||||
разбираться.
|
||||
|
||||
<!-- /дом: язык-доктрина -->
|
||||
|
||||
## Правила
|
||||
|
||||
<!-- дом: язык-правила -->
|
||||
|
||||
Reference in New Issue
Block a user