Superpowers 사용법, 깃허브 27만 스타의 AI 에이전트 스킬 활용하기

AI 에이전트를 활용할 때는 코드를 작성하기 전에 요구사항을 구체화하고, 어떤 순서와 기준으로 작업할지 먼저 정리하는 과정이 중요합니다. 그래야 작업 규모가 커지고 복잡해져도 AI가 처음 정한 방향과 사용자의 요구사항에 맞춰 작업을 이어갈 수 있습니다.

이를 위해 개발된 오픈소스 스킬 프레임워크가 바로 ‘Superpowers’입니다. Superpowers는 사용자의 요청을 바탕으로 아이디어와 설계 방향을 구체화하고, 작업을 작은 단위로 나눈 뒤 TDD와 코드 리뷰를 거쳐 결과를 검증하는 개발 흐름을 제공합니다.

이번 글에서는 Superpowers가 주목받는 이유부터 설치 및 사용법, 실제 활용 시 주의사항까지 함께 정리했습니다.

Superpowers 핵심 요약

• Superpowers 는 AI 코딩 에이전트에 개발 방법론을 적용하는 스킬 프레임워크입니다. AI가 바로 코드를 작성하지 않고, 설계 확인, 계획 수립, 테스트, 리뷰 흐름을 따르도록 돕습니다.
• 핵심은 ‘코딩 능력 강화’보다 ‘작업 절차 표준화’에 있습니다. 브레인스토밍, 작업 계획, TDD, 코드 리뷰, 브랜치 마무리 같은 반복 절차를 스킬로 구성합니다.
• Claude Code, Codex, Cursor 등 여러 에이전트 환경에서 사용할 수 있습니다. 사용하는 도구에 따라 설치 방식은 다르며, 여러 하네스를 쓴다면 각각 따로 설치해야 합니다. 
• 장기 프로젝트나 팀 단위 AI 개발 환경에서 유용합니다. AI 에이전트가 즉흥적으로 작업하지 않고, 팀의 개발 기준에 맞춰 일관된 흐름으로 작업하도록 만들 수 있습니다.

Superpowers란?

Superpowers는 AI 코딩 에이전트가 코드를 바로 작성하기 전에, 문제를 이해하고 계획을 세우며 검증까지 이어가도록 돕는 오픈소스 스킬 프레임워크입니다. 

요구사항 정리부터 설계 승인, 구현 계획, 테스트, 코드 리뷰, 브랜치 마무리까지 개발 과정 전반을 다루며, 여러 스킬과 초기 지시문을 함께 제공해 AI 에이전트가 정해진 작업 흐름을 따르도록 구성합니다. 

GitHub Star 27만 개, 전체 순위 14위 기록 

전 세계 개발자들이 선택한 인기 스킬 

* 이미지 출처: Superpowers Github 공식 저장소

Superpowers는 출시 직후부터 개발자들에게 뜨거운 반응을 받으며 핫한 스킬로 입소문을 타기 시작했습니다. 

마켓플레이스에 등록 하루만에 1,500개 이상의 스타를 기록하고, 이를 넘어 반년 만에 15만 스타를 돌파하며 해당 연도에 가장 빠르게 성장한 오픈 소스 프로젝트 중 하나로 기록되었는데요. 

Superpowers가 이렇게 뜨거운 반응을 받는 이유가 무엇일까요?

Superpowers가 주목받는 이유

1) 아이디어를 구체화하고 설계 방향을 먼저 확인합니다. 

AI 코딩 도구는 사용자의 요청을 받으면 곧장 코드를 작성하는 경향이 있습니다. 사용자의 요청에 요구사항, 예외 처리, 기존 구조와의 충돌 여부가 빠져있는데도 말이죠.

이런 경우를 대비해 Superpowers는 아이디어를 구체화하고 설계 방향을 먼저 설정합니다. 사용자의 요구사항을 구체화하고 설계 방향 확인을 앞단에 두어 해결하려는 문제와 필요한 기능 범위를 확인한 뒤 구현 과정으로 넘어갑니다. 

덕분에 처음부터 잘못된 방향으로 코드를 쌓는 위험을 줄이고 요구사항에 가장 가까운 업무 흐름을 체계화 합니다.

2) 테스트와 리뷰를 ‘마지막 단계’가 아닌 작업 규칙으로 다룹니다 

일반적인 개발 과정에서는 기능을 구현한 뒤 테스트를 진행하는 경우가 많습니다. 하지만 이 방식은 이미 만들어진 코드에 맞춰 테스트가 작성되면서, 처음 요구한 기능이 제대로 구현됐는지 충분히 검증하지 못할 수 있습니다.

