Superpowers 완벽 가이드: Windows 설치부터 AI 코딩 실무까지

AI 개발 도구 · 설치 가이드 · 실무 적용

Superpowers 완벽 가이드: Windows 설치부터 AI 코딩 실무까지

AI 에이전트에게 코드를 바로 작성하게 하는 대신, 요구사항 분석부터 구현 계획, 테스트, 코드 리뷰까지 체계적으로 진행하게 만드는 방법을 알아봅니다.

기준일: 2026년 10월 13일

이 글에서 직접 따라 할 내용

Superpowers가 무엇인지 이해하기
Windows 개발 PC에서 사용할 코딩 에이전트 선택하기
Claude Code, Antigravity, Codex, Cursor 설치 방법 확인하기
설치 후 스킬이 실제로 작동하는지 검증하기
기능 요청을 분석하고 구현 계획을 작성하게 하기
C#, ASP.NET Core, SQL Server 프로젝트에 적용하기
테스트와 코드 리뷰를 통해 결과 검증하기

1. Superpowers란?

obra/superpowers 공식 GitHub 저장소는 AI 코딩 에이전트가 소프트웨어를 개발할 때 활용할 수 있는 스킬과 개발 방법론을 제공하는 프로젝트입니다.

일반적인 AI 코딩 작업에서는 개발자가 기능을 요청하면 에이전트가 곧바로 코드를 작성하는 경우가 많습니다. 하지만 요구사항이 불분명하거나 기존 구조를 충분히 파악하지 못하면 불필요한 코드가 늘어나고, 테스트가 빠지거나 기존 기능이 손상될 수 있습니다.

Superpowers는 작업에 맞는 스킬을 활용해 요구사항을 구체화하고, 계획을 수립하고, 테스트와 검토를 수행하는 개발 흐름을 지원합니다.

① 요구사항 분석

무엇을 만들고 어떤 조건을 지켜야 하는지 정리합니다.

② 구현 계획

수정할 파일과 작업 순서, 테스트 방법을 구체화합니다.

③ 구현과 테스트

작업 단위별로 코드를 작성하고 결과를 검증합니다.

④ 검토와 마무리

요구사항 충족 여부와 코드 품질을 확인합니다.

중요: Superpowers를 설치한다고 코드가 자동으로 정확해지거나 모든 테스트가 통과하는 것은 아닙니다. 에이전트가 사용할 수 있는 작업 절차를 제공하는 것이며, 결과의 정확성은 실제 코드와 테스트, 실행 환경을 통해 확인해야 합니다.

2. 설치 전 준비사항

Superpowers를 사용하려면 먼저 이를 실행할 코딩 에이전트가 필요합니다. Superpowers 자체를 별도의 독립형 IDE나 일반 Windows 프로그램으로 생각하면 안 됩니다.

준비 항목	확인할 내용
Windows PC	사용 중인 코딩 에이전트의 Windows 지원 여부 확인
코딩 에이전트	Claude Code, Antigravity, Codex 또는 Cursor 중 하나
Git	수동 설치 방식이나 저장소 작업을 사용할 경우 필요
기존 프로젝트	실무 적용 시 Git 상태와 현재 작업 브랜치를 확인

Git이 설치되어 있다면 PowerShell에서 다음 명령으로 확인할 수 있습니다.

git --version

버전 문자열이 출력되면 Git 명령을 실행할 수 있는 상태입니다. 명령을 찾을 수 없다는 오류가 발생하면 Git 설치 또는 PATH 설정을 확인합니다.

Git 공식 다운로드: https://git-scm.com/downloads

3. 코딩 에이전트별 설치 방법

아래 방법 중 현재 사용하는 에이전트에 해당하는 한 가지 방법부터 진행하면 됩니다. 여러 에이전트를 함께 사용한다면 각 에이전트에 별도로 설치해야 할 수 있습니다.

3-1. Claude Code

Superpowers는 Claude Code의 공식 플러그인 마켓플레이스를 통한 설치 방법을 안내합니다.

Claude Code를 실행합니다.
Claude Code 입력창에서 다음 명령을 실행합니다.

/plugin install superpowers@claude-plugins-official

설치 과정에서 표시되는 안내를 따릅니다.
필요한 경우 새 세션을 시작한 뒤 스킬 인식 여부를 확인합니다.

