Паттерн Премиум и VIP #28

Паттерн 28. Контракт корпоративного источника

Задаёт контракт корпоративного источника контекста.

Aleksei Litvinau · ~16 мин чтения· Пункт маршрута 82 из 91

Проверяем доступ к полному тексту.

Проверяем доступ к полному тексту.

После чтения

Ваши заметки, проверка понимания и следующий шаг

Внедрение в организации

Уровень зрелости

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

Сквозной пример

Для Audit Log Service вы готовите план 30-дневного эксперимента в одной устойчивой продуктовой области. В него входят несколько сопоставимых изменений: локальная правка фильтра, изменение правил хранения событий в нескольких компонентах и экспорт с маскированием персональных данных.

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

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

Задание

Подготовьте план 30-дневного эксперимента для одной команды и одной устойчивой продуктовой области. Результат задания состоит в готовности провести эксперимент и принять решение по его итогам; само составление плана ещё не подтверждает пользу внедрения.

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

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

Укажите, как команда будет собирать восемь групп показателей:

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

Для каждого класса задач используйте одинаковые определения показателей в работе с агентом и без него. Событийные показатели, например число откатов, можно привести к числу на 100 запросов на слияние кода (PR). Время считайте в часах или днях, затраты на результат - на одно принятое изменение. Вместе со средними значениями сохраняйте размер выборки и разброс, чтобы несколько удачных задач не скрыли дорогие или долгие. Полный смысл показателей скорости, качества и затрат разобран в Урок 14. Метрики и где настоящий bottleneck.

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

По итогам эксперимента предстоит выбрать способ работы для каждого класса задач:

  • делегирование агенту как стандартный способ работы;
  • делегирование с дополнительными доказательствами;
  • выполнение человеком с помощью агента;
  • работа без делегирования.

В плане укажите владельца дальнейшей поддержки и условия, при которых новые запуски нужно остановить.

Что вы получаете на выходе

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

  • для каких классов задач применение агента можно расширить;
  • где нужны дополнительные проверки;
  • какие задачи остаются у человека;
  • какие доказательства, права и проверки на ревью нужны до расширения практики.

План задаёт условия продолжения и остановки. Вывод о пользе внедрения потребует результатов самого эксперимента.

Примеры к модулю 5