mylee04/claude-code-subagents

"개발자를 위한 Pokemon"- 당신의 AI 에이전트들이 레벨업하고, 팀을 결성하며, 어떠한 코딩 과제도 해결합니다.

Quick Start: cd ~/.claude && git clone https://github.com/mylee04/claude-code-subagents.git agents

(10초)

개발 팀처럼 함께 작동하는 31개의 특화된 AI 에이전트(AI agents)로 구성된 게임화된 컬렉션입니다. 각 에이전트는 사용함에 따라 레벨업하고, 업적(achievements)을 달성하며, 복잡한 작업을 위해 강력한 조합을 형성합니다.

핵심 가치: 하나의 범용적인 AI 어시스턴트 대신, 각 에이전트가 자신의 도메인(Python, DevOps, Security 등)에서 전문가로 활동하는 특화된 팀을 얻게 됩니다.

31명의 전문가 에이전트- Python 전문가부터 보안 감사관(security auditors)까지
게임화 시스템 (Gamification System)- 에이전트가 경험치(XP)를 획득하고, 레벨업(초보자 → 전설)하며, 업적을 달성합니다
스마트 에이전트 레지스트리 (Smart Agent Registry)- 사용 가능한 모든 에이전트를 자동으로 발견하고 조정합니다
팀 구성 (Team Formations)- 에이전트들이 시너지 보너스와 함께 협업합니다
실시간 진행 상황 추적 (Real Progress Tracking)- AI 팀이 실시간으로 협업하는 모습을 지켜보세요

지금 바로 체험해 보세요 - XP 시스템, 업적, 그리고 에이전트 협업이 작동하는 모습을 확인하세요:

cd ~/.claude/agents && python3 gamification/scripts/agents-demo.py

에이전트들이 레벨업하고, "Speed Demon"이나 "Bug Hunter"와 같은 업적을 달성하며, 실시간 미션 진행 상황을 확인하는 모습을 지켜보세요.

# 특정 에이전트 사용
/python-pro optimize this function
/devops-troubleshooter analyze these logs
...

SubAgents 시스템은 이제 여러 위치에서 에이전트를 자동으로 발견하고 조정하는 고급 AgentRegistry 기능을 갖추고 있습니다:

🔍 AGENT DISCOVERY
─────────────────
✓ Successfully discovered 34 agents
...

# 화려한 인터랙티브 데모 실행
python3 demo_agent_registry.py
# 또는 간단한 테스트 시도
...

통합된 발견 (Unified Discovery): /agents/, ~/.claude/agents/, 그리고 .claude/agents/에서 에이전트를 찾아냅니다.

내장된 오케스트레이션 (Built-in Orchestration): Claude Code가 에이전트 조율을 자동으로 처리합니다
팀 구성 (Team Formation): 프로젝트 요구 사항에 따라 3~6개의 에이전트를 지능적으로 추천합니다
외부 의존성 없음 (No External Dependencies): 내장된 Python 라이브러리만으로 작동합니다

📋 31개 전체 에이전트 (클릭하여 확장)

• 멀티 에이전트 워크플로우 (multi-agent workflows)를 위해 Claude Code의 내장된 오케스트레이션 (orchestration) 기능을 사용하세요

python-pro

• Python/Django/FastAPI 전문가
  javascript-pro
• JavaScript/TypeScript/React 전문가
  golang-pro
• Go 언어 전문가
  rust-pro
• Rust 프로그래밍 전문가
  sql-pro
• 데이터베이스 (Database) 쿼리 최적화
  backend-architect
• API 설계 및 마이크로서비스 (microservices)
  frontend-developer
• 현대적인 UI 컴포넌트 및 프레임워크
  full-stack-architect
• 완전한 시스템 설계

devops-engineer

• CI/CD 및 컨테이너화 (containerization)
  devops-troubleshooter
• 운영 환경 사고 대응
  cloud-architect
• AWS/GCP/Azure 인프라
  deployment-engineer
• 릴리스 자동화
  database-optimizer
• 성능 튜닝 (Performance tuning)
  incident-commander
• 긴급 대응 조율

code-reviewer

• 코드 품질 및 베스트 프랙티스 (best practices)
  test-engineer
• 테스트 전략 및 구현
  performance-engineer
• 최적화 및 프로파일링 (profiling)
  quality-engineer
• QA 프로세스 및 표준
  security-auditor
• 취약점 스캐닝 및 컴플라이언스 (compliance)

data-engineer

• ETL 파이프라인 및 데이터 아키텍처
  ai-engineer
• LLM 통합 및 RAG 시스템
  ml-engineer
