Claude Code를 위한 전문화된 서브 에이전트 (sub-agents)의 포괄적인 컬렉션으로, 도메인 특화 전문 지식과 지능적인 작업 위임 (task delegation)을 통해 개발 워크플로우를 향상시키도록 설계되었습니다.

서브 에이전트 (Sub-agents)는 소프트웨어 엔지니어링의 특정 도메인에 집중하는 Claude Code 내의 전문화된 AI 어시스턴트입니다. 이들은 전문가 수준의 가이드를 제공하고, 복잡한 작업을 자동화하며, 다른 에이전트들과 협력하여 포괄적인 솔루션을 제공합니다. 자세한 내용은 공식 문서에서 확인하세요.

backend-architect- 확장 가능한 API 아키텍처 (architectures), 인증 시스템 (authentication systems), 데이터베이스 스키마 (database schemas) 및 마이크로서비스 (microservices) 설계
frontend-specialist- 현대적인 React 애플리케이션, shadcn/ui 컴포넌트, Tailwind CSS 및 접근성 준수 (accessibility compliance)
fullstack-developer- 프론트엔드-백엔드 통합을 포함한 엔드 투 엔드 (end-to-end) 기능 구현
iac-expert- 코드형 인프라 (Infrastructure as Code), 클라우드 리소스 및 확장성 계획
ui-ux-designer- 뛰어난 시각적 디자인과 매끄러운 상호작용을 갖춘 멋지고 독특하며 현대적인 사용자 인터페이스 (user interfaces)

test-architect- 포괄적인 테스트 전략, 커버리지 분석 (coverage analysis) 및 품질 보증 (quality assurance) 계획
unit-test-generator- 포괄적인 엣지 케이스 (edge cases)와 높은 커버리지를 갖춘 컴포넌트 수준의 테스트
e2e-test-automator- Playwright를 이용한 엔드 투 엔드 (end-to-end) 사용자 여정 테스트
integration-test-builder- API 테스트, 데이터베이스 테스트 및 서비스 상호작용 검증

security-auditor- OWASP 준수, 취약점 평가 (vulnerability assessments) 및 보안 아키텍처 평가
code-reviewer- 코드 품질, 보안 리뷰 및 베스트 프랙티스 (best practices) 강제 적용

performance-profiler- 성능 병목 현상 (performance bottleneck) 식별 및 최적화
monitoring-architect- 시스템 관측성 (observability), 알림 (alerting) 및 성능 대시보드

cicd-engineer- CI/CD 파이프라인, 자동화된 빌드 및 배포 관리
docker-specialist- 컨테이너 최적화 및 오케스트레이션 (orchestration)
config-expert- 환경 설정 (environment configuration) 및 비밀 관리 (secrets management)

database-engineer- 데이터베이스 스키마 설계 (Database schema design), 쿼리 최적화 (query optimization), 및 마이그레이션 (migrations)
refactoring-expert- 기술 부채 (Technical debt) 감소 및 디자인 패턴 (design pattern) 구현
error-detective- 버그 분석 (Bug analysis), 근본 원인 파악 (root cause identification), 및 수정 사항 구현 (fix implementation)
dependency-manager- 안전한 의존성 업데이트 (dependency updates) 및 호환성 검증 (compatibility verification)
mindful-dev- 교육적 초점을 맞춘 사려 깊은 개발, 복잡한 작업을 이해하기 쉬운 학습 단계로 분해

tech-writer- 기술 문서 (Technical documentation), API 문서 (API docs), 및 사용자 가이드 (user guides)
release-compiler- 릴리스 노트 (Release notes), 마이그레이션 가이드 (migration guides), 및 변경 로그 (changelog) 작성
code-commentator- 인라인 문서화 (Inline documentation) 및 코드 설명 (code explanation)

project-orchestrator- 복잡한 프로젝트 조정 (project coordination) 및 멀티 에이전트 워크플로우 관리 (multi-agent workflow management)
migration-specialist- 안전성 검증을 포함한 스키마 및 데이터 마이그레이션 (Schema and data migrations)

Claude Code로 모든 프로젝트를 시작하려면 이 템플릿을 사용하세요. 이를 통해 project-orchestrator 서브 에이전트가 자동으로 활성화되어 요구 사항을 분석하고 적절한 전문 에이전트에게 작업을 위임합니다:

Use project-orchestrator sub agent to build [WHAT YOU WANT].
Name: [PROJECT NAME]
Type: [APPLICATION TYPE - Web App/API/Mobile/CLI/etc]
...

팁 (Tips):

• 더 나은 결과를 얻으려면 기능(features)을 구체적으로 명시하세요
• 기술 스택 (Tech Stack) 섹션은 선택 사항입니다 - 해당하지 않는 항목은 삭제하세요
• project-orchestrator가 적절한 서브 에이전트를 자동으로 식별하고 참여시킵니다
• 프론트엔드 전용 (frontend-only) 프로젝트의 경우, Backend/Database/Other 섹션을 생략하기만 하면 됩니다

# 특정 작업에 집중하기 위해 특정 에이전트 사용
claude --agent security-auditor "Review this authentication flow for vulnerabilities"
claude --agent frontend-specialist "Create a responsive navbar component with shadcn/ui"

# project-orchestrator가 여러 에이전트를 조정하도록 설정
claude --agent project-orchestrator "Build a user management system with authentication, CRUD operations, and admin dashboard"

