⚡
★ 86.6k

Superpowers 시작하기

한 번 설치하면. AI가 작동하는 방식이 영구적으로 바뀝니다.

Superpowers란 무엇인가요? (기술적 설명)

Superpowers는 에이전틱 skills 프레임워크입니다 — AI 코딩 에이전트에 로드하는 구조화된 행동 프로토콜 모음입니다. Jesse Vincent가 만들었으며, 그는 역사상 가장 널리 배포된 이슈 추적 시스템 중 하나인 Request Tracker의 저자로 잘 알려져 있습니다.

이 프레임워크는 AI 에이전트가 소프트웨어 개발 중에 어떻게 생각하고 행동해야 하는지를 정의합니다 — 단순히 어떤 코드를 작성할지뿐만 아니라, 언제 멈추고 질문해야 하는지, 어떻게 계획을 세우는지, 어떻게 검증하는지, 그리고 무언가가 실제로 완료됐는지 어떻게 알 수 있는지를 정의합니다.

기술적으로, Superpowers는 skills 모음입니다(플랫폼에 따라 plugins 또는 rules라고도 불립니다). 각 skill은 특정 조건에서 활성화되는 집중된 지침 세트입니다. AI 도구에 Superpowers를 설치하면, 기계가 읽을 수 있는 프로토콜로 구축된 전문적인 소프트웨어 엔지니어링 규율을 AI에게 부여하는 것입니다.

핵심 철학

Superpowers는 모든 skill에 걸쳐 적용되는 세 가지 원칙을 기반으로 합니다:

1. TDD 우선 (Test-Driven Development)

failing test 없이는 어떠한 production 코드도 작성되지 않습니다. 이것은 지침이 아닙니다 — 강제되는 규칙입니다. AI는 어떠한 구현도 작성하기 전에 실패하는 테스트를 작성해야 합니다. 이 단계를 건너뛰고 싶은 유혹이 생긴다면, Superpowers는 테스트 없이 작성된 모든 코드를 삭제하고 처음부터 다시 시작할 것을 명시적으로 요구합니다.

이것이 중요한 이유: 코드 작성 후에 작성된 테스트는 코드가 해야 하는 것이 아닌 코드가 하는 것을 테스트하는 경향이 있습니다. 먼저 작성된 테스트는 의도를 포착하고 가정을 조기에 발견합니다.

