SuperWork (spw) – Opus Extended Thinking Agent

Opus 모델의 깊은 추론 능력을 활용하여 복잡한 분석, 종합, 의사결정을 수행하는 서브에이전트

When to use this skill

• 복잡한 분석 종합: 여러 소스의 분석 결과를 종합해야 할 때
• 아키텍처 결정: 시스템 설계나 기술 선택이 필요할 때
• 우선순위 결정: 다수의 작업 중 순서를 정해야 할 때
• 디버깅 전략: 복잡한 버그의 근본 원인을 분석할 때
• 리팩토링 계획: 대규모 코드 개선 전략이 필요할 때

1. SuperWork 개요

핵심 개념

SuperWork는 Multi-Agent 시스템에서 “두뇌” 역할을 합니다:

[Worker x N] 데이터 수집/분석
      ↓
[SuperWork] 종합 → 판단 → 결정
      ↓
[Worker x N] 결정에 따라 실행

역할 분담

2. 사용 방법

기본 호출

# Claude Code에서 SuperWork 호출
claude task --model opus "분석 결과를 종합하고 우선순위 결정. SuperWork."

# 또는 spw 별칭 사용
claude task --model opus "spw: 아키텍처 결정 필요"

Task Tool 사용

// Task tool로 SuperWork 호출
{
  "subagent_type": "general-purpose",
  "model": "opus",
  "prompt": "SuperWork: 다음 분석 결과를 종합하고 IMPLEMENTATION_PLAN.md 작성...",
  "description": "SuperWork synthesis"
}

프롬프트 패턴

# SuperWork 프롬프트 템플릿

## Context
[분석 결과, 현재 상황, 제약 조건]

## Task
SuperWork: [수행할 작업 설명]

## Expected Output
- 종합 분석 결과
- 우선순위 목록
- 결정 사항 및 근거
- 다음 단계 액션 아이템

3. 워크플로우 패턴

패턴 1: 분석 종합 (Analysis Synthesis)

