Перейти к содержимому
TelegramGitHub

The Staff Engineer's Path, глава 5: Руководство большими проектами

Главная мысль: большой проект трудный не из-за технологии, а из-за неясности: размытая цель, много людей, старые системы. Руководителю проекта нужны не гениальные идеи, а упорство, смелость и готовность говорить с людьми. Он собирает контекст, даёт проекту структуру, всё записывает и активно ведёт проект к цели, а не ждёт, что всё случится само.

Глава отвечает на вопрос: как Staff-инженеру вести большой проект, в котором работают несколько команд и никто ему не подчиняется. В главе 4 автор разбирала, какие проекты брать при ограниченном времени. Теперь проект взят, и его нужно довести до цели. Темы главы:

  • как справиться с растерянностью в начале проекта;
  • какой контекст собрать: цели, клиенты, метрики успеха, ограничения, риски, история, команда;
  • как дать проекту структуру: роли, найм, объём работ, сроки, договорённости, встреча для старта;
  • как вести проект: исследовать, прояснять, проектировать, писать код, общаться и обходить препятствия.

Путь проекта: в начале справиться с растерянностью, собрать контекст и дать структуру; затем вести проект — исследовать, прояснить, спроектировать, писать код, общаться, обходить препятствия; при сильной смене курса начать сначала

Схему читают слева направо. Жёлтые блоки — начало проекта, синие — его ведение. Красный блок напоминает: если курс сильно изменился, проект проходит начальные шаги заново.

Хороший руководитель проекта (project lead) редко бывает гением. Обычно проект трудный по другой причине: направление неясно, люди сложные, а поведение старых систем трудно предсказать. Если в проекте много команд, рискованных решений или просто хаоса, такому проекту нужен технический лидер, который выдержит эту сложность и верит, что задачи решаемы. Часто это Staff-инженер.

Автор берёт случай, когда проект длится несколько месяцев и требует нескольких команд. Вы — назначенный техлид (tech lead) проекта и, возможно, делегируете части руководителям поменьше. Никто в проекте вам не подчиняется, но результат ждут от вас. Рядом есть менеджер проекта, продакт-менеджер, инженерные менеджеры со своими командами, но за итог отвечаете вы. Поэтому вы думаете о задаче целиком, включая работу, которая формально ничья.

В начале люди ходят кругами и выясняют, кто что делает и кто главный. Главный — вы, но только отчасти. Участники получают задачи от своих менеджеров, и не все согласны, должны ли они вам помогать. Если в проекте несколько менеджеров и директоров, неясно, за что отвечаете вы, а за что они. Могут быть и другие Senior-инженеры, даже старше вас по уровню.

Старт бывает разным. Вы приходите в старый проект с историей и сложными отношениями. Или проект новый, но уже есть требования, план и список stakeholder — людей и групп, которых проект касается. А бывает, что есть только набросок на доске, а директор решил дать деньги на плохо описанную проблему. Мнений много, сроки близко, а вы ещё не поняли, зачем нужен проект и какова ваша роль.

Автор советует начать с того, чтобы справиться с растерянностью. Перегрузка в начале нормальна: нужно время, чтобы построить в голове карты проекта.

Может появиться мысль, что вас поставили сюда по ошибке. Это синдром самозванца (imposter syndrome). Сильная тревога мешает усваивать новое и хорошо работать, поэтому страх не справиться часто сбывается сам. Иногда тревога — сигнал, что кончается один из ресурсов из главы 4: энергия, время или навыки.

Помогает и другой взгляд: трудность — это суть работы. Будь проект простым, вы бы не понадобились. Вы можете ошибиться, но кто-то должен рискнуть. До этого уровня вы дошли благодаря доверию к вам (credibility) и социальному капиталу (social capital), и одна ошибка вас не уничтожит.

Пять приёмов делают старт легче.