공식 저장소의 대체 마켓플레이스를 이용하려면 다음 두 명령을 순서대로 사용할 수 있습니다. 공식 마켓플레이스 방식과 대체 마켓플레이스 방식을 혼동하지 말고, 우선 공식 방식을 권장합니다.

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

3-2. Antigravity

공식 저장소는 Antigravity에서 플러그인을 설치하는 명령을 제공합니다.

agy plugin install https://github.com/obra/superpowers

이 명령은 Antigravity 환경에서 사용하는 명령입니다. 일반 PowerShell에 무조건 입력하는 명령이 아닙니다. Antigravity와 관련 CLI를 사용할 수 있는 상태인지 먼저 확인하고, 해당 환경에서 실행합니다.

Antigravity가 설치되어 있고 실행 가능한지 확인합니다.
해당 환경에서 agy 명령을 사용할 수 있는지 확인합니다.
위 설치 명령을 실행하고 오류가 없는지 확인합니다.
새 세션을 시작한 뒤 스킬이 활성화되는지 확인합니다.

명령이 인식되지 않으면 저장소 설치 명령을 반복하기보다 Antigravity의 현재 설치 및 CLI 안내부터 확인합니다.

3-3. Codex 앱

Codex 앱에서는 공식 플러그인 마켓플레이스를 통해 설치할 수 있습니다.

Codex 앱을 실행합니다.
사이드바에서 Plugins를 엽니다.
Coding 섹션에서 Superpowers를 찾습니다.
해당 항목 옆의 +를 선택하고 화면 안내에 따라 설치합니다.
새 대화에서 스킬이 작동하는지 확인합니다.

이 방식은 Codex 앱의 UI를 이용합니다. 아래 Codex CLI 설치 방식과는 별도입니다.

3-4. Codex CLI

Codex CLI에서는 플러그인 검색 인터페이스를 이용합니다.

/plugins

플러그인 검색 화면에서 superpowers를 검색하고 Install Plugin을 선택합니다. 메뉴가 보이지 않거나 설치가 실패하면 현재 Codex CLI 버전과 공식 설치 문서를 확인합니다.

대안: Windows에서 수동 연결하기

공식 Codex 안내에는 저장소를 내려받아 스킬 디렉터리를 연결하는 수동 설치 방법도 있습니다. 플러그인 마켓플레이스를 사용하기 어려울 때 선택할 수 있는 대안입니다.

먼저 PowerShell에서 저장소를 내려받습니다.

git clone https://github.com/obra/superpowers.git "$env:USERPROFILE\.codex\superpowers"

그다음 스킬 디렉터리를 만들고 Junction을 생성합니다.

New-Item -ItemType Directory -Force -Path "$env:USERPROFILE\.agents\skills"

cmd /c mklink /J "$env:USERPROFILE\.agents\skills\superpowers" "$env:USERPROFILE\.codex\superpowers\skills"

주의: 위 명령은 동일한 경로에 이미 저장소나 연결이 없는 경우를 전제로 합니다. 기존 폴더가 있다면 덮어쓰거나 삭제하지 말고 먼저 내용을 확인합니다. Junction 생성에 실패하면 관리자 권한이 필요한지, 경로가 이미 존재하는지 확인합니다.

설치 후 Codex를 재시작합니다. 이 수동 연결 방식과 플러그인 마켓플레이스 방식은 대체 경로이므로, 초보자는 먼저 앱 또는 CLI의 공식 플러그인 설치를 시도하는 편이 간단합니다.

상세 안내: Superpowers for Codex 공식 문서

3-5. Cursor

Cursor Agent 채팅에서 다음 명령을 사용해 플러그인 마켓플레이스 설치를 진행합니다.

/add-plugin superpowers

설치 과정에서 표시되는 안내를 따릅니다. 현재 버전에서 명령이 지원되지 않으면 Cursor의 플러그인 마켓플레이스에서 Superpowers를 검색하는 방법을 확인합니다.

명령어 주의: 과거 안내에서 볼 수 있는 /plugin-add와 혼동하지 마세요. 게시 시점에 최신 공식 저장소의 설치 안내를 다시 확인하는 것이 좋습니다.

4. 설치 후 실제로 작동하는지 확인하기

