Документы исполнения: от бэклога до плана отката

Сцена · README из одной строки

Твой первый день в новой команде. Ты клонируешь репозиторий и открываешь README. В нём одна строка: # backend. Дальше начинается квест: какая версия Node, откуда взять .env, почему тесты падают без какой-то локальной базы. Каждый ответ добывается вопросом в чате. На третий день ты узнаёшь, что деплоить умеет один человек, и он в отпуске.

А через месяц ты уже свой, и наступает вторая серия. Пятница, релиз, после выкатки падают платежи. Надо откатывать. Как откатывается миграция, которая уже переписала колонку? Никто не записал. План отката рождается в три ночи, на проде, методом проб.

Оба сюжета об одном: знание о том, как команда работает с кодом, жило в головах, а не в документах. Этот урок про этаж, который чинит обе серии: документы планирования и поставки.

Карта урока · что заберёшь

• Планирование: бэклог, планы релизов, ретро и lessons learned.
• Путь кода: README, стандарты, PR, changelog, версии.
• Путь до прода: CI/CD, конфигурация, IaC, запись о деплое, план отката.
• Реестры, которые спасают: фич-флаги и секреты.
• Главный принцип этажа: лучший документ исполнения исполняем машиной.

Две половины этажа: планирование и поставка

Документы исполнения отвечают на два вопроса. Что делаем и в каком порядке: это планирование. Как код доезжает до пользователя: это поставка. Первая половина про людей и время, вторая про конвейер.

Проверка качества у обоих одна: можно ли по документу действовать без автора. README хорош, если новичок запустил проект, ни разу не написав в чат. План отката хорош, если в три ночи по нему откатил человек, который релиз не выкатывал.

Планирование · бэклог, релизы, ретро

• Backlog: единственный список будущей работы. Сила бэклога не в полноте, а в единственности: если задачи живут в трёх местах (трекер, чат, голова лида), ни одно из них не источник истины.
• Sprint plan и release plan: что войдёт в ближайшую итерацию и в ближайший релиз. План это снимок договорённостей на дату, а не клятва: когда план меняется, меняют документ, а не делают вид, что так и было.
• Milestones: крупные вехи с критерием достижения. «Бета для первых десяти клиентов» это веха, «поработать над качеством» нет.
• Retrospective record и lessons learned: петля обучения команды. Ретро без записи испаряется за неделю. Запись с действиями («флаг убираем после полной раскатки, владелец Вася») превращает разговор в изменение процесса.
• Escalation record и meeting minutes: кто, когда и о чём договорился с внешними сторонами. Скучный жанр, пока не наступает спор «вы обещали в марте», и тогда запись стоит дороже любого красноречия.

Как резать запланированную работу на куски, чтобы каждый был проверяемым, мы уже разобрали в уроке про вертикальные срезы. Документы планирования и срезы это две стороны одного навыка: план описывает куски, срезы определяют их форму.