Тип goal и индекс ROADMAP.md убраны: цель — зонтик над параллельными направлениями, а у проекта на одного человека список работ линеен. Роадмап при этом наполовину дублировал беклог, а «что уже умеет» отвечают спеки и git log индекса. Секция «Готово» удалена, а не перенесена. Вместо цели — ось «стадия проекта»: build (беклог это план стройки, порядок строк значит зависимость, секция одна) и support (очередь правок, порядок значит важность, секции — полки домена). Стадия объявляется ключом [tasks] stage, меняется командой stage, без неё check отказывает: порядок строк нечем прочитать. Ушли теги goal:/decomposed, поле «Секция», раздел «Завершение», флаги --goal и edit --section. Версия раскладки 2 → 3, перевод проекта расписан записью журнала.
3.1 KiB
Сопровождение и эксплуатация
Это дом. Словарь «чем держат проект» назван в трёх местах трёх разных
скиллов: задачи типа chore (task-track), раздел «Эксплуатация»
в architecture.md (canon) и тема ревью operations (code-review). Ни
один из трёх им не владеет, поэтому дом стоит в shared/.
Три перечня «чем держат проект» уже разъезжались — на «метриках и логах» против «мониторинга», — и разъехались молча. Пока скиллы жили тремя плагинами, отсюда уезжали дословные копии: путь в чужое дерево не разрешался. Теперь дерево одно — кому словарь нужен, тот открывает этот файл, и сверять машиной больше нечего.
Одна тема живёт в трёх местах, и путать их слова нельзя.
Сопровождение — всё, чем держат проект: инструмент и сборка, процесс, выкладка, метрики и логи, инфраструктура, дежурство. Эксплуатация — его часть: работа системы на проде. Целое и часть, и никогда наоборот.
| Место | Уровень | Что там |
|---|---|---|
BACKLOG.md, задачи chore |
план | работы, которые собираемся делать |
architecture.md, раздел «Эксплуатация» |
состояние | как устроено сейчас: где работает, что рядом, кто перезапускает |
тема ревью operations |
оптика | чем проверяем: «это упало через неделю на проде» |
Слово «поддержка» не употребляется вовсе — в нём слышится помощь
пользователю, а это другая работа. По той же причине им не названа и стадия
проекта: у неё имя «доработка» (support), словарь — task-track, «Две
стадии».
Граница с возможностями проходит по тому, кто наблюдает. «Приложение сообщает о своём состоянии» — возможность приложения, её место среди прочих задач: наблюдает пользователь сервиса. «Дежурный видит состояние на одном экране» — сопровождение: наблюдаем мы. Одни и те же метрики попадают в задачи разных типов, и это верно — типы отвечают на разные вопросы.