설치 명령이 오류 없이 끝났다는 사실만으로 Superpowers가 정상 작동한다고 단정할 수는 없습니다. 공식 저장소는 새 세션에서 스킬을 사용할 만한 작업을 요청해 설치를 확인하는 방법을 안내합니다.

1단계: 새 세션 열기

설치한 코딩 에이전트에서 새 세션 또는 새 대화를 엽니다. 기존 세션에 설치 이전의 지침이 남아 있을 수 있으므로 새 세션에서 확인하는 편이 명확합니다.

2단계: 스킬이 필요한 작업 요청하기

예를 들어 다음 요청을 입력합니다.

새 기능을 구현하기 전에 요구사항을 구체화해 줘.
먼저 확인 질문을 하고, 요구사항이 정리되면
구현 계획과 테스트 전략을 작성해 줘.
내가 계획을 검토하기 전에는 코드를 수정하지 마.

요구사항 분석이나 계획 수립에 해당하는 스킬이 호출되는지, 작업 계획이 제시되는지 확인합니다. 에이전트에 따라 스킬을 표시하는 방식은 다를 수 있습니다.

3단계: 결과 확인

요청을 이해하기 위한 질문을 하는가?
구현 전에 요구사항과 범위를 정리하는가?
작업에 맞는 구현 계획을 제시하는가?
테스트와 검증 방법을 설명하는가?
승인 전에는 코드 수정이나 외부 변경을 진행하지 않는가?

이 확인 항목은 실무에서 사용하기 위한 점검 기준입니다. 모든 에이전트가 동일한 화면이나 동일한 문구를 출력해야 한다는 의미는 아닙니다.

5. Superpowers의 기본 개발 작업 흐름

Superpowers의 핵심은 스킬 이름을 외우는 것이 아니라 현재 작업에 맞는 절차를 적용하는 것입니다. 일반적인 기능 개발은 다음과 같이 진행할 수 있습니다.

Step 1. 아이디어와 요구사항 구체화

Step 2. 구현 계획 작성

Step 3. 구현 방식 선택 및 작업 수행

관련 스킬: subagent-driven-development, executing-plans

하위 에이전트를 지원하는 환경에서는 작업별 구현과 검토를 나누는 흐름을 사용할 수 있습니다. 하위 에이전트를 지원하지 않는 환경에서는 계획을 현재 세션에서 순서대로 실행하는 방식이 적절할 수 있습니다. 지원 여부와 현재 버전의 동작을 확인해야 합니다.

Step 4. 테스트 우선 개발

관련 스킬: test-driven-development

테스트를 먼저 작성하고 실패하는 것을 확인한 뒤 최소한의 구현을 진행하고, 다시 테스트해 결과를 확인합니다. 모든 작업에 동일한 테스트 도구를 적용할 수 있는 것은 아니므로 프로젝트에 맞는 검증 방식을 선택합니다.

Step 5. 코드 검토

관련 스킬: requesting-code-review, receiving-code-review

요구사항을 충족했는지, 기존 구조를 불필요하게 변경하지 않았는지, 테스트와 예외 처리가 적절한지 검토합니다.

Step 6. 작업 마무리

관련 스킬: finishing-a-development-branch

변경 사항과 검증 결과를 확인하고 브랜치를 어떻게 마무리할지 결정합니다. 커밋, 병합, 푸시와 같은 작업은 프로젝트의 협업 규칙과 승인 절차에 맞춰 진행합니다.

이 흐름은 모든 작업에 무조건 적용해야 하는 고정 순서가 아닙니다. 간단한 수정에는 불필요한 절차를 줄이고, 여러 파일을 변경하는 기능이나 위험도가 높은 작업에는 계획과 검토를 강화하는 방식으로 적용합니다.

6. 실무 예제: ASP.NET Core에 검색 기능 추가하기

이제 기존 C# 프로젝트에 검색 기능을 추가한다고 가정하겠습니다. 예를 들어 게시판 목록에서 제목을 검색하고, 페이지 이동과 정렬을 유지하는 기능을 개발하는 상황입니다.

실무 예제의 전제

기존 프로젝트 구조와 코딩 규칙을 우선합니다.
사용 중인 프레임워크와 라이브러리를 임의로 교체하지 않습니다.
요청하지 않은 대규모 리팩터링을 하지 않습니다.
테스트와 빌드 결과를 확인한 후 완료 여부를 판단합니다.

