Claude Code 실습 기획서

Eleven·2026년 4월 16일

Hello Again, Claude Code

목록 보기
1/5
post-thumbnail

신규 팀원 온보딩 자동화 시스템

버전: v2.0 (리뷰 반영)
작성일: 2026-04-15
학습 목표: 앞서 학습한 10개 모듈을 총체적으로 활용하여 실제 업무 자동화 시스템을 구축한다.

1. 시나리오 개요

배경

5인 스타트업 개발팀에 새 백엔드 개발자가 합류했다. 매번 반복되는 온보딩 작업들을 Claude Code로 자동화한다.

자동화 대상 업무

업무현재 방식자동화 후
온보딩 미팅 일정 조율이메일로 수동 조율자동 일정 제안 + 캘린더 등록
관계자 이메일 발송매번 직접 작성템플릿 기반 자동 발송
Slack 공지수동 메시지 작성자동 채널 알림
코드 리뷰 가이드구두 설명에이전트가 자동 안내
PR 규칙 안내문서 링크 공유자동 체크 및 피드백
GitHub 이슈 추적수동 확인MCP로 자동 조회

2. 사용 기술 매핑

단계기능역할
1단계CLAUDE.md + Planning Mode팀 헌법 수립 + 사전 계획 검토
2단계Slash Commands + Skills반복 업무 단축키 + 자동 감지 워크플로우
3단계MCP (GitHub + Google Calendar + Gmail + Slack)외부 도구 연결
4단계Hooks품질 게이트 자동화
5단계Subagents전문 에이전트 팀 구성
6단계Git Worktrees병렬 브랜치 작업
7단계Plugins전체 워크플로우 패키지화
8단계Checkpoints안전한 실험 및 롤백
9단계CLICI/CD 통합 자동화

3. 단계별 실습 계획

1단계 — 팀 헌법 수립

기능: CLAUDE.md + Planning Mode
소요 시간: 30분

실습 내용:

# Planning Mode로 온보딩 문서 구조 먼저 기획
/plan 신규 팀원 온보딩 자동화 시스템 전체 구조를 설계해줘

# 기획 승인 후 CLAUDE.md 작성

CLAUDE.md 작성 항목:

# 팀 온보딩 시스템

## 코딩 컨벤션
- 함수명: camelCase
- 파일명: kebab-case
- 들여쓰기: 2칸 공백

## PR 규칙
- main 직접 커밋 금지
- PR 최소 1명 리뷰어 필수
- 커밋 메시지: conventional commits

## 온보딩 절차
1. 환경 설정 완료
2. 코드베이스 탐색
3. 첫 PR 제출
4. 미팅 일정 조율

학습 포인트: CLAUDE.md는 강제력이 없다 → 강제력은 Hooks에서 나온다.

2단계 — 반복 업무 단축키

기능: Slash Commands + Skills
소요 시간: 45분

Slash Commands 생성:

mkdir -p .claude/commands

# /onboarding-checklist — 체크리스트 자동 생성
# /standup — 스탠드업 메시지 작성
# /pr-review — PR 설명 자동 작성
# /send-welcome-email — 환영 이메일 초안 작성

Skills 생성:

mkdir -p .claude/skills/code-mentor

# SKILL.md: 코드 질문 자동 감지 후 온보딩 수준에 맞게 설명
# description: 신규 팀원이 코드 관련 질문을 할 때 자동 감지

학습 포인트: Skills는 description이 자동 호출 트리거. 너무 광범위하게 쓰면 토큰 낭비.

3단계 — 외부 도구 연결 (MCP 4종)

기능: MCP
소요 시간: 50분

3-1. GitHub MCP (기설치)

# 온보딩 이슈 자동 조회
> "신규 팀원 온보딩 관련 열린 이슈 목록 보여줘"
> "온보딩 체크리스트 이슈 생성해줘"

3-2. Google Calendar MCP

# 설치
claude mcp add google-calendar -- npx -y @modelcontextprotocol/server-google-calendar

# 활용 예시
> "다음 주 화요일 오전 10시에 온보딩 미팅 일정 잡아줘"
> "참석자: 팀원 전체, 제목: 신규 팀원 온보딩 킥오프"

