최근 'Vibe Coding'이라는 말이 유행하고 있지만, 솔직히 말해 좀 불안해 보입니다.
Claude Code는 확실히 우수합니다. 하지만 너무 우수한 나머지 무조건 "알겠습니다"만 하는 '예스맨'이 되어버린 건 아닐까요?
"이거 만들어줘"라고 하면 순식간에 코드를 뱉어냅니다. 하지만 막상 실행해보면 에러가 쏟아지죠. "돌아가기만 하면 되는" 수준의 코드라면 쓸 수 있겠지만, 견고한 시스템을 만들기에는 아직 '신입 개발자' 같은 느낌을 지울 수 없습니다.
그러던 중, GitHub에서 39k 스타를 기록한 괴물 같은 프로젝트를 발견했습니다. 바로 "Superpowers"입니다. 이건 정말 Claude Code의 사용 방식을 완전히 바꿔놓을 물건입니다.
단순한 프롬프트 모음집이 아닙니다. 이것은 Claude Code에 '엔지니어링 규율'을 주입하는 최강의 스킬셋입니다. "일단 구현"이 아니라, "먼저 생각하고, 그 다음 설계하고, 마지막으로 코딩하는" 우리 같은 일반적인 엔지니어들이 당연하게 여기는 과정을 AI에게 강제하는 것입니다.
1. 진정한 강점은 '서브 에이전트 모드'에 있다
왜 Superpowers가 기본 Claude보다 압도적으로 유용한 걸까요? 그 비밀은 서브 에이전트(Subagent)라는 구조에 있습니다.
일반적인 채팅 모드에서 Claude는 혼자 모든 책임을 지는 '고독한 전사'입니다. 대화가 길어질수록 이전 맥락을 잊어버리고 엉뚱한 소리를 하기 쉽죠. 이른바 '파편화' 현상입니다.
하지만 Superpowers를 도입하면 Claude는 "호랑이 PM + 엘리트 외주 부대"로 진화합니다.
- 메인 에이전트 (PM): 전체를 조망하고 설계도를 손에 쥔 채 지시를 내립니다. 절대 직접 손을 쓰지 않습니다.
- 서브 에이전트 (실무 부대): "암호화 모듈 작성", "유효성 검사 로직 생성"과 같은 세부 작업마다 그 작업만을 위한 일회용 에이전트를 소환합니다.
- 완벽한 분리: 이 서브 에이전트는 이전 작업의 에러 로그 따위는 모릅니다. 완전히 깨끗한 상태에서 작업하고, 끝나면 사라집니다. 그래서 '환각(Hallucination)'이 잘 일어나지 않습니다.
이 구조를 생각한 사람은 정말 천재인 것 같습니다.
2. 실전: 진지하게 '이메일 검증 서비스'를 만들게 해보았다
말만으로는 무엇이든 할 수 있죠. 실제로 조금 까다로운 요구사항으로 Python 이메일 검증 서비스를 만들게 해보았습니다.
Prompt:
I want to develop an enterprise-grade 'email validation service' in Python. It needs to support RFC standards (including sub-addressing user+tag), Internationalized Domain Names (IDN), and perform DNS MX record checks to prevent invalid emails. Please design the architecture.
Step 1. Brainstorm: 무작정 코드를 쓰게 하지 않는다
요구사항을 던지면 Superpowers는 자동으로 /brainstorm을 발동시킵니다. "알겠습니다, 코드 짭니다!"가 아닙니다.
"사용 시나리오는 무엇인가요?", "DNS 검증 레벨은?", "배포 환경은?"이라며 마치 베테랑 아키텍트처럼 역질문을 해옵니다. 이 과정을 거쳐 터미널에 아름다운 ASCII 아트 설계도가 그려졌을 때, 솔직히 전율을 느꼈습니다.
Step 2. Write Plan: 프로 수준의 프로젝트 구성
설계가 확정되면 Claude는 단순한 '코드 조각'이 아니라 완전한 프로젝트 구조를 제시합니다. validators/(로직), middleware/(제한), cache/(최적화)... 이건 사람이 처음부터 생각하려면 몇 시간은 걸릴 '프로의 구성'입니다. Superpowers는 이를 '원자 단위 태스크'로 정의하여 구현 중의 망설임을 없애줍니다.
Step 3. 구현과 TDD: 규율 있는 코딩
이제 /execute-plan을 실행하기만 하면 됩니다. Superpowers는 TDD(테스트 주도 개발)를 중시합니다. 먼저 tests/ 디렉토리에 '실패하는 테스트'를 준비하고, 그것을 통과하도록 코드를 짜 나갑니다.
AI가 흔히 저지르는 "일단 돌아가지만 테스트는 없는" 스파게티 코드의 양산을 근본적으로 막아주는 것입니다.
3. 그 API, 정말 '프로 사양'인가? Apidog으로 마무리하기
Superpowers 덕분에 로직 자체는 꽤 견고하게 만들어졌습니다. 하지만 서비스로 공개하려면 한 단계가 더 필요합니다. 바로 인터페이스의 표준화입니다.
로컬에서 돌아갔다고 만족하면 안 됩니다. 저는 생성된 코드에서 API 정의를 추출하여 Apidog에 넣습니다.
- 자동 인수 테스트: Apidog의 자동 테스트 기능을 사용하여 AI가 작성한 로직에 저인망식 테스트를 겁니다. "작동한다"와 "운영을 견딘다"는 다른 문제니까요.
- 문서 즉시 생성: AI가 좋은 코드를 써도 문서가 엉망이면 아무도 써주지 않죠. Apidog이라면 코드에서 아름다운 API 문서를 자동 생성해줍니다. 이걸 팀에 공유하는 순간, "오, 제대로 만들었네"라는 분위기가 됩니다.
- 책임의 분리: Superpowers는 '로직의 정확성'을 보증하고, Apidog은 '서비스의 품질'을 보증합니다. 이 조합이 최강입니다.
4. 도입은 단 두 줄이면 끝
Claude Code 환경이 있다면 도입은 순식간입니다.
-
마켓플레이스 추가:
/plugin marketplace add obra/superpowers-marketplace -
설치:
/plugin install superpowers@superpowers-marketplace
검증: /sup을 입력하고 execute-plan, brainstorm, write-plan 등이 나오면 OK입니다.
요약: 급할수록 돌아가라
지금의 AI 트렌드는 '생성 속도' 경쟁에 치우쳐 있습니다. 하지만 Superpowers는 정반대입니다. "생각해라", "테스트해라"라며 일부러 속도를 늦춥니다.
하지만 결과적으로는 어떨까요? 버그 수정으로 인한 재작업이 사라져 전체 개발 시간은 압도적으로 단축되었습니다.
소프트웨어 엔지니어링의 진리죠. "코드의 양보다 질". 그것을 AI에게 배우게 될 줄은 몰랐네요.
