Раздел 16 · Архитектура и решения

Bus factor и передача знаний

middle-senior~40 мин

без входаВойди, чтобы отмечать прогресс, вести заметки и решать задачи в редакторе. войти

Bus factor и передача знаний

Сцена · всё ждёт Аню

В команде семь человек, но решения по заказам и биллингу принимает одна Аня. Она написала большую часть этого кода, знает, почему возвраты считаются именно так, и помнит инцидент, после которого в налогах появилась странная проверка. Каждый PR в биллинг ждёт её ревью. Каждый вопрос «а можно ли тут» уходит ей в личку.

Сначала это выглядит как удача: есть эксперт, всё под контролем. Потом Аня уходит в отпуск на две недели, и релизы биллинга встают. Не потому что никто не умеет писать код, а потому что никто не решается: «Аня вернётся, посмотрит». Задачи копятся, срочную правку тарифа катят без ревью, и она ломает возвраты.

Аня возвращается и разбирает завал. Её саму это не радует: отпуск испорчен звонками, на интересный новый проект её не отпускают («а кто останется на биллинге?»), повышение откладывают по той же причине. Она незаменима, и это её ловушка.

Этот урок про то, как измерить такую концентрацию знаний, почему она говорит не только о людях, но и об архитектуре, и что с ней делать.

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

  • Что такое bus factor и сколько он обычно составляет у живых проектов.
  • Почему bus factor это показатель архитектуры, а не только людей, и при чём тут закон Конвея.
  • Как его считать по истории репозитория и где эта оценка врёт.
  • Почему незаменимость это ловушка и для человека, и для компании.
  • Как поднимать bus factor: записи, ревью, ротация, онбординг, привычки команды.
  • Где bus factor у агентов и почему записанное знание защищает обоих.

Bus factor · определение и цифра

Bus factor (его же называют truck factor) это наименьшее число разработчиков, уход которых выводит проект из строя. Мрачное название говорит само за себя: сколько человек должен сбить автобус, чтобы никто не знал, как это работает. На деле автобус редко бывает автобусом. Это увольнение, переход в другую команду, декрет, долгая болезнь. Отпуск это мягкая версия: через две недели человек вернётся, но две недели знания нет.

Гильерме Авелино, Леонардо Пассос, Андре Ора и Марко Тулио Валенте в статье «A Novel Approach for Estimating Truck Factors» (ICPC 2016) оценили его автоматически, по истории коммитов, для 133 популярных проектов на GitHub. У 65 процентов систем truck factor оказался 2 или меньше. Два человека уходят, и в проекте не остаётся тех, кто знает большую часть кода.

Авторы проверили оценку опросом разработчиков 67 систем. 84 процента валидных ответов согласились или частично согласились, что найденные алгоритмом люди и есть главные авторы. А с самими числами truck factor согласились или частично согласились 53 процента. Это честная оговорка, к которой мы вернёмся: история коммитов хорошо находит авторов, но хуже отвечает, кто незаменим.

Показатель людей и архитектуры

Низкий bus factor обычно читают как проблему людей: «надо, чтобы Аня делилась знаниями». Это правда наполовину. Вторая половина про то, почему знание вообще застряло в одной голове.

Знание концентрируется там, где код трудно понять без автора:

  • Нет границ. Модуль, который знает про всё и от которого зависит всё, нельзя понять по кусочку. Его можно понять только целиком, а целиком его держит в голове один человек.
  • Нет записей. Почему возвраты считаются так, а не иначе, записано только в памяти Ани. Новичок видит странную проверку и не знает, можно ли её трогать.
  • Нет проверок. Правила, которые не проверяет машина, проверяет эксперт на ревью. Значит, без эксперта их никто не проверит.

Каждый из трёх пунктов это архитектурная проблема, и каждый чинится архитектурными средствами: контрактами модулей, ADR и fitness functions.

Мелвин Конвей в статье «How Do Committees Invent?» (Datamation, апрель 1968) сформулировал наблюдение, которое потом назвали его именем: организации, которые проектируют системы, «constrained to produce designs which are copies of the communication structures of these organizations». Дизайн системы повторяет структуру связей между людьми. Конвей добавляет важное: организация команды уже принимает проектные решения, потому что без нужных путей связи часть вариантов дизайна становится невозможной.

Для знаний отсюда следует вывод: знание течёт по путям связи. Модуль, вокруг которого общается один человек, получает структуру связи из одного человека. Его дизайн это одна голова, и знание о нём живёт там же. Хочешь, чтобы модуль знали двое, нужен путь связи вокруг модуля между двумя: общее ревью, пара, совместное владение. Ни одна вики этот путь не заменит.

дальше после входа

Урок целиком открыт всем, кто вошёл. Войди по своему email, чтобы читать дальше.

Вход пока по приглашению. Если хочешь учиться, напиши Vassiliy.