AI 코딩, 왜 자꾸 엉뚱한 코드를 짤까? 정답은 'Superpowers'에 있습니다

📋 30초 요약 AI 코딩의 엉뚱한 결과를 막고, 시니어 엔지니어처럼 체계적으로 개발하게 만드는 워크플로우 플러그인입니다. 브레인스토밍 ➔ 계획 ➔ TDD(테스트 주도 개발) ➔ 구현 ➔ 검증의 단계를 시스템적으로 강제합니다. Codex App에서 원클릭으로 설치 가능하며, 적용 시 코드 안정성과 디버깅 효율이 비약적으로 상승합니다.

AI 코딩 툴을 쓰다 보면 답답할 때가 참 많지요? "React로 Todo 리스트 만들어줘"라고 한마디 했을 뿐인데, AI가 묻지도 따지지도 않고 수백 줄의 코드를 와르르 쏟아냅니다. 작동하면 다행이지만, 요구사항과 미묘하게 빗나가 있거나 에러가 발생하면 결국 사람이 처음부터 디버깅을 해야 하는 악순환에 빠집니다.

오늘 제가 소개해 드릴 'obra/superpowers'는 이러한 흐름을 완전히 뒤바꾸는 혁신적인 플러그인입니다. 단순한 프롬프트 모음집이 아니라, AI에게 "생각하고, 계획하고, 검증한 뒤에 코드를 짜라"는 시니어 엔지니어의 규율을 강제하는 시스템이지요. 실무에서 이 플러그인을 어떻게 적용하고 활용할 수 있는지, 깃허브 저장소 분석부터 실제 설치 방법까지 상세히 파헤쳐 보겠습니다.

https://github.com/obra/superpowers

GitHub - obra/superpowers: An agentic skills framework & software development methodology that works.

1. Superpowers 플러그인의 핵심 작동 원리 (Mechanism)

✅ 결론부터 말하자면: 구현 전에 '기획과 승인' 절차를 두어 묻지마 코딩을 원천 차단합니다.

보통의 AI 코딩 환경에서 AI는 사용자의 명령(Prompt)이 들어오면 곧바로 파일 수정에 돌입합니다. 하지만 Superpowers 환경이 적용된 Codex는 다릅니다. 새로운 기능을 요청받으면 먼저 요구사항을 명확히 하고, 접근 방식을 2~3가지 제안합니다. 사용자의 승인이 떨어지면 그제야 '구현 계획'을 작성하지요.

버그 수정도 마찬가지입니다. 무턱대고 코드를 지우고 쓰는 대신, 로그를 확인하고 데이터 흐름을 추적하여 가설을 세웁니다. 구현 단계에서는 TDD(테스트 주도 개발)를 엄격히 지키며, 작업이 끝난 후에는 "완료된 것 같습니다"라는 추측성 멘트 대신, 실제 검증 명령을 실행하고 그 결과를 바탕으로 완료를 선언합니다.

2. obra/superpowers 깃허브 저장소 심층 해부

✅ 결론부터 말하자면: 시스템적으로 AI의 행동을 제어하는 구조적인 라우팅 체계를 가집니다.

제가 obra/superpowers 저장소를 직접 분석해 보니, 이 플러그인은 단순히 텍스트 지시문을 모아둔 것이 아니라 시스템적으로 AI의 행동 방식을 제어하도록 정교하게 설계되어 있었습니다. 핵심 구조는 다음과 같습니다.

💡Tip: using-superpowers 스킬이 아키텍처의 중심에는 using-superpowers 훅이 있습니다. 이는 일종의 '라우터' 역할을 하여 세션이 시작될 때 적용 가능성이 1%라도 있으면 브레인스토밍, TDD, 디버깅 같은 하위 스킬들을 우선 적용하도록 강제합니다.

3. 일반 AI vs Superpowers 워크플로우 비교 (Comparison)

Superpowers가 가져오는 가장 큰 변화는 '과정의 투명성'입니다. 아래 비교를 보시면 그 차이를 명확히 아실 수 있습니다.

• 일반적인 AI 환경 (Standard):
  [요청] ➔ [AI가 즉시 파일 수정] ➔ [에러 발생] ➔ [사용자가 에러 복사/붙여넣기] ➔ [AI가 다시 수정 시도] (무한 반복)
