plusai-solutions/ai-scrum-master-template

AI 코딩 에이전트 (AI coding agents)는 강력합니다. 기능을 계획하고, 코드를 작성하며, 테스트를 실행할 수 있습니다. 하지만 조정 (coordination)이 없다면 혼란에 빠지게 됩니다. 동일한 코드베이스에서 작업하는 여러 에이전트에게는 작업을 세분화하고, 태스크를 할당하며, 진행 상황을 추적하고, 아무것도 누락되지 않도록 보장할 누군가가 필요합니다.

이것이 바로 인간 스크럼 마스터 (Scrum Master)가 개발 팀을 위해 수행하는 역할입니다. 이 프로젝트는 그 역할을 GitHub에서 완전히 실행되는 **AI 스크럼 마스터 (AI Scrum Master)**로 대체합니다:

아이디어를 세분화하여 우선순위가 지정된 개별 백로그 티켓 (backlog tickets)으로 변환합니다.
작업을 할당합니다 전문화된 AI 에이전트 (planner, developer, tester)에게 작업을 할당합니다.
진행 상황을 추적합니다 자동으로 업데이트되는 칸반 보드 (Kanban board)에서 진행 상황을 추적합니다.
인간을 루프에 유지합니다 (Keeps humans in the loop) 모든 결정 지점에서 인간이 개입할 수 있도록 합니다.

결과적으로, 당신은 무엇을 만들고 싶은지 설명하기만 하면 되며, 조정된 AI 에이전트 팀이 모든 단계에서 완전한 가시성과 인간의 감독 하에 이를 구축합니다.

최근에는 범용 AI 에이전트 (OpenClaw와 같은)가 개인적인 싱글 플레이어 자동화를 위해 인기를 얻고 있습니다. 개인적인 이메일 초안을 작성하거나 채팅 인터페이스를 통해 데이터를 가져오는 데는 훌륭하지만, 엔터프라이즈 팀(engineering, finance, marketing, operations 전반)은 정교한 보안, 감사 가능성 (auditability), 그리고 구조화된 워크플로 (workflows)를 필요로 합니다. 이 템플릿은 AI 팀을 안전하게 실행하기 위해 GitHub의 엔터프라이즈급 인프라를 활용합니다. 우리의 GitHub 네이티브 방식이 일반적인 로컬 에이전트와 어떻게 다른지는 다음과 같습니다:

기능	이 템플릿 (GitHub 네이티브 엔터프라이즈)	일반 에이전트 (예: OpenClaw)
보안 및 개인정보 보호 (Security & Privacy)	엔터프라이즈 RBAC (역할 기반 액세스 제어): GitHub의 엄격한 권한 모델 하에서 작동합니다. 에이전트는 특정 권한이 부여된 저장소에만 접근합니다. 섀도우 IT (Shadow IT)가 발생하지 않으며, 보안 팀이 완전히 감사할 수 있습니다.	루트 액세스 (Root Access) 위험: 종종 로컬 머신이나 VPS 파일 시스템에 대한 광범위하고 샌드박스화되지 않은 액세스를 요구하며, 이는 심각한 데이터 개인정보 보호 및 보안 취약점을 유발합니다.
아키텍처 (Architecture)	서버리스 및 휘발성 (Serverless & Ephemeral): 모든 작업은 깨끗하고 격리된 클라우드 컨테이너에서 실행됩니다. 유휴 비용이 없고, 실행 간 데이터 유출이 없으며, 환경 오염이 발생하지 않습니다.	상태 유지 및 상시 가동 (Stateful & Always-On): 로컬 하드웨어에서 지속적으로 실행됩니다. 상태 오염, 의존성 충돌 및 의도치 않은 데이터 노출에 취약합니다.
방법론 (Methodology)	구조화된 애자일 워크플로우 (Structured Agile Workflows): 별도의 프롬프트를 가진 전문화된 역할(예: 프로젝트 매니저, 분석가, 리뷰어, 개발자)을 오케스트레이션하여, 복잡한 프로젝트에 대해 자연스러운 견제와 균형을 생성합니다.	단일 일반론자 (Solo Generalist): 채팅창을 통해 모든 것을 한 번에 처리하려는 단일

Scrum Master의 조정 하에 네 명의 전문화된 Claude AI 에이전트가 GitHub Actions를 통해 협업합니다:

기능 설명 → Scrum Master가 티켓 생성 → Planner가 설계 →
Developer가 구축 → Tester가 검증 → 사용자가 검토 및 머지(Merge)

에이전트 (Agent)	역할 (Role)
Scrum Master	Kanban 보드 관리, 티켓 생성, 작업 할당, 상태 추적
Planner	기능 요청 분석, 상세 구현 계획 수립
Fullstack Dev	기능 구현 (프론트엔드 + 백엔드), 테스트 작성, PR(Pull Request) 생성
QA Tester	PR 검토, 린트(Lint)/테스트/빌드 실행, 버그 보고 또는 승인