3-3. Gmail MCP

# 설치
claude mcp add gmail -- npx -y @modelcontextprotocol/server-gmail

# 활용 예시
> "온보딩 미팅 일정을 관계자들에게 이메일로 발송해줘"
> "수신자: 팀장, 멘토, 신규 팀원, 참고: HR팀"

3-4. Slack MCP

# 설치
claude mcp add slack -- npx -y @modelcontextprotocol/server-slack

# 활용 예시
> "#general 채널에 신규 팀원 합류 공지를 보내줘"
> "#dev 채널에 온보딩 미팅 일정 알림 보내줘"

통합 시나리오:

"신규 팀원 김개발 씨의 온보딩 미팅을 준비해줘"
    ↓
Google Calendar: 다음 주 화요일 10시 일정 생성
    ↓
Gmail: 관계자 전원에게 일정 안내 이메일 발송
    ↓
Slack: #general에 환영 메시지 + #dev에 일정 공유
    ↓
GitHub: 온보딩 이슈 생성 및 담당자 배정

4단계 — 품질 게이트 자동화

기능: Hooks
소요 시간: 45분

{
  "hooks": {
    "PostToolUse": [
      {
        "matcher": "Edit|Write",
        "command": "npx prettier --write \"$TOOL_INPUT_FILE_PATH\""
      }
    ],
    "PreToolUse": [
      {
        "matcher": "Bash",
        "command": "~/.claude/hooks/security-gate.sh"
      }
    ],
    "Stop": [
      {
        "command": "~/.claude/hooks/notify-complete.sh"
      }
    ]
  }
}

security-gate.sh 주요 규칙:

# main 브랜치 직접 커밋 차단
# rm -rf 패턴 차단
# 민감 정보 패턴 차단 (API 키 등)

학습 포인트: exit 0 = 허용, exit 1 = 경고, exit 2 = 차단.

5단계 — 전문 에이전트 팀 구성

기능: Subagents
소요 시간: 50분

온보딩 에이전트 팀 (5종):

.claude/agents/
├── onboarding-guide.md      ← 온보딩 절차 안내 전문
├── code-mentor.md           ← 코드 질문 답변 전문
├── schedule-manager.md      ← 일정 조율 전문 (Calendar MCP 사용)
├── email-notifier.md        ← 이메일 발송 전문 (Gmail MCP 사용)
└── slack-notifier.md        ← Slack 알림 전문 (Slack MCP 사용)

email-notifier 예시:

---
name: email-notifier
description: 온보딩 관련 이메일 발송이 필요할 때. 미팅 안내, 환영 메시지, 일정 공유.
tools: Read
model: sonnet
mcpServers: ["gmail"]
---

You are an email specialist for team onboarding.
Always write professional, warm, and concise emails.
Include: 일정, 장소/링크, 준비 사항, 담당자 연락처

slack-notifier 예시:

---
name: slack-notifier
description: 팀 Slack 채널에 온보딩 관련 공지가 필요할 때.
tools: Read
model: haiku
mcpServers: ["slack"]
---

You are a Slack notification specialist.
Always use appropriate channels and mention relevant team members.
Keep messages concise and actionable.

통합 워크플로우:

"온보딩 미팅 준비해줘" 입력 시:
├── schedule-manager → Google Calendar 일정 생성
├── email-notifier   → Gmail로 관계자 이메일 발송
├── slack-notifier   → Slack 채널 공지
└── onboarding-guide → GitHub 이슈 생성 + 체크리스트 배정

6단계 — Git Worktrees로 병렬 작업

기능: Git Worktrees
소요 시간: 30분

시나리오: 온보딩 문서 개선과 자동화 스크립트 개발을 동시에 진행

# 두 브랜치를 독립된 폴더에서 동시 작업
git worktree add ../onboarding-docs feature/docs-improvement
git worktree add ../onboarding-scripts feature/automation-scripts

# 각 폴더에서 다른 Subagent 할당
# onboarding-docs: documentation-writer 에이전트
# onboarding-scripts: code-reviewer 에이전트

