NFR, ADR, Decision Lock: числа вместо прилагательных
«Система должна быть быстрой». Агент согласился. Мы оба понимали под этим разное.
Прилагательные — враг проверяемости. «Быстро», «надёжно», «масштабируемо» нельзя закрыть актом. Поэтому в волне B WitnessDone переводит их в числа.
NFR — числа
Нефункциональные требования записываются измеримо: задержка, ёмкость, допустимые потери, время восстановления. Число можно проверить. Прилагательное — только обсудить.
ADR — почему так
Каждое значимое архитектурное решение оформляется записью: контекст, варианты, выбор, последствия. Через месяц агент (и человек) не будет «улучшать» решение, не понимая, зачем оно было принято.
Три словаря
Данные, интерфейсы и термины фиксируются в словарях. Если в одном модуле «пользователь», а в другом «аккаунт» — это не стиль, это будущая ошибка интеграции.
Decision Lock
Договорённости заблокированы. Хотите поменять — оформите изменение отдельно, с последствиями. Агент не может по ходу задачи тихо переписать контракт, потому что ему так удобнее.
Цена бездействия
Без этого слоя каждая новая сессия агента слегка переосмысляет проект. По отдельности изменения безобидны, вместе — дрейф архитектуры, который замечают на нагрузке.
Следующий пост — главный: порядок доказательства, шаг за шагом.
Читайте серию на arhellist.ru.
