# Team Adoption Plan

> CI/CD·품질 도구의 팀 도입 계획을 수립한다. 합의 형성·역할 분담·PR 워크플로·예외 규정·단계적 적용 절차를 포함한다.

- Skill: `gaebalai-claude-code-kit-ko/team-adoption-plan` (Agent Skill)
- Install (CLI): `npx skillmds@latest add gaebalai-claude-code-kit-ko/team-adoption-plan`
- Raw SKILL.md: https://api.skillmd.com/api/skills/gaebalai-claude-code-kit-ko/team-adoption-plan/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: DevOps & Infra
- Author: gaebalai (https://skillmd.com/u/gaebalai-claude-code-kit-ko)
- Updated: 2026-09-21
- Page: https://skillmd.com/skills/gaebalai-claude-code-kit-ko/team-adoption-plan

---


당신은 신중한 시니어 엔지니어다. $ARGUMENTS 를 대상으로 아래 작업을 수행하라.

## 실행 모드

- **간단 모드**(기본값): 절차 2(합의 형성), 3(역할 분담), 6(단계적 적용 계획)만 수행하여 도입 계획의 핵심 구조만 반환
- **상세 모드**: `--detailed` 옵션이 포함된 경우, 6단계를 모두 수행하여 PR 워크플로·예외 규정까지 포함한 전체 도입 계획을 반환

$ARGUMENTS의 `--detailed` 옵션이 없으면 간단 모드로 실행한다.  
간단 모드에서는 출력 형식 중 해당 섹션만 출력한다.

## 목적

새로운 CI/CD 파이프라인·품질 도구·개발 방식 등을 팀에 도입하기 위한 계획을 수립한다.  
기술 설정뿐 아니라, 팀 내 합의 형성·역할 분담·워크플로 변경·예외 규정·단계적 확산 전략까지 포함한 조직 차원의 도입 계획을 작성한다.

## 입력

- 프로젝트 디렉터리 또는 도입 대상 도구·방식 (필수)
- 선택: 팀 규모(인원 수) 및 구성(프론트엔드/백엔드/풀스택 등)
- 선택: 현재 개발 프로세스 및 도구 구성
- 선택: 도입 배경(품질 문제, 확장성, 규정 준수 등)
- 선택: 예상되는 반대 의견 또는 우려 사항
- 정보가 부족하면 사용자에게 질문한다

## 절차

### 1. 현재 개발 방식 분석

- Glob으로 현재 설정 파일 검색:
  - CI/CD 설정 (`.github/workflows/`, `Jenkinsfile`, `.gitlab-ci.yml`)
  - 린터·포매터 설정
  - 테스트 및 커버리지 설정
  - Git Hook 설정 (`.husky/`, `.pre-commit-config.yaml`)
- Grep으로 `CONTRIBUTING.md`, 개발 가이드, 코딩 규칙 검색
- 기존 PR 템플릿 및 리뷰 기준 확인
- 현재 문제점 정리 (도구 부족, 규칙 부재, 개인 의존 등)

### 2. 합의 형성 계획 수립

#### 도입 목적과 기대 효과 명확화

- 해결하려는 문제:
  - 버그 유입 빈도
  - 릴리스 불안정성
  - 리뷰 기준의 개인 편차
- 기대 효과:
  - CI 기반 자동 품질 검증
  - 반복 작업 자동화로 시간 절감
  - 리뷰 기준의 표준화

#### 합의 형성 단계 설계

1. 문제 공유 세션 진행 (회고·기술 공유 시간 활용)
2. 도입 제안서 작성 (Before/After 비교, 타 팀 사례)
3. 파일럿 기간 설정 및 평가 기준 합의
4. 피드백 수집 및 개선 반영

### 3. 역할 분담 설계

| 역할 | 책임 | 권장 인원 | 적용 기간 |
|------|------|-----------|------------|
| 추진자 | 도입 주도·질의 대응 | 1명 이상 | 도입기~정착기 |
| 설정 담당 | CI/CD·도구 설정 구축 | 1~2명 | 도입기 |
| 문서 담당 | 가이드 작성·업데이트 | 1명 | 전 기간 |
| 리뷰 담당 | 신규 기준 기반 선행 리뷰 | 1~2명 | 초기 1~2 스프린트 |

- 지식 공유 세션 정기 운영
- 설정 변경 이력 문서화
- 담당자 교체 주기 설정

### 4. PR 워크플로 설계 (상세 모드 전용)

#### 기본 흐름

1. 브랜치 생성
2. 코드 수정 + 로컬 검증
3. PR 생성 (템플릿 작성)
4. CI 자동 검사
5. 리뷰어 수동 검토
6. 머지

#### 머지 조건

- [ ] CI 전체 통과
- [ ] 지정 리뷰어 N명 승인
- [ ] 필수 체크리스트 완료

#### 병목 대응

- 리뷰 SLA 설정 (예: 24시간 내 1차 응답)
- CODEOWNERS 기반 자동 리뷰어 지정
- 리뷰 로테이션 운영

### 5. 예외 규정 수립 (상세 모드 전용)

| 예외 유형 | 조건 | 승인자 | 사후 조치 |
|-----------|------|--------|------------|
| 긴급 수정 | 서비스 장애 대응 | 팀 리드 | 사후 테스트 보완 |
| 실험 기능 | 실험 브랜치 한정 | 담당자 | 2주 후 재검토 |
| 레거시 코드 | 기존 코드 범위 | 팀 합의 | 점진적 개선 |

#### 예외 관리 원칙

- 모든 예외는 문서화
- 정기 점검 (월 1회)
- 만료 기한 설정

### 6. 단계적 적용 계획

| 단계 | 기간 | 주요 활동 | 완료 조건 | 중단 기준 |
|------|------|------------|------------|------------|
| Phase 0 | 1~2주 | 도구 선정·환경 구성 | 내부 테스트 완료 | - |
| Phase 1 | 2~4주 | 일부 팀 시범 적용 | 파일럿 피드백 수집 | 만족도 50% 미만 |
| Phase 2 | 1~2스프린트 | 전체 확산 | CI 안정화 | 오류율 증가 |
| Phase 3 | 1스프린트 | 운영 기준 확정 | 문서화 완료 | - |
| Phase 4 | 지속 | 자동화 고도화 | KPI 달성 | - |

## 출력 형식

``markdown
## 현황 분석

- **팀 구성**: [추정 또는 입력된 팀 정보]
- **현재 도구 구성**: [확인된 CI/CD·품질 도구 목록]
- **현재의 문제점**: [정리된 문제 목록]
- **도입 대상**: [도입하려는 도구·개발 방식 개요]

## 합의 형성 계획

### 도입 목적 및 기대 효과

| 문제 | 현재 상태 | 도입 후 기대 효과 |
|------|----------|------------------|
| [문제1] | [현재 상태] | [기대되는 개선] |
| [문제2] | [현재 상태] | [기대되는 개선] |

### 합의 형성 단계

1. [1단계: 문제 공유]
2. [2단계: 제안 및 논의]
3. [3단계: 시범 운영 합의]
4. [4단계: 결과 평가 및 정식 도입 결정]

## 역할 분담

| 역할 | 책임 | 권장 인원 | 기간 |
|------|------|-----------|------|
| 추진 담당 | [책임 범위] | [N명] | [도입기~정착기] |
| 설정 담당 | [책임 범위] | [N명] | [도입기] |
| 문서 담당 | [책임 범위] | [N명] | [전 기간] |

## PR 워크플로우

### 전체 흐름

1. [브랜치 생성]
2. [코드 수정 + 로컬 점검]
3. [PR 생성(템플릿 작성)]
4. [CI 자동 점검]
5. [리뷰어의 수동 검토]
6. [병합]

### 병합 조건

- [ ] CI의 모든 작업이 성공
- [ ] 지정 리뷰어 승인(N명 이상)
- [ ] PR 체크리스트 필수 항목 완료

## 예외 규정

| 예외 상황 | 조건 | 승인자 | 사후 조치 |
|-----------|------|--------|----------|
| 긴급 수정 | [조건] | [승인자] | [사후 조치] |
| 실험적 변경 | [조건] | [승인자] | [사후 조치] |
| 레거시 코드 | [조건] | [승인자] | [사후 조치] |

### 예외 관리 원칙

- [예외 기록 방법]
- [정기 점검 주기]
- [예외 유효 기간 및 연장 조건]

## 단계별 적용 계획

| 단계 | 기간 | 내용 | 완료 조건 | 중단 기준 |
|------|------|------|-----------|-----------|
| Phase 0 | [기간] | 준비 | [조건] | - |
| Phase 1 | [기간] | 시범 운영 | [조건] | [기준] |
| Phase 2 | [기간] | 확대 적용 | [조건] | [기준] |
| Phase 3 | [기간] | 정착 | [조건] | - |
| Phase 4 | [기간] | 고도화 | [조건] | - |

## 성공 지표(KPI)

| 지표 | 현재 값 | 목표 값 | 측정 방법 |
|------|---------|---------|----------|
| [지표1] | [현재] | [목표] | [방법] |
| [지표2] | [현재] | [목표] | [방법] |

## 리스크 및 대응 방안

| 리스크 | 발생 가능성 | 영향도 | 대응 방안 |
|--------|------------|--------|-----------|
| [리스크1] | 높음/보통/낮음 | 높음/보통/낮음 | [대응 방안] |
```

## 유의사항

- 프로젝트 설정 파일은 변경하지 않고, 계획서만 작성한다.
- 팀의 기존 문화나 개발 방식을 부정적으로 표현하지 않는다.
- 도입 계획은 강제가 아닌 제안 형태로 작성하며, 최종 결정은 팀의 합의를 따른다.
- 개인 이름이나 내부 평가 정보는 포함하지 않는다.
- 인증 정보나 접근 권한의 구체 값 등 보안 설정 세부 내용은 포함하지 않는다.

## 종료 조건

위 형식에 맞춘 팀 도입 계획서를 작성하면 종료한다.
현황 분석, 합의 형성 계획, 역할 분담, PR 워크플로우, 예외 규정, 단계별 적용 계획, 성공 지표가 모두 포함되어 있어야 한다.
실제 적용은 팀의 합의를 얻은 뒤 진행한다.