학습 포인트: Worktrees + Subagents 조합으로 진정한 병렬 작업 가능.

7단계 — 전체 워크플로우 패키지화

기능: Plugins
소요 시간: 40분

플러그인 구조:

onboarding-plugin/
├── .claude-plugin/
│   └── plugin.json          ← 메타데이터
├── commands/
│   ├── onboarding-checklist.md
│   ├── standup.md
│   └── send-welcome-email.md
├── agents/
│   ├── onboarding-guide.md
│   ├── email-notifier.md
│   └── slack-notifier.md
├── hooks/
│   └── hooks.json
├── .mcp.json                ← GitHub + Calendar + Gmail + Slack 설정
└── README.md

배포 흐름:

# 로컬 테스트
claude --plugin-dir ./onboarding-plugin

# 팀 배포
git push
# 팀원이 설치:
/plugin install onboarding-plugin

8단계 — 안전한 실험

기능: Checkpoints
소요 시간: 20분

시나리오:

1. 이메일 템플릿 A안 작성 → 체크포인트 자동 생성
2. B안 작성
3. Esc+Esc → A안과 B안 비교
4. 더 나은 안 선택
5. 나머지 롤백

학습 포인트: Restore code / Restore conversation / Restore both 세 가지 옵션 구분.

9단계 — CI/CD 통합

기능: CLI
소요 시간: 20분

# 온보딩 체크리스트 자동 생성 (비대화형)
claude -p "신규 팀원 온보딩 체크리스트 생성" --permission-mode dontAsk

# 에러 로그 자동 분석
cat error.log | claude -p "온보딩 스크립트 에러 원인 분석해줘"

# Opus로 온보딩 프로세스 개선안 설계 (비용 효율)
claude --model opusplan "현재 온보딩 프로세스의 병목을 분석하고 개선안을 설계해줘"

4. 전체 아키텍처

신규 팀원 합류
      ↓
Planning Mode: 온보딩 계획 수립 및 승인
      ↓
CLAUDE.md: 팀 규칙 로드
      ↓
┌─────────────────────────────────────────┐
│           에이전트 팀 병렬 실행          │
│                                         │
│  schedule-manager  → Google Calendar   │
│  email-notifier    → Gmail             │
│  slack-notifier    → Slack             │
│  onboarding-guide  → GitHub Issues     │
└─────────────────────────────────────────┘
      ↓
Hooks: 코드 품질 자동 검증 + 보안 게이트
      ↓
Git Worktrees: 문서/스크립트 병렬 개발
      ↓
Checkpoints: 안전한 실험 및 롤백
      ↓
Plugins: 전체 워크플로우 팀에 배포
      ↓
CLI: CI/CD 파이프라인 통합

5. 단계별 소요 시간

단계기능예상 시간
1단계CLAUDE.md + Planning Mode30분
2단계Slash Commands + Skills45분
3단계MCP 4종 (GitHub + Calendar + Gmail + Slack)50분
4단계Hooks45분
5단계Subagents (5종)50분
6단계Git Worktrees30분
7단계Plugins40분
8단계Checkpoints20분
9단계CLI20분
합계약 5시간 30분

6. 학습 완료 체크리스트

  • CLAUDE.md 작성 및 팀 컨벤션 정의
  • Planning Mode로 사전 계획 검토 경험
  • Slash Commands 3개 이상 직접 생성
  • Skills와 Commands의 차이 이해 및 적용
  • GitHub + Google Calendar + Gmail + Slack MCP 연동
  • PreToolUse / PostToolUse Hook 동작 확인
  • 5종 Subagent 팀 구성 및 병렬 실행 경험
  • Git Worktrees로 두 브랜치 동시 작업
  • Plugin 생성 및 로컬 테스트
  • Checkpoints로 롤백 실습
  • CLI Print Mode로 자동화 스크립트 실행

7. wrap up 정책

  • 각 단계 완료 후 wrap up 키워드 입력 시 Markdown + troubleshooting 중심으로 정리
  • 국문 + 영문 병기
  • Velog 시리즈: Claude Code 실전 — 온보딩 자동화
profile
Eleven
다음 포스트

Establish Team Charter

0개의 댓글