[Claude] Claude Code Superpowers brainstorm 스킬 활용 및 설치 방법

 

이번 글에서는 Claude Code의 Superpowers 플러그인 brainstorm 스킬이 어떻게 동작하는지 살펴보겠습니다.

 

Superpowers는 Jesse Vincent(obra)와 Prime Radiant 팀이 만든 Claude Code 플러그인으로, 코드 작성 전 설계·검토 단계를 구조화하는 스킬 모음입니다. brainstorm 스킬은 `/superpowers:brainstorm` 커맨드로 호출하거나 자연어로 의도를 설명해 호출할 수 있습니다(v5.0부터 슬래시 커맨드는 deprecated 표시가 붙었고, 자연어 호출 방식이 권장됩니다). 어떤 방식으로 호출하든 요구사항 정리부터 설계 승인까지 단계를 거치기 전에는 Claude가 코드를 작성할 수 없도록 막습니다.

1. brainstorm 스킬의 동작 방식

brainstorm 스킬은 9단계 체크리스트와 그 안의 3개 승인 게이트(design approval, spec self-review, user review)로 동작합니다. 큰 흐름은 다음과 같습니다.

• Context Exploration 단계에서 현재 코드베이스와 문제 영역을 파악합니다. 코드가 없는 새 프로젝트라면 입력한 요구사항이 전부입니다.
• Visual Companion 제안 단계에서 시각화가 도움이 될 만한 주제면 브라우저 기반 시각화 도구를 켤지 묻습니다.
• Clarifying Questions 단계에서 모호한 부분을 하나씩 묻습니다. 한꺼번에 쏟아내는 방식이 아니라 한 번에 하나씩, 가능하면 선택지 형태로 질문합니다.
• Approach Options 단계에서 2~3개의 구현 방향을 비교합니다. 각 옵션에는 트레이드오프와 리스크가 함께 붙습니다.
• Design Approval 단계에서 설계안을 섹션 단위로 보여주고 사용자 승인을 받습니다. 첫 번째 게이트입니다.
• Write Design Doc → Spec Self-Review → User Review 단계에서 사양 문서를 `docs/superpowers/specs/YYYY-MM-DD-<topic>-design.md` 경로로 저장하고, 모순이나 누락 여부를 스킬이 스스로 점검한 뒤(두 번째 게이트), 사용자가 작성된 사양을 다시 검토합니다(세 번째 게이트). 이 문서는 PR 설명이나 RFC로 재활용할 수 있습니다.
  
  

이 모든 게이트를 통과하기 전에는 코드 작성이나 다른 구현 스킬 호출이 차단됩니다.

 

실제 사례로, 알림 데몬 구현 요청에서 brainstorm 스킬 하나만으로 424줄짜리 설계 문서가 생성된 경우가 있습니다. cooldown 정책, hot-reload 동작 같은 핵심 결정들이 코드 한 줄 없이 문서로 먼저 확정됐습니다.

 

2. Visual Brainstorming Companion

시각화가 도움이 될 만한 주제를 다룰 때 스킬이 "브라우저로 보여드릴까요?"라고 묻고, 사용자가 동의하면 그 세션 동안 사용 가능한 도구로 등록됩니다.

활성화되면 로컬 웹 서버가 뜨고, 스킬이 생성한 HTML 페이지가 브라우저 창에서 열립니다. ASCII 다이어그램의 한계를 피하면서 mockup이나 아키텍처 다이어그램을 보여주기 위한 용도입니다. 활성화했다고 해서 모든 질문이 브라우저로 가지 않으며, 스킬이 질문별로 텍스트와 시각화 중 적합한 쪽을 고릅니다.

 

3. 전체 Superpowers 워크플로

brainstorm은 Superpowers 전체 워크플로의 첫 단계입니다.

 

brainstorm  →  write-plan  →  execute-plan
 (요구·설계)   (작업 단위 분해)  (서브에이전트 TDD 구현)

 

`/superpowers:write-plan`은 승인된 설계를 2~5분 단위의 실행 작업으로 분해합니다. `/superpowers:execute-plan`은 서브에이전트가 TDD 방식으로 각 작업을 구현합니다. brainstorm과 마찬가지로 이 두 슬래시 커맨드도 v5.0에서 deprecated 처리되어, 자연어로 "writing-plans 스킬로 계획을 잡아줘" 같이 호출하는 방식이 권장됩니다. git worktree와 조합하면 서브에이전트가 격리된 브랜치에서 병렬로 작업하는 구성도 가능합니다.

 

4. 설치 방법

Claude Code 2.0.13 이상이 필요합니다. 플러그인 마켓플레이스에서 두 단계로 설치합니다.

 

/plugin marketplace add obra/superpowers-marketplace
/plugin install superpowers@superpowers-marketplace

공식 마켓플레이스를 사용하는 방법도 있습니다.

/plugin install superpowers@claude-plugins-official

 

설치 후 세션을 시작하면 Claude에 "You have Superpowers" 부트스트랩 프롬프트가 주입됩니다. `/help`에서 `superpowers:` 네임스페이스를 확인하면 사용 가능한 스킬 목록 전체를 볼 수 있습니다.

 

 

`/superpowers:brainstorm`(또는 자연어 호출)은 아이디어를 바로 코드로 옮기고 싶을 때 의도적으로 속도를 늦추는 스킬입니다. 설계 문서가 산출물로 남기 때문에 다음 작업의 입력이 되고, 팀 리뷰나 PR 설명으로 재활용하기도 편합니다.

 

이전에 소개한 gstack의 `/office-hours`가 "만들 가치가 있는가"를 따지는 데 집중한다면, Superpowers의 brainstorm은 기술 구현 단계의 설계 게이트에 더 비중을 둡니다. 두 스킬을 이어서 쓰는 패턴도 커뮤니티에서 자주 보입니다.

 

 

📌 Claude Code 관련 글 모음

• Claude Code 2.0 설치 방법 (Windows)
• Claude Code 토큰 사용 팁 정리
• Claude Code에서 Subagent 생성 및 활용하는 방법
• Claude Code 자주 사용하는 명령어 정리
• Claude Code에서 Skills 활용하는 방법

 

<참고>

1. obra/superpowers - GitHub

2. Superpowers: How I'm using coding agents in October 2025 - fsck.com
3. Superpowers 5 - fsck.com (2026.03)
4. Claude Code Got 100x Better With Superpowers Skill - Medium

5. Superpowers brainstorming - claudemarketplaces.com