Superpowers’ brainstorming skill now draws out what you want before anything gets built

1 month ago

Superpowers rebuilt its brainstorming skill around drawing out what you want: one open question first, playback as it goes, sizing after intent, and a builder check in place of the spec reviewer. Merged into the dev branch on Oct 6, 2026; tested in Claude Code with Claude Opus 5.5. https://github.com/obra/superpowers/pull/2463

Ask about this presentation

Chapters

  1. 0:00Superpowers’ brainstorming skill now draws out what you want before anything gets built
  2. 0:12The old skill opened every conversation with process jargon
  3. 0:24Menus pushed people toward plausible but wrong goals
  4. 0:40The first message is now an opt-out line and one open question
  5. 0:51It plays its understanding back as it goes, with its guesses marked
  6. 1:05It sizes the work after it understands the request
  7. 1:20A fresh builder reads the design before you do
  8. 1:32Nothing gets built until you approve the full description
  9. 1:45All six blind testers preferred the new version
  10. 1:56The rewrite is on the dev branch and tested only in Claude Code
Show transcript
  1. Superpowers rewrote its brainstorming skill from scratch, and Jesse Vincent merged it on October 6. It now asks what you want and why, and decides how much paperwork the job needs afterwards.

    Slide text
    github.com/obra/superpowers · brainstorming merged Oct 6, 2026 · dev branch
    Socratic design refinement
    Drawing out intent before building
    README.md · obra/superpowers PR #2463
  2. In the project's tests, every opening from the old skill began with 40 to 80 words about specs and plans, even for a bakery. Every non-trivial one was a lettered menu.

    Slide text
    github.com/obra/superpowers · brainstorming merged Oct 6, 2026 · dev branch
    old opening, quoted in the PR
    “I’m treating this as architectural… spec… implementation plan”
    25 of 25 openings led with 40–80 words of process talk
    20 of 20 non-trivial openings were a lettered A–E menu
    PR #2463 body · measured on dev before the rewrite
  3. Those menus steered people. Planning a talk after layoffs, a simulated person picked excitement and alignment, when the real goal was rebuilding trust. The old skill offered 16 to 27 options per conversation. The rewrite offers one at most.

    Slide text
    github.com/obra/superpowers · brainstorming merged Oct 6, 2026 · dev branch
    picked from the menu
    excitement and alignment
    real goal of the post-layoff talk
    rebuilding trust
    16–27 menu options per conversation before · 0–1 after
    PR #2463 body · multi-turn runs with simulated humans
  4. The new first message says you can skip the questions, then asks one open question about a real moment, like when you last wished this thing existed. A menu appears only when you're stuck.

    Slide text
    github.com/obra/superpowers · brainstorming merged Oct 6, 2026 · dev branch
    skills/brainstorming/SKILL.md
    “One open question that gets them describing. Ask about a real moment or a concrete picture: ‘What’s the moment you find yourself wishing this existed?’”
    “Offer a short menu only when they’re stuck.”
    skills/brainstorming/SKILL.md at the merge commit
  5. Once it understands one part, the skill describes it back in about 200 to 300 words, then returns to questions. In six test runs that came by the sixth turn, with the agent's guesses labeled as guesses.

    Slide text
    github.com/obra/superpowers · brainstorming merged Oct 6, 2026 · dev branch
    200–300 words per playback chunk, alternating with questions
    turn 3–6 where the first playback landed in six test runs
    “Mark anything you’re guessing as your guess; only what they said goes in as theirs.”
    SKILL.md · PR #2463 commit “play back as you go”
  6. Sizing now comes last. It's a quick task, a small change agreed in chat, or a project with a written design. Asked to make an app icon cornflower blue, the old skill wrote a design every time. The new one changed the colour.

    Slide text
    github.com/obra/superpowers · brainstorming merged Oct 6, 2026 · dev branch
    A quick, clear task do it
    A small change agreed in chat
    A project a written design
    “Make the app icon cornflower blue” handled as a quick task: 0 of 5 runs before · 5 of 5 after
    SKILL.md “Size the Work” · PR #2463 body
  7. For a project, the spec reviewer is gone. A fresh subagent reads the design as its builder and lists what it would still need to ask. You get one round of those questions, most important first.

    Slide text
    github.com/obra/superpowers · brainstorming merged Oct 6, 2026 · dev branch
    spec-document-reviewer-prompt.md
    builder-check-prompt.md
    “Report only the questions you’d still need answered before you could plan this well… Rank them by importance.”
    skills/brainstorming/builder-check-prompt.md · PR #2463
  8. The approval gate stays. Writing code, scaffolding and installing dependencies all wait until you approve the full description. If you opt out of the questions at the start, the skill ends and the gate goes with it.

    Slide text
    github.com/obra/superpowers · brainstorming merged Oct 6, 2026 · dev branch
    <HARD-GATE>
    “Building includes writing product code, scaffolding, installing dependencies, creating projects, and invoking an implementation skill. Reading and exploring are fine.”
    Opting out of the questions ends the skill, and the gate with it.
    skills/brainstorming/SKILL.md at the merge commit
  9. In a blind comparison, six testers each tried both versions without knowing which was which, and all six preferred the new one. The biggest gains were feeling understood and trust.

    Slide text
    github.com/obra/superpowers · brainstorming merged Oct 6, 2026 · dev branch
    mean rating old new
    understood 6.3 8.8
    pleasant 6.3 8.0
    worth the time 7.3 7.8
    trust 6.7 8.7
    PR #2463 body · 6 testers × 2 sessions, labels hidden
  10. The rewrite is on the dev branch, so the latest release still ships the old skill. It was tested only in Claude Code with Claude Opus 5.5. The details are in pull request 2463 in the superpowers repository.

    Slide text
    github.com/obra/superpowers · brainstorming merged Oct 6, 2026 · dev branch
    main and the latest release still ship the old skill tested with Claude Opus 5.5 in Claude Code eval harness and results: PR #2464, still open
    github.com/obra/superpowers/pull/2463
    PR #2463 · obra/superpowers

What happened in AI today, in your inbox

One short email each evening. Read it and you’re caught up.

Built with ❤️ in New York