2. YAGNI (You Aren't Gonna Need It)

명시적으로 필요한 것만 구축합니다. 투기적 추상화, "미래 대비", "혹시 모를" 추가 설정 옵션은 없습니다. 코드베이스에 추가하는 모든 것은 유지보수 비용이 있습니다. Superpowers는 AI가 현재 작업에 집중하도록 유지합니다.

3. 주장보다 증거

테스트가 통과하는 것을 보는 것이 증거입니다. 작동해야 한다고 말하는 것은 주장입니다. Superpowers는 AI가 완료됐다고 주장하기 전에 실제 출력 — 실제 테스트 결과, 실제 명령 출력, 실제 파일 diff — 을 생성하도록 요구합니다. "작동해야 합니다"는 허용되는 완료 선언이 아닙니다.

설치

Superpowers는 여러 플랫폼에서 작동합니다. 사용하는 도구를 선택하세요:

Claude Code

/plugin install superpowers@claude-plugins-official

이것은 전체 Superpowers skill 스위트를 Claude Code 세션에 설치합니다. Skills는 컨텍스트에 따라 자동으로 활성화됩니다.

Cursor

/add-plugin superpowers

플러그인을 추가한 후, Cursor가 skill 정의를 로드합니다. Cursor 세션을 재시작해야 할 수 있습니다.

Gemini CLI

gemini extensions install superpowers

확장 프로그램을 승인하기 위한 프롬프트를 따르세요. 모든 skills는 다음 Gemini CLI 세션에서 사용 가능해집니다.

Codex

Codex 설정 파일을 통해 Superpowers를 사용자 정의 지침 세트로 추가하세요. 플러그인 설치 경로는 공식 Codex 문서를 참조하세요.

OpenCode

opencode plugin add superpowers

Skills는 세션 시작 시 자동으로 로드됩니다.

설치 확인

설치 후, AI 에이전트에게 물어보세요:

"어떤 Superpowers skills가 사용 가능한가요?"

올바르게 설치된 Superpowers 스위트는 활성화된 skills를 나열합니다. brainstorming, writing-plans, executing-plans, test-driven-development 등을 포함한 skills가 보여야 합니다.

에이전트가 skills를 인식하지 못한다면, 설치 명령을 다시 실행하고 세션을 재시작하세요.

7단계 핵심 워크플로

설치되면, Superpowers는 구조화된 7단계 프로세스를 통해 개발을 안내합니다. 아래는 간단한 개요입니다 — 각 단계에는 전용 챕터가 있습니다.

단계Skill설명
1BRAINSTORM문제 공간 탐구
2ISOLATE안전한 작업 환경 생성
3PLAN상세한 작업 목록 작성
4EXECUTEsubagents로 구현
5TESTTDD 사이클: Red → Green → 완료
6REVIEW2단계 품질 게이트
7COMPLETE검증된 인도

1단계: Brainstorming

AI가 어떤 코드도 건드리기 전에 여러분과 함께 문제를 탐구합니다. 한 번에 하나씩 명확화 질문을 하고, 트레이드오프와 함께 2~3가지 접근 방식을 제시하며, 여러분의 승인을 기다립니다. 하드 게이트가 설계가 승인될 때까지 코드 작성을 방지합니다.

→ Brainstorming & Design에서 자세히 다룸

2단계: Isolation

작업은 git worktree에서 이루어집니다 — 저장소의 격리된 복사본입니다. 변경 사항은 의도적으로 병합될 때까지 격리됩니다. main branch는 항상 안전합니다.

→ 실행 워크플로의 일부로 다루어짐

3단계: Writing Plans

실행이 시작되기 전에 상세한 구현 계획이 작성됩니다. 계획의 각 작업은 완전한 코드 스니펫, 정확한 파일 경로, 정확한 명령과 함께 자체 완결됩니다. 계획은 검토되고 승인됩니다.

→ Writing Plans에서 자세히 다룸

4단계: Execution & Subagents

계획의 작업들은 신선한 subagent 프로세스에 디스패치됩니다 — 이전 작업에 대한 기억이 없는 격리된 AI 인스턴스입니다. 이는 한 작업의 오류가 다음 작업을 오염시키는 것을 방지합니다. 완료된 각 작업은 2단계 리뷰를 거칩니다.

→ Execution & Subagents에서 자세히 다룸

5단계: Test-Driven Development

모든 기능은 failing test로 시작합니다. RED-GREEN-REFACTOR 사이클을 엄격하게 따릅니다. 테스트 스위트를 실행하고 실제 통과 출력을 볼 때까지 어떤 기능도 완료로 표시되지 않습니다.

→ Test-Driven Development에서 자세히 다룸

6단계: Review

2단계 리뷰 프로세스가 spec 준수(요청된 것을 구축했나요?)와 코드 품질(코드가 유지보수 가능하고 올바른가요?) 모두를 확인합니다. 이 두 관심사는 별도로 평가됩니다.

→ Execution & Subagents 챕터의 일부

7단계: Completion

모든 검증 게이트가 통과된 후, 에이전트는 깔끔한 완료 보고서를 제시하고, pull request 생성을 돕고, 작업이 적절히 통합되도록 보장합니다. 증명 가능하게 완료될 때까지 아무것도 "완료"가 아닙니다.

→ finishing-a-development-branch skill 문서에서 다룸

빠른 참조: 주요 명령

액션AI에게 말할 내용
새 기능 시작"저는 [기능]을 추가하고 싶습니다. brainstorming skill을 사용하세요."
계획 작성"설계에 동의했습니다. 구현 계획을 작성하세요."
계획 실행"subagents를 사용하여 이 계획을 실행하세요."
TDD 실행"test-driven development를 사용하여 [기능]을 구현하세요."
작업 리뷰"완료하기 전에 이 구현을 리뷰하세요."

다음 단계

이 가이드는 워크플로의 각 단계를 심도 있게 다룹니다. 챕터는 첫 번째 읽기에는 순서대로 읽고, 이후에는 참고 자료로 사용하도록 설계되었습니다.

기억하세요: Superpowers는 속도를 늦추기 위한 것이 아닙니다. 작성 → 버그 → 수정 → 다시 버그의 값비싼 사이클을 멈추기 위한 것입니다. 초기의 규율이 이후에 여러 배의 시간을 절약합니다.