Superpowers 완벽가이드 1편: 코딩 에이전트를 더 잘 일하게 만드는 시스템

요약#

참고 자료#

• obra/superpowers - GitHub README
• using-superpowers - SKILL.md
• brainstorming - SKILL.md
• Jesse Vincent - Superpowers: How I’m using coding agents in October 2025

문제 상황#

많은 사람이 코딩 에이전트를 처음 쓸 때 가장 먼저 기대하는 것은 속도입니다.
아이디어를 말하면 바로 코드가 나오고, 버그를 설명하면 곧장 수정 패치가 나오기를 바랍니다.

문제는 그 속도가 자주 오해와 함께 온다는 점입니다.
에이전트는 사용자의 말을 대충 그럴듯하게 해석한 뒤, 아직 확정되지 않은 요구사항을 사실처럼 받아들이고 구현을 시작하기 쉽습니다.

이때 생기는 낭비는 늘 비슷합니다.

• 요구사항을 잘못 이해한 채 코드부터 작성합니다
• 확인되지 않은 가정을 바탕으로 구조를 정합니다
• 테스트보다 구현이 먼저 나와서 수정 비용이 커집니다
• 작업이 끝났다고 말하지만, 실제 검증은 충분하지 않습니다

결국 문제는 모델이 똑똑하냐보다, 어떤 순서로 일하느냐에 가깝습니다.
속도는 이미 충분히 빠릅니다.
부족한 것은 절차와 규율입니다.

Superpowers는 무엇인가?#

Superpowers는 코딩 에이전트가 따라야 할 작업 절차를 문서화하고, 그 절차를 실제 세션에서 다시 꺼내 쓰게 만드는 시스템입니다.
공식 README는 이를 코딩 에이전트를 위한 완전한 소프트웨어 개발 workflow라고 설명합니다.

여기서 중요한 것은 두 가지입니다.

• 재사용 가능한 skills
• 그 skills를 먼저 찾고 따르도록 만드는 초기 지침

즉, Superpowers의 본체는 화려한 설치 명령이 아닙니다.
에이전트가 일을 시작하기 전에 “지금 이 상황에 맞는 절차가 있는가”를 먼저 확인하게 만드는 구조입니다.

이 지점에서 많은 분이 Superpowers를 단순한 프롬프트 꾸러미로 오해합니다.
하지만 프롬프트 꾸러미는 사람이 매번 꺼내 붙여넣어야 하고, 어떤 것을 언제 써야 하는지도 사람이 기억해야 합니다.

반대로 Superpowers는 “무엇을 해야 하는가”보다 “어떻게 시작해야 하는가”를 먼저 정의합니다.
그래서 같은 도구를 써도 작업 결과가 더 일관되게 나옵니다.

왜 프롬프트 모음과 다를까요?#

겉으로 보면 둘 다 텍스트 문서처럼 보입니다.
하지만 실제 역할은 꽤 다릅니다.

핵심은 자동 완성된 답변이 아니라, 자동으로 떠오르는 절차입니다.
Superpowers는 에이전트의 성능을 마법처럼 높여주는 비밀 옵션이 아니라, 산만한 작업을 구조화된 작업으로 바꾸는 운영체제에 가깝습니다.

어떻게 작동할까요?#

공식 저장소와 skill 문서를 함께 보면 Superpowers의 흐름은 비교적 선명합니다.
사용자 요청이 들어오면, 에이전트는 바로 코드를 쓰는 대신 관련 skill이 있는지 먼저 확인합니다.

이 짧은 흐름 안에는 using-superpowers, brainstorming, writing-plans, 구현 단계의 검증 skill이 순서대로 들어 있습니다.
이 흐름에서 특히 눈에 띄는 부분은 세 가지입니다.

왜 이 구조가 중요한가요?#

Superpowers의 진짜 가치는 기능 목록이 아니라, 암묵지를 외부 문서로 끌어낸다는 데 있습니다.
숙련된 개발자는 머릿속으로 알고 있는 순서를 자연스럽게 따르지만, 에이전트는 그 순서를 항상 기억하지 않습니다.

그래서 좋은 사용자는 결국 같은 말을 반복하게 됩니다.

• 먼저 설계하자
• 테스트부터 만들자
• 추측하지 말고 원인을 찾자
• 끝났다고 하기 전에 검증하자

Superpowers는 이 반복을 문서화합니다.
그리고 문서화된 절차를 필요할 때마다 다시 불러와, 에이전트가 스스로 그 순서를 따르게 만듭니다.

Jesse Vincent의 글도 같은 지점을 강조합니다.
설치 그 자체보다 흥미로운 부분은 skills이며, 이 skills가 에이전트에 작업 습관을 부여한다는 점입니다.

이 관점에서 보면 Superpowers는 모델을 더 똑똑하게 만드는 프로젝트가 아닙니다.
에이전트가 덜 충동적으로 일하게 만드는 프로젝트입니다.

한계도 분명합니다#

좋은 절차가 있다고 해서 모든 작업이 자동으로 좋아지지는 않습니다.
오히려 어디까지가 skill의 역할이고, 어디부터가 사람의 판단인지 분리해서 봐야 합니다.

실제 한계는 다음과 같습니다.

• skill을 읽고 따를 수 있는 도구 환경이 필요합니다
• 질문과 설계 단계가 늘어나므로, 성급한 사용자에게는 느리게 느껴질 수 있습니다
• 잘못된 목표가 들어오면 절차는 좋아져도 목표 자체는 여전히 잘못될 수 있습니다
• 팀의 기존 규칙과 충돌하면, 어떤 규칙이 우선인지 명확히 정해야 합니다

즉, Superpowers는 만능 자동화가 아닙니다.
다만 생각 없이 달리는 에이전트를, 설명 가능한 절차 위에서 달리게 만드는 데에는 매우 강합니다.

이 시리즈는 어디로 가나요?#

이 글은 개념만 다룹니다.
다음 글부터는 “그래서 실제로 어떤 느낌으로 쓰는가”를 차근차근 보여드릴 예정입니다.

현재 구상한 시리즈는 다음과 같습니다.

• 1편: Superpowers 완벽가이드 1편: 코딩 에이전트를 더 잘 일하게 만드는 시스템
• 2편: Superpowers 완벽가이드 2편: 설치하기
• 3편: Superpowers 완벽가이드 3편: 처음 시작할 때 바뀌는 대화 흐름
• 4편: Superpowers 완벽가이드 4편: 설계가 먼저인 작업 흐름
• 5편: Superpowers 완벽가이드 5편: 큰 작업을 작은 계획으로 나누는 구조
• 6편: Superpowers 완벽가이드 6편: 테스트와 리뷰를 중심에 두는 구현 흐름
• 7편: Superpowers 완벽가이드 7편: 여러 에이전트로 확장하는 고급 흐름

이 순서가 좋은 이유는, 독자가 먼저 큰 그림을 이해한 뒤에야 개별 skill의 의미가 살아나기 때문입니다.
설치 명령을 먼저 외우는 것보다, 왜 이런 시스템이 필요한지 먼저 이해하는 편이 훨씬 오래 갑니다.

Superpowers를 한 문장으로 정리하면 이렇습니다.
코딩 에이전트를 더 많이 일하게 만드는 시스템이 아니라, 더 나은 순서로 일하게 만드는 시스템입니다.