개발자 일자리 위협? 이 AI 에이전트는 '진짜' 엔지니어처럼 일합니다 (obra/superpowers 분석)
AI가 ‘코드’만 짜는 시대는 끝났습니다: obra/superpowers 완전 정복
여러분의 AI 코딩 파트너는 어떤가요? 혹시 무턱대고 코드를 쏟아내다가 버그를 만들고, 수정하다가 더 큰 버그를 만들지는 않나요? 우리는 지금까지 AI를 단순히 ‘빠른 타이핑 도구’로만 사용해 왔을지도 모릅니다.
하지만 오늘 소개할 obra/superpowers는 다릅니다. 이 프로젝트는 AI에게 코드를 짜라고 시키는 대신, “소프트웨어 엔지니어링을 하라”고 명령합니다. 요구사항을 분석하고(Brainstorm), 설계를 마친 뒤(Plan), 테스트 주도 개발(TDD)로 구현(Finish)하는 ‘시니어 개발자의 작업 프로세스’를 AI에게 이식한 것입니다.
GitHub에서 조용히 그러나 폭발적으로 주목받고 있는 이 Agentic Skills Framework를 심층 분석합니다.
1. obra/superpowers란 무엇인가?
GitHub 리포지토리: obra/superpowers
obra/superpowers는 Claude Code (및 OpenCode) 환경을 위한 에이전트 스킬 프레임워크(Agentic Skills Framework)입니다.
일반적인 AI 코딩 툴이 사용자의 질문에 즉답을 내놓는 ‘챗봇’에 가깝다면, Superpowers는 AI에게 엄격한 업무 규율(Methodology)을 부여합니다. 이 프레임워크를 설치하면 AI는 단순히 코드를 생성하는 것을 넘어, 마치 실제 개발 팀의 일원처럼 행동하게 됩니다.
핵심 철학: “Vibes”가 아닌 “Engineering”
대부분의 LLM은 확률에 기반해 ‘그럴듯한(Vibes)’ 코드를 작성하려 합니다. Superpowers는 이를 거부하고 다음을 강제합니다:
- 명세(Specification) 없이는 코드를 짜지 않는다.
- 계획(Plan) 없이는 파일을 수정하지 않는다.
- 테스트(Test) 없이는 작업을 완료하지 않는다.
2. 주요 기능 (Key Features)
이 프로젝트의 README와 문서는 AI를 ‘숙련된 엔지니어’로 만들기 위한 구체적인 스킬(Skills)과 워크플로우(Workflows)를 정의하고 있습니다.
2.1. The Holy Trinity (3대 핵심 워크플로우)
Superpowers의 핵심은 다음 세 가지 단계적 명령어입니다.
/brainstorm(브레인스토밍 & 명세)- AI가 바로 코딩에 뛰어들지 못하게 막습니다.
- 사용자와 대화하며 해결하려는 문제의 본질, 제약 조건, 엣지 케이스를 파악합니다.
- 결과물로 명확한 요구사항 명세서를 작성합니다.
/plan(설계 & 계획)- 작성된 명세를 바탕으로 구현 계획(Implementation Plan)을 수립합니다.
- 어떤 파일을 생성하고, 어떤 함수를 수정할지, 테스트는 어떻게 할지 단계별로 정리합니다.
- 사용자가 이 계획을 승인하기 전까지는 코드를 건드리지 않습니다.
/finish(구현 & 검증)- 계획에 따라 코드를 작성합니다.
- 중요: 단순히 코드를 짜는 게 아니라, TDD(테스트 주도 개발) 방식을 따릅니다. 테스트를 먼저 작성하고, 이를 통과하는 코드를 구현하며, 최종적으로 모든 테스트가 통과되었는지 확인합니다.
2.2. Skills System (스킬 시스템)
이 리포지토리는 수십 개의 SKILL.md 파일들로 구성되어 있습니다. 이 파일들은 AI에게 특정 상황에서 어떻게 행동해야 하는지를 가르치는 ‘매뉴얼’ 역할을 합니다.
- Debugging Skill: 에러 로그를 읽고 근본 원인을 추적하는 법.
- Testing Skill: 단위 테스트를 작성하고 실행하는 법.
- Collaboration Skill: 사용자에게 명확하게 질문하고 의도를 파악하는 법.
2.3. Context Injection (컨텍스트 주입)
사용자가 별도로 프롬프트를 입력하지 않아도, Superpowers는 AI의 시스템 프롬프트에 현재 프로젝트의 상태와 필요한 스킬을 자동으로 주입합니다. 덕분에 AI는 대화가 길어져도 자신의 역할과 현재 진행 중인 단계(설계 중인지, 구현 중인지)를 잊지 않습니다.
3. 아키텍처 및 작동 원리 (Deep Dive)
어떻게 AI에게 이런 행동을 강제할 수 있을까요?
- Markdown as Code: 모든 ‘스킬’은 마크다운 문서로 작성되어 있습니다. AI는 이 문서를 읽고 자신의 행동 지침(System Prompt)으로 삼습니다. 이는 코드를 수정하지 않고도 AI의 행동을 교정할 수 있는 매우 유연한 구조입니다.
- Symlink Strategy: 설치 시, 이 스킬 파일들은 Claude Code나 OpenCode의 설정 디렉터리(
~/.config/...)로 심볼릭 링크(Symlink)됩니다. 즉, 리포지토리를 업데이트하면(git pull), 내 AI의 능력도 즉시 업그레이드됩니다. - Native Tool Integration: Claude Code의 기본 도구(Tool) 시스템과 통합되어, AI가 스스로 판단하여 필요한 스킬(예: “지금은 문서를 찾아봐야 해”)을 호출할 수 있습니다.
4. 설치 및 설정 가이드 (Installation)
주의: 이 도구는 Claude Code 또는 OpenCode가 설치된 환경을 전제로 합니다. 터미널 사용에 익숙해야 합니다.
1단계: 리포지토리 클론
먼저 obra/superpowers 리포지토리를 로컬 설정 디렉터리에 복제합니다.
1
2
3
4
5
# 디렉터리 생성 (없는 경우)
mkdir -p ~/.config/opencode
# 리포지토리 클론
git clone https://github.com/obra/superpowers.git ~/.config/opencode/superpowers
2단계: 플러그인 및 스킬 디렉터리 준비
OpenCode(또는 Claude Code)가 인식할 수 있는 폴더 구조를 만듭니다.
1
2
mkdir -p ~/.config/opencode/plugins
mkdir -p ~/.config/opencode/skills
3단계: 심볼릭 링크 연결 (핵심)
Superpowers의 기능을 활성화하기 위해 심볼릭 링크를 생성합니다. (기존에 설치된 것이 있다면 rm으로 삭제 후 진행하세요.)
1
2
3
4
5
6
# 플러그인 연결
ln -s ~/.config/opencode/superpowers/.opencode/plugins/superpowers.js ~/.config/opencode/plugins/superpowers.js
# 스킬 연결
# 주의: skills 디렉터리 안에 'superpowers'라는 이름으로 링크를 겁니다.
ln -s ~/.config/opencode/superpowers/skills ~/.config/opencode/skills/superpowers
4단계: 재시작
사용 중인 Claude Code 또는 OpenCode 세션을 재시작하면 설치가 완료됩니다.
(참고: Claude Code의 경우 마켓플레이스 명령어를 지원할 수도 있으나, 최신 기능을 사용하려면 위와 같이 Git Clone 방식을 추천합니다.)
5. 실전 사용 가이드 (Usage Workflow)
설치가 완료되었다면, 이제 AI와 함께 ‘일’을 해볼 차례입니다.
시나리오: “로그인 페이지 만들어줘”
1. 브레인스토밍 (/brainstorm)
1
2
3
4
5
User: /brainstorm 사용자 로그인 기능을 추가하고 싶어.
AI: 알겠습니다. 로그인 기능에 대해 구체화해 봅시다.
- 이메일/비밀번호 방식인가요, 소셜 로그인인가요?
- 비밀번호 찾기 기능이 포함되나요?
- 보안 요구사항(2FA 등)은 무엇인가요?
AI는 명확한 명세가 나올 때까지 질문을 던집니다. 합의가 끝나면 SPECIFICATION.md 같은 문서를 생성합니다.
2. 계획 수립 (/plan)
1
2
3
4
5
6
7
User: /plan
AI: 앞서 확정된 명세를 바탕으로 계획을 세우겠습니다.
1. User 모델 업데이트 (DB 스키마 변경)
2. AuthController 생성
3. 로그인 UI 컴포넌트 작성
4. 단위 테스트 및 통합 테스트 작성
이 계획으로 진행할까요?
3. 구현 및 종료 (/finish)
1
2
3
4
5
6
7
User: /finish
AI: 작업을 시작합니다.
- [Test] 로그인 실패 테스트 작성... 완료
- [Code] 인증 로직 구현... 완료
- [Test] 테스트 실행... 통과
- [Refactor] 코드 정리...
모든 작업이 완료되었습니다.
6. 장단점 비교 (Pros & Cons)
| 구분 | 일반 AI 코딩 (ChatGPT, Copilot) | Superpowers (Claude Code + Plugin) |
|---|---|---|
| 접근 방식 | 즉각적인 코드 생성 (Speed) | 체계적인 엔지니어링 (Quality) |
| 오류 제어 | 사용자가 직접 코드 리뷰 및 수정 | AI가 테스트를 통해 스스로 검증 |
| 복잡도 | 복잡한 요구사항 시 문맥을 잃기 쉬움 | 계획(Plan)을 통해 복잡한 과업을 쪼개서 수행 |
| 속도 | 빠름 (하지만 디버깅에 시간 소요) | 느림 (설계/테스트 과정 포함) |
| 사용자 경험 | 주니어 개발자에게 지시하는 느낌 | 시니어 개발자와 협업하는 느낌 |
7. 결론: AI 에이전트의 미래를 미리보다
obra/superpowers는 단순히 편리한 도구가 아닙니다. 이것은 “AI와 인간이 어떻게 협업해야 하는가”에 대한 모범 답안을 제시합니다.
우리는 종종 AI에게 “그냥 해줘(Do it)”라고 말하고 결과물에 실망합니다. 하지만 Superpowers는 우리에게 “먼저 생각하고, 계획하고, 검증하라”는 소프트웨어 개발의 기본 원칙을 AI에게 가르쳤습니다. 그 결과, AI는 비로소 믿을 수 있는 동료가 되었습니다.
지금 당장 여러분의 터미널에 Superpowers를 설치해보세요. 그리고 AI가 여러분의 코드를 ‘망치는’ 것이 아니라, 견고하게 ‘건축’하는 과정을 지켜보시기 바랍니다.
한 줄 요약: AI에게 코딩을 시키지 말고, 엔지니어링을 시키세요. 그 시작이 바로 Superpowers입니다.
References
- https://github.com/obra/superpowers