1. [Sonnet x N] 코드베이스 분석
   - 파일별 분석 결과 생성
   - analysis/*.md 파일로 저장

2. [SuperWork] 종합 분석
   - 모든 분석 결과 읽기
   - 패턴 및 문제점 식별
   - 우선순위 결정
   - IMPLEMENTATION_PLAN.md 작성

3. [Sonnet] 계획에 따라 실행

패턴 2: 디버깅 전략 (Debug Strategy)

1. [Codex] 테스트 실행 → 실패 로그 수집

2. [SuperWork] 원인 분석
   - 스택 트레이스 분석
   - 관련 코드 검토
   - 가설 수립 및 검증 순서 결정

3. [Sonnet] 가설 검증 및 수정

패턴 3: 아키텍처 결정 (Architecture Decision)

1. [Gemini] 요구사항 및 제약조건 분석

2. [SuperWork] 아키텍처 결정
   - 대안 비교 분석
   - 트레이드오프 평가
   - 최종 결정 및 ADR 작성

3. [Sonnet] 결정에 따라 구현

4. IMPLEMENTATION_PLAN.md 관리

파일 구조

# Implementation Plan

## Priority 1: Critical (즉시 처리)
- [ ] 인증 토큰 갱신 버그 수정
- [ ] API 레이트 리미팅 추가

## Priority 2: High (이번 스프린트)
- [ ] 사용자 프로필 캐싱 구현
- [ ] 페이지네이션 추가

## Priority 3: Medium (다음 스프린트)
- [ ] DB 커넥션 풀링 리팩토링
- [ ] 에러 로깅 개선

## Completed
- [x] 프로젝트 구조 설정
- [x] CI/CD 파이프라인 구성

SuperWork의 계획 업데이트 규칙

1. 작업 완료 시: [ ] → [x], Completed로 이동
2. 새 작업 발견 시: 적절한 우선순위에 추가
3. 블로커 발견 시: Priority 1으로 승격
4. 의존성 발견 시: 순서 조정

5. 실전 예시

예시 1: 대규모 리팩토링 계획

# Step 1: 코드 분석 (Sonnet 병렬)
claude task "src/* 전체 파일의 코드 스멜 분석"

# Step 2: SuperWork 종합
claude task --model opus "
SuperWork: 분석 결과를 종합하세요.

## Input
- analysis/*.md 파일들

## Task
1. 주요 문제점 식별
2. 리팩토링 우선순위 결정
3. IMPLEMENTATION_PLAN.md 작성

## Constraints
- 기존 테스트 통과 유지
- 점진적 변경 (빅뱅 금지)
"

# Step 3: 계획에 따라 실행
claude task "IMPLEMENTATION_PLAN.md의 Priority 1 작업 수행"

예시 2: 버그 근본 원인 분석

# Step 1: 에러 정보 수집
codex-cli shell "npm test 2>&1 | tee test-output.log"

# Step 2: SuperWork 분석
claude task --model opus "
spw: 테스트 실패 원인을 분석하세요.

## Input
- test-output.log
- 관련 소스 코드

## Task
1. 스택 트레이스 분석
2. 근본 원인 가설 3개 수립
3. 검증 순서 및 방법 제시

## Output
- ROOT_CAUSE_ANALYSIS.md 작성
"

예시 3: 기술 선택 결정

claude task --model opus "
SuperWork: 상태 관리 라이브러리를 선택하세요.

## Context
- React 18 프로젝트
- 중규모 (50+ 컴포넌트)
- 실시간 데이터 필요

## Candidates
1. Redux Toolkit
2. Zustand
3. Jotai
4. React Query + Context

## Task
1. 각 옵션 장단점 분석
2. 프로젝트 요구사항과 매칭
3. 최종 추천 및 근거

## Output
- ADR (Architecture Decision Record) 작성
"

6. Best Practices

DO (권장)

1. 명확한 컨텍스트 제공: 분석에 필요한 모든 정보 포함
2. 구조화된 출력 요청: 결과 형식 명시 (MD, JSON 등)
3. 제약 조건 명시: 시간, 비용, 기술적 제약 포함
4. 결정 근거 요청: 왜 그런 결정인지 기록

DON’T (금지)

1. 단순 작업에 사용: 코드 검색, 파일 읽기는 Sonnet으로
2. 컨텍스트 과부하: 필요한 정보만 제공
3. 모호한 요청: 구체적인 태스크 명시
4. 결과 미저장: 항상 파일로 결과 저장

7. 트리거 키워드

다음 키워드로 SuperWork를 호출할 수 있습니다:

SuperWork:     # 전체 이름
spw:           # 짧은 별칭
super-work:    # 하이픈 버전
opus-work:     # 모델 기반 이름

# 예시
"spw: 분석 결과 종합해줘"
"SuperWork: 아키텍처 결정 필요"

8. 다른 에이전트와의 연계

Multi-Agent 오케스트레이션

workflow:
  name: "Feature Implementation"
  steps:
    - agent: Gemini
      task: "요구사항 분석"
      output: requirements.md

    - agent: Sonnet (x10)
      task: "관련 코드 분석"
      output: analysis/*.md

    - agent: SuperWork  # Opus
      task: "종합 및 계획 수립"
      input: [requirements.md, analysis/*.md]
      output: IMPLEMENTATION_PLAN.md

    - agent: Sonnet
      task: "Priority 1 구현"
      input: IMPLEMENTATION_PLAN.md

    - agent: Codex
      task: "테스트 및 빌드"

OpenContext 연계

# 작업 시작 전: 컨텍스트 로드
oc_search query="이전 아키텍처 결정"

# SuperWork 실행
claude task --model opus "spw: ADR 작성"

# 작업 완료 후: 결정사항 저장
oc_create_doc folder="project/decisions" title="ADR-001-state-management.md"

Quick Reference

호출 방법

claude task --model opus "SuperWork: [태스크]"
claude task --model opus "spw: [태스크]"

주요 용도

• 분석 종합
• 아키텍처 결정
• 우선순위 결정
• 디버깅 전략
• 계획 수립

출력 파일

• IMPLEMENTATION_PLAN.md – 작업 계획
• ADR-*.md – 아키텍처 결정 기록
• ROOT_CAUSE_ANALYSIS.md – 원인 분석

태그

#superwork #spw #opus #extended-thinking #analysis #synthesis #decision-making

References

• agent-workflow – 전체 멀티에이전트 워크플로우
• subagent-creation – 서브에이전트 생성
• Ralph Wiggum Technique