• 모델 학습 및 배포
  data-ai-ml-engineer
• 풀스택 데이터 과학

api-documenter

• 문서화 및 가이드
  dx-optimizer
• 개발자 경험 (Developer experience) 개선
  user-feedback-analyst
• 사용자 조사 및 인사이트
  business-analyst
• 지표 및 KPI 분석
  content-marketer
• 콘텐츠 전략 및 SEO
  tech-portfolio-reviewer
• 이력서 및 포트폴리오 최적화

git-specialist

• 버전 관리 (Version control) 작업

🎮 게이미피케이션 (Gamification) 작동 방식

🟢 Novice(Lv.1-10) - 기초 학습 및 사용자의 패턴 이해
🔵 Adept(Lv.11-30) - 전문성 개발 및 프로젝트 컨벤션 (Conventions) 이해
🟡 Expert(Lv.31-70) - 기술 숙달 및 사용자의 요구 사항 예측
🟠 Master(Lv.71-120) - 엘리트 성능 및 선제적 권장 사항 제공
🔴 Grandmaster(Lv.121-200) - 전설적인 상태 및 깊은 프로젝트 통찰력
💎 Legend(Lv.201+) - 궁극의 숙달 및 초월적인 능력

• 🩸
  First Blood- 첫 번째 작업 완료 (+50 XP) - ⚡
  Speed Demon- 빠른 작업 완료 (+300 XP) - 🐛
  Bug Hunter- 10개의 프로덕션 버그 해결 (+150 XP) - 🛡️
  Guardian Angel- 보안 취약점 방지 (+400 XP)

./agents # 모든 에이전트 레벨 보기
./agents python-pro # 특정 에이전트 확인
./agents log python-pro "Built API" # 수동 XP 기록

🤖 Smart Agent Registry (Advanced)

**에이전트 레지스트리 시스템 (Agent Registry System)**은 사용자가 생성한 커스텀 에이전트를 포함하여 사용 가능한 모든 에이전트를 자동으로 발견하고 조정합니다:

# Claude Code는 사용자의 요청에 따라 에이전트를 자동으로 조정합니다
"Build a React TypeScript dashboard with real-time data"
# 자동으로 조정됨: react-specialist → typescript-pro → data-engineer → test-engineer

이것이 중요한 이유: 더 이상 수동으로 조정할 필요가 없습니다. 시스템은 다음을 기반으로 에이전트를 지능적으로 선택합니다:

• 프로젝트의 기술 스택 (Tech stack)
• 에이전트의 전문성 및 성능 이력
• 작업의 복잡성 및 요구 사항
• 에이전트의 가용성 및 XP 레벨

주요 기능:

• ✅ 여러 위치로부터의 자동 에이전트 발견
• ✅ 기술 스택 분석 및 매칭
• ✅ 성능 기반 권장 사항
• ✅ XP 추적 통합
• ✅ 스마트 팀 구성

우리의 종합적인 분석 시스템을 통해 데이터 기반 AI 개발의 힘을 경험해 보세요. 에이전트 성능을 추적하고, 팀의 효율성을 모니터링하며, 아름다운 시각화 도구로 개발 워크플로 (Workflow)를 최적화할 수 있습니다.

╔══════════════════════════════════════════════════════════════════════╗
║ 🏆 에이전트 리더보드 (AGENT LEADERBOARD) 🏆 ║
╠══════════════════════════════════════════════════════════════════════╣
...

╔══════════════════════════════════════════════════════════════════════╗
║ 🎯 팀 구성 인사이트 (TEAM FORMATION INSIGHTS) ║
╠══════════════════════════════════════════════════════════════════════╣
...

╔══════════════════════════════════════════════════════════════════════╗
║ 📈 사용량 인사이트 대시보드 (USAGE INSIGHTS DASHBOARD) ║
╠══════════════════════════════════════════════════════════════════════╣
...

SubAgents 분석을 최대한 활용하려면 다음 명령어들을 숙달하세요:

# 🏆 리더보드 및 순위 (LEADERBOARD & RANKINGS)
./agents leaderboard # 전체 XP 리더보드 보기
./agents top 10 # 상위 10개 에이전트 표시
...

아름다운 진행 시각화 도구와 함께 에이전트들이 실시간으로 협업하는 모습을 지켜보세요:

╔══════════════════════════════════════════════════════════════════════╗
║ 🚀 미션 진행 중: "API 최적화" (MISSION IN PROGRESS: "API Optimization") ║
╠══════════════════════════════════════════════════════════════════════╣
...

리더보드 보기:./agents leaderboard

• 어떤 에이전트가 선두를 달리고 있는지 확인하세요