6-1. 먼저 요구사항을 정리하도록 요청하기

프로젝트 루트에서 코딩 에이전트를 실행한 뒤 다음과 같이 요청합니다.

현재 ASP.NET Core 프로젝트에 게시판 검색 기능을 추가하고 싶다.

먼저 기존 프로젝트 구조와 관련 코드를 조사해 줘.
코드를 수정하기 전에 다음 항목을 정리해 줘.

1. 현재 게시판 목록을 처리하는 Controller, Service, Repository 또는
   해당 프로젝트에서 사용하는 계층
2. 검색 조건과 페이지 번호, 정렬 조건이 전달되는 경로
3. 기존 검색 및 페이징 구현 여부
4. 수정이 필요한 파일과 예상 영향 범위
5. 필요한 테스트와 검증 방법

기존 구조와 코딩 규칙을 우선하고,
조사 결과와 구현 계획을 내가 검토하기 전에는 파일을 수정하지 마.

이 단계의 목적은 코드를 빨리 생성하는 것이 아니라 실제 프로젝트 구조를 먼저 파악하게 하는 것입니다. 프로젝트에 없는 계층이나 파일을 가정해서 구현 계획을 만들지 않았는지 확인합니다.

6-2. 구현 계획 검토하기

계획이 제시되면 다음 항목을 확인합니다.

기존 코드와 실제 파일 경로가 일치하는가?
검색어가 없을 때 기존 목록 기능이 유지되는가?
페이지 번호와 정렬 조건이 검색 후에도 일관되게 유지되는가?
SQL 파라미터를 사용하고 있는가?
빈 검색어, 특수문자, 결과가 없는 경우를 고려했는가?
테스트 방법과 기대 결과가 구체적인가?

6-3. 계획을 승인한 뒤 구현하기

계획을 확인한 다음 작업을 진행하도록 지시합니다.

검토한 계획대로 구현을 진행해 줘.

작업 원칙:
- 기존 프로젝트의 구조와 네이밍 규칙을 유지한다.
- 필요한 범위만 수정한다.
- 테스트를 작성하거나 기존 테스트를 보완한다.
- 테스트가 실패하면 원인을 조사하고 수정한다.
- 빌드와 테스트 결과를 실제로 확인한다.
- 실행하지 않은 검증을 완료했다고 보고하지 않는다.

작업이 끝나면 수정한 파일, 변경 이유,
실행한 명령, 실제 결과, 남은 위험을 정리해 줘.

위 문장은 실무에 활용할 수 있는 예시 프롬프트입니다. Superpowers의 특정 명령어가 아니라, 에이전트가 프로젝트의 조건과 검증 책임을 이해하도록 돕는 요청입니다.

7. 테스트와 검증은 어떻게 진행할까?

코드가 생성되었다는 사실과 코드가 정상적으로 동작한다는 사실은 다릅니다. .NET 프로젝트에서는 프로젝트 구성에 맞춰 빌드와 테스트를 수행합니다.

예를 들어 솔루션 파일이 있는 프로젝트 루트에서 다음 명령을 사용할 수 있습니다.

dotnet build YourSolution.sln
dotnet test YourSolution.sln

YourSolution.sln은 예시 이름이므로 실제 솔루션 파일명으로 바꿔야 합니다. 테스트 프로젝트가 없거나 솔루션 구성이 다르면 명령과 검증 절차도 조정해야 합니다.

검증 항목	확인할 내용
빌드	컴파일 오류와 프로젝트 참조 오류가 없는가?
단위 테스트	핵심 로직과 예외 조건이 예상대로 동작하는가?
통합 테스트	DB와 API 등 연결되는 구성 요소가 함께 동작하는가?
회귀 테스트	기존 기능에 문제가 생기지 않았는가?
변경 사항 검토	요청과 무관한 파일이나 설정이 변경되지 않았는가?

빌드가 성공해도 기능 요구사항을 충족한다는 보장은 없습니다. 반대로 테스트 실행 환경이나 외부 서비스가 준비되지 않아 실패할 수도 있습니다. 따라서 실패 원인을 구분하고, 실제 실행 결과와 미실행 항목을 함께 보고해야 합니다.

8. SQL Server 프로젝트에 적용할 때의 안전 원칙

