[심층분석] 코딩 에이전트에게 '일하는 법'을 가르치다 — Superpowers가 제시하는 에이전트 주도 개발의 새로운 표준

도입: AI 코딩 에이전트의 아킬레스건

2025년 하반기부터 AI 코딩 에이전트는 소프트웨어 개발의 핵심 도구로 자리잡았습니다. Claude Code, Cursor, GitHub Copilot, Codex 등 다양한 에이전트가 개발자의 곁에서 코드를 작성하고 리팩토링하며 디버깅을 돕고 있습니다. 그런데 실무에서 이들을 깊이 사용해 본 개발자라면 공통적으로 느끼는 불만이 하나 있습니다. 에이전트가 코드를 '잘' 쓰는 것과, 프로젝트를 '제대로' 진행하는 것은 완전히 다른 문제라는 점입니다.

에이전트에게 "로그인 기능을 만들어줘"라고 하면, 그럴듯한 코드가 나옵니다. 하지만 기존 인증 체계와의 정합성, 테스트 전략, 점진적 구현 순서 같은 것들은 개발자가 일일이 챙겨야 합니다. 에이전트는 뛰어난 코딩 능력을 갖추고 있지만, 소프트웨어 개발 '방법론'은 모르는 상태인 셈입니다. 마치 문법과 어휘를 완벽히 아는데 글쓰기 전략은 모르는 작가와 같습니다.

이 근본적인 문제를 정면으로 해결하려는 오픈소스 프로젝트가 등장했습니다. Jesse Vincent(obra)가 만든 Superpowers는 코딩 에이전트에게 체계적인 소프트웨어 개발 워크플로우를 부여하는 프레임워크입니다. GitHub에서 10만 개가 넘는 스타를 기록하며, 단순한 프롬프트 모음이 아니라 에이전트 시대의 개발 방법론으로서 주목받고 있습니다.

기술 분석: Superpowers는 어떻게 작동하는가

핵심 개념 — "스킬(Skill)" 기반 조합형 아키텍처

Superpowers의 기본 단위는 스킬(Skill)입니다. 스킬이란 에이전트가 특정 상황에서 따라야 할 행동 규칙과 절차를 정의한 구조화된 지시문입니다. 예를 들어 "테스트 작성 스킬", "코드 리뷰 스킬", "설계 문서 작성 스킬" 등이 있으며, 이들이 레고 블록처럼 조합되어 전체 개발 워크플로우를 구성합니다.

기존에 개발자들이 사용하던 시스템 프롬프트나 커스텀 지시문과의 결정적 차이는 자동 트리거에 있습니다. 개발자가 "지금 TDD로 해줘"라고 매번 지시할 필요 없이, 에이전트가 컨텍스트를 파악해 적절한 스킬을 자동으로 활성화합니다. 프로젝트 디렉토리에 Superpowers를 설치해두면, 에이전트가 알아서 해당 스킬 세트를 로드하고 그에 따라 행동합니다.

워크플로우 — 4단계 자율 개발 프로세스

Superpowers가 제시하는 개발 워크플로우는 명확한 4단계로 구성됩니다.

1단계: 요구사항 정제(Spec Elicitation)

에이전트가 코드 작성에 뛰어들기 전에, 먼저 개발자에게 "정확히 무엇을 만들려고 하는가"를 질문합니다. 이 과정에서 에이전트는 모호한 요구사항을 구체적인 스펙으로 변환합니다. 핵심은 완성된 스펙을 읽기 쉬운 크기의 청크(chunk)로 나누어 개발자에게 보여준다는 점입니다. 10페이지짜리 설계 문서를 한 번에 던지는 것이 아니라, 소화 가능한 단위로 쪼개어 확인을 받습니다.

이는 실무에서 매우 중요한 의미를 가집니다. 에이전트가 자율적으로 30분간 작업한 후 결과물이 방향이 틀어져 있으면, 그 시간은 전부 낭비됩니다. Superpowers는 작업 시작 전에 합의 지점을 확보함으로써 이 리스크를 최소화합니다.

2단계: 구현 계획 수립(Implementation Planning)

스펙이 확정되면 에이전트는 구현 계획을 작성합니다. 여기서 Superpowers의 철학이 명확히 드러나는데, 구현 계획은 "열정은 넘치지만 판단력이 부족하고, 프로젝트 맥락이 없으며, 테스트를 싫어하는 주니어 엔지니어"도 따라할 수 있을 만큼 상세해야 합니다. 이 유머러스한 표현 속에 깊은 통찰이 담겨 있습니다. 에이전트 역시 맥락을 잊거나 잘못 해석할 수 있으므로, 계획 자체에 충분한 가드레일이 내장되어야 한다는 것입니다.

이 계획은 세 가지 원칙을 강조합니다:

