1.5 Принятие решений и управление

Обзор и мотивация

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

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

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

Ключевые принципы

Записывайте решения и их обоснование; решение без обоснования это обязательство-обуза.
Спускайте решения на самый низкий уровень, где есть контекст, в рамках ясных ограждений.
Соразмеряйте вес процесса с весом и обратимостью решения.
Различайте обратимые («дверь в обе стороны») и необратимые («дверь в одну сторону») решения и управляйте ими по-разному.
Предпочитайте проторённые дороги и значения по умолчанию согласованиям в каждом случае.
Относитесь к техническому долгу как к управляемому портфелю, а не как к моральному изъяну, который нужно прятать.
Делайте управление прозрачным; скрытое принятие решений порождает недоверие и переделки.

Компромиссы: плюсы и минусы

Подход к управлению	Плюсы	Минусы
Центральный совет рассматривает всё	Максимальная согласованность и надзор	Тяжёлое узкое место; обезвластивает команды; медленно
Проторённая дорога с локальной автономией	Масштабируется, быстро, безопасное значение по умолчанию, усиливает команды	Требует предварительных вложений в платформу; часть команд сходит с дороги
Полная автономия команд, без управления	Быстро, высокая ответственность	Фрагментация, дублирование, повторяющиеся ошибки
ADR / RFC	Долговечная память, лучшие решения, прозрачность	Накладные расходы на письмо; игнорируются без сопровождения

Выбор источника	Плюсы	Минусы
Построить	Полный контроль, точное соответствие, возможность выделиться	Вечные расходы на сопровождение и штат
Купить	Быстро, с поддержкой, сопровождает кто-то другой	Стоимость лицензий, привязка, неидеальное соответствие
Принять (открытый код)	Нет платы за лицензию, можно изучить, сообщество	Бремя поддержки и безопасности ложится на вас

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

Вопросы для обсуждения с командой