ПриёмЧто делать
Создайте себе якорьЗаведите личный документ — внешнюю часть мозга на весь проект: слухи, вопросы, зацепки, списки. Когда не знаете, что делать дальше, перечитайте, что считали важным раньше
Поговорите со спонсоромУзнайте, кто спонсор (sponsor) проекта и чего он ждёт. Придите с письменным описанием цели и признаков успеха и спросите, согласен ли он. Уточните свою роль и кому носить новости
Решите, кому показывать сомненияНе Junior-инженерам: они ждут от вас опоры. Найдите хотя бы одного человека для откровенности: руководителя, ментора или коллегу-Staff-инженера из главы 2. Лучше того, кто скажет «мне тоже трудно», чем того, кто сразу решает ваши проблемы
Дайте себе маленькую победуСделайте любой шаг, который даёт контроль: поговорите с кем-то, нарисуйте схему, начните документ. В начале проекта не знать чего-то легче всего, позже это неловко. Фраза «я тут новый, поправьте меня» открывает много дверей.
Опирайтесь на свои сильные стороныКак и со стратегией в главе 3: любите код — начните с кода, любите людей — идите к людям, а если любите читать, возьмите документы. Так мозг привыкает, что это обычный проект

Разобраться в неясности, для себя и для других, помогают карты из главы 2. Locator map показывает место проекта: цели, ограничения, историю и связь с целями бизнеса. Topographical map показывает рельеф: местную политику, привычки людей и то, как принимаются решения. А куда вы идёте и какие вехи пройдёте, показывает treasure map. Вот что нужно прояснить для себя и для всех.

Цели. Почему из всех задач бизнеса выбрали именно этот проект? Ответ на «зачем» мотивирует и направляет весь проект. Без него легко сделать работу и не решить настоящую проблему. Иногда, поняв цель, вы видите, что проект её не достигнет. Лучше узнать это сразу.

Потребности клиентов. В первую неделю в инфраструктурной команде автор спросила коллегу, зачем другой команде нужна новая функция. Тот ответил: «Может, и не нужна. Мы так думаем, но проверить не можем». Даже у самого внутреннего проекта есть клиенты — те, кто будет пользоваться результатом.

Понять, чего пользователи хотят на самом деле, а не что они говорят, трудно. Попросите пользователя показать, как он работает со старой системой. Попросите внутренних клиентов описать API мечты. Слушайте настоящие ответы, а не те, которые хотите услышать, и избегайте жаргона: люди стесняются признаться, что не поняли. Даже при наличии продакт-менеджера клиентов нельзя игнорировать.

Метрики успеха. Опишите, как вы измерите успех. Для новой функции метрики могут быть в PRD (product requirements document, документ с требованиями к продукту). Если их нет, предложите свои и согласуйте со спонсором. Проекты часто меряют прогресс объёмом кода, но код сам по себе ничего не говорит о решённой проблеме. Иногда успех — это как раз удалённый код. Что изменится: больше выручки, меньше сбоев, быстрее процесс? Сара Уэллс (Sarah Wells) мерила успех миграции 150 с лишним микросервисов в Kubernetes временем на поддержку кластера и числом язвительных сообщений в Slack.

Если проект придумали вы, будьте особенно строги к метрикам: с хорошей репутацией можно увлечь людей яркой речью, но вы можете ошибаться. Не делайте доверие и социальный капитал единственным двигателем проекта.

Спонсоры, stakeholder и клиенты. Кто хочет проект и кто за него платит? Кто главные клиенты и чего они ждут? Если идея ваша, вам, возможно, придётся всё время доказывать ценность проекта, чтобы его продолжали финансировать.

Жёсткие ограничения. Ролей без ограничений автор не встречала. Узнайте свои: сроки, которые нельзя сдвинуть, бюджет, занятые команды, от которых вы зависите, компоненты, которые нельзя использовать, трудные люди. «Выпустить функцию» и «выпустить функцию без нужного числа инженеров, когда два stakeholder спорят о курсе» — разные проекты. Описывайте реальность дипломатично: документ могут переслать тому самому трудному человеку.

Риски. Это «полёт на Луну» (moonshot) или «полёт на крышу» (roofshot) — огромная мечта или понятный шаг? Чем амбициознее проект, тем он рискованнее. Предскажите риски: неизвестные, зависимости, ключевые люди, без которых проект рухнет. Частый страх — сделать то, чем никто не будет пользоваться. Небольшие частые итерации дают обратную связь и шанс поправить курс или даже рано закрыть проект. Один большой выпуск в конце такого шанса не даёт.

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

Команда. В проекте одной команды вы общаетесь со всеми. В проекте многих команд нужен контактный человек в каждой, а в очень большом — руководитель части проекта (sublead) в каждой области. Возможно, ваш проект сам часть большего, и тогда sublead — вы.

Дерево проекта: вы как руководитель проекта в корне, ниже контакт в команде A и руководители частей B и C, у них свои руководители частей и контакты

