Кто может создать ADR?

Рассмотрите такие области, как конкретные люди, конкретные роли, конкретные команды или конкретные отделы; также подумайте, есть ли люди, роли, команды или отделы, которые могут заказать ADR, то есть запросить её, а написать её будет кто-то другой.

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

Что оправдывает создание ADR?

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

Пример ответа: мы хотим создавать ADR, когда хотим, чтобы будущие разработчики понимали «почему» того, что мы делаем.

Что оправдывает отказ от создания ADR?

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

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

Каков жизненный цикл ADR?

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

Пример ответа: мы хотим, чтобы у ADR было пять этапов жизненного цикла: Инициирование → Исследование → Оценка → Реализация → Сопровождение → Вывод из эксплуатации.

Каковы критерии для этапов жизненного цикла ADR?

Рассмотрите такие области, как критерии приёмки ADR, то есть как понять, что она достаточно хороша, чтобы перейти с одного этапа жизненного цикла на следующий? Чётко ли сформулирована проблема? Рассмотрены ли альтернативы? Достаточно ли хорошо поняты и задокументированы компромиссы? Весь ли уместный контекст на месте? Все ли уместные заинтересованные стороны вовлечены? Учтены ли все отзывы?

Пример ответа: мы хотим, чтобы заинтересованные стороны голосовали по ADR, когда активная команда 1) завершила исследование, 2) завершила оценку, 3) опубликовала предложение ADR для заинтересованных сторон с просьбой о комментариях и сроком в одну неделю, 4) все комментарии заинтересованных сторон учтены и рассмотрены.

Какие роли и обязанности взаимодействуют с ADR?

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

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

Как управление взаимодействует с ADR?

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

Пример ответа: управление ADR осуществляется в таком порядке приоритета: генеральный директор, технический директор, юридический директор, команда, реализующая ADR, эксперты в команде, лучше всех знающие ADD. Больше ни у кого нет полномочий по управлению, если иное не описано в ADR.

Какие принципы взаимодействуют с ADR?

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

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