Журнал решений для небольшого проекта

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

Отбирайте решения, которые будут иметь последствия

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

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

Зафиксируйте условия и выбор

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

У учебной группы может получиться такая запись.

Решение 014. Раздача заданий на первом занятии
Статус: принято
Выбор: напечатать листы и сохранить ссылку для ведущего
Условия: в аудитории нет проверенного доступа к сети
Альтернатива: выдавать ссылку каждому участнику
Причина: первый шаг должен работать сразу после входа
Последствие: ведущему нужна проверенная версия для печати
Пересмотр: после проверки сети и устройств перед второй встречей

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

Покажите цену и границы

Причина должна отвечать на вопрос, почему вариант подходит при данных условиях. Здесь важно, что первое действие не должно зависеть от сети. Формулировка «бумажный вариант удобнее» оставляет место для нескольких толкований. Укажите конкретное преимущество и то, что за него придётся сделать. Для печати нужны готовый файл и время. Для ссылки нужна проверка доступности. Тогда будущая команда поймёт, какой факт изменит сравнение.

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

Пересматривайте решение с сохранением истории

Допустим, перед второй встречей проверили сеть и оказалось, что участники спокойно открывают ссылку. Не переписывайте старое объяснение так, словно печати никогда не было. Создайте новую запись с новым условием. В старой укажите, что её заменило следующее решение, и дайте ссылку. В новой запишите, с какого момента действует новое правило. Так у команды остаётся ответ на вопрос, почему первая встреча была устроена иначе.

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

Проверьте журнал на одном спорном выборе

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

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

Свяжите спор с условием, которое можно проверить

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

Источник

• Майкл Найгард. Исходное описание записей архитектурных решений