av/dev-conventions
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity

манифест приведён к машинному виду, объявлен governance

Browse Source 
- добавлен ключ governance: без него конвенция, потерявшая topic, была
  неотличима от GUIDE.md и тихо теряла проверки об отъезде к потребителю
- комментарии из манифеста убраны — их всё равно съела бы первая же
  команда; то, чего не было в README.md, дописано туда
This commit is contained in:
av
2026-07-28 10:16:39 +03:00
parent 34d53d667d
commit 271603122d
2 changed files with 23 additions and 100 deletions
Download Patch File Download Diff File Expand all files Collapse all files
README.md
+9 -3
View File
@@ -163,11 +163,17 @@ prefix: KEYS
```
Четыре заглавные латинские буквы, уникальные по всему канону; перечислены в
манифесте набора, секция `[prefixes.live]`. Префикс выбирается под файл, а не
выводится по формуле, и не переиспользуется никогда. Правила адресуются
идентификатором `KEYS-5` — без пути к файлу. Подробности формы —
манифесте набора, секция `[prefixes.live]`, путём **от корня репозитория**, а
не от `conventions/` — манифест покрывает и обвязку тоже. Префикс выбирается
под файл, а не выводится по формуле, и не переиспользуется никогда. Правила
адресуются идентификатором `KEYS-5` — без пути к файлу. Подробности формы —
`LANGUAGE.md`.
`GUIDE.md` тоже несёт префикс и тоже проверяется как конвенция: правила в нём
записаны тем же языком и цитируются по номерам. Темы у него нет — подписаться
на него нельзя, к потребителю он не едет, — и манифест называет его отдельным
ключом `governance`, чтобы конвенция, потерявшая `topic`, не сошла за него.
Буква `X` в начале префикса зарезервирована за репозиториями: канон её не
занимает никогда, а локальные правила потребителя берут префиксы только на
неё (`XTIM`, `XLOG`). Так столкновение локального префикса с будущим