API ВЕГА

Помогает уточнить требования и согласовать дизайн до начала разработки. Сначала определяет тип задачи — spike, bounded или architectural — и доводит её до нужного этапа согласования, чтобы не переходить к реализации без одобрения.

Возможности

  • Выясняет цель, ограничения и критерии успеха; если данных не хватает, задаёт по одному уточняющему вопросу.
  • Для spike согласует вопрос и план проверки, затем выдаёт рекомендацию. Результат spike — ответ, а не код для дальнейшего использования.
  • Для bounded-задачи изучает контекст проекта, предлагает короткий дизайн в чате и ждёт явного одобрения.
  • Для architectural-задачи предлагает 2–3 подхода с компромиссами, готовит письменную спецификацию и передаёт работу навыку writing-plans.
  • Масштабирует процесс по сложности задачи. Если в ходе работы обнаруживается скрытая сложность, переводит её на более строгий путь.

Когда использовать

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

Примеры

Spike — проверка осуществимости:

can we...
is it possible...
quick and dirty is fine

Bounded-задача — небольшое изменение существующего потока:

a new flag, a small endpoint, a one-file fix

Для architectural-задачи спецификация сохраняется по пути:

docs/superpowers/specs/YYYY-MM-DD-<topic>-design.md

Установка

npx skills add https://github.com/obra/superpowers --skill brainstorming