Claude Code Superpowers 플러그인 - AI에게 코드보다 기획서를 먼저 쓰게 하기
목차
개요
GitHub 19만 스타에 달하는 Claude Code 플러그인 Superpowers의 사용기가 화제다. 이 플러그인은 AI 코딩 도구가 사용자의 의도를 무시하고 “기획에 없던 기능까지 추가”하는 고질적 문제를 구조적으로 해결한다. 핵심은 단순하다. 코드를 쓰기 전에 기획서부터 쓰게 만든다.
문제 정의: AI 코딩 도구의 임의 확장
기존 AI 코딩 도구의 가장 큰 문제는 사용자 승인 없이 기능을 확장한다는 점이다. “메모앱 만들어줘”라고 했을 때 AI는 사용자가 요청하지 않은 태그 시스템, 검색 기능, 동기화 기능을 마음대로 추가한다. 이 과정에서 버그가 증가하고, 기획자와 개발 결과물 사이의 간극이 벌어진다.
Superpowers는 이를 “AI가 기획 없이 독단적으로 기능을 확장하는 현상”으로 정의한다. 결과적으로 코드 품질 저하와 기획자와의 갈등이 발생한다.
Superpowers 플러그인 핵심 구조
Superpowers는 GitHub 188만 스타를 기록한 Claude Code 플러그인이다. “기획서 작성 → 구현 계획 → 코드 작성 → 별도 리뷰”의 4단계를 강제하는 구조를 제공한다.
스펙 우선 작성 강제
플러그인은 사용자가 어떤 코딩 요청을 하든 먼저 스펙 문서를 작성하도록 유도한다. 소크라테스식 질문을 통해 요구사항을 상세하게 파악한다. “이 메모는 어떤 사용자가 쓰는가”, “삭제 시 휴지통이 필요한가”, “동기화 범위는 어디까지인가”와 같은 질문이 반복된다.
작성된 스펙은 파일로 보존된다. 세션이 바뀌어도 AI가 약속을 기억할 수 있게 하는 핵심 메커니즘이다.
이중 검증 체계
코드 작성 후 별도의 리뷰 단계가 강제된다. 구현이 스펙을 충실히 따랐는지 다른 서브에이전트가 검증한다. 이 2단계 검증으로 임의 확장된 기능을 잡아낸다.
스펙 레벨 검증이 가능하다는 점이 기존 코드 리뷰와 가장 큰 차이다. “이 코드가 동작하는가”가 아니라 “이 코드가 기획서대로 동작하는가”를 본다.
서브에이전트 기반 컨텍스트 격리
각 작업마다 새로운 서브에이전트가 호출된다. 컨텍스트가 격리되어 이전 단계의 노이즈가 다음 단계에 영향을 주지 않는다. 이는 장시간 세션에서 AI가 본래 목표를 잃어버리는 컨텍스트 드리프트 문제를 해소한다.
실제 메모앱 제작 5단계 워크플로우
저자가 직접 메모앱을 만들어본 워크플로우는 다음과 같다.
| 단계 | 작업 내용 | 산출물 |
|---|---|---|
| Brainstorming | AI와 아이디어 발산 | 메모 |
| 기획서 작성 | 요구사항 명세 | spec.md |
| 구현 계획 | 단계별 작업 분해 | plan.md |
| 개발 | 실제 코드 작성 | 소스 코드 |
| 검증 | 스펙 준수 여부 확인 | 리뷰 리포트 |
각 단계는 별도로 커밋된다. 어떤 결정이 어디서 이뤄졌는지 git history로 추적할 수 있다.
Visual Companion 기능은 별도로 주목할 만하다. 시각적 목업과 레이아웃을 제시받아 UI 의도를 사전에 합의할 수 있다. “기획서 안에 포함된 디자인 시안”이 자동으로 만들어지는 셈이다.
사용 환경은 Claude Code Desktop이며 Max 플랜 이상이 권장된다. Subagent-driven 개발 방식과 스펙 드리븐 개발(Spec-Driven Development) 철학을 결합했다.
기획자 역할의 재정의
가장 흥미로운 시사점은 “기획이 AI 시대의 진정한 병목”이라는 인식 전환이다. 코드 작성 속도가 빨라질수록 정확한 요구사항 정의가 중요해진다. Superpowers는 이를 구조적으로 보장하는 프레임워크다.
저자는 글의 마지막에서 이렇게 정리한다. AI가 코드를 빨리 짤 수 있게 된 시대일수록, 무엇을 만들어야 하는지 정의하는 일이 가장 큰 부가가치를 만들어낸다. 기획자의 역할이 줄어든 게 아니라 오히려 더 중요해졌다.
결론
Superpowers는 AI 코딩 도구에 “기획서 먼저, 코드 나중”이라는 원칙을 구조적으로 강제하는 플러그인이다. 스펙 우선 작성, 이중 검증, 서브에이전트 격리라는 세 축으로 AI의 임의 확장을 막는다. 도구가 발전할수록 기획자의 역할이 오히려 더 중요해진다는 관점은 한 번쯤 곱씹어볼 만한 인사이트다.