Принципы WitnessDone: реестры раньше описаний и след на каждом шаге

Однажды агент назвал кусок работы «MVP» — и молча выкинул из него треть функций. Тогда я начал записывать принципы.

Их около дюжины. Расскажу о главных — каждый появился после конкретной боли.

Spec-first

Пока не описано, что и как проверять, код не пишется. Утверждения, написанные после кода, всегда описывают то, что получилось, — как чек-лист приёмки квартиры, составленный после осмотра.

Реестры раньше описаний

Сначала таблица «требование → задача» без пустых клеток, потом красивые документы. Полноту проверяет таблица, а не ощущение.

Не верь слову агента

«Готово» — только с акта. Ручная проверка в чате — не проверка.

VerificationTax

«Готово» стоит денег: прогнать проверки и оставить след. Налог платится всегда — вопрос только, сразу или с процентами.

Decision Lock

Договорённость нельзя поменять по ходу. Изменение оформляется отдельно и видно всем.

Honesty

Не хватает данных — вопрос человеку, а не догадка.

Context по задаче

Агенту дают только документы, нужные для этой задачи, а не «прочитай репозиторий».

Документы по-русски

Чтобы их читал человек через месяц, а не только модель.

Цена бездействия

Каждый принцип закрывает конкретный способ, которым агент тихо портит проект. Без них вы ловите эти способы по одному — на проде.

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

Читайте серию на arhellist.ru.

#WitnessDone #SDD #принципы