작업은 다음과 같은 단계가 포함된 Kanban 보드(GitHub Issue)를 통해 흐릅니다:

Backlog (백로그) → Planning (계획) → Developing (개발) → Testing (테스트) → Human Review (사용자 검토) → Done (완료)

Scrum Master는 작업이 진행됨에 따라 자동으로 티켓을 단계 간에 이동시킵니다. 사용자는 언제든지 Kanban 보드 이슈를 확인하여 프로젝트의 전체 상태를 볼 수 있습니다.

사용자가 Kanban 이슈에 댓글을 작성합니다: @scrum-master Create backlogs for user auth and dashboard (사용자 인증 및 대시보드를 위한 백로그를 생성해줘)

Scrum Master가 이를 티켓으로 분할하여 Backlog에 추가합니다. 사용자가 티켓을 승인합니다: approve User authentication (사용자 인증 승인)

Scrum Master가 기능 이슈를 생성하여 Planner를 트리거합니다. Planner가 요청을 분석하고 구현 계획을 게시합니다. 사용자가 계획을 검토하고 승인합니다. Scrum Master가 티켓을 Developing 단계로 이동하면, Fullstack Dev가 코딩을 시작합니다. Dev가 기능 브랜치를 푸시하고 develop 브랜치로 PR을 엽니다.

Scrum Master가 티켓을 Testing 단계로 이동하면, QA Tester가 PR을 검토합니다. Tester가 린트, 테스트, 빌드를 실행하여 버그를 보고하거나 승인합니다. 사용자가 PR을 머지(Merge)하면, Scrum Master가 티켓을 Done으로 표시합니다.

사용자는 주요 체크포인트에서 제어권을 유지합니다:

시점	사용자의 행동
백로그 생성 시	티켓을 검토하고, 구축을 원하는 티켓에 대해 approve <ticket> 명령 수행
...

그 외의 모든 과정은 자동화되어 있습니다. 사용자는 언제든지 Kanban 보드 이슈에서 진행 상황을 모니터링할 수 있습니다.

git clone https://github.com/YOUR_USERNAME/nextjs-app-sample.git
cd nextjs-app-sample

또는 GitHub에서 **"Use this template"**를 클릭하여 이 템플릿으로부터 자신만의 저장소(repo)를 생성할 수 있습니다.

다음 두 가지 인증 방법 중 하나를 사용할 수 있습니다:

옵션 A: Claude Code OAuth 토큰 (Pro 또는 Max 사용자라면, 로컬에서 claude setup-token을 실행하여 생성하세요)

• GitHub 저장소로 이동 → Settings → Secrets and variables → Actions - New repository secret 클릭 - Name: CLAUDE_CODE_OAUTH_TOKEN 입력

• Value: 귀하의 Claude Code OAuth 토큰 입력

• Add secret 클릭

옵션 B: Anthropic API Key

• GitHub 저장소로 이동 → Settings → Secrets and variables → Actions - New repository secret 클릭 - Name: ANTHROPIC_API_KEY 입력

• Value: Anthropic Console에서 발급받은 API 키 입력

• Add secret 클릭 - .github/workflows/ 디렉토리 내의 워크플로(workflow) 파일들을 업데이트하여, claude-code-action 설정 내의 CLAUDE_CODE_OAUTH_TOKEN을 anthropic_api_key로 교체하세요.

• https://github.com/apps/claude 로 이동

• Install 클릭 - 저장소(또는 모든 저장소)를 선택

• 이를 통해 Claude가 귀하의 이슈(issues) 및 풀 리퀘스트(PRs)와 직접 상호작용할 수 있게 됩니다.

• Settings → Actions → General로 이동 - Workflow permissions 항목 아래에서 Read and write permissions를 선택 - Allow GitHub Actions to create and approve pull requests를 체크 - 저장(Save)

Issues → Labels로 이동하여 다음 라벨들을 생성하세요:

라벨 (Label)	색상 제안
kanban	blue
feature-request	teal
awaiting-human-review	yellow
needs-revision	light yellow
approved-plan	green
bugs-found	red
tests-passed	green
ready-for-merge	green
needs-clarification	yellow
priority-high	red
priority-medium	yellow
priority-low	green

아래 링크를 클릭하여 칸반 보드(Kanban board) 이슈를 자동으로 생성하세요 (YOUR_ORG/YOUR_REPO를 실제 저장소 이름으로 교체하세요):

또는 제목을 Kanban Board, 라벨을 kanban으로 설정하고 다음 본문 내용을 포함하여 수동으로 새 이슈를 생성하세요:

## Kanban Board
### Backlog
### Planning
...

CLAUDE.md 수정— 프로젝트 개요, 기술 스택 (tech stack), 그리고 코딩 표준 (coding standards)을 귀하의 앱에 맞게 업데이트하세요. 이 파일은 모든 에이전트 (agents)가 작업을 수행하기 전에 읽는 주요 컨텍스트 (context) 파일입니다. 에이전트의 동작, 모델 (models), 또는 통신 패턴 (communication patterns)을 조정하고 싶다면 .claude/agents/ 내의 에이전트 설정 (agent configs)을 수정하세요.