• Superpowers 적용 환경:
  [요청] ➔ [브레인스토밍: 2~3가지 방향 제안] ➔ [사용자 승인] ➔ [구현 계획서 작성] ➔ [실패하는 테스트 코드 작성 (TDD)] ➔ [최소한의 코드 구현] ➔ [검증 명령 실행] ➔ [리뷰 및 완료]

🙋‍♂️ 실사용기"제가 실무에서 써보니, 처음에는 '테스트 코드부터 짜겠습니다'라며 제동을 걸어 코딩 속도가 느려지는 듯했습니다. 하지만 특히 '체계적 디버깅(Systematic Debugging)' 규칙은 감탄이 나옵니다. 에러가 났을 때 AI가 감으로 코드를 고치는 행위를 원천 차단하고, 최근 변경 내역 확인, 에러 스택 트레이스 분석 등을 거쳐 가설을 세운 뒤 코드를 수정하게 만들어 줍니다."

4. Codex App 환경 플러그인 설치 및 확인 (Checklist)

자, 이론을 알았으니 이제 직접 적용해 봐야겠지요? Codex App 환경에서 세팅하는 순서는 다음과 같습니다.

1. Codex App을 실행합니다.
2. 좌측 사이드바 메뉴에서 Plugins 탭으로 이동합니다.
3. Coding 카테고리를 선택하거나, 상단 검색창에 'Superpowers'를 검색합니다.
4. 해당 플러그인의 + (또는 Install) 버튼을 눌러 설치를 완료합니다.

⚠️ 주의하세요! (새 스레드 필수)설치 직후 기존 스레드에서 계속 대화하면 플러그인이 적용되지 않습니다. 세션 시작 시 훅(Hook)이 작동하므로 반드시 새 스레드(New Thread)를 열고 시작하셔야 합니다.

[정상 작동 확인 체크리스트]

새 스레드를 열고 "Let's make a react todo list" 라고 입력해 보세요.

• ❌ 적용 실패: AI가 곧바로 App.jsx나 index.js 파일을 생성하려고 합니까?
• ⭕ 적용 성공: AI가 프로젝트의 목적, 요구되는 핵심 기능(삭제, 수정 등), 디자인 방향 등에 대해 질문을 던지며 브레인스토밍을 시작합니까?

5. 자주 묻는 질문 (FAQ)

Q1. Superpowers는 Codex에 영구 적용되나요?

네, 플러그인 형태로 설치해 두었다면, 새 Codex 세션을 열 때마다 백그라운드에서 자동으로 규칙이 주입됩니다. 매번 번거롭게 프롬프트를 붙여넣을 필요가 없습니다.

Q2. 깃허브에 있는 프롬프트를 복사해서 수동으로 써도 되나요?

물론 일부 규칙을 복사해서 붙여넣어도 효과는 있습니다. 하지만 Superpowers의 진정한 가치는 SessionStart 훅을 통해 여러 스킬 간의 유기적인 라우팅(연결)을 자동으로 해주는 데 있습니다. 완전한 형태의 워크플로우를 원하신다면 공식 플러그인 설치를 강력히 권장합니다.

Q3. 코드를 빨리 짜고 싶은데, 자꾸 계획부터 세우자고 합니다. 끌 수 없나요?

끌 수도 있지만, 굳이 끄지 않아도 됩니다. Superpowers의 내부 규칙에는 "사용자의 지시가 최우선이다"라는 조항이 있습니다. 따라서 프롬프트에 *"브레인스토밍이나 TDD 생략하고, 지금 당장 이 함수를 파이썬으로 구현해 줘"*라고 명시적으로 지시하면, 플러그인 규칙을 무시하고 곧바로 코딩을 진행합니다.

마치며

AI를 단순한 '타자기'로 쓸 것인가, 아니면 내 프로젝트의 '시니어 파트너'로 쓸 것인가는 어떻게 툴을 세팅하느냐에 달려있습니다.

기능 요구사항이 애매하거나, 잦은 버그로 디버깅 지옥에 빠져 계신 분, 혹은 배포 전 코드 품질을 비약적으로 높이고 싶은 개발자분들이라면 오늘 소개해 드린 Codex Superpowers를 꼭 한번 경험해 보시길 바랍니다. 초기에는 엄격한 절차에 적응하는 시간이 필요하지만, 한 번 익숙해지면 예전의 무작위 코딩 방식으로는 돌아가기 힘드실 겁니다. 궁금한 점이 있다면 언제든 댓글로 남겨주세요!