최근 AI에 의한 코드 자동 생성은 눈부신 진화를 거듭하고 있습니다. 특히 Anthropic이 출시한 「Claude Code」는 터미널 상에서 자율적으로 동작하며, 파일 조작 및 Git 관리까지 수행하는 강력한 도구로서 개발자 커뮤니티에 충격을 주었습니다.

하지만 많은 개발자는 여전히 AI를 「벌거벗은(naked)」 상태, 즉 특별한 규율 없이 사용하고 있습니다.

프롬프트에 「로그인 기능을 구현해줘」라고만 입력하고, AI가 갑자기 코드를 쓰기 시작하는——.

이러한 개발 스타일은 현재 **「Vibe Coding (분위기와 기세에 의존하는 코딩)」**이라고 불리고 있습니다. 그리고 이 Vibe Coding이야말로 AI 주도 개발에서 가장 큰 병목 현상이 되고 있습니다.

본 기사에서는 Vibe Coding에서 벗어나, Claude Code에 강력한 개발 SOP (표준 작업 절차, Standard Operating Procedure)를 강제하는 오픈 소스 플러그인 **「Superpowers」**에 대해, 그것이 해결하는 페인 포인트(Pain Point)와 구체적인 워크플로우를 해설합니다.

AI에게 사양서나 지시를 통째로 맡겨 직접 코드를 쓰게 하는 (벌거벗은 채 사용하는) 수법에는 실무 운용에 있어 다음과 같은 치명적인 문제가 있습니다.

사양 이해 부족 상태로 구현에 직행

AI는 모호한 지시에도 「무언가를 출력해야만 한다」는 특성 때문에, 진정한 의도를 질문하여 명확히 하기 전에 멋대로 가정을 세워 구현을 시작해 버립니다. -
이해의 차이로 인한 「재작업(rework)」의 무한 루프

구현이 진행된 단계에서 「사실은 이런 동작을 원했다」라고 인간이 수정을 지시하면, 코드의 정합성이 깨지며 수정의 연쇄가 시작됩니다. -
테스트 결여로 인한 품질의 불안정화

AI가 작성한 코드는 언뜻 작동하는 것처럼 보여도, 경계값 오류나 에지 케이스(Edge Case)에 대한 테스트가 작성되지 않은 경우가 많아 배포 후 버그 발생률이 높아집니다. -
컨텍스트의 비대화와 정밀도 저하 (Context Rot)

동일 세션에서 끊임없이 수정과 실행을 반복하면, 대화 이력 (컨텍스트, Context)이 비대해져 AI의 추론 정밀도가 급격히 저하됩니다.

Superpowers는 Claude Code를 위해 설계된 오픈 소스 「에이전트 기술 프레임워크 (Agentic Skills Framework)」입니다.

GitHub 리포지토리: obra/superpowers

Superpowers의 최대 특징은 **「LLM 자체를 똑똑하게 만드는 것이 아니라, Claude Code에 시스템 개발의 SOP (표준 작업 절차)를 강제한다」**는 점에 있습니다.

플러그인을 도입하면 Claude Code 내에 14개 이상의 재사용 가능한 「Skill (기술)」이 설치됩니다. 이를 통해 Claude는 「갑자기 코드를 쓰는 것」을 시스템적으로 금지당하며, 다음과 같은 엔지니어링 규율을 강제 실행하게 됩니다.

「먼저 정말로 원하는 것을 질문한다」 ➡️ 「설계와 계획을 세운다」 ➡️ 「테스트를 작성한다」 ➡️ 「구현한다」 ➡️ 「리뷰와 검증을 수행한다」

Superpowers를 도입함으로써 AI 프로그래밍 프로세스는 다음과 같이 격변합니다.

Superpowers를 활성화한 Claude Code는 태스크를 다음과 같은 7가지 프로세스로 엄격히 분해하여 실행합니다.

코드를 쓰기 전에 AI가 사용자의 진정한 의도를 심층적으로 파고듭니다. 기술적인 트레이드오프(Trade-off)나 설계 선택지를 제안하여 사양의 어긋남을 완전히 해소합니다.

상세한 사양서 (Spec)와 계획서 (Plan)를 Markdown 형식으로 자동 작성합니다. 각 계획은 「태스크당 2~5분」 내에 완료할 수 있는 극소 단위의 스텝으로 분해되며, 진행 상황 (ToDo 리스트)이 관리됩니다.

태스크별로 독립된 개발 환경 (Git Worktree)을 자동으로 생성합니다. 이를 통해 여러 병렬 태스크가 뒤섞여 메인 작업 브랜치 (Main Branch)를 오염시키는 것을 방지합니다.

Superpowers의 핵심 부분입니다.

• 구현 전에, 우선
  실패하는 테스트를 작성한다. - 그 테스트를 통과하기 위한 오직
  최소한의 코드를 작성한다. - 테스트가 통과하면 코드를
  **리팩터링 (Refactoring)**한다.

이 사이클 (Red-Green-Refactor)을 AI 스스로 루프 실행하게 합니다.

대규모 태스크를 실행할 경우, 모든 것을 하나의 세션에서 처리하면 토큰 (Token) 양의 증가로 인해 Claude가 혼란을 겪습니다. Superpowers는 특정 소규모 태스크를 "별도의 깨끗한 서브 에이전트 (Subagent)"에 위임하여 최소한의 컨텍스트 (Context)로 실행하게 함으로써 정확도를 유지합니다.

구현이 끝나면, 작성된 코드가 처음에 합의한 사양서 (Specification)를 충족하는지, 코드 규약 (Code Convention)을 따르고 있는지를 AI 스스로 (및 정적 분석 도구)가 리뷰합니다.

테스트와 리뷰를 모두 통과한 단계에서 격리된 브랜치의 변경 사항을 정리하여, 풀 리퀘스트 (Pull Request)를 생성하거나 메인 브랜치로 안전하게 머지 (Merge)합니다.

Superpowers는 Claude Code의 표준 플러그인 시스템을 이용하여 몇 가지 명령어로 도입할 수 있습니다.

먼저, Superpowers의 제공처인 플러그인 마켓플레이스 (Plugin Marketplace)를 Claude Code에 등록합니다.

# Claude Code 콘솔에서 실행
/plugin marketplace add obra/superpowers-marketplace

마켓플레이스에서 Superpowers 본체를 설치합니다.

/plugin install superpowers@superpowers-marketplace

설치 완료 후, 새로운 세션을 시작하면 Superpowers가 자동으로 활성화되어 SOP에 기반한 개발이 시작됩니다.

AI 개발 도구의 경쟁에서 많은 개발자는 "어떻게 하면 더 똑똑한 모델 (LLM)을 사용할까"에 매몰되기 쉽습니다. 하지만 실무에서의 소프트웨어 개발에서는 모델의 IQ 높이보다, **"어떠한 절차 (SOP)를 밟아 개발을 진행할 것인가"**라는 소프트웨어 엔지니어링의 규율이 최종 품질에 더 큰 영향을 미칩니다.

Superpowers는 Claude Code에 그 규율 (테스트 퍼스트, 계획 퍼스트)을 강제적으로 심어주기 위한 가장 실용적인 솔루션 중 하나입니다.

"AI에게 코드를 쓰게 하면 항상 버그투성이다", "수정 사항이 너무 많아 결국 직접 쓰는 게 더 빠르다"라고 느끼고 계신 분들은, 꼭 Claude Code에 Superpowers를 장착하여 규율 있는 AI 주도 개발 (AI-driven Development)을 경험해 보시기 바랍니다.