Принципы WitnessDone: не верь слову агента — верь следу
Однажды агент назвал кусок работы «MVP» — и молча выкинул из него треть функций. Тогда я начал записывать принципы.
Их около дюжины. Расскажу о главных — каждый появился после конкретной боли.
Spec-first Пока не описано, что и как проверять, код не пишется. Утверждения, написанные после кода, всегда описывают то, что получилось, — как чек-лист приёмки квартиры, составленный после осмотра.
Реестры раньше описаний Сначала таблица «требование → задача» без пустых клеток, потом красивые документы. Полноту проверяет таблица, а не ощущение.
Не верь слову агента «Готово» — только с акта. Ручная проверка в чате — не проверка.
VerificationTax «Готово» стоит денег: прогнать проверки и оставить след. Налог платится всегда — вопрос только, сразу или с процентами.
Decision Lock Договорённость нельзя поменять по ходу. Изменение оформляется отдельно и видно всем.
Honesty Не хватает данных — вопрос человеку, а не догадка.
Context по задаче Агенту дают только документы, нужные для этой задачи, а не «прочитай репозиторий».
Документы по-русски Чтобы их читал человек через месяц, а не только модель.
Цена бездействия Каждый принцип закрывает конкретный способ, которым агент тихо портит проект. Без них вы ловите эти способы по одному — на проде.
Следующий пост — волны и вертикальные срезы: как построить порядок работ, чтобы проверяемый кусок был с первого дня.
Читайте серию на arhellist.ru.
Полный текст: https://arhellist.ru/blog/printsipy-witnessdone-reestry-ranshe-opisaniy-i-sled-na-kazhdom-shage/