Кто решает, является ли данное решение дверью в одну сторону, и как вы будете ловить ошибки классификации в обоих направлениях? Классификация решений по обратимости одна из самых действенных привычек управления, и её ценность рушится, если ошибиться с отметкой: отнесёте обратимый выбор к необратимым и утопите его в обдумывании, отнесёте необратимый к обратимым и выпустите модель данных или контракт публичного API, который дёшево не отменить. Противоположный риск в том, что человек, ближайший к работе, может быть смещён в сторону скорости, а центральный совет в сторону осторожности. Приведите в обсуждение конкретные примеры: чего на самом деле стоило бы, во времени и деньгах, обратить каждое решение и кто несёт эту стоимость. В корпоративной и государственной среде обязательства по закупкам и данные в масштабе превращают многие выборы в двери в одну сторону, которые поначалу выглядели обратимыми. Договоритесь, кто классифицирует, и выработайте привычку быстро спрашивать второе мнение обо всём, что близко к границе, чтобы дефицитное внимание ложилось туда, где обращение действительно дорого.
Кто владеет проторённой дорогой, финансирует и обеспечивает её персоналом и что мешает ей выродиться в привратника? Проторённая дорога работает, только если благословлённые значения по умолчанию действительно хорошо поддерживаются и проще альтернатив, а это требует устойчивых вложений, которые легко недофинансировать. Компромисс жёсткий: дорога без ресурсов становится набором предписаний без поддержки, то есть именно привратничеством, которое модель призвана заменить, и команды её обходят. Приведите свидетельства здоровья дороги: уровень внедрения, насколько актуальны одобренные инструменты, как быстро отвечает платформенная команда и как часто команды подают заявки на выход с дороги. Для больших и регулируемых организаций проторённая дорога ещё и способ сделать соответствующий требованиям выбор лёгким, поэтому её финансирование это инвестиция в соответствие, а не только удобство. Определите ясного владельца и постоянный бюджет и измеряйте, выбирают ли команды дорогу потому, что она действительно самый лёгкий путь.
Где команды обходят ваше управление и что говорит вам этот теневой IT? Команды уходят с санкционированного пути, когда он болезненнее обходного, поэтому широко распространённый теневой IT скорее вердикт о дизайне вашего управления, чем проблема дисциплины. Соображения здесь подлинные: часть уклонения безрассудна, но многое рациональное избегание совета по ревью, ставшего многонедельной очередью. Приведите свидетельства: какие согласования пропускаются, какие неофициальные инструменты тихо распространились и сколько на самом деле занимает официальный путь. В корпоративном и государственном контексте ставки выше, потому что несанкционированные инструменты могут нарушать обязательства по аудиту, безопасности и закупкам, имеющие юридический вес. Если картина показывает, что люди обходят узкое место, исправление состоит в ускорении и расширении проторённой дороги и сужении области совета до немногих сквозных необратимых решений, а не в добавлении согласований.
Какая доля нашей мощности поставки на самом деле идёт на погашение технического долга и можем ли мы назвать самые высокопроцентные позиции, которые стоит атаковать первыми? Технический долг ведёт себя как сложный процент, тихий налог на каждое будущее изменение, и большая организация может нести его годами, прежде чем кто-то заметит, что систему стало медленно и хрупко менять. Противоположное давление прямолинейно: каждый час на долг это час, не потраченный на функции, видимые руководству, поэтому погашение сокращают первым, когда срок поджимает. Приведите в обсуждение реальные свидетельства: письменный реестр значимого долга, честную оценку постоянной стоимости каждой позиции и стоимости её устранения и фактическую долю недавней мощности, ушедшую на погашение, а не на новую работу. Для корпораций и государственных органов с десятилетними горизонтами неуправляемый долг рано или поздно вынуждает к дорогой переписке или замечанию аудита, поэтому воспринимайте постоянную долю на погашение как управление рисками и решите, кто её охраняет, когда графики сдвигаются.
Когда нам нужно обоснование решения двухлетней давности, можем ли мы на самом деле его найти и поддерживает ли кто-нибудь эту запись живой? Вся ценность записи об архитектурном решении в том, что обоснование переживает людей, принявших решение, и эта ценность рушится, если ADR пишут один раз, никогда не ищут и они тихо устаревают. Напряжение между дисциплиной письма, нужной, чтобы зафиксировать контекст, варианты и последствия в момент решения, и ежедневным давлением просто выпустить и двигаться дальше. Приведите в обсуждение конкретные проверки: возьмите три важных недавних решения и посмотрите, сможет ли кто-нибудь найти записанное обоснование за минуты, и проверьте, помечены ли замещённые ADR как таковые, а не молча противоречат текущей практике. В корпоративной и государственной среде эта доступная для поиска запись и есть то обоснованное свидетельство, которого требуют аудиторы и надзорные органы, поэтому решите, где живут ADR, кто их рецензирует и что делает решение достаточно значимым, чтобы его записывать.
Когда мы в последний раз пересматривали крупное решение «построить или купить» относительно его исходных допущений и заметили бы мы вообще, что эти допущения истекли? Выбор источника относится к самым дорогим и труднообратимым решениям, а допущения за ним (цены поставщика, ваш собственный штат, зрелость варианта с открытым кодом) тихо устаревают, пока решение остаётся замороженным. Противоположные соображения сопоставляют безвозвратные затраты и потрясения от переключения с нарастающей стоимостью привязки, неидеального соответствия или бремени сопровождения, которое вам больше не нужно. Приведите исходный ADR и его заявленные допущения, текущую оценку TCO для каждого пути, включая лицензирование, интеграцию, штат и стоимость выхода, и любой сигнал (изменение цены, понижение поддержки), что предпосылка сместилась. Для государственных и регулируемых покупателей правила закупок и многолетние контракты делают эти двери в одну сторону особенно обязывающими, поэтому заранее договоритесь о триггерах и периодичности, которые вынудят сознательно принять решение заново, а не слепо продлить контракт.

Взгляд по секторам

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

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

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

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

Примеры

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

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

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

Бизнес-обоснование: мотивы, ROI и TCO

Решения самая высокорычажная и наименее видимая статья затрат в программах. Один неудачный необратимый архитектурный или закупочный выбор может навязать годы торможения или исправление за девять знаков. Хорошее управление им, несколько часов обдумывания и письменная запись, стоит по сравнению с этим почти ничего. Отдача от ADR и делегирования по обратимости приходит из двух источников: избегание дорогих ошибок в решениях «двери в одну сторону» и избегание напрасного обдумывания и переделок во всём остальном. Записанное обоснование также резко сокращает повторяющуюся стоимость пересмотра решённых вопросов и обратной разработки замысла унаследованных систем командами.

Технический долг делает аргумент о TCO конкретным. Неуправляемый долг ведёт себя точно как сложный процент: растущий налог на каждое будущее изменение, пока система фактически не становится несопровождаемой и не требует дорогой переписки. Управление долгом как портфелем с постоянным выделением мощности на погашение высокопроцентных позиций обходится гораздо дешевле грядущего кризиса. Хорошее управление дёшево внедрить, это в основном дисциплина записи решений и предварительные вложения в проторённую дорогу. Пропустить его дорого: вы платите избегаемыми переписками, сюрпризами привязки, провалами аудита и потерей институциональной памяти. Чтобы убедить руководство, формулируйте управление на его языке: снижение рисков, избегание переделок, более быстрая поставка по проторённой дороге и готовая к аудиту обоснованность. Покажите, что цель не больше процесса, а лучше нацеленный процесс: тяжёлый контроль только там, где обращение дорого, и беспрепятственная скорость везде остальное.