На схеме руководитель проекта стоит в корне дерева. У части команд есть только контакт, у других — свой sublead, у которого бывают свои sublead. Несколько лидеров часто значит неясность, кто что делает, и это частый источник конфликтов. Поэтому стройте с лидерами хорошие рабочие отношения и узнайте, кто лидеры, как они участвуют в проекте и какую роль ждут для себя.

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

На высоких уровнях роли размываются. Очень опытный инженер, инженерный менеджер и технический менеджер программ (TPM, technical program manager) похожи: все они должны быть «взрослыми в комнате», то есть видеть риски, убирать блокеры, решать проблемы. Если TPM не следит за пробелами и статусом, это должны делать другие.

Начало проекта — лучшее время распределить обязанности лидеров. Иначе двое однажды узнают, что делают одно и то же, а другая работа провалится в щель. Проще всего составить таблицу, кто за что отвечает. Пример:

РольЗа что отвечает
Продакт-менеджерПотребности клиентов, первые требования, KPI продукта, A/B-эксперименты, последнее слово о поведении, которое видит пользователь. Вместе с инженерным менеджером задаёт объём работ и вехи
ТехлидАрхитектура верхнего уровня, последнее слово о техническом подходе, менторство по технике. Вместе с командой проектирует компоненты, помогает с кодом, тестами и эксплуатацией
Инженерный менеджерНайм, здоровье команды, рост и оценка людей
TPMСроки и статус проекта для stakeholder
Команда инженеровДизайн компонентов, код, тесты, деплой и мониторинг

Это только пример: лидеров может быть больше или меньше. У внутренних проектов, например в инфраструктуре, продакт-менеджера обычно нет.

Для строгого подхода есть RACI — матрица ответственности «задача × человек». Название составлено из четырёх ролей:

  • Responsible — тот, кто делает работу.
  • Accountable — тот, кто сдаёт работу и подтверждает, что она готова. Он один на задачу и часто совпадает с Responsible.
  • Consulted — те, у кого спрашивают мнение.
  • Informed — те, кому сообщают о ходе работы.

Иногда это перебор, но когда матрица нужна, она очень нужна. В хаотичном проекте одного знакомого Staff-инженера из Google команда без RACI либо бесконечно обсуждала вопрос, потому что не знала, кто решает, либо пересматривала решения снова и снова. Матрица не убрала эти две беды полностью, но дала структуру, против которой никто не спорил, и с ней легко начать разговор о ролях.

Каким бы способом вы ни шли, все лидеры должны одинаково понимать роли. Автор когда-то была sublead и нервничала перед встречами с главным руководителем, хотя помог бы один прямой вопрос: «Вот за что, как я думаю, я отвечаю. Вы согласны?»

И последнее о ролях: руководитель проекта неявно занимает каждую пустую роль. Нет менеджера у команды — помогаете людям расти вы. Никто не собирает требования — это вы. Никто не ведёт проект как менеджер — тоже вы.

Пустые роли, которые вы не хотите или не успеваете занять, нужно закрыть людьми: нанять внутри или снаружи компании либо выбрать sublead. Ищите людей, которые дополняют вас: любите общую картину — ищите любителя деталей, и наоборот. Лучший вариант — человек, который обожает работу, которую вы терпеть не можете. Но не ставьте проект в зависимость от узкого навыка одного человека: люди уходят.

Мохит Чеппудира (Mohit Cheppudira), Principal-инженер в Google, говорил, что большой проект — это по сути строительство организации. Он искал лидеров не только с хорошим техническим суждением, но и с правильным настроем: оптимистов, которые решают конфликты и двигают проект. Их успех — ваш успех.

Менеджеры проектов используют треугольник: время, бюджет и объём работ. Его формулируют и так: «быстро, дёшево, качественно — выберите два». Мысль очевидная, но о ней легко забыть: меньше людей — меньше сделаете. Договоритесь, что именно вы пытаетесь сделать.

Скорее всего, проект не выйдет одним куском. Если функций несколько, давайте ценность по частям: решите, что делаете первым, поставьте веху (milestone) и дату, опишите, какие функции в неё входят и что сможет пользователь. Джеки Беновиц (Jackie Benowitz), инженерный менеджер нескольких огромных межкомандных проектов, считает каждую веху бета-тестом. Её можно показать, и пользователи дают обратную связь. Будьте готовы, что каждый шаг меняет требования к следующему: увидев новую возможность, люди понимают, чего ещё хотят или что вы идёте не туда.

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

