av
dff05ad097
- каталог скилла и все вызовы переименованы: префикс `doc-` называл материал, а скилл занят формой — раскладкой всех частей проекта и общим повышением версии, включая каталог задач; - README перестроен: `canon` вынесен из семейства документов отдельным блоком и отдельным узлом графа, правило префиксов переформулировано, у документов уточнено владение — содержимым, а не раскладкой; - заведена запись 2 журнала версий: в проекте ничего не переехало, но путь к `docs.py` и имя вызова живут в гейте и в `CLAUDE.md` проекта и сломаются молча; - прежние адреса в записи 1 и в журнале решений оставлены как есть: журнал описывает состояния, которые были, и задним числом не переписывается.
3.0 KiB
Сопровождение и эксплуатация
Это дом. Словарь «чем держат проект» назван в трёх местах трёх разных
скиллов: секция Сопровождение в роадмапе (task-track), раздел «Эксплуатация»
в architecture.md (canon) и тема ревью operations (code-review). Ни
один из трёх им не владеет, поэтому дом стоит в shared/.
Три перечня «чем держат проект» уже разъезжались — на «метриках и логах» против «мониторинга», — и разъехались молча. Пока скиллы жили тремя плагинами, отсюда уезжали дословные копии: путь в чужое дерево не разрешался. Теперь дерево одно — кому словарь нужен, тот открывает этот файл, и сверять машиной больше нечего.
Одна тема живёт в трёх местах, и путать их слова нельзя.
Сопровождение — всё, чем держат проект: инструмент и сборка, процесс, выкладка, метрики и логи, инфраструктура, дежурство. Эксплуатация — его часть: работа системы на проде. Целое и часть, и никогда наоборот.
| Место | Уровень | Что там |
|---|---|---|
ROADMAP.md, секция Сопровождение |
план | работы, которые собираемся делать: цели и их задачи |
architecture.md, раздел «Эксплуатация» |
состояние | как устроено сейчас: где работает, что рядом, кто перезапускает |
тема ревью operations |
оптика | чем проверяем: «это упало через неделю на проде» |
Слово «поддержка» не употребляется вовсе — в нём слышится помощь пользователю, а это другая работа.
Граница с возможностями проходит по тому, кто наблюдает. «Приложение сообщает о своём состоянии» — возможность приложения, её место среди прочих целей: наблюдает пользователь сервиса. «Дежурный видит состояние на одном экране» — сопровождение: наблюдаем мы. Одни и те же метрики попадают в разные секции роадмапа, и это верно — секции отвечают на разные вопросы.