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. 역할 분담 설계

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

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

기본 흐름

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

머지 조건

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

병목 대응

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

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

예외 관리 원칙

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

6. 단계적 적용 계획

출력 형식

``markdown

현황 분석

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

합의 형성 계획

도입 목적 및 기대 효과

합의 형성 단계

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

역할 분담

PR 워크플로우

전체 흐름

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

병합 조건

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

예외 규정

예외 관리 원칙

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

단계별 적용 계획

성공 지표(KPI)

리스크 및 대응 방안

## 유의사항

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

## 종료 조건

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