Большой проект можно разбить на направления работ (workstream): куски функциональности, которые делают параллельно, часто разными подкомандами, у каждого свои вехи. Главное, чтобы у всех была одна ясная картина, что и когда вы делаете: хоть в программе для роадмапов, хоть стикерами на доске.

Автор почти не встречала людей, которые хорошо оценивают сроки. Каждый проект уникален, и точно знать срок можно, только если вы уже делали ровно то же самое. Советы «дробить работу» или «умножать оценку на три» её не радуют. Ей ближе совет из «Программиста-прагматика» (The Pragmatic Programmer): единственный способ узнать график — набраться опыта на этом же проекте. Выпуская небольшие куски, вы узнаёте скорость команды и обновляете график. Ещё авторы советуют вести журнал оценок и тренировать этот навык.

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

Много мелких решений помогают проекту идти гладко, и их стоит обсудить всей командой:

  • Встречи. Как часто встречаться? Нужны ли ежедневные стендапы, как часто собираются лидеры многих команд, будут ли демо и ретроспективы?
  • Неформальное общение. В новом проекте люди стесняются писать в личку. Помогают общий канал для болтовни, встречи для знакомства или поездка всех в одно место на пару дней. Если команда разбросана по часовым поясам, нужно хотя бы несколько общих рабочих часов.
  • Статус. Как спонсор хочет узнавать о проекте? Куда идти остальной компании? Кто и как часто будет рассылать новости?
  • Дом документации. Заведите официальную страницу проекта в вики с запоминающимся адресом. Это центр вселенной проекта: итоги встреч, описание следующей вехи, формулировка связанного OKR и ссылки на всё остальное.
  • Практики разработки. Какие языки, как деплоить, какие стандарты код-ревью (code review), сколько тестов, нужны ли feature flag?

Последний шаг подготовки — встреча для старта проекта (kickoff). Если всё уже записано, она может казаться лишней, но люди, увидев лица друг друга, чувствуют себя командой. Расскажите, кто есть кто, каковы цели, какие структуры вы создали, что будет дальше, что вы хотите от людей и где задавать вопросы.

Пункт «что вы хотите от людей» важен весь проект. Новые лидеры часто лишь намекают, что было бы неплохо что-то сделать, и всем приходится гадать, насколько просьба важна. Говорите прямо.

Любимый доклад автора о проектах — «Avoid the Lake!» Крипы Кришнан (Kripa Krishnan), VP в Google Cloud Platform. Кришнан сравнивает «ведение» (driving) проекта с вождением машины: это не значит нажать на газ и ехать прямо. Руководитель выбирает маршрут, принимает решения, реагирует на опасности и отвечает за то, чтобы все доехали целыми.

В главе 3 разбиралась одна обязанность руководителя: следить, чтобы решения принимались. Здесь — остальные задачи на пути к цели.

Автора настораживает, когда у нового проекта уже есть design doc или план, тем более с деталями реализации вроде «построить GraphQL-сервер на Node.js». В первый день для таких решений не хватает информации: нужно исследование, чтобы понять настоящие потребности и оценить подходы. Если цели трудно сформулировать или они пересказывают реализацию, исследование было слишком коротким.

Чем больше проект, тем вероятнее, что у разных команд разные ментальные модели: чего вы добиваетесь и каким путём идёте. У команд бывают неизвестные вам ограничения и негласные ожидания. Например, команда согласилась помочь, думая, что проект решит и её задачу, а это не так. Люди называют одно и то же разными словами или говорят одинаковыми словами о разном. Цель — суметь коротко описать, чего хочет каждая команда, так, чтобы она согласилась с описанием.

Для этого говорите с пользователями и stakeholder и слушайте, какими именно словами они говорят.

Исследование даёт чёткое определение проекта и elevator pitch — короткий рассказ о проекте за время поездки в лифте. Появляется и ясное описание того, чего вы не делаете. Чем лучше вы понимаете задачу, тем легче объяснить её другим.

Только когда понятно, что вы делаете, думайте, как это сделать. Автор видела руководителей, которые держались за первую идею и отвергали все факты против неё. Держите ум открытым, пока не согласовали, что решаете.

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

Большая часть старта — дать всем ментальные модели проекта. Когда частей, мнений и похожих проектов много, держать всё в голове тяжело. У тех, кого вы просите о помощи, свой фокус. Если не упростить им картину, они будут оптимизировать не то или запутают ясный рассказ о проекте, который вы ведёте для организации.

