31만 스타를 받은 Markdown 폴더, Superpowers의 방법론

이번 주 GitHub 트렌딩 1위 저장소는 모델도, 프레임워크도, 스타트업의 오픈소스 미끼도 아닙니다. 코딩 에이전트가 어떻게 행동해야 하는지 알려주는 Markdown 파일 묶음입니다.

Jesse Vincent의 Superpowers는 스타 약 311,000개에 지난주 5,900개쯤이 붙었습니다. 저장소 자신의 설명은 이렇습니다. 코딩 에이전트를 위한 완전한 소프트웨어 개발 방법론이고, 조합 가능한 스킬 세트와 에이전트가 실제로 그 스킬을 쓰게 만드는 초기 지시로 구성됩니다.

방법론에 30만 스타는 이상한 광경입니다. 10년 만에 가장 큰 개발자 집단이 동시에 프로세스를 원하기로 결정했거나, 스타 버튼이 “나중에 생각해 봐야지” 북마크가 된 겁니다. 아마 둘 다겠죠. 그래도 이 물건 자체는 진지하게 볼 값이 있습니다. 에이전트가 코드를 쓰기 전에 무엇을 해야 하는가에 대해 누구보다 주관이 뚜렷한 답이니까요.

첫 동작은 시작하지 않는 것

README가 설명하는 워크플로는 이렇습니다. 에이전트는 당신이 뭔가 만들고 있다는 걸 알아차리는 순간 코드를 쓰기 시작하지 않습니다. 한 발 물러나서 당신이 실제로 뭘 하려는지 묻습니다.

대화에서 스펙을 끌어낸 다음, 읽을 수 있을 만큼 짧은 덩어리로 나눠 보여줍니다. 요구 사항 한 벽이 아니라 덩어리로요. 승인하면 구현 계획을 만듭니다. README의 표현대로 “취향은 나쁘고 판단력도 없고 프로젝트 맥락도 없으며 테스트를 혐오하는 열의 넘치는 주니어 엔지니어”가 따라 할 수 있을 만큼 상세하게요.

그 문장이 이 저장소에서 가장 좋은 부분입니다. 동시에 LLM이 안 좋은 날 보이는 모습에 대한 정확한 묘사이고, 그 독자를 위해 계획을 쓰는 건 대부분의 엔지니어가 건너뛰는 규율입니다. 독자가 우리 맥락을 공유한다고 가정하니까요.

그리고 “시작”이라고 말하면 서브에이전트 주도 개발을 시작합니다. 에이전트들이 각 작업을 처리하고, 자기 작업을 검사하고 리뷰하며 계속 나아갑니다. README는 에이전트가 계획에서 벗어나지 않고 두어 시간을 자율로 일하는 게 드문 일이 아니라고 합니다.

상자 안에 실제로 든 것

스킬이 열다섯 개쯤 되고, 기능별로 묶여 있습니다.

테스트에는 항목이 하나인데, 그게 중요한 하나입니다. test-driven-development, 즉 레드-그린-리팩터 사이클이고, 테스트 안티패턴에 관한 참고 문서가 붙습니다. 디버깅에는 systematic-debugging이 있습니다. 추적, 심층 방어, 조건 기반 대기에 기법이 정리된 4단계 근본 원인 프로세스입니다. 여기에 verification-before-completion이 붙는데, 하는 일은 하나입니다. 고쳐지지 않은 것에 대해 에이전트가 승리를 선언하는 걸 막는 것.

무게중심은 협업에 있습니다. 의도를 끌어내는 brainstorming, writing-plans, executing-plans, dispatching-parallel-agents, 코드 리뷰 요청과 수용, using-git-worktrees, finishing-a-development-branch, 그리고 2단계 리뷰가 붙은 subagent-driven-development입니다. 스펙 준수 여부를 먼저, 그다음 코드 품질을 봅니다.

메타 스킬 둘이 고리를 닫습니다. 새 스킬을 만드는 writing-skills, 그리고 대화 시작 시 모델이 시스템을 불러오게 만드는 도입부 using-superpowers입니다. 스킬이 자동으로 트리거되니 이론상 이걸 하나하나 기억할 필요가 없습니다. 당신의 에이전트가 그냥 갖고 있는 겁니다.

설치는 하네스마다, 열여섯 번

에이전트 도구 시장이 얼마나 파편화됐는지 보여주는 대목입니다. Superpowers는 Claude Code, Antigravity, Codex 앱과 CLI, Cursor, Devin CLI, Factory Droid, Gemini CLI, GitHub Copilot CLI, Grok Build, Kimi Code, OpenCode, Pi, Qwen Code, Hermes, Muse용 지시를 함께 배포합니다.

Claude Code, 공식 마켓플레이스 기준입니다.

/plugin install superpowers@claude-plugins-official

Vincent 자신의 마켓플레이스를 통해서도 됩니다.

/plugin marketplace add obra/superpowers-marketplace
/plugin install superpowers@superpowers-marketplace