포괄적인 커버리지를 위한 에이전트 체이닝 (Chain agents)

claude --agent backend-architect "Design the API structure"
--agent security-auditor "Review the security implications"
...

많은 에이전트들이 적절한 전문가에게 작업을 자동으로 위임합니다:

backend-architect → security-auditor (취약점 평가를 위해)
frontend-specialist → performance-profiler (최적화를 위해)
project-orchestrator → 프로젝트 요구사항에 따른 여러 에이전트

각 에이전트는 다음을 제공합니다:

• 해당 도메인의 전문 지식 (Specialized knowledge)
• 베스트 프랙티스 (Best practices) 및 산업 표준 (Industry standards)
• 프레임워크 특정 가이드라인 (Framework-specific guidance)
• 성능 최적화 기술 (Performance optimization techniques)

에이전트들은 다음과 같은 목적을 위해 협업합니다:

• 중복 작업 방지
• 도메인 간 일관성 확보
• 컨텍스트 (Context) 및 요구사항 공유
• 도메인 간 호환성 검증

project-orchestrator를 사용하는 경우:

• 새로운 기능이나 프로젝트를 시작할 때
• 요구사항이 여러 도메인에 걸쳐 있을 때
• 프론트엔드 (Frontend), 백엔드 (Backend), 테스트 (Testing) 간의 조정이 필요할 때

도메인 전문가 (Domain specialists)를 사용하는 경우:

• 특정 기술적 과제가 있을 때
• 한 분야에서 전문가 수준의 가이드가 필요할 때
• 집중적이고 고품질의 결과물을 원할 때

test-architect를 사용하는 경우:

• 테스트 전략을 계획할 때
• 새로운 테스트 인프라 (Test infrastructure)를 구축할 때
• 품질 게이트 (Quality gates) 및 커버리지 (Coverage) 목표를 정의할 때

넓게 시작하기 (Start Broad): 복잡하고 다각적인 작업에는 project-orchestrator를 사용하세요.
구체적으로 접근하기 (Go Specific): 집중적인 기술 작업에는 도메인 전문가를 사용하세요.
워크플로우 체이닝 (Chain Workflows): 포괄적인 커버리지를 위해 에이전트들을 결합하세요.
자동 위임 활용하기 (Leverage Auto-Delegation): 에이전트들이 서로 협력하도록 하세요.

Claude Code에서 이 에이전트들을 전역적으로 사용할 수 있게 하려면, 모든 .md 파일을 Claude Code 에이전트 디렉토리로 복사하세요:

# 모든 에이전트 파일을 복사하여 전역적으로 사용할 수 있게 합니다
cp *.md ~/.claude/agents/
# 또는 이 리포지토리에서 클론(Clone)하여 복사합니다
...

에이전트가 사용 가능한지 확인하세요:

ls ~/.claude/agents/
# 25개의 모든 에이전트 파일이 표시되어야 합니다

에이전트(Agents)를 에이전트 디렉터리에 배치하면 Claude Code에서 자동으로 사용할 수 있게 됩니다. 추가적인 설정은 필요하지 않습니다.

에이전트는 Claude Code의 메모리 시스템 (memory system)과 함께 작동하여 다음과 같은 역할을 수행합니다:

• 세션 전반에 걸쳐 프로젝트 컨텍스트 (project context) 기억
• 에이전트 간 지식 공유
• 권장 사항의 일관성 유지

이 컬렉션은 오픈 소스 (open source)이며 기여를 환영합니다:

새로운 에이전트 (New Agents): 기존 패턴을 따라 새로운 도메인 특화 (domain-specific) 에이전트 생성
에이전트 개선 (Agent Improvements): 더 나은 위임 패턴 (delegation patterns) 또는 전문 지식으로 기존 에이전트 강화
문서화 (Documentation): 사용 예시 및 모범 사례 (best practices) 개선
통합 패턴 (Integration Patterns): 더 나은 에이전트 간 조정 (inter-agent coordination) 전략 개발

각 에이전트는 다음 구조를 따릅니다:

---
name: agent-name
description: 이 에이전트를 언제 어떻게 사용하는지
...

이 프로젝트는 MIT 라이선스 (MIT License) 하에 라이선스가 부여됩니다 - 자세한 내용은 LICENSE 파일을 참조하세요.

이슈 (issues), 질문 또는 기여에 대해서는 다음을 참고하세요:

작업 유형	권장 에이전트	대체 에이전트
새로운 프로젝트	project-orchestrator	backend-architect , frontend-specialist
API 설계	backend-architect	security-auditor , database-engineer
UI 컴포넌트	frontend-specialist	ui-ux-designer , fullstack-developer
UI/UX 디자인	ui-ux-designer	frontend-specialist
테스트 전략	test-architect	unit-test-generator , e2e-test-automator
성능 문제	performance-profiler	monitoring-architect
보안 검토	security-auditor	code-reviewer
버그 수정	error-detective	code-reviewer
문서화	tech-writer	code-commentator
배포	cicd-engineer	docker-specialist , iac-expert
학습 및 교육	mindful-dev	tech-writer , code-commentator

소프트웨어 엔지니어링의 모든 측면에 대해 지능적이고 전문화된 지원을 통해 개발 워크플로 (development workflow)를 강화하세요.