bijutharakan/multi-agent-squad

Claude Code를 위한 지능형 오케스트레이션 (Orchestration) 시스템으로, 사용자의 프로젝트 구조에 적응하고 특화된 AI 에이전트 (AI agents)를 통해 개발을 관리합니다.

Multi-Agent Squad는 Claude Code를 엔터프라이즈급 통합 기능을 갖춘 완전한 소프트웨어 개발 팀으로 변모시킵니다. 이 디렉토리에서 Claude를 시작하기만 하면 다음과 같은 작업이 수행됩니다:

프로젝트에 대해 질문 — 자연스러운 대화를 통해
완벽한 구조 생성 — 사용자의 요구 사항에 기반하여
특화된 에이전트 설정 — 프로젝트 유형에 맞춰
통합 구성 — 30개 이상의 인기 도구와 함께
MCP 서버 활성화 — 향상된 AI 기능을 위해
개발 오케스트레이션 — 전체 라이프사이클(Lifecycle)을 통해
워크플로 자동화 — 사용자의 특정 요구 사항에 기반하여

┌──────────────────────────────────────────────────────┐
│ MULTI-AGENT SQUAD │
│ │
...

# 1. 이 리포지토리(Repository)를 클론(Clone)하세요
git clone https://github.com/bijutharakan/multi-agent-squad.git
cd multi-agent-squad
...

/project 명령어가 전체 오케스트레이션 설정을 트리거합니다!

설정 후에는 다음과 같은 환경을 갖추게 됩니다:

🤖 특화된 AI 에이전트 (AI agents) — 프로젝트에 맞춤화된
🔌 구성된 통합 (Integrations) — 기존 도구들과의 연결
🚀 MCP 서버 — 향상된 기능을 위한
🦝 자동화된 워크플로 (Workflows) — 사용자의 요구 사항에 기반한
📊 스프린트 관리 (Sprint management) — 리뷰 사이클을 포함한
🔔 스마트 알림 (Smart notifications) — 원하는 채널로 받는
🔐 보안 점검 (Security checks) — 및 품질 게이트 (Quality gates)

/project 명령어로 Claude를 시작하면 다음과 같은 과정을 안내합니다:

"무엇을 만들고 계신가요?" — 프로젝트 설명
"새로운 프로젝트인가요, 기존 프로젝트인가요?" — 그에 따라 적응함
"모노레포 (Monorepo)인가요, 멀티레포 (Multi-repo)인가요?" — 사용자의 선택
"작업을 어떻게 추적하시나요?" — GitHub, Jira, Linear 또는 수동 방식
"무엇을 자동화하고 싶으신가요?" — 요구 사항에 맞는 커스텀 훅 (Custom hooks)
"어떤 통합을 원하시나요?" — Slack, 이메일, Teams 등
"MCP 서버를 활성화할까요?" — 향상된 AI 기능 제공

그 후 Claude는 사용자의 프로젝트를 위한 완벽한 구조, 통합 및 자동화를 생성합니다.

your-project/
├── CLAUDE.md # 오케스트레이션 (Orchestration) 지침
├── PROJECT.md # 프로젝트 상세 정보
...

your-project/
├── CLAUDE.md # 오케스트레이션 (Orchestration) 지침
├── PROJECT.md # 프로젝트 상세 정보
...

your-project/
├── CLAUDE.md # 오케스트레이션 (Orchestration) 지침
├── PROJECT.md # 프로젝트 상세 정보
...

사용자의 프로젝트를 기반으로, Claude는 관련 에이전트 (Agents)를 제안합니다:

🎯 프라임 오케스트레이터 (Prime Orchestrator)

• 전체 워크플로우 (Workflow) 관리
  📊 프로덕트 매니저 (Product Manager)
• 요구사항 및 사용자 스토리 (User stories)
  🏗️ 솔루션 아키텍트 (Solution Architect)
• 시스템 설계 (System design)
  💻 백엔드 엔지니어 (Backend Engineer)
• API 개발
  🎨 프론트엔드 엔지니어 (Frontend Engineer)
• 사용자 인터페이스 (User interface)
  ✅ QA 엔지니어 (QA Engineer)
• 테스트 (Testing)
  🔧 DevOps 엔지니어 (DevOps Engineer)
• 배포 (Deployment)

🏗️ API 아키텍트 (API Architect)