기존 업무 시스템에서는 데이터베이스 변경을 특히 주의해야 합니다. AI 에이전트가 SQL을 생성할 수 있더라도 운영 데이터에 대한 실행 권한을 무조건 부여해서는 안 됩니다.

읽기 작업과 데이터 변경 작업을 구분하기

조회 작업: 스키마 확인, SELECT 쿼리 작성, 실행 계획과 성능 지표 분석
변경 작업: INSERT, UPDATE, DELETE, DROP, TRUNCATE, 스키마 변경 등
외부 영향 작업: 운영 배포, 공유 브랜치 푸시, 병합, 외부 시스템 변경 등

변경 작업은 영향 범위와 대상 환경을 확인하고 승인 절차를 거친 뒤 실행하도록 해야 합니다. 특히 DELETE나 TRUNCATE처럼 데이터 손실을 유발할 수 있는 명령은 자동 실행을 허용하지 않는 것이 안전합니다.

실무용 안전 지침 예시

데이터베이스 작업 원칙:

1. 먼저 스키마와 관련 쿼리를 조사한다.
2. 조회 쿼리와 데이터 변경 쿼리를 구분한다.
3. 운영 데이터 변경은 실행 전에 대상, 조건, 예상 영향 범위를 설명한다.
4. DELETE, UPDATE, DROP, TRUNCATE 등 변경 작업은
   명시적인 승인을 받기 전에는 실행하지 않는다.
5. 가능하면 테스트 환경에서 검증한다.
6. 실행 결과와 영향받은 행 수를 확인한다.
7. 확인하지 못한 결과를 성공으로 보고하지 않는다.

이 지침은 실무 프로젝트에 적용할 안전 규칙의 예시입니다. Superpowers를 설치하는 것만으로 데이터베이스 권한이나 승인 정책이 자동 설정되는 것은 아닙니다. 실제 DB 계정 권한과 도구 설정도 별도로 관리해야 합니다.

9. 설치와 실행 중 문제가 발생한다면?

증상	확인 방법
설치 명령이 인식되지 않음	현재 에이전트와 CLI가 해당 명령을 지원하는지 공식 문서 확인
설치는 됐지만 스킬이 호출되지 않음	새 세션 시작 후 스킬을 활용할 만한 요청으로 다시 확인
Codex 수동 연결 오류	대상 경로와 기존 폴더, Junction 생성 결과 확인
빌드 실패	실제 오류 메시지, SDK 버전, 프로젝트 참조 확인
테스트 실패	코드 결함, 테스트 데이터, 외부 서비스, 환경 설정을 구분
AI가 계획 없이 코드를 변경함	새 세션에서 요구사항과 승인 조건을 명시하고 변경 사항 확인

오류가 발생했다고 바로 저장소를 삭제하거나 전체 설정을 초기화하지 마세요. 먼저 오류 메시지와 설치 경로를 확인하고, 기존 프로젝트나 설정을 보존한 상태에서 원인을 좁혀 가는 것이 좋습니다.

10. 최종 체크리스트

사용할 코딩 에이전트를 선택했다.
해당 에이전트의 공식 설치 방법을 확인했다.
설치 명령을 올바른 환경에서 실행했다.
새 세션에서 스킬이 인식되는지 확인했다.
요구사항과 구현 계획을 먼저 검토했다.
작업 범위와 수정 파일을 확인했다.
빌드와 테스트를 실제로 실행했다.
요청하지 않은 코드 변경이 없는지 검토했다.
데이터베이스 변경과 배포에 승인 절차를 적용했다.
실행하지 않은 테스트는 완료로 보고하지 않았다.

11. 공식 참고 링크

마무리

Superpowers를 실무에 적용할 때 가장 중요한 것은 설치 자체가 아니라 개발 절차를 일관되게 운영하는 것입니다. 요구사항을 먼저 구체화하고, 구현 계획을 검토하고, 코드를 변경한 뒤 실제 테스트와 리뷰를 수행하는 흐름을 만들어 보세요.

설치 명령과 플러그인 지원 여부는 각 에이전트의 업데이트에 따라 바뀔 수 있습니다. 실제 설치 전에는 위 공식 저장소의 최신 안내를 다시 확인하고, 운영 프로젝트에서는 테스트와 승인 절차를 유지해야 합니다.

LUCKY BLOG

Pinned Post