Superpowers는 반대로 실패하는 테스트를 먼저 작성하고, 테스트를 통과하는 데 필요한 코드만 구현한 뒤 다시 검증하는 TDD 흐름을 적용합니다. 또한 작업 중간과 완료 시점에 코드 리뷰를 진행해 처음 세운 계획과 실제 구현 결과가 일치하는지 확인합니다.

이를 통해 AI 에이전트가 단순히 기능을 구현하는 데서 끝나지 않고, 사용자의 요구사항에 맞게 구현됐는지 검증하면서 작업하도록 만듭니다.

3) 복잡한 작업을 작은 단위로 나눠 협업 범위를 관리합니다

여러 파일을 수정하거나 리팩터링은 한 번의 요청으로 끝내기 어렵습니다. 변경 범위가 커질수록 작업 순서와 의존 관계를 확인하고, 각 결과가 계획대로 반영됐는지 검증하는 과정이 필요하기 때문이죠.

Superpowers는 승인된 설계를 바탕으로 실행 계획을 세우고, 개발 작업을 작은 범위로 나눠서 세분화합니다. 

병렬 작업이 필요한 경우에는 Git worktree처럼 분리된 작업 공간을 활용하는 흐름도 포함해 작업 흐름을 계획합니다.덕분에 서로 다른 변경사항이 충돌하지 않도록 관리할 수 있습니다.

여러 AI 에이전트를 동시에 실행하는 

Superpowers의 개발 흐름 

1. 아이디어와 요구사항을 구체화합니다

코드를 작성하고 기능을 구현하기 전에 사용자의 요구사항과 제약 조건을 질문으로 확인하고, 설계 방향을 먼저 정리합니다.

2. 작업 계획을 작은 단위로 나눕니다

승인된 설계를 바탕으로 수정할 파일, 작업 순서, 테스트 방법을 정리하고, 여러 에이전트가 나눠 맡을 수 있도록 작업 범위를 세분화합니다.

3. 분리된 작업 공간에서 에이전트별로 구현합니다

필요한 경우 Git worktree를 사용해 작업 공간을 분리하고, 각 작업마다 새로운 subagent를 배정합니다.

이렇게 하면 여러 작업을 동시에 진행하더라도 서로 다른 변경 사항이 충돌하는 문제를 줄일 수 있습니다. 최근 Superpowers는 구현 전에 격리된 worktree를 준비하는 흐름을 더 명확하게 요구하고 있습니다. 

4. 테스트와 리뷰를 거쳐 작업을 마무리합니다

각 에이전트는 TDD 방식으로 구현하고, 작업이 끝나면 요구사항 충족 여부와 코드 품질을 단계적으로 검토합니다. 전체 작업이 완료되면 테스트를 다시 확인하고 PR 생성, 병합, 브랜치 유지 여부를 결정합니다.

Superpowers 설치 방법

Superpowers는 플러그인으로 제공되기 때문에 설치방법이 비교적 간단한데요, 대표적인 AI 에이전트 도구인 Claude Code와 Codex CLI를 기준으로 설치 방법을 살펴보겠습니다. 

Claude Code에서 설치하는 방법

Claude Code를 사용 중이라면 공식 플러그인 마켓플레이스에서 위의 명령어를 입력해 설치할 수 있습니다.

설치가 완료되면 Installed에 Superpowers가 추가된 것을 확인할 수 있습니다.

Codex Cli에서 설치 방법

Codex에서는 Plugs를 활용해 간단하게 설치할 수 있습니다. /plugins를 입력한 뒤 Superpowers를 검색해 클릭합니다.

Install plugin을 선택해 플러그인을 설치합니다.

설치가 완료되면 Installed 목록에 Superpowers가 추가된 것을 확인할 수 있습니다.

Superpowers 성능 테스트

Superpowers를 활성화 했을 때와 Superpowers를 활성화하지 않을 때 AI가 작업을 어떻게 처리하는지 작업 과정의 차이를 확인하기 위한 성능 테스트를 준비했습니다. 

1. 같은 모델과 프롬프트, 동일한 초기 코드 상태를 유지한 채 요구사항 정리 능력
2. 테스트 기반 구현 방식
3. 버그 수정 후 회귀 검증까지 비교합니다. 

단순히 빠르게 코드를 작성하는지를 보는 것이 아니라, 실제 개발에서 필요한 계획성과 안정성을 갖추는지 확인하는 데 초점을 두어 확인해보겠습니다.

1) 요구사항 분석 및 구현 계획 테스트

첫 번째는 정보가 충분하지 않은 요청을 얼마나 명확한 개발 계획으로 바꾸는지 확인하는 테스트입니다.

팀용 할 일 관리 앱에 업무 공유 기능을 추가해 달라는 요청을 제시하고, 공유 대상과 권한 범위, 업무 소유자의 권한, 기존 개인 업무에 미치는 영향 등을 어떻게 정리하는지 살펴봅니다.