Антипаттерны и ловушки

Недокументированные решения: обоснование теряется в момент ухода принявших его людей.
Узкое место совета по согласованиям: центральный орган, в очереди к которому должен стоять каждый проект.
Процесс «один размер для всех»: прогон тривиальных обратимых решений через тяжёлое ревью.
Паралич анализа: мучения над легко обратимыми решениями «двери в обе стороны».
Теневой IT: команды полностью уклоняются от управления, потому что санкционированный путь слишком болезнен.
Невидимый технический долг: долг, который никогда не инвентаризировался, не погашался и тихо нарастал.
Рефлексы «строить всё» или «покупать всё»: выбор источника по привычке, а не по анализу TCO.
Театр управления: документы и советы, существующие для видимости, но не формирующие решения.

Модель зрелости

Уровень 1 (Начальный): Решения принимаются стихийно и не записываются; управление либо отсутствует, либо превращено в сплошное узкое место; технический долг невидим, а обоснование выбора испаряется с уходом людей.
Уровень 2 (Развитие): Некоторые решения документируются и существует некоторое ревью, но практика непоследовательна между командами, а процесс часто не соответствует весу и обратимости решения.
Уровень 3 (Стандартизация): ADR, проторённая дорога, делегирование по обратимости и реестр долга задокументированы и соблюдаются по всей организации, так что соответствующий требованиям выбор лёгкий по умолчанию, а обоснование доступно для поиска.
Уровень 4 (Управление): Управление измеряется относительно базовых значений: отслеживаются внедрение проторённой дороги, охват ADR, время цикла решения, долг как доля мощности и доли исключений вне дороги, а решения о погашении долга или пересмотре источников запускаются этими свидетельствами, а не кризисом.
Уровень 5 (Оркестрация): Управление непрерывно настраивается и интегрировано с планированием поставки и рисков; контроль точно нацелен на необратимые решения; долг и выбор источников активно перебалансируются как портфели и решаются заново на основании свидетельств по мере смены обстоятельств.

Идеи для обсуждения

Можем ли мы найти записанное обоснование самых важных наших недавних решений?
Где наше управление служит узким местом, а где его нет, хотя оно нужно?
Какие из наших нынешних решений являются дверями в одну сторону и относимся ли мы к ним так?
Какая доля нашей мощности идёт на погашение технического долга и достаточно ли этого?
Следуют ли наши команды проторённой дороге потому, что она действительно самый лёгкий путь, или обходят её?
Когда мы в последний раз пересматривали крупное решение «построить или купить» относительно его исходных допущений?

Главные выводы

Записывайте значимые решения и их обоснование в ADR; делайте рассуждение долговечным.
Управляйте через проторённые дороги и значения по умолчанию, а не привратничество в каждом случае.
Соразмеряйте вес процесса с весом и обратимостью решения; делегируйте двери в обе стороны, обдумывайте двери в одну сторону.
Анализируйте «построить, купить или принять» по совокупной стоимости владения и записывайте допущения.
Управляйте техническим долгом как явным портфелем с постоянной долей на погашение.
Держите управление прозрачным и лёгким; направляйте дефицитный контроль туда, где обращение дорого.

Источники и дополнительное чтение

Michael Nygard, “Documenting Architecture Decisions” (the original ADR pattern)
Gregor Hohpe, “The Software Architect Elevator” and “37 Things One Architect Knows”
Amazon shareholder letters on Type 1 vs Type 2 (one-way vs two-way door) decisions
Ward Cunningham, the original “technical debt” metaphor
Martin Fowler, writings on technical debt and evolutionary architecture
Neal Ford, Rebecca Parsons, Patrick Kua, “Building Evolutionary Architectures”
Nicole Forsgren, Jez Humble, Gene Kim, “Accelerate” (loosely coupled architecture and autonomy)
ISO/IEC/IEEE 42010 on architecture description

1.5 Принятие решений и управление

Обзор и мотивация

Ключевые принципы

Рекомендации

Примите записи об архитектурных решениях и процесс RFC подходящего размера

Управляйте через проторённые дороги, а не привратников

Используйте советы по архитектурному ревью экономно и прозрачно

Сделайте «построить, купить или принять» осознанным анализом

Управляйте техническим долгом как портфелем

Различайте обратимые и необратимые решения