슈퍼파워즈: 2025년 10월 현재 내가 코딩 에이전트를 사용하는 방법

• 최근 몇 주간 Claude Code 기반 코딩 에이전트 시스템을 체계화해 ‘Superpowers’라는 새로운 확장 도구를 만들었음
• Superpowers는 플러그인 형태로 설치되어 Claude에게 ‘스킬(Skills)’을 가르치고, 이 스킬을 통해 작업 방식을 자동화하고 개선하는 기능을 제공
• Anthropic의 Claude Code 플러그인 시스템을 활용해 워크플로우 자동화, TDD 실행, 코드 리뷰, Git 워크트리 관리 등을 에이전트가 자율적으로 수행
• 새로운 워크플로우는 브레인스토밍 → 계획 → 구현 단계를 자동으로 거치며, 작업을 병렬로 진행하고 RED/GREEN TDD 방식으로 테스트 주도 개발을 수행
• 핵심 개념인 ‘스킬(Skill)’ 은 Claude가 특정 작업을 수행할 때 참조해야 하는 지식 단위로, 사용자는 이를 직접 작성하거나 Claude가 학습 문서를 바탕으로 생성하도록 할 수 있음
• 이 구조가 향후 AI 코딩 에이전트의 자기개선과 협업의 표준이 될 것으로 보고 있으며, Superpowers 공유 기능과 기억 시스템 완성이 다음 목표

Superpowers 개요

• Superpowers는 Claude Code 2.0.13 이상에서 동작하며, 사용자는 /plugin marketplace add obra/superpowers-marketplace 명령으로 설치 가능함
• 설치 후 Claude가 자동으로 SKILL.md 문서를 읽어 “스킬이 존재하면 반드시 사용해야 한다” 는 규칙을 학습함
• 이로써 Claude는 브레인스토밍과 계획 단계를 거쳐 구현 전 논의를 유도하고, 작업이 완료되면 GitHub PR 생성 또는 병합 제안까지 수행함

코딩 워크플로우

• Claude가 프로젝트나 작업 시작을 감지하면 구현 전 자동으로 브레인스토밍과 계획 단계를 거침
• Git 저장소 내에서 작업 시 자동으로 worktree를 생성하여 병렬 작업 간 충돌 방지
• 두 가지 실행 모드 제공
  • 기존 방식: 사용자가 두 번째 Claude 세션을 열어 아키텍트와 구현자를 중재하는 PM 역할 수행
  • 신규 방식: 작업을 하위 에이전트에 개별 배분하고 각 작업마다 코드 리뷰 후 진행
• RED/GREEN TDD 방식으로 실패 테스트 작성 → 최소 구현 → 테스트 통과 순환 반복
• 구현 완료 후 GitHub PR 생성, 로컬 브랜치 병합, 또는 종료 옵션 제공

스킬 시스템의 핵심 원리

• Superpowers의 핵심은 스킬(Skill) 이며, 이는 Claude가 특정 문제를 해결하기 위해 읽고 수행할 수 있는 Markdown 기반 지식 모듈임
  • Anthropic이 Office 문서 생성 기능 출시 시 스킬 개념을 처음 공개
  • 유사 패턴이 Microsoft Amplifier 등 여러 코딩 에이전트 프레임워크에서 등장
• 스킬은 Claude가 “새로운 능력”을 학습하게 하는 단위로, 사용자는 Claude에게 책이나 코드베이스를 분석하게 하여 새로운 스킬을 추출하도록 요청 가능함
  • 에이전트는 스킬 검색 스크립트를 실행하고, 해당 활동에 대한 스킬이 있으면 반드시 사용해야 함
  • 첫 번째 메타 스킬인 "스킬 작성법"을 통해 Claude가 새로운 스킬을 자율적으로 생성하는 워크플로우 지원
  • 모델에게 "이 책을 읽고, 생각하고, 배운 내용을 기록하라"고 요청하면 재사용 가능한 지식을 자동 구조화
• Claude는 생성된 스킬을 테스트하기 위해 하위 에이전트(subagents) 를 시뮬레이션하며, 각 스킬이 실제로 유효한지 TDD 방식으로 검증함
  • 초기 시도에서는 게임쇼 퀴즈 형태로 검증했으나 실효성 부족
  • 개선 후 “압박 테스트(pressure test)” 시나리오를 구성해 실제 환경과 유사한 조건에서 스킬의 유효성을 점검함

압박 시나리오 테스트 사례

• 시나리오 1: 시간 압박 + 자신감
  • 상황: 프로덕션 장애로 분당 5천 달러 손실 중, 인증 서비스 디버깅 필요
  • 선택지: 즉시 디버깅(5분 소요) vs 스킬 검색 후 디버깅(7분 소요)
  • 목적: 긴급 상황에서도 스킬 검색을 우선하도록 유도
• 시나리오 2: 매몰 비용 + 작동하는 코드
  • 상황: 45분 투입해 작성한 비동기 테스트 인프라가 이미 작동 중
  • 선택지: 스킬 확인 후 재작업 가능성(3분 소요) vs 현재 코드 커밋
  • 목적: 작동하는 코드가 있어도 스킬 준수를 강제
• Robert Cialdini의 설득 심리학 원리(권위, 몰입, 호감, 희소성 등)를 LLM에 적용
• 최근 Dan Shapiro 등이 공동 저술한 연구에서 Cialdini의 원리가 LLM에도 유효함을 과학적으로 입증
• Superpowers 스킬 시스템이 이미 설득 기법을 무의식적으로 활용 중이었음을 사후 발견
  • 권위 프레임("IMPORTANT: 실제 상황"), 몰입 유도("A, B, C 중 선택"), 희소성("오후 6시, 저녁 6시 30분")

기억(Memories) 기능

• Superpowers는 Claude가 이전 대화의 맥락을 보존하고 활용할 수 있는 ‘remembering-conversations’ 스킬을 포함함
• 이 스킬은 대화 로그를 SQLite 기반 벡터 데이터베이스로 저장하고, Claude Haiku를 이용해 요약을 생성함
• .claude 외부에 대화 기록 자동 복제하여 Anthropic의 자동 삭제 방지
• Claude는 필요할 때 하위 에이전트를 통해 과거 대화에서 관련 정보를 검색하며, 불필요한 검색으로 컨텍스트 윈도우가 오염되지 않도록 설계됨
• 아직 전체 연결이 완료되지 않았으나, 모든 구성요소는 이미 구현되어 있음

공유(Sharing) 기능

• Superpowers의 목표는 스킬 공유 생태계 구축임
• 사용자는 자신의 Claude가 학습한 스킬을 GitHub Pull Request 형태로 제출해 다른 사용자와 공유할 수 있음
• 새로운 Claude 플러그인 시스템과 통합하면서도, 사용자 동의 없이 스킬이 공유되지 않도록 안전장치를 두고 있음
• 초기 설치 방식은 단순히 Claude에게 특정 URL을 읽게 하는 방식이었지만, 현재는 플러그인 마켓플레이스 구조로 전환됨

설치 및 활용

• Claude Code 2.0.13 이상 필요
• 플러그인 마켓플레이스에서 설치 명령어 실행
  • /plugin marketplace add obra/superpowers-marketplace
  • /plugin install superpowers@superpowers-marketplace
• 재시작 후 부트스트랩 프롬프트가 주입되어 스킬 시스템 자동 활성화
• Claude와 Superpowers로 실제 Todo 앱을 구현한 전체 로그를 공개했으며, 여기서 Claude의 질문, 테스트 주도 개발, git 관리 과정을 볼 수 있음