Новые факты, не связанные с тем, что человек уже знает, быстро забываются: это бусины без нитки (так пишет Ален де Боттон в «Искусстве путешествовать»). Поэтому прицепляйте новое к знаниям человека: протяните нитку через знакомые понятия или дайте аналогию, пусть и не точную.

Новичка в Kubernetes засыпают терминами: Pods, Services, Namespaces, Deployments, ReplicaSets. Документация объясняет каждый через другие новые термины. Понятно становится, когда друг скажет: «Считай это процессом UNIX». Модель неточна, но точность не нужна: важна цепочка к тому, что человек уже знает.

Связь абстрактной идеи со знакомой вещью облегчает её запомнить и объяснить. «Выбор лидера» (leader election) понять легче, чем «алгоритм распределённого консенсуса». Давайте понятиям проекта запоминающиеся имена и аналогии.

Два человека могут говорить одни и те же слова и иметь в виду разное.

Эрик Эванс (Eric Evans) в книге Domain-Driven Design (2003) предложил строить единый язык (ubiquitous language): на нём говорят и разработчики системы, и эксперты предметной области. Даже слова «пользователь», «клиент» и «аккаунт» значат разное в финансах, маркетинге и инженерии. Используйте слова своей аудитории, а если групп несколько, дайте глоссарий.

Сильнее всего сложность снижают картинки. Пара схем «до» и «после» бывает яснее целого эссе. Вложенные идеи рисуют вложенными фигурами, параллельные — параллельными, иерархию — деревом. Помните о привычных значениях: цилиндр многие прочтут как хранилище данных, а зелёное и красное как «поощрять» и «остановить».

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

График прогресса: доля сервисов на новой платформе растёт по месяцам, пунктир продолжает текущий темп до цели 100% в декабре, цель отмечена красной линией

Синие точки — факт по месяцам, красная линия — цель, пунктир — куда ведёт текущий темп. В книге график тоже показывает движение к цели, но данные здесь наши.

После исследования и прояснения у вас много идей. Не думайте, что все их поняли и согласны: молчаливое согласие может ничего не значить. Самый быстрый способ выровнять всех — записать.

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

Записать — не значит написать 20 страниц на каждую мелочь: короткий текст часто идеален. Но важные аспекты плана в нём должны быть, а коллеги должны иметь шанс указать на опасности. Ревью дизайна — это не только «сработает ли архитектура», но и «ту ли проблему решаем» и «верны ли наши допущения о других командах». Как говорит Киан Синнотт (Cian Synnott), письменный дизайн — очень дешёвая итерация.

Дизайн обычно оформляют как design doc, его часто называют RFC (request for comment). Единого стандарта нет, и какой процесс лучше, автор не судит, но она большая сторонница шаблонов. Проектируя сложную систему, легко что-то забыть. Атул Гаванде (Atul Gawande) в «Чек-листе» (The Checklist Manifesto) пишет, что чек-лист помогает избегать типичных ошибок. Хороший шаблон RFC так же напоминает о забытых темах и заставляет отвечать на неудобные вопросы.

Если в компании есть свой шаблон, следуйте ему. Автор называет разделы, которые ставит в каждый RFC как минимум.

Разделы RFC: слева обязательные — контекст, цели, дизайн, безопасность, рассмотренные альтернативы; справа полезные — предыстория, компромиссы, риски, зависимости, эксплуатация

Слева на схеме — обязательные разделы даже для маленького RFC, справа — те, что делают документ полезнее.

Контекст. Документ должен быть привязан ко времени и месту. Найдя его через два года, человек должен по шапке понять, нужен ли он ему: название, автор, даты «создан» и «обновлён» и статус (идея, ревью, заменён, в работе, завершён, на паузе).

Цели. Какую проблему вы решаете или какую возможность используете. Если есть PRD, дайте краткий пересказ и ссылку. Читатели должны понять, ту ли проблему вы решаете. Если не согласны — отлично, вы узнали это до того, как построили не то. Цель не должна содержать реализацию. Пример плохой цели: «создать serverless API для перевода кудахтанья кур». Без настоящей проблемы нельзя понять, верен ли подход, а слово «serverless» уже крупное решение без обоснования. Реализация служит цели, а не подменяет её.

