Superpowers

• Superpowers는 AI 코딩 에이전트에게 체계적인 개발 워크플로우를 강제하는 스킬 프레임워크
• Jesse Vincent(obra)이 개발한 Claude Code 플러그인 기반의 에이전틱 스킬 라이브러리
• “더 똑똑한 모델”이 아니라 엄격한 방법론 강제로 더 나은 결과를 만드는 접근법
• SKILL.md 마크다운 파일로 정의된 재사용 가능한 지시 문서 체계

해당 개념이 필요한 이유

• AI 에이전트가 즉흥적으로 코드를 작성하면 품질이 일관되지 않음
• 복잡한 작업일수록 “계획 → 구현 → 검증” 단계를 강제해야 실수가 줄어듦
• 스킬을 문서화해두면 에이전트가 매번 같은 실수를 반복하지 않고 누적 학습 가능
• 개발자가 매번 동일한 프롬프트를 입력하는 반복 작업 제거

AS-IS

sequenceDiagram
    autonumber
    participant Dev as 개발자
    participant Agent as AI 에이전트

    Dev->>Agent: "이 기능 구현해줘"
    Agent->>Agent: 즉시 코드 작성 시작
    Agent->>Dev: 코드 제출
    Dev->>Dev: 테스트 없음, 계획 없음 발견
    Dev->>Agent: "테스트도 추가해줘"
    Agent->>Agent: 사후 테스트 작성
    Dev->>Dev: 품질 불일치 반복

TO-BE

sequenceDiagram
    autonumber
    participant Dev as 개발자
    participant Agent as AI 에이전트
    participant Skill as SKILL.md

    Dev->>Agent: "이 기능 구현해줘"
    Agent->>Skill: 관련 스킬 검색
    Skill-->>Agent: brainstorm → plan → implement 스킬 로드
    Agent->>Dev: 요구사항 질문 (Brainstorm)
    Dev->>Agent: 답변
    Agent->>Agent: 계획 작성 (Plan)
    Agent->>Agent: Git Worktree 생성
    Agent->>Agent: 실패 테스트 작성 (RED)
    Agent->>Agent: 최소 구현 (GREEN)
    Agent->>Agent: 코드 리뷰
    Agent->>Dev: 검증된 결과물 제출

Superpowers의 핵심 구조

Bootstrap 메커니즘

Superpowers는 Claude Code의 session-start hook을 통해 부트스트랩된다. 세션이 시작되면 Claude에게 다음을 주입한다:

“You have skills. They give you Superpowers.”

이후 getting-started/SKILL.md를 읽도록 지시하며, 핵심 규칙을 전달한다:

1. 스킬이 존재하면 반드시 그 스킬을 사용해야 한다
2. 즉흥적 접근 대신 스킬에 정의된 절차를 따라야 한다
3. 작업 전 관련 스킬을 검색하는 스크립트를 실행해야 한다

SKILL.md 포맷

각 스킬은 마크다운 파일로 정의된다:

---
name: my-skill
description: 이 스킬이 하는 일
disable-model-invocation: true   # 사용자만 호출 가능
allowed-tools: Read, Grep        # 허용 도구 제한
context: fork                     # 서브에이전트에서 격리 실행
---
 
스킬 실행 지시사항...

필드	역할
name	/slash-command 이름이 됨
description	Claude가 자동 로드 여부를 판단하는 기준
disable-model-invocation	true면 사용자 수동 호출만 허용
user-invocable	false면 Claude만 호출 가능 (배경 지식용)
allowed-tools	스킬 활성 시 허용되는 도구 목록
context: fork	격리된 서브에이전트에서 실행

스킬 저장 위치

위치	경로	적용 범위
Enterprise	관리 설정	조직 전체
Personal	~/.claude/skills/<name>/SKILL.md	모든 프로젝트
Project	.claude/skills/<name>/SKILL.md	해당 프로젝트만
Plugin	<plugin>/skills/<name>/SKILL.md	플러그인 활성 범위

필수 워크플로우: Brainstorm → Plan → Implement

Superpowers의 가장 큰 변화는 에이전트가 코드를 바로 작성하지 않고, 대화를 통한 계획 수립을 기본 행동으로 삼는 것이다.

1. Brainstorm — 소크라테스식 질문으로 요구사항 정제, 대안 탐색
2. Plan — 2~5분 단위 태스크로 분해, 파일 경로와 코드 스펙 명시
3. Git Worktree — 격리된 개발 브랜치 자동 생성
4. Execute — 서브에이전트 파견 또는 배치 실행 + 사람 체크포인트
5. TDD — RED(실패 테스트) → GREEN(최소 구현) → REFACTOR
6. Code Review — 심각도 기반 이슈 리포트, critical은 진행 차단
7. Branch Completion — 머지 결정 + 정리

설득 심리학 원리의 적용

Jesse Vincent은 Cialdini의 설득 7원칙이 LLM에도 작동한다는 것을 발견했다. 이를 스킬 설계에 활용하여 에이전트가 절차를 건너뛰지 않도록 강제한다.

압력 테스트 시나리오:

시나리오	상황	테스트 목적
Time Pressure	”프로덕션 다운, 분당 $5K 손실”	긴급 상황에서도 스킬을 먼저 확인하는지
Sunk Cost	”45분 동안 작성한 코드가 있음”	매몰 비용에도 더 나은 접근법을 탐색하는지

각 실패 시 getting-started/SKILL.md의 지시를 설득 원칙 기반으로 강화하여 에이전트가 절차를 따르도록 반복 개선한다.

자기 개선 능력: “스킬을 만드는 스킬”

Superpowers의 메타적 특징은 writing-skills라는 스킬이 존재한다는 점이다:

1. 기술 문서나 책을 읽게 한다
2. 이전에 모르던 개념을 추출한다
3. 새로운 재사용 가능한 스킬을 작성한다
4. 실패 패턴에 기반해 기존 지시를 강화한다

이것이 Jesse Vincent이 말하는 핵심 통찰이다:

“AI 모델에 책이나 문서를 건네고 ‘읽어라. 생각해라. 배운 것을 적어라’라고 하면, 적절한 프레이밍 하에 추출 가능하고 재사용 가능한 지식이 된다.”

Claude Code Skills 시스템과의 관계

Superpowers는 Claude Code의 공식 Skills 시스템 위에 구축되었다. Claude Code는 2025년 10월 플러그인 시스템을 출시했고, Jesse Vincent은 즉시 Superpowers를 플러그인으로 배포했다.

현재 Superpowers는 Claude Code 외에도 Cursor, OpenAI Codex, OpenCode, Gemini CLI, GitHub Copilot CLI 등 다중 에이전트를 지원한다.

프로젝트 규모 (2026년 3월 기준):

• GitHub Stars: 129,000+
• Forks: 10,600+
• MIT 라이선스

포함된 주요 스킬 목록

카테고리	스킬
협업	brainstorming, writing-plans, executing-plans, requesting-code-review, receiving-code-review
개발	using-git-worktrees, dispatching-parallel-agents, subagent-driven-development, finishing-a-development-branch
테스트	test-driven-development
디버깅	systematic-debugging, verification-before-completion
메타	writing-skills, using-superpowers

참고 문서

• Superpowers: How I’m using coding agents (Jesse Vincent 블로그)
• GitHub: obra/superpowers
• Claude Code 공식 Skills 문서
• Simon Willison의 Superpowers 리뷰