• API 설계
  💻 백엔드 엔지니어 (Backend Engineer)
• 구현 (Implementation)
  📖 API 문서화 전문가 (API Documentation Specialist)
• 문서 (Docs)
  ✅ API 테스트 엔지니어 (API Test Engineer)
• 테스트 (Testing)

📝 테크니컬 라이터 (Technical Writer)

• 문서화 (Documentation)
  🏗️ 정보 아키텍트 (Information Architect)
• 구조 (Structure)
  👁️ 문서 검토자 (Documentation Reviewer)
• 품질 (Quality)

스프린트 관리 (Sprint Management)

• 자동화된 의식 (Ceremonies) 및 추적
  PR 리뷰 사이클 (PR Review Cycles)
• 코멘트 해결을 포함한 코드 리뷰 강제화
  품질 게이트 (Quality Gates)
• 단계 전환 전 자동화된 체크
  휴먼 체크포인트 (Human Checkpoints)
• 중요한 결정에는 승인 필요
  데일리 스탠드업 (Daily Standups)
• 자동화된 리마인더 및 보고서

Claude에게 평소처럼 말하세요:

• "사용자 인증 (User authentication) 기능을 추가해야 해"
• "CI/CD 설정을 도와줘"
• "API 문서를 생성해줘"
• "우리 아키텍처를 검토해줘"

자동화하고 싶은 내용을 Claude에게 말하세요:

"테스트 실행하는 걸 자꾸 까먹어"
→ 파일 변경 후 테스트 자동 실행
"데일리 스탠드업 리마인더를 줘"
→ 오전 9시 Slack/이메일 리마인더
"코드 품질을 체크해줘"
→ 저장 시 자동 린트 (Lint) 및 포맷팅 (Format)
"내 진행 상황을 추적해줘"
→ 자동 시간 추적 및 보고서
"보안 체크"
→ 커밋 전 비밀 정보 (Secrets) 스캔
"휴식 리마인더"
→ 매시간 건강을 위한 휴식 알림

훅 (Hooks)은 다음을 사용하여 사용자의 특정 요구사항에 맞춰 동적으로 생성됩니다:

python scripts/generate-hooks.py

GitHub- 이슈 (Issues), PR, 프로젝트 (Projects), Actions
Jira- 스프린트 (Sprints), 에픽 (Epics), 스토리 (Stories), 번다운 차트 (Burndown charts)
Linear- 사이클 (Cycles)을 포함한 현대적인 이슈 추적
Azure DevOps- 보드 (Boards), 리포지토리 (Repos), 파이프라인 (Pipelines)
ClickUp, Monday.com, Asana- 시각적 프로젝트 관리

Slack- 실시간 알림 (Real-time notifications), 일일 요약 (Daily summaries), 스레드 관리 (Thread management)
Microsoft Teams- 어댑티브 카드 (Adaptive cards), 채널 업데이트 (Channel updates)
Discord- 웹훅 (Webhooks), 커뮤니티용 임베드 (Embeds for communities)
Email- HTML/일반 텍스트 (HTML/plain text), 일일 요약 (Daily digests), 중요 알림 (Critical alerts)

CI/CD- GitHub Actions, Jenkins, GitLab CI, CircleCI
모니터링 (Monitoring)- Sentry, Datadog, Prometheus, New Relic
테스트 (Testing)- BrowserStack, SonarQube, Cypress Dashboard
문서화 (Documentation)- Confluence, Notion, GitHub Wiki
시간 추적 (Time Tracking)- Toggl, Harvest, Clockify

14개 이상의 사전 구성된 MCP 서버를 통해 Claude의 기능을 확장하세요:

PostgreSQL Explorer- 자연어 데이터베이스 쿼리 (Natural language database queries)
Memory Server- Claude 세션 전반에 걸친 지속적인 컨텍스트 (Persistent context)
Enhanced Filesystem- 권한을 포함한 고급 파일 작업 (Advanced file operations with permissions)

GitHub Integration- 심층적인 PR 및 이슈 관리 (Deep PR and issue management)
Test Runner- 테스트 스위트 실행 및 모니터링 (Execute and monitor test suites)
Docker Management- 컨테이너 및 이미지 제어 (Container and image control)
Kubernetes- 배포 및 포드 (Pod) 관리

Slack Server- 채널 읽기, 메시지 전송
Linear Server- 전체 이슈 트래킹 통합 (Full issue tracking integration)
Notion Server- 페이지 및 데이터베이스 액세스
Confluence Server- 문서 관리