Дизайн. Как вы достигнете цели. Дайте читателям достаточно, чтобы оценить, сработает ли решение: для пользователей — функции и интерфейсы, для зависимостей — как вы их используете, чтобы владельцы заметили ошибки. Раздел может занять пару абзацев или 10 страниц: API, псевдокод, схемы, модели данных, шаги процесса.

Лучше ошибиться, чем быть расплывчатым. Многие пишут дизайн туманно, чтобы с ними не спорили о деталях. Но ошибка или спорная идея полезнее неясности: если вы неправы, вам скажут и вы смените курс, а если идея спорная, вы рано узнаете, что коллеги против.

Автор даёт два совета для точности. Первый: у каждого глагола должен быть ясный исполнитель, а пассивный залог прячет информацию. Ребекка Джонсон (Rebecca Johnson) предлагает тест: если после глагола можно вставить «зомби», залог пассивный.

РасплывчатоТочно
Данные будут зашифрованы при передаче (кем? зомби?)Клиент шифрует данные перед отправкой
JSON будет распакованКомпонент Parse распаковывает JSON

Второй совет: лучше лишнее слово или повтор, чем двусмысленность. Ева Пэриш (Eva Parish) советует не писать голые «это» и «то», а добавлять существительное. В фразе «заменить OldSolution на NewSolution. TeamB это нужно» непонятно, что нужно TeamB. Писать хорошо можно научиться: есть курсы Google Technical Writing.

Безопасность, приватность, compliance. Что вы защищаете и от кого? Трогает ли план данные пользователей, где хранятся ключи и пароли? Если считаете, что раздел не нужен, напишите, почему.

Рассмотренные альтернативы. Хотели бы вы делать проект, если бы задачу решала обычная таблица? Этот раздел показывает, что вы решаете проблему, а не увлеклись решением. Если альтернатив нет, вы, вероятно, не продумали задачу. Почему не подходят простые решения или готовые продукты? У автора есть правило: если в компании есть правдоподобный вариант, а вы его не берёте, отправьте RFC владельцам этой системы и дайте им ответить.

Эти разделы держат автора документа честным. Ещё несколько делают документ ценнее:

  • Предыстория. Что нужно знать читателю для оценки дизайна, включая глоссарий внутренних названий.
  • Компромиссы (trade-off). Минусы дизайна, которые вы принимаете сознательно, потому что выгода больше.
  • Риски. Что может пойти не так. Если беспокоит сложность, задержки или неопытность команды, предупредите ревьюеров.
  • Зависимости. Что нужно от других команд: инфраструктура, код, одобрение безопасности или юристов. Сколько времени им нужно и знают ли они, что вы придёте?
  • Эксплуатация. Кто запускает систему, как её мониторить, кто отвечает за бэкапы и учения по восстановлению после аварий.

Книга не про архитектуру, но автор называет ловушки, которые часто видит в дизайн-документации. Найдите их у себя сами, чтобы их не искали другие.

ЛовушкаВ чём проблема
«Это совершенно новая проблема»Почти наверняка нет. Ищите прошлые и похожие проекты и готовые решения
«Выглядит легко!»Инженеры недооценивают чужие области. Бухгалтерия, зарплаты, найм или даже графики on-call — трудные задачи. Если задача кажется тривиальной, вы её не понимаете
Строим для настоящегоСработает ли решение через три года? Кроме роста нагрузки думайте о росте компании, поглощениях, числе продуктов. Не станет ли компонент узким местом, где все ждут одну команду?
Строим для очень далёкого будущегоСвой балансировщик, лишний кэш, автоматический переход между регионами нужно обосновать. «Может, понадобится потом» — не обоснование, а одна из самых дорогих фраз в разработке
«Каждому пользователю нужно просто…»Пятерых пользователей можно научить хитрым правилам, сотни будут ошибаться. Смена привычек людей — трудная часть, и она должна быть в дизайне
«Трудное решим потом»Квартал шлифуют систему для лёгких случаев, а трудные могут оказаться нерешаемыми. Или сложность перекладывают на других: все клиенты API должны менять код вместо обратной совместимости
Решаем малую проблему, усложняя большуюПри нехватке людей проблемы обходят костылями, а костыли скрыто зависят от поведения системы и мешают полному решению потом. Если нет ресурсов на корень проблемы, хотя бы напишите об этом
«Это не переписывание (но это оно!)»«Всего лишь» вынести бизнес-логику или перенести в облако обычно значит переписать намного больше задуманного.
А это можно эксплуатировать?Что непонятно в 3 часа дня, будет непонятно в 3 часа ночи. Делайте системы наблюдаемыми, процессы — скучными и самодокументируемыми. Запишите в RFC, кто дежурит. В ротации on-call нужно больше трёх человек, лучше от шести, иначе ждите выгорания и пропущенных вызовов
Больше всего обсуждаем мелочиЭто bikeshedding, по «закону тривиальности» Паркинсона (1957): комитет по атомной станции больше всего спорит о материале для велосипедного навеса. Даже опытные люди пишут абзацы о мелких решениях и молчат о трудных

