Claude Code는 터미널 환경에서 유용한 에이전트 역할을 수행하지만, 별도의 통제 장치가 없으면 구체적인 요구사항 확인 절차를 건너뛰고 임의로 코드를 먼저 작성하거나 테스트 검증 없이 구현을 밀어붙이는 문제가 자주 발생합니다. 이러한 즉흥적 작성을 방지하고 규율 있는 소프트웨어 개발 방법론을 에이전트에 주입하기 위해 설계된 프레임워크가 바로 superpowers입니다.
superpowers는 에이전트가 코드를 쓰기 전에 질문을 통해 요구사항을 분석하고, 작업을 잘게 쪼갠 계획을 세우며, 엄격한 테스트 주도 개발(TDD) 사이클을 거치도록 강제하는 스킬 세트입니다. Claude Code CLI 환경에서 공식 마켓플레이스 명령어로 superpowers를 설치하고, 체계적인 개발 흐름을 적용하는 구체적인 절차를 살펴봅니다.
Claude Code의 무분별한 코드 생성을 제어하는 superpowers 개요
개발자가 AI 코딩 도구를 사용할 때 마주치는 가장 큰 위험 중 하나는 불명확한 지시를 모델이 자의적으로 해석하여 잘못된 방향의 코드를 대량으로 양산하는 현상입니다. Claude Code 역시 지시문을 수신하면 곧바로 파일을 수정하거나 완성되지 않은 설계를 바탕으로 로직을 구성하려는 성향을 보일 수 있습니다.
superpowers는 이러한 에이전트의 충동적인 구현 행동을 제어하기 위해 고안되었습니다. 기능을 만들기 전 반드시 질문을 던져 요구사항을 정의하는 brainstorming, 승인된 설계를 2~5분 단위의 구체적인 태스크로 나누는 writing-plans, 실패하는 테스트를 먼저 작성하지 않은 코드는 아예 삭제해 버리는 test-driven-development 등의 스킬이 단계별로 연쇄 동작합니다.
이를 통해 개발자는 Claude Code와 작업할 때 임의 추측에 의한 기능 왜곡을 줄이고, 검증 가능한 단위 테스트를 기반으로 안정적인 소스코드를 구축할 수 있습니다.
Claude Code 환경에서 superpowers 플러그인 설치하는 공식 명령어
Claude Code CLI 환경에서는 플러그인 관리 명령어를 통해 마켓플레이스에서 superpowers를 직접 설치할 수 있습니다. Anthropic 공식 플러그인 마켓플레이스를 이용하거나 원작자의 마켓플레이스를 등록하여 설치하는 두 가지 경로가 지원됩니다.
# 1. Anthropic 공식 마켓플레이스에서 직접 설치
/plugin install superpowers@claude-plugins-official
# 2. 또는 원작자 마켓플레이스를 추가 등록한 뒤 설치
/plugin marketplace add obra/superpowers-marketplace
/plugin install superpowers@superpowers-marketplace- Claude Code 터미널 세션 프롬프트에
/plugin install superpowers@claude-plugins-official명령어를 입력해 공식 마켓플레이스로부터 플러그인을 다운로드 및 설치합니다. - 공식 마켓플레이스 조회가 원활하지 않은 경우,
/plugin marketplace add obra/superpowers-marketplace명령어로 저장소를 등록한 뒤/plugin install superpowers@superpowers-marketplace를 실행합니다. - 설치가 완료되면 현재 활성화된 세션을 종료하고 새 세션을 시작합니다. 세션 시작 시 부트스트랩 훅이 주입되므로 정상적인 스킬 트리거를 위해 세션 재시작이 필요합니다.
- 새 세션에서 기능 개발 요청(예: 간단한 컴포넌트나 모듈 구현 요청)을 입력했을 때, Claude Code가 코드를 바로 작성하지 않고 질문을 던지는 브레인스토밍 단계로 진입하는지 확인합니다.
플러그인 설치 시 주의해야 할 환경적 한계도 존재합니다. Claude Code 웹 에이전트(claude.ai/code) 환경에서는 플러그인 구동이 완전히 지원되지 않거나 프로세스가 멈추는 현상이 나타날 수 있습니다. 웹 환경에서 플러그인이 정상 작동하지 않는다면 이는 superpowers 플러그인의 문제가 아니라 플랫폼 지원 범위의 제한 때문이므로, 로컬 CLI 환경을 주 경로로 활용해야 합니다.
브레인스토밍부터 TDD까지 이어지는 핵심 스킬 워크플로
superpowers가 설치되면 개발의 각 단계마다 정해진 규칙을 가진 스킬들이 순차적으로 실행됩니다. 이 체계는 무작정 구현에 들어가는 대신 명확한 명세와 검증 절차를 거치도록 통제합니다.
가장 먼저 실행되는 스킬은 brainstorming입니다. 이 스킬은 코드를 한 줄이라도 작성하기 전에 활성화됩니다. 에이전트는 사용자가 진정으로 원하는 것이 무엇인지, 그 이유가 무엇인지를 파악하기 위해 구체적인 질문을 던집니다. 이후 사용자가 설명한 내용을 다시 정리해 피드백을 요청하며, 작은 변경 사항은 대화창 내에서 합의하고 프로젝트 단위의 작업은 설계 문서로 정리합니다.
설계가 승인되면 writing-plans 스킬이 이어받습니다. 이 스킬은 승인된 디자인 문서를 바탕으로 작업을 2분에서 5분 사이에 끝낼 수 있는 아주 작은 태스크 단위로 분할합니다. 분할된 모든 작업에는 정확한 대상 파일 경로, 작성해야 할 완전한 코드 예시, 작업 완료 여부를 확인할 수 있는 검증 절차가 명시됩니다.
실제 구현 단계에서는 test-driven-development 스킬이 규칙을 강제합니다. 이 스킬은 엄격한 RED-GREEN-REFACTOR 사이클을 적용합니다.
- RED: 구현하려는 기능에 대해 실패하는 테스트 코드를 먼저 작성하고, 실제로 테스트가 실패하는 것을 확인합니다.
- GREEN: 해당 테스트를 통과시킬 수 있는 최소한의 코드만을 작성하고, 테스트 통과를 확인합니다.
- REFACTOR: 테스트 통과 상태를 유지하며 코드를 리팩터링하고 커밋합니다.
특히 test-driven-development 스킬에는 테스트를 작성하기 전에 미리 작성된 프로덕션 코드를 자동으로 삭제하는 엄격한 규칙이 포함되어 있어, 테스트 없는 임의 구현을 원천적으로 차단합니다.
계획 실행 시 subagent-driven-development를 권장하는 이유
작성된 계획을 바탕으로 작업을 진행할 때, superpowers에는 작업을 수행하는 두 가지 스킬 경로가 존재합니다. 바로 executing-plans와 subagent-driven-development입니다.
executing-plans 스킬은 단일 컨텍스트 내에서 인라인 방식으로 모든 태스크를 순차 실행합니다. 반면 subagent-driven-development 스킬은 분할된 태스크마다 완전히 독립된 새로운 서브에이전트를 생성하여 작업을 위임하고, 각 태스크가 끝날 때마다 단계별 코드 리뷰를 거치는 방식을 취합니다.
단일 세션에서 계속 작업을 진행하면 컨텍스트 누적이나 이전 단계의 부산물로 인해 에이전트의 판단력이 흐려질 수 있습니다. 반면 서브에이전트 방식은 태스크마다 깨끗한 상태의 컨텍스트를 제공받아 작업하므로 가장 철저하고 높은 완성도를 보장합니다. 공식 문서에서도 서브에이전트 사용이 지원되는 환경이라면 executing-plans 대신 superpowers:subagent-driven-development 스킬을 사용할 것을 명시적으로 권장하고 있습니다. Claude Code는 서브에이전트 실행이 가능하므로 이 방식을 통해 안정적인 구현 품질을 확보할 수 있습니다.
