296k 스타가 달린 Superpowers: 15개 스킬을 모두 읽어보니 방법론 전체가 170KB의 마크다운으로 되어 있다

Jesse Vincent (obra)의 기술 프레임워크인 Superpowers가 이번 주 금요일에 태어난 지 1년이 됩니다. 이 GitHub 레포지토리는 2025년 10월 9일에 생성되었으며, 이번 주에는 논평들이 이를 'AI 코딩을 위한 방법론 계층'으로 추앙하고 있습니다. 그중 대부분은 낮은 수십만 단위의 스타 개수를 인용합니다. 저는 오늘 GitHub API를 직접 확인했습니다: 296,175개의 스타, 26,439개의 포크, 1,094명의 워처이며 MIT 라이선스를 따릅니다. 그리고 v6.4.2로 클론하여 모든 스킬 파일을 읽어보았습니다. 사람들이 이 프로젝트에 대해 말하는 것과 실제로 구현된 내용 사이의 간극이 흥미로운 부분입니다.

오늘 측정된 수치

제가 2026년 10월 7일에 확인했을 때, api.github.com/repos/obra/superpowers는 296,175개의 스타, 26,439개의 포크를 보고하며 마지막 푸시는 10월 6일이었습니다. 이 레포지토리는 2025년 10월 9일에 생성되었기 때문에, 이번 게시물 작성 후 이틀 뒤에 첫 번째 생일을 맞이합니다. 이번 주에 돌아다니는 기사들은 여전히 대략 113k 스타를 인용하고 있는데, 이는 프로젝트가 얼마나 빠르게 움직이는지, 그리고 스타 개수가 분기별로 얼마나 구식이 되는지를 보여줍니다. 스타는 어쨌든 지연된 지표입니다. 제가 더 자세히 살펴보기로 결심한 이유는 더 간단합니다. 런타임이나 의존성이 없는 마크다운 파일 더미가 누군가의 업무 방식 자체를 변화시키지 않는 한, 296k 스타에 도달하기 어렵기 때문입니다.

구현된 내용: 15개 스킬, 170KB

저는 v6.4.2 태그(2026년 9월 25일 커밋)로 레포지토리를 클론하고 개수를 세어보았습니다: SKILL.md 파일 15개, 총 170,125바이트입니다. 가장 큰 스킬들은 다음과 같습니다:

• subagent-driven-development: 32,577바이트로, 이 세트에서 가장 큰 스킬입니다.
• writing-skills: 26,623바이트로, 새로운 스킬을 작성하기 위한 가이드입니다.
• executing-plans: 20,405바이트
• brainstorming: 17,548바이트
• writing-plans: 10,335바이트
• test-driven-development: 9,578바이트
• systematic-debugging: 9,465바이트

이것이 전체 제품입니다. 모델도 없고, 서버도 없고, 패키지 의존성도 없습니다 (기여자 가이드라인에서 제로 의존성 규칙을 강제합니다). 이는 끝까지 지침이며, 이 지침들은 대부분의 CLAUDE.md 파일들이 갖추지 못하는 방식으로 의견이 명확합니다.

세션 장악 방법

핵심 구성 요소는 using-superpowers 부트스트랩입니다. 이 설명은 모든 것을 담고 있습니다: “어떤 대화를 시작할 때 사용하라 - 스킬을 찾고 사용하는 방법을 확립하며, 명확히 하는 질문을 포함하여 어떤 응답보다도 스킬 호출이 필요하다.” 이 부트스트랩이 세션 시작 시 실행되면, 스킬들은 스스로 트리거됩니다. TDD를 직접 호출할 필요가 없습니다. 상황 자체가 이를 유발합니다.

유지 관리자들은 자동 트리거링을 매우 중요하게 여겨 새로운 하네스 통합에 대해 게이트(제한)를 설정하고 있습니다. 기여자 가이드라인에 따르면: 깨끗한 세션을 열고 정확히 Let's make a react todo list를 보내면, 작동하는 통합은 코드가 작성되기 전에 반드시 brainstorming 스킬을 발동시켜야 합니다. 만약 브레인스토밍이 자동으로 트리거되지 않으면, 해당 통합은 거부됩니다. 현재 README에는 16개의 하네스를 위한 설치 섹션이 포함되어 있습니다: Claude Code, Cursor, Codex App 및 CLI, Gemini CLI, GitHub Copilot CLI, OpenCode, Antigravity, Devin CLI, Factory Droid, Grok Build CLI, Kimi Code, Pi, Qwen Code 그리고 몇 가지 더.

아이언 로(The Iron Law)

test-driven-development 스킬은 리포지토리에서 가장 엄격한 9.5 KB입니다. 이 스킬의 핵심 규칙은 코드 블록 안에 대문자로 명시되어 있습니다:

NO PRODUCTION CODE WITHOUT A FAILING TEST FIRST