• Red/Green TDD: 먼저 실패하는 테스트를 작성하고, 그 테스트를 통과시키는 코드를 작성
• YAGNI(You Aren't Gonna Need It): 당장 필요하지 않은 기능은 만들지 않기
• DRY(Don't Repeat Yourself): 중복 코드 최소화

이 원칙들은 새로운 것이 아닙니다. 수십 년간 소프트웨어 공학에서 검증된 원칙들입니다. Superpowers의 혁신은 이 원칙들을 에이전트가 실행 가능한 형태로 인코딩했다는 점에 있습니다.

3단계: 서브에이전트 주도 개발(Subagent-Driven Development)

가장 흥미로운 단계입니다. 개발자가 "go"를 외치면, 메인 에이전트가 서브에이전트(subagent)들을 생성하여 각 엔지니어링 태스크를 분배합니다. 메인 에이전트는 관리자(supervisor) 역할을 하며, 서브에이전트의 작업 결과를 검수하고, 품질 기준에 미달하면 재작업을 지시합니다.

이 구조는 소프트웨어 팀의 조직 구조를 그대로 모방합니다. 테크 리드가 태스크를 분배하고, 개발자가 구현하고, 코드 리뷰를 통해 품질을 확인하는 과정을 에이전트 내부에서 재현하는 것입니다. 이 덕분에 Claude Code 기준으로 수 시간 동안 자율적으로 작업이 진행될 수 있다고 합니다. 개발자는 중간중간 진행 상황만 확인하면 됩니다.

4단계: 검수 및 반복(Review & Iterate)

각 서브에이전트의 작업이 완료되면 메인 에이전트가 결과를 검토합니다. 테스트 통과 여부, 코드 품질, 원래 스펙과의 정합성 등을 확인하고, 문제가 있으면 해당 태스크를 다시 서브에이전트에게 보냅니다.

플랫폼 지원

Superpowers는 단일 에이전트에 종속되지 않는 크로스 플랫폼 프레임워크입니다. 현재 지원하는 환경은 다음과 같습니다:

• Claude Code: 공식 마켓플레이스를 통한 설치
• Cursor: 플러그인 마켓플레이스 지원
• Codex / OpenCode: 수동 설정 필요
• Gemini: gemini-extension.json을 통한 연동

프로젝트 구조를 보면 .claude-plugin, .cursor-plugin, .codex, .opencode, GEMINI.md 등 각 플랫폼별 설정 파일이 분리되어 있어, 하나의 스킬 세트를 여러 에이전트에서 재사용할 수 있는 구조입니다.

---

업계 맥락과 비교: 에이전트 워크플로우 경쟁 지형

프롬프트 엔지니어링과의 차이

많은 개발자가 시스템 프롬프트나 .cursorrules, CLAUDE.md 등의 설정 파일을 통해 에이전트의 행동을 커스터마이징하고 있습니다. Superpowers와의 근본적 차이는 추상화 수준입니다.

단순 프롬프트 커스터마이징은 "코드 작성 시 TypeScript를 사용해라", "함수는 30줄 이내로 작성해라" 같은 규칙 수준에 머뭅니다. 반면 Superpowers는 개발 프로세스 전체를 정의합니다. 요구사항 분석 → 설계 → 구현 → 검증이라는 소프트웨어 엔지니어링의 전체 라이프사이클을 에이전트가 자율적으로 수행할 수 있도록 구조화한 것입니다.

비유하자면, 프롬프트 엔지니어링이 코딩 컨벤션 문서라면, Superpowers는 개발 조직의 운영 매뉴얼에 해당합니다.

Agentic Coding의 다른 접근들과 비교

현재 에이전트 기반 개발에는 여러 접근법이 공존합니다:

• Devin, SWE-Agent 계열: 에이전트 자체의 능력을 향상시키는 데 집중합니다. 더 똑똑한 에이전트를 만드는 방향입니다.
• MCPTools, LangChain 계열: 에이전트에게 더 많은 도구(tool)를 제공합니다. 데이터베이스 접근, API 호출 등 에이전트의 행동 반경을 넓히는 방향입니다.
• Superpowers 계열: 에이전트의 행동 방식(methodology)을 정의합니다. 기존 에이전트의 능력은 그대로 두되, 그 능력을 어떤 순서와 원칙으로 사용할지를 규정합니다.

Superpowers의 접근이 흥미로운 이유는, 이것이 사실상 "소프트웨어 공학" 그 자체를 에이전트에게 가르치는 것이기 때문입니다. 우리가 수십 년간 축적한 개발 방법론 — 애자일, TDD, 페어 프로그래밍 — 의 정수를 에이전트가 실행 가능한 형태로 번역한 것입니다.

왜 이 접근법이 공감을 얻었나

많은 개발자들이 에이전트와 협업하면서 겪는 가장 큰 좌절은 "맥락 이탈(context drift)"입니다. 에이전트가 작업을 진행하다가 어느 순간 원래 의도와 다른 방향으로 흘러가는 현상입니다. 5분짜리 수정을 부탁했는데 에이전트가 파일 10개를 리팩토링하고 있는 상황, 많은 분이 경험했을 것입니다.

Superpowers는 이 문제를 구조적으로 해결합니다. 명시적 스펙 합의 → 상세 구현 계획 → 태스크 단위 실행 → 단계별 검증이라는 파이프라인을 통해, 에이전트가 각 단계에서 벗어나지 않도록 가드레일을 설치합니다.

---

한국 개발자에게 주는 시사점

즉시 적용 가능한 실무 시나리오

시나리오 1: 신규 기능 개발

현재 프로젝트에 결제 기능을 추가해야 한다고 가정해 봅시다. Superpowers 없이 에이전트를 사용하면, "결제 기능 만들어줘"라는 지시에 에이전트가 바로 코드를 생성하기 시작합니다. PG사 연동 방식, 에러 핸들링 전략, 기존 주문 시스템과의 통합 방식 등은 개발자가 일일이 추가로 지시해야 합니다.

Superpowers가 활성화된 상태라면, 에이전트는 먼저 "어떤 PG사를 사용하나요?", "부분 환불을 지원해야 하나요?", "기존 주문 모델과 결제 모델의 관계는 어떻게 설계할까요?" 같은 질문으로 스펙을 정제합니다. 이 과정에서 개발자가 미처 생각하지 못한 엣지 케이스까지 도출될 수 있습니다.

시나리오 2: 레거시 코드 리팩토링

5년 된 모놀리식 서비스를 마이크로서비스로 분리하는 작업에서, Superpowers의 단계적 접근법은 특히 빛을 발합니다. 에이전트가 한 번에 전체 아키텍처를 변경하려 하지 않고, 명확한 계획 아래 하나의 서비스씩 분리하면서 각 단계마다 테스트를 통해 기존 기능이 깨지지 않았음을 확인합니다.

시나리오 3: 1인 개발자 또는 소규모 팀

서브에이전트 구조는 사실상 가상의 개발팀을 제공하는 것과 같습니다. 1인 개발자가 프로덕트를 만들 때, 설계자-구현자-리뷰어의 역할 분리를 에이전트가 내부적으로 수행합니다. 스타트업 초기 단계에서 인력이 부족할 때 특히 유용할 수 있습니다.

도입 시 고려할 점

• 학습 곡선: Superpowers 자체는 설치만 하면 자동으로 작동하지만, 에이전트와의 스펙 합의 과정에서 요구사항을 명확히 전달하는 능력이 필요합니다. 이는 기존의 코딩 능력과는 다른 역량이며, 오히려 프로덕트 매니저의 역량에 가깝습니다.
• 비용 고려: 서브에이전트를 여러 개 생성하여 작업하므로, API 호출 비용이 증가합니다. 특히 Claude Code의 경우 토큰 사용량이 상당히 늘어날 수 있으므로, 프로젝트 규모와 예산을 감안하여 사용해야 합니다.
• 커스터마이징의 중요성: skills 디렉토리 내의 스킬 정의를 프로젝트에 맞게 조정하는 것이 중요합니다. 예를 들어 한국 프로젝트에서 자주 사용하는 기술 스택(Spring Boot, Next.js 등)에 대한 특화 스킬을 추가하면 더 나은 결과를 얻을 수 있습니다.

학습 로드맵 제안

1. 1주차: 기존 프로젝트에 Superpowers를 설치하고, 간단한 기능 추가 태스크를 실행해 보며 워크플로우를 체험
2. 2주차: skills 디렉토리의 각 스킬 파일을 읽고, 자신의 개발 스타일에 맞게 수정
3. 3주차: 팀 프로젝트에 적용하고, 서브에이전트 실행 로그를 분석하여 병목 구간 파악
4. 4주차 이후: 자체 스킬을 작성하여 팀 특화 워크플로우 구축

마무리: 에이전트 시대, 개발자의 역할은 어떻게 변하는가

Superpowers가 보여주는 방향은 명확합니다. 코드를 작성하는 것은 에이전트가 하되, 무엇을 왜 만들 것인지 결정하는 것은 여전히 인간의 몫이라는 것입니다. 그리고 그 결정을 에이전트가 실행할 수 있는 형태로 구조화하는 능력이 앞으로의 개발자에게 핵심 역량이 될 것입니다.

흥미로운 점은, 이 프로젝트가 제시하는 원칙들 — TDD, YAGNI, 명확한 스펙, 단계별 검증 — 이 사실 수십 년 전부터 존재하던 소프트웨어 공학의 기본 원칙이라는 것입니다. 인간 개발자에게는 "알지만 바빠서 안 하는" 것들이었지만, 에이전트에게 이를 강제함으로써 오히려 개발 프로세스의 품질이 올라가는 역설적인 상황이 발생합니다.

에이전트가 방법론을 충실히 따르는 세상에서, 개발자는 더 이상 "코드를 짜는 사람"이 아니라 "올바른 것을 올바른 순서로 만들도록 이끄는 사람"으로 진화할 것입니다. Superpowers는 그 전환점을 보여주는 하나의 이정표입니다.

여러분은 현재 코딩 에이전트와 어떻게 협업하고 계신가요? Superpowers 같은 워크플로우 프레임워크가 실제로 에이전트의 자율성을 높여줄 수 있다고 보시나요, 아니면 결국 개발자가 매 단계를 직접 관리해야 한다고 생각하시나요? 여러분의 경험을 공유해 주세요.