프로젝트 분석 (Project Analytics)- 사용자 정의 메트릭 및 인사이트 (Custom metrics and insights)
모니터링 통합 (Monitoring Integration)- Datadog, Prometheus 액세스

설정 방법: python scripts/mcp-server-setup.py

요구사항 (Requirements)→ PM 에이전트가 사양 (Specs) 작성
설계 (Design)→ 아키텍트가 시스템 설계 작성
구현 (Implementation)→ 엔지니어가 구축
테스트 (Testing)→ QA가 품질 보장
배포 (Deployment)→ DevOps가 릴리스 처리

병렬 개발이 필요한 멀티 리포지토리 (Multi-repo) 프로젝트의 경우:

./scripts/worktree-manager.sh create-feature auth frontend backend

다른 도구들과 달리, Multi-Agent Squad는:

• ✅ 설치 과정 없음 (No installation process) - 클론(Clone) 후 바로 시작
• ✅ 설정 파일 없음 (No configuration files) - Claude가 필요한 것을 질문함
• ✅ 강제된 구조 없음 (No forced structure) - 사용자의 선호도에 맞게 적응
• ✅ 학습 곡선 없음 (No learning curve) - 평이한 영어로 제어

Git- 버전 관리용
Claude Code- AI 인터페이스

GitHub CLI(gh

) - GitHub 통합용
Python 3.8+ - 자동화 스크립트용
Jira API Token - Jira 통합용

Claude는 사용자가 보유한 것을 확인하고 이를 활용하여 작업합니다!

• 오케스트레이션 (Orchestration)을 시작하는 메인 엔트리 포인트 /project

• 멀티 리포지토리 (Multi-repo)를 위한 Git 워크트리 (Worktree) 관리 worktree-manager.sh

• 기존 코드베이스 분석 discover-project.py

• 범용 통합 관리자 integration-setup.py

• MCP 서버 설정 mcp-server-setup.py

• 애자일 (Agile) 도구 통합 agile-tools-setup.py

• Slack 웹훅 (Webhook) 설정 slack-integration.py

• 이메일 알림 설정 email-integration.py

• GitHub API 자동화 github-integration.py

• 스프린트 (Sprint) 의식 및 추적 sprint-management.sh

• 자동화된 PR 리뷰 강제 적용 pr-review-cycle.sh

• 동적 훅 (Hook) 생성 generate-hooks.py

• Git 훅 설정 setup-git-hooks.sh

사용자: "/project"
Claude: "안녕하세요! 저는 당신의 Multi-Agent Squad 오케스트레이터입니다. 무엇을 만들고 계신가요?"
사용자: "팀 협업을 위한 SaaS 제품입니다"
...

사용자: "빌드에 대한 Slack 알림을 설정해줘"
Claude: "Slack 통합 설정을 도와드리겠습니다. 설정을 실행합니다..."
[권한 요청을 포함한 대화형 설정]
...

사용자: "우리 데이터베이스의 모든 사용자를 보여줘"
Claude: [PostgreSQL MCP 서버 사용]
"데이터베이스의 사용자 목록입니다:
...

단순한 템플릿이나 스크립트와 달리, Multi-Agent Squad는 Claude의 지능을 사용하여 다음과 같은 작업을 수행합니다:

프로젝트 이해 - 경직된 설정이 아닌 문맥적으로 이해
워크플로우 적응 - 특정 방식을 강요하는 대신 사용자의 워크플로우에 적응
선호도 학습 - 사용자의 선호도를 학습하여 그에 따라 자동화 조정
지능적 결정 - 사용자의 통제권을 유지하면서 지능적인 결정 수행

Claude Code를 위해 구축됨 - 범용 프레임워크가 아님
서브 에이전트 (Sub-agents) 사용 - 단순한 프롬프트가 아닌 실제 AI 위임 수행
MCP 프로토콜 (MCP Protocol) - API 래퍼가 아닌 직접적인 도구 접근
Claude Hooks - 사용자의 워크플로우와 깊은 통합

YAML 파일 없음 - 오직 대화로만 진행
설정 마법사 없음 - Claude가 필요한 것을 직접 요청
의존성 없음 - 사용자가 보유한 환경에서 바로 작동
종속성 없음 (No lock-in) - 당신의 프로젝트를 당신의 방식대로

