코딩 AI, 왜엉뚱한 걸만들어 올까
중급자용깃허브 주간 인기 TOP10© AIKOREACLUBobra/superpowers
코딩 AI, 왜 엉뚱한 걸 만들어 올까
코딩 AI가 바로 코드부터 짜지 않고 묻기, 계획, 테스트 먼저, 검토 순서로 일하게 하는 스킬 묶음이에요
코딩 AI에게 "우리 빵집 홈페이지 만들어 줘"라고 하면 몇 분 만에 파일이 잔뜩 생겨요. 그런데 열어 보면 결제까지 되는 쇼핑몰이고, 정작 원한 건 오늘 남은 빵을 보여 주는 한 장이었죠. 슈퍼파워의 스킬 설명은 이렇게 적어요. AI는 사람이 원한다고 믿는 걸 만드는데, 그 믿음은 보통 느끼는 것보다 얇아요.슈퍼파워는 이 순서를 바꿔요. 코드를 쓰기 전에 먼저 묻고, 설계를 확인받고, 작게 쪼갠 계획을 세운 뒤, 실패하는 테스트부터 쓰게 하죠. 이번 주에만 깃허브 별을 5,956개 더 받은 저장소예요.
묻지 않고 짜면 생기는 일
문제 1짐작으로 하나를 골라 바로 만들어요
파일 14개문제 2확인 없이 끝났다고 해요
- 테스트 먼저 쓰기안 함
- 실패했다가 통과하는 걸 보기안 함
- 계획과 비교해 검토안 함
README가 내세우는 원칙은 "주장보다 증거, 끝났다고 말하기 전에 확인"이에요.
근거 없음슈퍼파워가 막으려는 상황을 보여 주려고 저희가 그린 예시예요. 실제 코딩 AI가 고르는 방향은 요청과 모델에 따라 달라져요.
한눈에
무엇인가요
스킬 묶음이에요. 만든 사람 제시 빈센트는 코딩 AI를 위한 소프트웨어 개발 방법론이라고 불러요. 상황마다 꺼내 읽는 스킬(작업 설명서) 여러 개와, 그 스킬을 꼭 쓰게 만드는 처음 지시문으로 이뤄져 있어요.알아서 켜져요. 무언가를 만들자는 말이 나오면 brainstorming 이, 설계가 승인되면 writing-plans 가, 구현에 들어가면 test-driven-development 가 저절로 켜지죠. 따로 명령을 외울 필요 없이, 일을 시작하기 전에 맞는 스킬부터 확인하는 게 규칙이에요.권장이 아니라 의무예요. README는 이 순서를 골라 쓰는 제안이 아니라 반드시 거치는 작업 흐름이라고 적어요.
함께 쓰는 도구 · 클로드 코드 · 코덱스 · 커서 · 제미나이 CLI · 깃허브 코파일럿 CLI · 오픈코드 · 안티그래비티 · 그록 빌드 · 키미 코드 · 큐원 코드
이런 분께
- AI에게 맡기면 엉뚱한 걸 만들어 와서 답답했던 분
- 테스트와 검토를 거친 코드를 원하는 개발자
- 여러 시간 걸리는 작업을 AI에게 맡겨 두고 싶은 분
어떻게 작동하나요
1. 묻기(brainstorming). 원하는 것과 이유를 질문으로 끌어내고, 이해한 내용을 읽을 만한 길이로 되돌려 보여 줘요. 작은 일은 대화로 합의하고, 프로젝트라면 설계 문서를 써요.2. 작업 공간 나누기(using-git-worktrees). 설계가 승인되면 새 브랜치에 따로 떨어진 작업 공간을 만들고, 테스트가 깨끗하게 통과하는 상태인지 먼저 봐요.3. 계획(writing-plans). 2~5분짜리 작업으로 쪼개요. 작업마다 정확한 파일 경로, 코드, 확인 단계가 들어가요.4. 실행. subagent-driven-development 는 작업마다 새 보조 AI를 붙이고 끝날 때마다 검토해요(가장 꼼꼼). executing-plans 는 지금 대화에서 한꺼번에 하고 마지막에 한 번 검토해요(가장 저렴).5. 테스트 먼저(test-driven-development). 실패하는 테스트를 쓰고, 실패하는 걸 보고, 최소한의 코드로 통과시키고, 커밋해요. 테스트보다 먼저 쓴 코드는 지워요.6. 검토와 마무리. 작업 사이마다 계획과 비교해 문제를 심각도별로 알리고, 심각한 문제는 진행을 막아요. 다 끝나면 테스트를 다시 확인하고 합치기, 풀 리퀘스트, 그대로 두기, 버리기 중에서 고르게 해요.계획을 세운 뒤에는 AI가 몇 시간씩 계획에서 벗어나지 않고 혼자 일하는 일도 드물지 않다고 README는 적어요.
할 수 있는 일
바로 쓸 수 있나요
필요한 것클로드 코드(유료 요금제) 같은 코딩 AI 도구 하나
비용저장소는 MIT 라이선스로 무료예요. 기업용 상용 지원은 따로 문의하라고 적혀 있어요
시작하기
- 클로드 코드에서 설치
앤트로픽 공식 플러그인 장터에 올라가 있어서 한 줄이면 돼요.
/plugin install superpowers@claude-plugins-official - 커서라면
커서 에이전트 대화창에서 입력해요. 플러그인 장터에서 superpowers 를 찾아 설치해도 돼요.
/add-plugin superpowers - 제미나이 CLI라면
코덱스, 깃허브 코파일럿 CLI, 오픈코드 등은 README에 도구별 명령이 따로 있어요. 여러 도구를 쓰면 도구마다 각각 설치해요.
gemini extensions install https://github.com/obra/superpowers - 새 대화에서 확인
새 대화를 열고 아래 문장을 보내 보세요. 제대로 설치됐으면 코드보다 brainstorming 스킬이 먼저 켜져요.
Let's make a react todo list
Let's make a react todo list
README가 설치 확인용으로 든 문장이에요(리액트로 할 일 목록을 만들자는 뜻).슈퍼파워를 켜면 대화가 이렇게 흘러가요
README와 스킬 설명에 적힌 순서를 보여 주려고 저희가 그린 예시예요. 실제 질문과 계획은 쓰는 코딩 AI와 프로젝트에 따라 달라져요.
비슷한 도구
슈퍼파워는 만들기 전에 묻고 계획하는 순서에 집중하고, ECC는 그 순서에 기억과 보안 검사까지 얹은 더 큰 묶음이에요(각 README 기준).
주의할 점
- 브레인스토밍 단계의 시각 보조 화면은 만든 회사 로고를 그들 웹사이트에서 불러오면서 쓰는 버전을 알려요. 프로젝트 내용은 보내지 않는다고 하고, 환경 변수 SUPERPOWERS_DISABLE_TELEMETRY 로 끌 수 있어요. 클로드 코드의 DISABLE_TELEMETRY 설정도 따라요.
- 테스트 전에 쓴 코드를 지울 만큼 규칙이 강해요. 스킬 설명은 버릴 시제품, 자동 생성 코드, 설정 파일만 예외로 두고, 그때도 사람에게 먼저 물으라고 해요.
- "다 정했으니 묻지 말고 코드만 써"라고 하면 설계 확인 단계를 건너뛰는 문제가 열린 이슈(#2655)로 올라와 있어요(2026-11-03 확인).
- 여러 코딩 도구를 쓰면 도구마다 따로 설치해야 해요. 헤르메스처럼 대화가 길어져 압축되면 처음 지시문이 사라지는 도구도 있어서, 스킬이 안 켜지면 새 대화를 열라고 README가 안내해요.
더 보기
제시 빈센트와 회사 Prime Radiant가 만들어요. 기업용 상용 지원은 따로 문의하라고 적혀 있어요.
낯선 말
- 스킬 · AI가 필요할 때 꺼내 읽는 작업 설명서
- 보조 AI(서브에이전트) · 큰 일 중 한 조각만 맡아 처리하는 별도 AI
- TDD · 테스트를 먼저 쓰고 통과하도록 코드를 짜는 방식. 빨강(실패), 초록(통과), 정리 순서
- 워크트리 · 같은 저장소를 다른 폴더에 하나 더 펼쳐 놓고 따로 작업하는 깃 기능
- YAGNI · 지금 필요 없는 기능은 만들지 말라는 원칙
댓글
AI 답은 참고 자료예요. 법·세금·돈·건강처럼 삶에 큰 영향을 주는 일에서는 AI 답이 정답이 될 수 없어요. 최종 판단은 전문가나 공식 기관에서 확인하세요.