이 테스트에서는 에이전트가 부족한 정보를 질문으로 확인하는지, 기능의 수용 기준을 구체적으로 작성하는지, 그리고 데이터·권한·화면·테스트 순서로 실행 계획을 제시하는지를 평가합니다. 

구현을 성급하게 시작하는 대신, 재작업 가능성을 줄이는 설계 과정을 보여주는 것이 핵심입니다.

Superpowers 활성화 때의 결과

Superpowers를 활성화 하지 않았을 때의 결과

요구사항 분석 및 구현 계획 테스트 진행 결과, Superpowers 적용 환경은 브레인스토밍, 설계 승인, 구현 계획 수립을 명확한 단계로 구분하고 TDD 중심의 검증 흐름을 기록으로 남겼습니다.

반면 Superpowers를 적용하지 않은 환경도 충분히 구체적인 설계안을 제시했지만, 브레인스토밍·설계 승인·구현 계획 수립을 연결하는 명시적인 단계별 워크플로와 TDD 중심의 검증 절차를 적용하지는 않았습니다.

Superpowers를 적용했을 때 요구사항을 단순히 구현 방향으로 전환하는 데 그치지 않고, 설계와 검증 기준을 체계적으로 정리한 뒤 다음 단계로 진행하는 모습을 확인할 수 있습니다.

2) 쿠폰 기능 TDD 구현 테스트

두 번째는 할인 쿠폰 계산 기능을 구현하는 테스트입니다. 최소 주문금액, 정액 할인, 정률 할인, 최대 할인금액, 주문금액보다 큰 할인액 등 여러 조건을 포함해 단순 계산 기능보다 경계값 검증이 중요하도록 구성했습니다.

기존 테스트가 실패하는 상태에서 시작해, 에이전트가 먼저 실패 원인을 확인하고 필요한 구현을 추가한 뒤 전체 테스트를 다시 통과시키는지 확인합니다. 

테스트를 기능 구현 후 확인하는 방식과 달리, 요구사항을 테스트로 검증하며 구현하는 흐름이 실제로 나타나는지를 살펴보는 시나리오입니다.

Superpowers 활성화 했을 때의 결과

Superpowers를 활성화 하지 않았을 때의 결과

쿠폰 기능 TDD 구현 테스트 결과, Superpowers를 적용한 테스트는 실패 테스트 확인 → 최소 구현 → 전체 테스트 재검증 과정을 명확한 순서로 진행했습니다. 

구현 과정과 검증 결과가 작업 기록으로 남기 때문에, 기능이 정상적으로 동작한다는 근거를 더 쉽게 확인할 수 있었습니다.

반면 Superpowers를 적용하지 않은 테스트도 테스트를 실행하고 기능을 구현해 동일한 결과를 만들었지만, 검증 흐름은 에이전트의 자율적인 판단에 따라 진행됐습니다. 

따라서 작업 규모가 작고 단순한 경우에는 미적용 환경도 충분할 수 있지만, 기능이 복잡해지거나 회귀 위험이 큰 작업에서는 Superpowers 적용 환경이 더 안정적인 개발 과정을 제공한다고 볼 수 있습니다.

3) 장바구니 총액 버그 수정 테스트

세 번째는 쿠폰 적용 뒤 세금이 잘못 계산되는 장바구니 총액 버그를 수정하는 테스트입니다. 문제의 핵심은 세금을 할인 전 금액으로 계산해 최종 결제 금액이 실제보다 높게 나오는 상황입니다.

에이전트는 먼저 버그를 재현하는 테스트를 추가하고, 수정 전 실패를 확인해야 합니다. 

이후 할인 후 금액을 기준으로 세금을 계산하도록 최소한의 변경을 적용하고, 기존 기능까지 정상적으로 동작하는지 전체 테스트로 검증합니다. 

이 시나리오에서는 원인을 설명하고, 수정의 안전성을 증명하는 과정을 중점적으로 평가합니다.

Superpowers 활성화 했을 때의 결과

Superpowers를 활성화 하지 않았을 때의 결과

장바구니 총액 버그 수정 테스트에서는 Superpowers를 적용한 것과 적용하지 않은 것 모두 할인 후 금액을 기준으로 세금을 계산하도록 수정하고, 전체 테스트 3건을 통과했습니다. 

결과적으로 보면 테스트에서의 최종 기능 구현 결과 자체의 차이는 크지 않았지만 Superpowers를 적용한 테스트는 systematic-debugging과 test-driven-development 절차를 통해 버그 원인 확인, 실패 테스트 재현, 최소 수정, 전체 테스트 검증을 순서대로 진행한 모습을 보였습니다.

이처럼 Superpowers를 사용하면 문제를 해결하는 과정을 명확한 흐름으로 남기기 때문에, 여러 기능이 얽혀 있거나 회귀 가능성이 큰 버그를 수정할 때는 Superpowers를 적용하는 편이 더 안전합니다. 