바로 아래에 있는 강제 조항에는 다음과 같이 쓰여 있습니다: “테스트 전에 코드를 작성했는가? 삭제하라. 처음부터 다시 시작하라.” 그리고 실제로 강력한 부분이 있습니다: 삭제된 코드를

기여자 가이드라인은 AI 에이전트에게 경고하며 시작합니다: 이 레포지토리는 PR(Pull Request) 거부율이 94%에 달하며, 관리자들은 '이 풀 리퀘스트는 거짓으로 만들어진 쓰레기다'와 같은 공개 댓글과 함께 몇 시간 내에 잡동사니 같은 PR을 닫습니다. 모든 PR은 그것을 생성한 모델, 하네스(harness), 하네스 버전, 설치된 플러그인을 공개하거나 수작업으로 작성했음을 명시해야 합니다. 에이전트가 생성한 기여물은 인간의 것과는 다르게, 공개적으로 다른 기준이 적용됩니다.

설정 담당자로서 저에게 눈에 띄는 정책 두 가지가 있었습니다. 첫째: '스킬은 산문(prose)이 아니라 에이전트 행동을 형성하는 코드이다.' 스킬 변경에는 평가 증거가 필요하며, 이는 superpowers-evals 하네스를 통해 실행됩니다. 이 과정에서 Quorum이라는 CLI가 실제 코딩 에이전트를 Gauntlet QA 에이전트를 거쳐 시나리오 수용 기준에 따라 등급을 매깁니다. 둘째: 프로젝트별 스킬은 핵심 기능(core)에서 아예 거부됩니다. 범용 목적으로만 사용 가능하며, 나머지는 자체 플러그인에 포함되어야 합니다.

설치 경로 및 텔레메트리 상세 정보

Claude Code에서는 공식 플러그인 마켓플레이스에 있습니다:

/plugin install superpowers@claude-plugins-official

Cursor Agent 채팅에서는:

/add-plugin superpowers

설치하기 전에 알아두면 좋을 상세 정보가 하나 있습니다: brainstorming의 선택적 시각 보조 도구는 관리자 웹사이트에서 로고 이미지를 불러오며, 이 요청에는 사용자의 Superpowers 버전이 포함됩니다. README에 따르면 프로젝트 데이터, 프롬프트, 클릭은 없습니다. 이는 옵트아웃(opt-out) 텔레메트리이며, 옵트아웃 방법은 환경 변수입니다:

export SUPERPOWERS_DISABLE_TELEMETRY=1

또한 이미 설정했다면 DISABLE_TELEMETRY와 CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC도 인식합니다.

자신만의 설정을 위해 훔쳐갈 것들

이 모든 방법론을 채택할 필요는 없습니다. 오늘 밤 복사해 볼 만한 세 가지 패턴이 있습니다.

첫째, 진입 조건(entry conditions)을 가진 작고 이름 붙여진 스킬들이 단순히 규칙들을 모아놓은 파일보다 우수합니다. 여기에 있는 모든 스킬의 프론트매터(frontmatter)는 언제 적용되는지(

벤치마킹을 위해 분기점을 거치는 것이 아니라, 실제 사용하면서 얻은 솔직한 한계점들입니다. 이 과정 자체가 실재합니다: 브레인스토밍, git worktree, 서면 계획, 그리고 서브 에이전트 검토를 거쳐 CSS 수정 하나에 적용되는 것은 엄청난 프로세스이며, 워크플로우 스킬들은 명확하게 축소되지 않습니다. 저는 실행 시 컨텍스트 윈도우 비용이 아닌 디스크의 바이트 크기를 측정했기 때문에, 로딩하는 것이 무료라고 주장하지는 않습니다. 부트스트랩은 인덱스를 구축하고 트리거가 될 때 본문을 불러오지만, 실제로 결정하는 것은 사용자의 하네스(harness) 플러그인 로딩 방식입니다. 스킬 내용은 평가 하네스에서 실제 에이전트 행동을 기준으로 조정되었으며, Claude Code 환경에서 성장했기 때문에 그곳에서 가장 예상 가능한 튜닝 결과를 기대할 수 있고, 더 작은 하네스에서는 좀 더 실험적일 것입니다. 그리고 프로젝트별로 특화된 스킬을 원한다면, 코어(core)가 설계상 거부하기 때문에 직접 작성해야 합니다. 이 거부 정책은 버그가 아니며, 이것이 바로 해당 시스템이 1년 만에 296k 스타를 달성할 만큼 충분히 일반성을 유지하는 이유입니다.

출처: obra/superpowers on GitHub (GitHub API의 star 및 fork 카운트, 2026년 10월 7일; skill 카운트 및 파일 크기는 v6.4.2 클론 기준), 원래 출시 발표문, 그리고 리포지토리 자체의 README와 AGENTS.md. 위에서 언급된 Next.js 샘플 키트는 여기서 무료로 받을 수 있습니다.