무엇을 하나

obra/superpowers는 코딩 에이전트가 곧바로 코드를 쓰지 않고 정해진 절차를 따르도록 하는 '스킬' 모음이자 개발 방법론이다. README에 따르면 에이전트는 무언가를 만들려 한다는 것을 인식하면 먼저 사용자가 정말 원하는 바를 되묻는다. 이후 대화에서 명세를 추려 읽기 좋은 분량으로 나눠 보여주고, 승인을 받으면 구현 계획을 세운다. 주 언어는 셸(Shell)이며 라이선스는 MIT다.

작동 방식

핵심은 상황에 맞게 자동으로 발동하는 스킬이다. README가 설명하는 기본 흐름은 다음과 같다.

  1. brainstorming: 요구사항을 질문으로 끌어내고 설계 문서를 만든다.
  2. using-git-worktrees: 설계 승인 뒤 새 브랜치에 격리된 작업 공간을 만들고 테스트 기준선을 확인한다.
  3. writing-plans: 작업을 2~5분 단위로 쪼개 파일 경로, 코드, 검증 단계를 명시한다.
  4. subagent-driven-development / executing-plans: 작업마다 새 서브에이전트를 투입해 검토하거나, 현재 세션에서 일괄 구현한 뒤 마지막에 한 번 검토한다.
  5. test-driven-development: 실패하는 테스트를 먼저 쓰는 레드-그린-리팩터 사이클을 강제하고, 테스트 이전에 작성한 코드는 삭제한다.
  6. requesting-code-review와 finishing-a-development-branch: 계획 대비 검토 후 병합·PR 등 선택지를 제시한다.

프로젝트 측은 에이전트가 계획에서 벗어나지 않고 두어 시간씩 자율적으로 일하는 경우도 드물지 않다고 설명한다. 이 밖에 체계적 디버깅, 완료 전 검증, 세션 오작동을 진단하는 diagnosing-superpowers 등의 스킬도 포함된다.

써보면

설치는 에이전트마다 다르며, 여러 도구를 쓴다면 각각 설치해야 한다. 클로드 코드에서는 공식 마켓플레이스로 설치한다.

/plugin install superpowers@claude-plugins-official

제미나이 CLI(Gemini CLI), 깃허브 코파일럿 CLI, 큐웬 코드(Qwen Code), 키미 코드(Kimi Code), 오픈코드(OpenCode), 파이(Pi), 헤르메스 에이전트(Hermes Agent) 등도 각자의 설치 명령을 제공한다. 설치 후에는 별도 조작 없이 "리액트 할 일 목록을 만들자"처럼 말하면 코드를 쓰기 전에 brainstorming이 먼저 발동한다.

의의와 한계

특정 모델이 아니라 여러 에이전트 도구에 공통으로 얹는 방법론이라는 점이 특징이다. 반면 스킬이 자동 발동하는 구조라 의도와 다르게 작동하거나 토큰 사용이 늘 수 있다는 점은 README도 인정한다. 운영팀은 이런 문제를 위해 진단용 스킬을 따로 두었다. 또 새 스킬 기여는 원칙적으로 받지 않고, 스킬 수정은 지원하는 모든 에이전트에서 동작해야 한다는 조건을 둔다. 기업용 상용 지원과 함께, 일부 시각화 기능에는 사용 현황 파악용 텔레메트리가 포함돼 있어 도입 전 확인이 필요하다. 에이전트 코딩을 도입하려는 국내 개발팀에는 프롬프트 관례를 팀 표준 절차로 정리하는 참고 사례가 될 수 있다.