Большинство проектов требуют много нового кода или правок старого. Как руководителю участвовать в такой работе? Если вы не программист, подставьте свою основную техническую работу.

Это зависит от размера проекта и команды и от ваших предпочтений. В маленькой команде вы участвуете в каждом изменении. В проекте многих команд пишете отдельные функции, мелкие исправления или вообще не пишете.

Джой Эберц (Joy Ebertz) замечает, что код — редко самое ценное применение вашего времени: большую часть её кода мог бы написать кто-то намного младше. Но код даёт глубокое понимание и заставляет чувствовать цену своих архитектурных решений наравне с командой.

Следите, не пишете ли вы код вместо более трудных дел. Это форма «перекусов» (snacking) из главы 4: вы берёте понятную работу с быстрой отдачей и избегаете больших решений по дизайну или сложных переговоров.

Ваше время менее предсказуемо, а встреч у вас больше, поэтому большие задачи вы будете делать долго и заблокируете других. Берите работу, которая не срочная и не лежит на критическом пути.

Используйте код как рычаг. Катрина Оуэн (Katrina Owen), Staff-инженер в GitHub, придумала стандартный способ тестировать пагинацию API и переписала на него все старые тесты: новые теперь копируют образец. Ваши решения должны усиливать команду, а не заменять её. Росс Дональдсон (Ross Donaldson), Staff-инженер по базам данных, называет свою работу «разведкой и картографией»: он находит проблему, приносит её команде, и решают вместе. Вместо того чтобы брать каждое важное изменение, работайте в паре (pairing): так вы подключаетесь к ключевой части, а остальное оставляете коллеге.

На код-ревью помните, как воспринимают ваши комментарии. Даже если вы дружелюбны, замечание Staff-инженера пугает начинающих. Иногда лучше оставить «достаточно хороший» шаблон, даже если вы сделали бы лучше. И не делайте все ревью сами: вы станете единой точкой отказа.

Есть и неявная сторона примера: всё, что вы делаете, задаёт ожидания команде. Если самый старший в команде небрежен, небрежной будет вся команда. Подробнее о роли примера — в главе 7.

Без хорошего общения проект не сдать вовремя. Если команды не говорят друг с другом, прогресса нет. Если вы не говорите с людьми вне проекта, stakeholder не знают, как идут дела.

Создавайте поводы, чтобы участники регулярно общались, особенно в полностью удалённых командах. Помогают общие встречи, дружелюбные каналы в Slack, демо и неформальные события.

Знакомство делает безопасными уточняющие вопросы: незнакомым людям неловко сказать «я не знаю этот термин». Стремитесь к тому, чтобы спрашивать и признавать незнание было нормой.

У проекта есть и внешние заинтересованные люди: stakeholder, спонсоры, команды-клиенты. Дайте им простой способ узнавать новости: личные разговоры, регулярные письма или дашборд со статусами.

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

Проговаривайте выводы: после факта добавляйте «это значит, что…».

Сообщайте статус честно. Когда проект буксует, хочется сделать бодрое лицо и рисовать зелёный статус. Но тогда в конце будет неприятный сюрприз. Такие проекты зовут «арбузами» (watermelon): снаружи зелёные, внутри красные. Если проект застрял, не прячьте это, а просите помощи.

Что-то обязательно пойдёт не так. Ключевая технология не масштабируется, юристы запретили её лицензию, компания меняет курс, уходит ключевой человек. Легче, если вы заранее ждёте проблему, просто пока не знаете какую.

За рулём отвечаете вы. Сказать «проект заблокирован, ничего не поделать» нельзя. Ваша задача — найти объезд, эскалировать тому, кто поможет, или, если иначе нельзя, сообщить stakeholder, что цель недостижима. Если статус зелёный, кроме одной нерешаемой ключевой проблемы, он не зелёный.