팀 케미스트리 확인:./agents formations

• 가장 효과적인 팀 조합을 발견하세요

패턴 분석:./agents insights

• 개발 워크플로 (Workflow)를 이해하세요

업적 추적:./agents achievements

• 새로운 배지를 획득하기 위한 진행 상황을 모니터링하세요

데이터 내보내기:./agents export-stats

• 보고를 위한 상세 분석 데이터를 가져오세요

프로 팁 (Pro Tip): ./agents recommend "프로젝트 설명"을 사용하면

사용자의 특정 요구 사항과 과거 성능 데이터를 기반으로 AI가 지원하는 팀 제안을 받을 수 있습니다.

🚀 설치 옵션 (Installation Options)

cd ~/.claude && git clone https://github.com/mylee04/claude-code-subagents.git agents

git clone https://github.com/mylee04/claude-code-subagents.git
cd claude-code-subagents
./install.sh

git clone https://github.com/mylee04/claude-code-subagents.git
cp -r claude-code-subagents/agents/* ~/.claude/agents/

💡 사용 예시 (Usage Examples)

# 개발 (Development)
/python-pro "refactor this class with proper type hints"
/javascript-pro "optimize this React component performance"
...

# 기능 개발 (Feature Development)
"Implement user authentication with social login"
# Claude Code가 조정함: backend-architect → frontend-developer → security-auditor → test-engineer
...

🔧 문제 해결 (Troubleshooting)

설치 확인 (Check installation): ls ~/.claude/agents/

에이전트 파일들이 보여야 합니다.
에이전트 형식 검증 (Verify agent format): 에이전트에는 YAML 프론트매터 (YAML frontmatter)가 필요합니다:

name: agent-name
description: Agent description

대안 방법 (Alternative methods): 자연어 사용 ("Use python-pro to...") 또는 태스크 도구 (Task tool) 사용

문제 (Problem): 파일은 존재하지만 명령 목록에 나타나지 않음

해결책 (Solution): 각 .md 파일 상단에 YAML 프론트매터 (YAML frontmatter)를 추가하세요.

원인 (Cause): YAML 프론트매터 (YAML frontmatter) 누락

수정 (Fix): 필수 YAML 헤더를 추가하면 에이전트가 즉시 작동합니다.

🤝 기여하기 (Contributing)

• 적절한 카테로리 폴더에 .md 파일을 생성하세요. 필수 사항 (REQUIRED): YAML 프론트매터 (YAML frontmatter)를 포함해야 합니다:

---

name: your-agent-name
description: Brief description
color: blue # 선택 사항 (optional)

• ./install.sh를 실행하여 에이전트를 사용할 수 있게 만드세요.

• 풀 리퀘스트 (Pull request)를 제출하세요.

• 모바일 개발 (Swift, Kotlin, React Native)

• 게임 개발 (Unity, Unreal Engine)

• 블록체인 (Solidity, Web3)

• 도메인 특화 전문가 (Healthcare, Finance, E-commerce)

"개발자를 위한 포켓몬 같습니다. 이제는 디버깅이 기다려질 정도예요!" - 시니어 엔지니어 (Senior Engineer)

"주요 리팩토링 프로젝트에서 개발 시간을 70% 단축했습니다" - 테크 리드 (Tech Lead)

기능 (Feature)	다른 컬렉션 (Other Collections)	SubAgents
기본 에이전트 (Basic Agents)	✅ 예 (Yes)	✅ 31명의 전문가 (31 Specialists)
게임화 (Gamification)	❌ 아니오 (No)	✅ 전체 XP 시스템 (Full XP System)
프로젝트 스캐너 (Project Scanner)	❌ 아니오 (No)	✅ DNA 분석 (DNA Analysis)
팀 시너지 (Team Synergies)	❌ 아니오 (No)	✅ 포메이션 보너스 (Formation Bonuses)

설치 (Install): cd ~/.claude && git clone https://github.com/mylee04/claude-code-subagents.git agents

데모 실행하기:python3 gamification/scripts/agents-demo.py

기능 계획하기: "사용자 인증 시스템 구축"
특정 에이전트 사용하기:/python-pro 이 함수를 최적화해줘

첫 번째 미션 보너스: 첫 번째 작업을 완료하고 "First Blood" 업적을 달성하세요 (+50 XP)

개발 워크플로우를 레벨업할 준비가 되셨나요? 지금 설치하여 당신의 개인 개발 팀으로서 작동하는 31명의 AI 전문가들의 강력함을 경험해 보세요.

탁월함을 추구하는 개발자들을 위해 ❤️로 제작됨 | 라이선스: MIT | 이슈 및 지원