манифест набора переименован в .conventions-suite.toml
- оба манифеста теперь данные инструмента: он их читает и переписывает целиком, комментариев они не держат — точка в начале ставит их рядом со служебными файлами, а не среди содержимого репозитория - прежнее основание из TOOL.md («в наборе файл правится при каждой новой теме, и прятать его незачем») отпало: правит его convy - ссылки в README.md, CLAUDE.md, TOOL.md и TODO.md обновлены
This commit is contained in:
@@ -46,10 +46,16 @@ javascript — никогда). Уровнем CLI компонент не ст
|
||||
репозитория, а не про уровень.
|
||||
|
||||
Манифесты названы по тому, что описывают, а не по уровню ради симметрии:
|
||||
`suite.toml` в наборе — идентичность набора, `.conventions.toml` в проекте —
|
||||
подключённые конвенции. Точка в проекте отделяет служебное от содержимого
|
||||
проекта; в наборе файл правится при каждой новой теме, и прятать его незачем.
|
||||
Отсюда же бесплатное определение контекста: по имени рядом видно, где ты.
|
||||
`.conventions-suite.toml` в наборе — идентичность набора, `.conventions.toml`
|
||||
в проекте — подключённые конвенции. Оба начинаются с точки, потому что оба —
|
||||
данные инструмента, а не документы репозитория: они читаются и **переписываются
|
||||
целиком** командами, комментариев не держат, и объяснения к ним живут в
|
||||
соседних файлах. Отсюда же бесплатное определение контекста: по имени рядом
|
||||
видно, где ты.
|
||||
|
||||
Прежде манифест набора назывался `suite.toml` и точки не имел — на том
|
||||
основании, что правится он руками при каждой новой теме. Основание отпало:
|
||||
правит его инструмент.
|
||||
|
||||
## Раскладка команд
|
||||
|
||||
@@ -80,8 +86,9 @@ convy suite new новая тема: шапка, префикс, запис
|
||||
Три следствия для реализации:
|
||||
|
||||
- **контекст определяется и отказ говорится явно.** `.conventions.toml` рядом
|
||||
— проект, `suite.toml` — набор. Проектная команда, набранная в наборе, не
|
||||
делает ничего наугад: она отказывает и подсказывает наборный аналог;
|
||||
— проект, `.conventions-suite.toml` — набор. Проектная команда, набранная в
|
||||
наборе, не делает ничего наугад: она отказывает и подсказывает наборный
|
||||
аналог;
|
||||
- **помощь группируется заголовками** «В проекте» и «В наборе»: в плоском
|
||||
списке уровни не видны;
|
||||
- **синонимов нет.** `convy project pull` рядом с `convy pull` не заводим: два
|
||||
|
||||
Reference in New Issue
Block a user