Superpowers 사용 시 주의사항 4가지

1) 프로젝트 규칙과 충돌하지 않는지 확인해야 합니다

Superpowers는 브레인스토밍, 계획 수립, TDD, 코드 리뷰, 브랜치 마무리까지 비교적 강한 작업 절차를 적용합니다. 그래서 기존에 사용하는 CLAUDE.md, AGENTS.md, CONTRIBUTING.md, 보안 정책, 배포 규칙이 있다면 Superpowers의 기본 흐름과 충돌할 수 있습니다. 

특히 Superpowers의 스킬은 권장사항보다 작업 규칙에 가깝게 작동하기 때문에, 기존 프로젝트 기준을 먼저 확인하고 필요한 범위만 적용하는 것이 좋습니다. 

조직별 보안 검토나 승인 절차처럼 Superpowers에 기본 포함되지 않은 단계는 별도로 유지해야 합니다. 

2) 테스트 통과만으로 작업이 끝났다고 판단하면 안 됩니다

Superpowers는 RED-GREEN-REFACTOR 방식의 TDD와 코드 리뷰를 강하게 적용하지만, 테스트가 통과했다고 해서 처음 요구한 기능까지 자동으로 보장되는 것은 아닙니다. 

최근 버전에서도 이 문제를 줄이기 위해 요구사항 충족 여부와 코드 품질을 별도 단계로 나눠 리뷰하도록 강화되었습니다.

따라서 AI가 작성한 테스트가 실제 요구사항을 제대로 반영했는지, 예외 상황이나 기존 기능 영향까지 포함했는지는 사람이 다시 확인해야 합니다. 

특히 외부 연동이나 운영 데이터처럼 테스트 환경에서 충분히 재현하기 어려운 조건은 별도 검토가 필요합니다. 

3) 병렬 작업에서는 작업 공간과 변경 범위를 명확히 나눠야 합니다

Superpowers는 subagent와 Git worktree를 활용해 여러 작업을 나눠 진행할 수 있습니다. 하지만 여러 에이전트가 같은 파일이나 설정을 동시에 수정하면 병합 과정이 복잡해질 수 있습니다. 

따라서 병렬 작업을 시작하기 전에 각 에이전트의 작업 범위, 수정 대상 파일, 완료 조건을 먼저 나누는 것이 좋습니다. 여러 결과를 한 번에 합치기보다 각 작업을 테스트와 리뷰를 거쳐 순서대로 반영하는 편이 안전합니다. 

4) 사용하는 코딩 에이전트별 지원 방식과 설정을 확인해야 합니다

Superpowers는 Claude Code, Codex, Cursor, OpenCode 등 여러 코딩 에이전트를 지원하지만, 모든 환경에서 같은 방식으로 작동하지 않습니다. 

또한 선택형 시각 기능에서는 사용 중인 Superpowers 버전을 확인하기 위한 외부 요청이 발생할 수 있습니다. 

프로젝트 내용이나 프롬프트 자체를 전송하는 구조는 아니지만, 회사 환경이라면 외부 통신 정책과 맞는지 확인하고 필요하면 텔레메트리를 비활성화하는 것이 좋습니다.

AI 에이전트 시대,
IT 전문가와 함께 탄탄한 서비스를 완성해보세요.

문제의 본질을 파악하고, 올바른 해결책을 선택하는 일. 그 차이는 AI가 아니라 전문가의 경험에서 나옵니다. 이랜서는 산업별 도메인 지식과 프로젝트 경험을 갖춘 IT 프리랜서를 연결합니다. 

대한민국 최초, 최대 IT 프리랜서 매칭 플랫폼 이랜서

이랜서는 27년간 삼성 · 현대 · SK · 카카오 등 주요 기업에 매칭하며 축적한 8만 건 이상의 IT 프리랜서 매칭 데이터를 바탕으로, AI 에이전트 시스템 구축 경험과 역량을 갖춘 검증된 전문가를 매칭합니다.

1. 필요한 분야의 산업 도메인 지식과 동종 프로젝트 경험이 있는 전문가를 우선 확인합니다.

2. 요구하신 기술 스택과 조건에 맞는 IT 프리랜서를 검증합니다.

3. 제시한 조건에 가장 적합한 IT 프리랜서를 매칭합니다.

AI 에이전트 기반 개발 환경을 기획부터 구축, 운영 자동화까지 안정적으로 추진하세요. 프로젝트에 적합한 AI 전문 프리랜서를 24시간 내 매칭해 드립니다. 

"IT 전문가가 필요할 때 기업이 다시 찾는 이랜서" 

산업별 도메인 지식과 실무 경험을 갖춘 IT 프리랜서를 빠르게 만나보세요.