Cursor는 에이전트 채팅에서 /add-plugin superpowers. Gemini CLI는 gemini extensions install https://github.com/obra/superpowers. Copilot CLI는 마켓플레이스를 등록한 뒤 copilot plugin install superpowers@superpowers-marketplace. Antigravity는 agy plugin install https://github.com/obra/superpowers. Devin은 devin plugins install obra/superpowers. Factory Droid는 등록 후 설치. Codex 앱과 CLI는 둘 다 공식 플러그인 마켓플레이스를 거칩니다.

하네스를 두 개 이상 쓴다면 각각 따로 설치해야 합니다. 같은 스킬 열두 개가 공유 업데이트 경로 없이 열두 벌로 존재한다는 뜻이고, README의 업데이트 안내는 “코딩 에이전트에 따라 다소 다르지만 대개 자동”입니다. 이 프로젝트에 대한 비판이 아닙니다. 생태계의 현 상태이고, 방법론 저장소가 그걸 감당하는 걸 보는 건 꽤 유익합니다.

기여 정책이 본심을 말해 준다

기여 섹션에 파묻혀 있는 내용입니다. 새 스킬 기여는 대체로 받지 않고, 스킬 수정은 지원하는 모든 에이전트에서 동작해야 하며, 다른 사람이 올린 이슈를 고치는 에이전트 작성 PR은 메인테이너가 요청하지 않는 한 받지 않습니다. 당신이 같은 문제를 겪었더라도요.

그 마지막 규칙이 왜 있는지 생각해 보세요. 이런 저장소의 뻔한 실패 모드는, 스킬이 통제하려는 바로 그 에이전트들이 만들어 낸 그럴듯한 스킬에 파묻히는 것입니다. Vincent는 그걸 예상하고 미리 막았습니다. 불친절해 보이는 비용을 치르면서요.

더 미묘한 함의도 있습니다. 에이전트가 무엇이든 스킬로 만들 수 있다면, 희소한 자원은 스킬이 아니라 어떤 스킬을 가질 가치가 있는지에 대한 판단입니다. 이 저장소가 실제로 파는 게 그 판단이고, 그건 풀 리퀘스트로 열려 있지 않습니다.

방법론이 깨지는 곳

네 가지, 제가 목격한 빈도 순입니다.

프로세스는 취향을 고치지 못합니다. 잘못 구상한 기능을 완벽하게 실행한 계획은 잘 테스트된 잘못된 물건을 낳습니다. brainstorming 스킬은 당신이 진짜 원하는 게 뭔지 물어서 도와주지만, 아이디어가 시시하다고 말해 주지는 않습니다.

토큰 경제. 스펙, 덩어리 단위 리뷰, 계획, 서브에이전트 파견, 작업마다 2단계 리뷰, 완료 전 검증. 작은 작업에서는 엄청난 오버헤드입니다. 이 방법론은 며칠 단위 작업을 전제로 설계됐고, 한 줄 수정에는 우스워 보일 겁니다.

계획은 흘러갑니다. 0분에 쓴 계획을 향한 두 시간의 자율 작업은 계획이 맞았을 때는 괜찮습니다. 세 번째 작업이 두 번째 작업의 잘못된 가정을 드러내면, 두 시간의 자신감 넘치는 잘못된 방향 작업이 남고, 리뷰만이 당신과 거대한 diff 사이를 막고 있습니다.

그리고 솔직한 하나. 스킬은 프롬프트이고, 프롬프트는 제안입니다. 여기 있는 모든 것은 모델이 이미 아는 다섯 가지 대신 이 스킬을 따르기로 선택하는 데 달려 있습니다. using-superpowers가 부트스트랩으로 존재하는 이유입니다. 다른 프롬프트를 불러오게 하는 일이 임무인 프롬프트입니다.

누구를 위한 것인가

다른 사람이 의존하는 코드를 배포하고, 고쳐지지 않은 것에 에이전트가 자신 있게 완료 표시를 하는 걸 본 적이 있다면, 이건 합리적인 가드레일이고 시도하는 데 명령 하나면 됩니다. test-driven-development와 verification-before-completion부터 시작하고 일주일은 나머지를 무시하세요. 그 둘이 행동을 가장 많이 바꿉니다.

프로토타이핑 중이라면 건너뛰세요. 이 방법론은 쓰레기를 배포하지 않는 데 최적화돼 있고, 그건 아이디어가 되는지 알아보는 것과 다른 목표입니다.

30만 스타는 이 방법론에 대한 판결이 아닙니다. 지금이라는 시점에 대한 판결입니다. 많은 사람이 자기가 감독할 수 있는 속도보다 빠르게 코드를 쓰는 에이전트를 갖게 됐고, 감독을 더 싸게 만들어 줄 무언가를 찾고 있습니다. Superpowers는 그 답 하나입니다. 그게 Markdown으로 만들어졌다는 사실이 가장 흥미로운 부분입니다.