brainstorming - Прояснение замысла перед разработкой

Когда звать

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

Что проясняет brainstorming

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

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

Как появляется согласованный замысел

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

Для небольшой правки достаточно короткого документа. Для проекта инструкция задаёт полный состав: намерение, цели, то, что делать не нужно, ограничения, рассмотренные подходы и оставшиеся исполнителю решения. Программный проект по умолчанию получает файл в docs/superpowers/specs/. Путь можно изменить по правилам вашей рабочей среды. Перед передачей большого документа отдельный агент проверяет, сможет ли исполнитель составить по нему план.

Автор разделяет вопросы этой проверки на уже отвеченные, мелкие и действительно требующие решения владельца. Уже известные ответы вносятся в документ, небольшие решения агент принимает сам и помечает. Существенные вопросы собираются в одно обращение. Это полезная деталь для ситуации, когда обсуждение начинает повторяться вместо того, чтобы уточнять замысел.

Визуальный помощник и право отказаться

Макеты в браузере предлагаются в момент, когда изображение объяснит устройство лучше текста. Это отдельное согласие, не обязательный режим общения. README сообщает, что такой помощник по умолчанию загружает логотип с сайта автора с версией набора; предусмотрено отключение телеметрии. При подготовке карточки мы ничего не запускали.

Пользователь вправе отказаться от вопросов и попросить сразу приступить к работе. Ещё одно исключение относится к отдельно согласованному пробному прототипу: его нельзя незаметно превращать в готовый продукт. В обычном процессе после утверждения замысла следует writing-plans. Карточка описывает прочитанную инструкцию версии набора 7.0.1, а не проверенный нами результат обсуждения с агентом.