Multi-Agent Squad는 애자일 개발 (Agile development)의 모든 측면에 걸쳐 30개 이상의 통합 (Integrations)을 지원합니다:

# 대화형 통합 설정 (권장)
python scripts/integration-setup.py
# 향상된 기능을 위한 MCP 서버 설정
...

📋 프로젝트 관리 (Project Management)

• GitHub, Jira, Linear, Azure DevOps, ClickUp
  💬 커뮤니케이션 (Communication)
• Slack, Teams, Discord, Email
  📄 문서화 (Documentation)
• Confluence, Notion, GitHub Wiki
  🚀 CI/CD
• GitHub Actions, Jenkins, GitLab CI
  📊 모니터링 (Monitoring)
• Sentry, Datadog, Prometheus
  🧪 테스트 (Testing)
• BrowserStack, SonarQube, Cypress
  ⏱️ 시간 추적 (Time Tracking)
• Toggl, Harvest, Clockify

전체 설정 지침은 docs/INTEGRATIONS.md를 참조하세요.

자격 증명 관리 (Credential Management)

• .env.* 파일에 안전하게 저장
  권한 범위 지정 (Permission Scoping)
• 최소한의 필수 액세스 권한만 부여
  비밀 정보 탐지 (Secret Detection)
• 보안을 위한 프리커밋 훅 (Pre-commit hooks)
  MCP 서버 보안 (MCP Server Security)
• 인터넷에 접속하는 서버에 대한 경고 제공

사용자: "블록체인을 이해하는 에이전트가 필요해"
Claude: [특화된 블록체인 에이전트 생성]

사용자: "데이터베이스의 모든 사용자를 보여줘"
Claude: [PostgreSQL MCP 서버를 사용하여 직접 쿼리 수행]
사용자: "우리 테스트 커버리지 추세가 어때?"
...

• 개발 (Development)

• 스테이징 (Staging)

• 운영 (Production)

• 모두 대화를 통해 관리

• 코드 리뷰 오케스트레이션 (Code review orchestration)

• 배포 파이프라인 (Deployment pipelines)

• 문서 업데이트

• 스프린트 의식 (Sprint ceremonies)

• 모두 평이한 영어로 수행

Claude는 항상 다음 사항에 대해 권한을 요청합니다:

• 운영 (Production) 배포
• 데이터베이스 마이그레이션 (Database migrations)
• 보안 변경 사항
• 메인 브랜치 머지 (Main branch merges)
• 리소스 삭제

Multi-Agent Squad는 다음을 지향합니다:

유연성 (Flexibility)

• 당신의 프로젝트를 당신의 방식대로
  단순성 (Simplicity)

• 복잡한 명령어나 설정 없음
  지능 (Intelligence)

• 실제 전문 지식을 갖춘 에이전트
  적응성 (Adaptability)

• 당신이 보유한 환경에서 작동
  투명성 (Transparency)

• 명확하고 문서화된 결정

• "새로운 기능을 어떻게 추가하나요?"

• "내가 어떤 에이전트들을 가지고 있나요?"

• "프로젝트 상태를 보여줘"

• "Slack 알림 설정을 도와줘"

• "내 데이터베이스를 위한 MCP 서버를 구성해줘"

• "커스텀 자동화 훅 (Automation hook)을 생성해줘"

INTEGRATIONS.md- 전체 통합 가이드
AGILE_WORKFLOW.md- 엔터프라이즈 워크플로우 상세 정보
HOOKS_GUIDE.md- 자동화 훅 (Automation hook) 참조
AGENT_GUIDELINES.md- 에이전트 (Agent) 생성 가이드

# 사용 가능한 통합 목록 확인
python scripts/integration-setup.py
# MCP 서버 상태 확인
...

MIT License - LICENSE 파일을 참조하세요

기여를 환영합니다! 기여하는 가장 좋은 방법은 시스템을 사용해 보고 여러분의 경험을 공유하는 것입니다.

시작할 준비가 되셨나요? 이 디렉토리로 cd 한 뒤 Claude Code를 시작하기만 하면 됩니다. 설치도, 설정도 필요 없습니다. 그저 자연스러운 대화를 통해 놀라운 소프트웨어를 구축하세요!

Multi-Agent Squad: AI가 인간의 창의성과 만나 탁월한 소프트웨어를 구축하는 곳.