Scrum Master에게 무엇을 구축할지 알려주려면 Kanban 보드 이슈에 다음과 같이 댓글을 남기세요:

@scrum-master 사용자 인증, 대시보드, 작업 CRUD, 드래그 앤 드롭 재정렬, 검색/필터 기능이 포함된 작업 관리 앱을 위한 백로그 (backlogs)를 생성해줘

Scrum Master는 이를 보드 위의 백로그 티켓 (backlog tickets)으로 세분화할 것입니다. 그 후 과정은 다음과 같습니다:

티켓 승인 (Approve a ticket): Kanban 이슈에 approve <ticket-title>이라고 댓글을 남기세요.

계획 검토 (Review the plan): Planner가 기능 (feature) 이슈에 계획을 생성합니다. 이를 검토한 후 approved-plan 라벨을 추가하고 @fullstack-dev please implement라고 댓글을 남기세요.

구축 과정 모니터링 (Watch it build): Fullstack Dev가 기능을 구현하고 PR (Pull Request)을 생성합니다.

자동 테스트 (Auto-tested): QA Tester가 PR을 검토하고, 테스트를 실행하며, 결과를 보고합니다.

병합 (Merge): 테스트를 통과하면 PR을 검토하고 develop 브랜치로 병합합니다.

Kanban 보드는 모든 단계에서 자동으로 업데이트됩니다.

이 템플릿은 어떠한 기술 스택 (tech stack)과도 함께 작동합니다. 에이전트들은 CLAUDE.md를 읽어 프로젝트의 다음 사항들을 파악합니다:

• 프레임워크 (Framework) 및 언어 (language)
• 빌드 (build), 테스트 (test), 린트 (lint) 명령
• 프로젝트 구조 (project structure) 및 컨벤션 (conventions)
• 의존성 (dependencies) 및 설치 방법

Next.js, Django, Rails, Flutter, Go, Rust 또는 그 외 무엇이든 귀하의 스택을 설명하기 위해 CLAUDE.md를 수정하기만 하면 에이전트들이 그에 맞춰 적응할 것입니다.

main
— 프로덕션 (Production, 안정적이며 배포됨)

develop
— 개발 (Development, 통합 브랜치)

feature/*
— 기능 브랜치 (Feature branches, develop에서 AI에 의해 생성됨)

모든 PR은 develop을 대상으로 합니다. 오직 사람만이 develop에서 main으로 병합합니다.

실제 기술 스택을 설명하려면 CLAUDE.md를 수정하세요. 에이전트들은 매 작업 전에 이 파일을 읽으므로, 정확하게 유지하는 것이 프로젝트에 적합한 코드를 작성하도록 보장합니다.

에이전트 설정 (Agent configs)은 .claude/agents/에 위치합니다:

scrum_master.md — 보드 관리 및 조정
product_manager.md

— 기능 분석 및 계획
fullstack_dev.md

— 코드 구현
tester.md

— 코드 리뷰 및 테스트

각 워크플로 (Workflow)는 claude_args에 모델을 지정합니다.

이 모델들은 .github/workflows/ 파일에서 변경할 수 있습니다:

claude-opus-4-6

— 가장 뛰어난 성능, 계획 및 조정에 사용
claude-sonnet-4-6

— 빠르고 비용 효율적, 구현 및 테스트에 사용

새로운 에이전트(예: 전담 API 개발자)를 추가하려면:

• YAML 프론트매터 (Frontmatter)가 포함된 .claude/agents/your_agent.md 파일을 생성합니다.

• 해당 에이전트를 트리거하는 워크플로 (Workflow)를 .github/workflows/에 생성합니다.

• 새로운 에이전트의 역할을 문서화하기 위해 CLAUDE.md를 업데이트합니다.

• CLAUDE.md — 프로젝트 컨텍스트 (Context), 기술 스택 (Tech stack), 그리고 코딩 표준 (Coding standards)

• WORKFLOW_SETUP.md — 상세 설정 및 아키텍처 가이드

• COMMUNICATION_PROTOCOL.md — 에이전트 간의 통신 및 작업 인수인계 방식

각 워크플로 (Workflow) 실행 시 Claude API 토큰이 소비됩니다. 비용을 관리하려면:

• Opus는 제한적으로 사용합니다 (계획, Scrum Master 조정)
• Sonnet은 구현 및 테스트를 담당합니다 (낮은 비용)
• 워크플로 (Workflow) 파일에서 --max-turns를 조정하여 대화 길이를 제한합니다.
• console.anthropic.com에서 사용량을 모니터링합니다.

GitHub Actions와 라벨을 수동으로 설정하고 싶지 않으신가요? 저희는 Collo.dev를 구축하고 있습니다 — 설정 없이 클릭 한 번으로 이 전체 AI Scrum 팀을 설치할 수 있는 완전 호스팅형 GitHub App입니다. 대기 명단에 등록하세요.