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

Язык стейкхолдеров и RFC

middle-senior~45 мин

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

Язык стейкхолдеров и RFC

Сцена · «эльфийский»

Инженер приходит к менеджеру продукта с просьбой. «В биллинге плохие абстракции, высокая связность, слой репозиториев протекает в сервисы. Нужно две недели на рефакторинг». Менеджер вежливо кивает и слышит примерно такое: «две недели ничего не будет, ради чего-то, чего я не увижу». В квартальном плане и так не хватает места. Отказ.

Через три месяца в биллинге инцидент: правка тарифа задела возвраты, часть клиентов получила двойное списание. Выходные на разбор, возвраты денег, письма с извинениями. Менеджер спрашивает: «почему никто не сказал, что там опасно?» Инженер отвечает: «я же говорил!»

Оба правы. Инженер действительно говорил. Но говорил на языке, в котором у менеджера нет слов для принятия решения: «связность» и «абстракции» не складываются в план, бюджет и риск. Менеджер не глупый и не враг. Ему просто не перевели.

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

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

  • Почему технически точная просьба проигрывает и чего в ней не хватает стейкхолдеру.
  • Четыре валюты, в которых считают решения: деньги, сроки, риск, предсказуемость.
  • Формулу просьбы на языке риска и словари качества, которые понимают обе стороны.
  • RFC как триггер обсуждения, клапан для несогласия и способ учиться у коллег.
  • Почему RFC может испариться, а ADR остаётся рядом с кодом.
  • Как писать один документ для двух аудиторий.

Почему «плохие абстракции» не работают

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

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

Это тот же принцип, что у уровней C4 из урока про design records: у каждого рисунка своя аудитория, и уровень зума выбирают под читателя. Продакту показывают Context, а не классы. Просьбу о техдолге тоже показывают на уровне Context: что видит бизнес, а не что видит редактор кода.

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

Четыре валюты стейкхолдера

Решения о времени команды считают в четырёх валютах. Хорошая просьба называет хотя бы одну.

  • Деньги. Потерянная выручка, цена инцидента, цена людей. «Двойное списание стоило возвратов на такую-то сумму и двух дней поддержки».
  • Сроки. Сколько стоит изменение сейчас и сколько будет стоить через полгода. «Задача по тарифам занимает неделю, а могла бы день».
  • Риск. Вероятность плохого события и его цена. «Каждый релиз тарифов может задеть возвраты, и проверяем мы это руками».
  • Предсказуемость. Насколько оценки команды совпадают с фактом. Часто самый сильный довод: менеджер планирует квартал по оценкам, и зона, где оценки врут вдвое, ломает ему весь план.

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

Вот как выглядит перевод. Цифры в правой колонке условные, в своей просьбе бери настоящие из трекера и инцидентов:

Инженер говоритСтейкхолдер слышитПеревод на язык решения
высокая связность в биллингеничегоза квартал четыре задачи из шести по тарифам превысили оценку вдвое: планировать биллинг сейчас нельзя
нет тестов на возвраты«хотят время на тесты»каждый релиз возвратов это полдня ручной проверки и риск ошибиться в деньгах клиента
надо обновить фреймворк«хотят поиграться с новым»с такой-то даты версия не получает исправлений безопасности, дальше каждая уязвимость это аврал вне плана
архитектура не масштабируется«хотят переписать»при росте заказов в полтора раза, который стоит в плане на весну, ночной отчёт перестанет успевать к утру

Обрати внимание: ни в одной строке справа нет слов «абстракция», «связность», «рефакторинг». Причина остаётся инженерной, а разговор идёт о следствии.

Формула просьбы на языке риска

Перевод проще делать по шаблону. Четыре предложения:

Сейчас [наблюдаемый факт с числом]. Если ничего не делать, [последствие в деньгах, сроках или риске]. Предлагаю [маленький шаг], это стоит [время]. После него [метрика] станет [число], проверим через [срок].

Просьба из сцены по этому шаблону:

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

Три вещи в этой формуле работают сильнее, чем кажется.

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

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

Общий словарь качества. Слова «быстро», «надёжно», «чтобы не падало» у обеих сторон значат разное. Нейтральный словарь дают модели качества из урока про NFR: характеристики ISO/IEC 25010 (надёжность там делится на безотказность, доступность, отказоустойчивость и восстанавливаемость) и девять измерений arc42 Quality Model. «Это про восстанавливаемость» звучит для обеих сторон одинаково, а «это про качество кода» нет. Как превращать эти характеристики в требования с числами, разобрано там же.

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

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

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