С препятствием разбирайтесь вместе с командой. Чем больше перемена, тем вероятнее, что нужно вернуться к началу главы: снова справиться с растерянностью, собрать контекст и считать проект перезапущенным. Не сейте панику и не давайте ходить слухам: давайте людям факты.

В трудный момент помните, что успеха проекта хотите не только вы. Работа вашего руководителя — сделать успешным вас, работа директора — сделать успешной организацию. Если вы не просите помощи, им труднее делать свою работу. Многие сопротивляются просьбе о помощи: она кажется провалом. Но если вы застряли, самый большой провал — не попросить. Как вытаскивать застрявшие проекты, автор разбирает в главе 6.

  • Staff-инженер берёт задачи, которые кажутся нерешаемыми, и делает их решаемыми.
  • Растерянность в начале большого проекта нормальна: проект трудный, поэтому в нём и нужен такой человек, как вы.
  • Соберите контекст: цели, клиентов, метрики успеха, спонсоров, ограничения, риски, историю и команду.
  • Структура снижает неясность: роли лидеров, вехи, оценки сроков, общий дом документации и встреча для старта.
  • Заранее решите, как вы измерите успех, особенно если проект придумали вы.
  • Вести проект — значит активно им управлять, а не ждать, что всё случится само.
  • Сначала поймите, какую проблему решаете, и только потом выбирайте решение.
  • Записывайте планы ясно и с позицией: ошибку поправят, а расплывчатость останется.
  • Компромиссы будут всегда, поэтому ясно говорите, что вы оптимизируете.
  • Часто сообщайте статус с учётом аудитории и честно, без «арбузов»; ждите смены курса и просите помощи, когда застряли.
ТерминЗначение
руководитель проекта (project lead)Тот, кто отвечает за результат большого проекта, хотя участники ему не подчиняются
subleadРуководитель части большого проекта, который отчитывается перед главным руководителем
спонсор (sponsor)Тот, кто хочет проект, даёт ресурсы и ждёт результата
stakeholderЧеловек или группа, которых проект касается
RACIМатрица ролей: Responsible, Accountable, Consulted, Informed
веха (milestone)Промежуточный результат с датой, который можно показать пользователям
направление работ (workstream)Кусок функциональности со своими вехами, который делают параллельно с другими
встреча для старта проекта (kickoff)Встреча, на которой команда знакомится и узнаёт цели и правила проекта
RFCDesign doc для обсуждения дизайна с коллегами до работы
единый язык (ubiquitous language)Общие слова разработчиков и экспертов предметной области
bikesheddingДолгий спор о мелочах, потому что их легко понять
проект-«арбуз» (watermelon)Проект с зелёным статусом снаружи и красным внутри
  • Перед большой миграцией хранилища или переездом на новую платформу данных заведите личный документ-якорь и одну вики-страницу проекта для всех.
  • Спросите спонсора, как он поймёт, что проект удался. Для data-проекта это может быть доля таблиц на новой платформе, время свежести данных или число жалоб аналитиков.
  • Составьте таблицу ролей: кто отвечает за модель данных, кто за pipeline, кто за сроки и кто сообщает статус потребителям данных.
  • Делайте вехи, которые можно показать: первые витрины на новой платформе, которыми аналитики уже пользуются.
  • Запросы к платформенной команде и DBA отправляйте за квартал, а не за неделю до запуска.
  • Пишите RFC с разделом альтернатив: может, задачу решает уже существующий инструмент или dbt-проект соседней команды.
  • В дизайне pipeline называйте исполнителя у каждого действия: не «данные будут очищены», а «задача clean_orders в Airflow удаляет дубликаты».
  • В статусе пишите, что потребители данных могут делать сейчас, а не сколько DAG вы написали.
  1. Почему автор считает, что большой проект трудный чаще из-за неясности, чем из-за технологии?
  2. Какие пять приёмов помогают справиться с растерянностью в начале проекта, и почему не стоит делиться сомнениями с Junior-инженерами?
  3. Зачем распределять роли лидеров в начале проекта и когда нужна матрица RACI?
  4. Почему каждая веха должна быть похожа на бета-тест?
  5. Почему цель в RFC не должна содержать реализацию, и почему лучше ошибиться, чем быть расплывчатым?
  6. Когда руководителю проекта стоит писать код, а когда он становится узким местом?

Предыдущая: Ограниченное время. Следующая: Почему мы остановились?.