Process Roles Guide

역할별 가이드

규칙 ID 범위: PROC-ROLE-* 대상: PO, PSM, Engineer, QA 관련 문서: Collaboration-Process, Process-Phase-1-Epic-Creation, Process-Phase-2-Task-Creation, Process-Phase-3-Development, Process-Phase-4-Deployment

📋 목차

  1. PO (Product Owner)
  2. PSM (Product Scrum Master)
  3. Engineer (Developer)
  4. QA (Quality Assurance)

👤 PO (Product Owner)

담당자

  • Roki-Noh (Roki)

주요 역할

  • Epic 작성 및 검수
  • 비즈니스 요구사항 정의
  • 우선순위 결정

워크플로우

graph LR
    A[Epic 아이디어] --> B[epic.md 템플릿 작성<br/>또는 AI 에이전트 사용]
    B --> C[AI 검수<br/>(직접 작성 시)]
    C --> D[Epic 개선]
    D --> E[PSM 전달]

    style A fill:#e1f5ff
    style B fill:#fff4e6
    style C fill:#fff4e6
    style D fill:#fff4e6
    style E fill:#e7f5e7
Loading

상세 프로세스

1. Epic 작성

🆕 방법 1: AI Epic 생성 에이전트 사용 (권장)

단계 소요 시간 설명
1 1분 Epic Creation Agent 가이드 참고
2 2분 ChatGPT/Claude에 프롬프트 붙여넣기
3 7-10분 AI와 대화하며 Epic 완성
4 2분 완성된 Epic을 GitHub Issue에 붙여넣기

장점:

  • ✅ 형식 걱정 없음
  • ✅ 누락 방지
  • ✅ 작성 시간 75% 단축
  • ✅ 검수 단계 생략 가능

방법 2: 직접 템플릿 작성 (기존 방식)

단계 소요 시간 설명
1 2분 command-center 레포지토리 접속
2 1분 GitHub Issues → New issue → epic.md 템플릿 선택
3 25-30분 템플릿 작성 (배경, 사용자 스토리, 완료 조건 등)
4 10분 AI 검수 (validate-epic-story-structure-conversational.md)
5 5분 개선 사항 반영

2. 필수 포함 항목

섹션 요구사항 체크포인트
배경 및 목적 왜 필요한가? [ ] 명확한 비즈니스 이유 작성
사용자 스토리 3개 이상, 체크박스 형식 [ ] 3개 이상 작성
[ ] 체크박스 형식 (- [ ])
완료 조건 체크박스 형식, 검증 가능 [ ] 검증 가능한 조건
[ ] 체크박스 형식
관련 레포지토리 최소 1개 선택 [ ] 최소 1개 체크

3. AI 검수 (직접 작성 시)

검수 도구: .github/prompts/validate-epic-story-structure-conversational.md

단계 설명
1 ChatGPT/Claude 접속
2 검수 프롬프트 붙여넣기
3 Epic 내용 붙여넣기
4 AI와 대화형 검수 진행
5 개선된 Epic으로 이슈 업데이트

체크리스트

## Epic 작성 체크리스트

### 작성 전
- [ ] 비즈니스 요구사항 명확히 이해
- [ ] 사용자 페르소나 파악
- [ ] 우선순위 판단 (P0-P4)

### 작성 중
- [ ] command-center 레포지토리에서 이슈 생성
- [ ] Epic 템플릿 사용 (epic.md) 또는 AI 에이전트 사용
- [ ] 배경 및 목적 작성
- [ ] 사용자 스토리 3개 이상 작성 (체크박스 형식)
- [ ] 완료 조건 명확히 정의 (체크박스 형식)
- [ ] 관련 레포지토리 체크박스 선택 (최소 1개)

### 작성 후
- [ ] AI 검수 완료 (직접 작성 시)
- [ ] Epic 이슈 생성
- [ ] 프로젝트 #1 자동 추가 확인
- [ ] 타입 '에픽', Status '검수대기' 자동 설정 확인
- [ ] PSM에게 검토 요청 (Slack/Discord 멘션)

문의 및 지원


👥 PSM (Product Scrum Master)

담당자

  • reus-jeon (Reus)
  • garden92 (Garden)

주요 역할

  • Epic 검토 및 Task 생성
  • Task 검수 및 할당
  • 토요일 병합 리뷰 진행

워크플로우

graph LR
    A[Epic 검토] --> B[Epic to Tasks 실행]
    B --> C[Task 검수]
    C --> D[Task 할당]
    D --> E[토요일 리뷰]
    E --> F[배포 승인]

    style A fill:#fff4e6
    style B fill:#fff4e6
    style C fill:#fff4e6
    style D fill:#e7f5e7
    style E fill:#ffe6e6
    style F fill:#e7ffe7
Loading

상세 프로세스

1. Epic 검토

검토 항목 체크포인트
사용자 스토리 [ ] 명확성
[ ] 3개 이상
[ ] 체크박스 형식
완료 조건 [ ] 구체성
[ ] 검증 가능성
관련 레포지토리 [ ] 적절성
[ ] 최소 1개 선택
기술적 타당성 [ ] 구현 가능성
[ ] 리소스 예측

검토 결과:

  • 승인: Epic to Tasks 실행
  • 거절: PO에게 피드백 전달 → 수정 후 재검토

2. Epic to Tasks 실행

실행 방법 (3가지 중 선택):

방법 트리거 설명
⭐ 방법 1 라벨 Epic 이슈에 ready-for-tasks 라벨 추가
방법 2 댓글 /generate-tasks 또는 /epic-to-tasks 댓글 작성
방법 3 Manual Actions 탭에서 실행

실행 프로세스:

  1. dry_run: true로 테스트
  2. Artifacts에서 생성 결과 확인
  3. 문제 없으면 dry_run: false로 재실행
  4. 생성된 Task 확인

3. Task 검수

검수 항목 검증 내용
완성도 [ ] Task 설명이 명확하고 실행 가능한가?
작업량 [ ] Estimate 값이 적절한가? (1-13 포인트)
우선순위 [ ] Priority 설정이 올바른가? (P0-P4)
요구사항 [ ] 테스트 요구사항이 구체적인가?
Branch 명 [ ] Feature branch 명이 명시되었는가?

검수 작업:

  • 불완전한 Task 직접 편집
  • 불필요한 Task 삭제
  • 중복 Task 병합
  • Estimate 값 재평가

검수 완료:

  • Projects Status: 검수대기검수완료
  • ready-for-dev 라벨 자동 추가 (< 1초 ~ 5분 내)

4. Task 할당

할당 기준 설명
전문성 기술 스택에 맞는 엔지니어 할당
작업량 이터레이션 당 작업량 균등 분배
우선순위 P0-P1 우선 할당

5. 토요일 병합 리뷰

리뷰 일정:

  • 매주 토요일 오전 10시
  • 최소 2일 전 공지 (Slack/Discord)

리뷰 항목:

항목 검토 내용
Dev 검증 결과 검증 완료 여부, 발견된 이슈
코드 품질 AI 리뷰 통과 여부, 추가 피드백
요구사항 충족 Task 요구사항 완전 구현 여부
테스트 커버리지 80%+ 달성 여부
배포 리스크 기존 기능 영향도, 롤백 계획
문서화 API 문서, 사용자 가이드 작성

리뷰 결과:

  • 승인: devstg 머지 → Status: 테스트중
  • 거절: 리버트 커밋 생성 → Status: 진행중 → 피드백 전달

체크리스트

## Epic 검토 및 Task 생성 체크리스트

### Epic 검토
- [ ] 사용자 스토리 명확성 확인
- [ ] 완료 조건 구체성 검토
- [ ] 관련 레포지토리 적절성 확인
- [ ] 기술적 타당성 검증
- [ ] 필요 시 PO에게 피드백

### Epic to Tasks 실행
- [ ] Epic to Tasks 실행 (3가지 방법 중 선택):
  - [ ] 방법 1: ready-for-tasks 라벨 추가 (권장)
  - [ ] 방법 2: /generate-tasks 댓글 작성
  - [ ] 방법 3: Actions 탭에서 Manual 실행
- [ ] dry_run=true로 먼저 테스트
- [ ] Artifacts에서 생성 결과 확인
- [ ] 문제 없으면 dry_run=false로 실행
- [ ] 생성된 Task 검토 (모든 체크된 레포지토리)

### Task 검수
- [ ] Task 완성도 확인
- [ ] 작업량(Estimate) 검증
- [ ] 우선순위 확인
- [ ] 요구사항 구체성 확인
- [ ] Branch 명 확인
- [ ] Task 보완/수정
- [ ] Epic에 Task 링크 자동 추가 확인
- [ ] Status: 검수대기 → 검수완료
- [ ] Task Assignee 할당

### 토요일 리뷰
- [ ] 리뷰 일정 공지 (최소 2일 전)
- [ ] 리뷰 대상 엔지니어 명단 확인
- [ ] Dev 검증 결과 확인
- [ ] 코드 품질 확인
- [ ] 요구사항 충족 확인
- [ ] 테스트 커버리지 확인 (80%+)
- [ ] 배포 리스크 평가
- [ ] 문서화 확인
- [ ] 승인/거절 결정
- [ ] 승인 시: stg 브랜치로 머지
- [ ] 거절 시: 리버트 커밋 생성 + 피드백 전달

문의 및 지원


💻 Engineer (Developer)

담당자

  • 정규직
  • 파트타이머

주요 역할

  • 할당된 Task 구현
  • 테스트 작성
  • dev 검증

워크플로우

graph LR
    A[Task 할당] --> B[Feature Branch]
    B --> C[Draft PR]
    C --> D[구현 & 테스트]
    D --> E[Ready for Review]
    E --> F{AI 리뷰}
    F -->|통과| G[dev 검증]
    F -->|거절| D
    G --> H[리뷰요청]

    style A fill:#e1f5ff
    style B fill:#fff4e6
    style C fill:#fff4e6
    style D fill:#e7f5e7
    style E fill:#fff9e6
    style F fill:#ffe6e6
    style G fill:#e7f5e7
    style H fill:#e7ffe7
Loading

상세 프로세스

1. Task 요구사항 확인

확인 항목 설명
설명 [ ] 구현할 기능의 목적 및 범위 이해
요구사항 [ ] 기능 요구사항 (체크리스트) 확인
테스트 요구사항 [ ] 테스트 시나리오 (체크리스트) 확인
완료 조건 [ ] 완료 기준 (체크리스트) 확인
Branch 명 [ ] Feature branch 네이밍 확인
Estimate [ ] 예상 작업량 (포인트) 확인

2. Feature Branch 및 Draft PR 생성

자동 생성 (선택사항):

  • ready-for-dev 라벨이 추가되면 자동 실행
  • 브랜치명: feat/issue-{번호} 자동 생성
  • Draft PR 자동 생성 (dev 브랜치로 향함)

수동 생성:

# Base 브랜치에서 시작
git checkout dev
git pull origin dev

# Feature Branch 생성
git checkout -b 123-user-login

# Draft PR 생성
gh pr create \
  --title "✨ 사용자 로그인 기능 구현" \
  --body "Closes #123" \
  --base dev \
  --draft

Status 변경: 검수완료진행중


3. 구현 및 커밋

개발 프로세스:

  1. 로컬 환경 설정
  2. 기능 구현
  3. 테스트 작성 (80%+ 커버리지)
  4. 로컬 테스트 (lint, typecheck, test)
  5. Gitmoji 커밋

Gitmoji 커밋 규칙:

Gitmoji 설명 예시
새 기능 ✨ #123: 사용자 로그인 기능 구현
🐛 버그 수정 🐛 #123: 로그인 토큰 만료 처리 버그 수정
테스트 추가 ✅ #123: 로그인 테스트 추가
♻️ 리팩토링 ♻️ #123: 로그인 로직 함수 분리

자세한 규칙: Team Codex - 커밋 메시지 규칙


4. AI 리뷰

트리거 방법 (3가지):

  1. ⭐ Draft PR → "Ready for review" 버튼 클릭 (권장)
  2. ready-for-review 라벨 추가
  3. re-review 라벨 추가 (재리뷰)

AI 리뷰 항목:

  • 코드 품질 (복잡도, 가독성)
  • 테스트 커버리지 (80%+)
  • 이슈 요구사항 충족 여부
  • 보안 취약점
  • 코딩 표준 준수

리뷰 결과:

  • 통과: 자동으로 dev 브랜치로 머지
  • 거절: 수정 필요 → 수정 후 re-review 라벨 추가

5. Dev 검증

검증 항목:

항목 확인 내용
기능 동작 [ ] 요구사항대로 동작하는가?
UI/UX [ ] 디자인이 올바르게 적용되었는가?
데이터 흐름 [ ] API 호출 및 데이터 처리가 정상인가?
에러 처리 [ ] 예외 상황에서 적절히 처리되는가?
성능 [ ] 응답 시간이 적절한가?
브라우저 호환성 [ ] Chrome, Safari, Firefox에서 동작하는가?
모바일 호환성 [ ] 모바일 기기에서 동작하는가?

검증 완료: Status: 진행중리뷰요청


체크리스트

## 개발 체크리스트

### 개발 시작
- [ ] Task 요구사항 이해
- [ ] 관련 문서 확인 (Architecture, Code Conventions)
- [ ] Feature Branch 생성 (123-feature-name)
- [ ] Draft PR 생성 (Closes #123)
- [ ] Status: 검수완료 → 진행중
- [ ] 로컬 개발 환경 설정 완료

### 구현
- [ ] 기능 구현 완료
- [ ] 테스트 작성 완료 (80%+ 커버리지)
- [ ] 로컬 lint 통과 (npm run lint)
- [ ] 로컬 typecheck 통과 (npm run type-check)
- [ ] 로컬 test 통과 (npm run test)
- [ ] Gitmoji 커밋 규칙 준수
- [ ] 이슈 번호 커밋 메시지 포함 ([#123])
- [ ] console.log 제거
- [ ] 주석 처리된 코드 제거
- [ ] 사용하지 않는 import 제거

### AI 리뷰
- [ ] Ready for Review 전환 또는 ready-for-review 라벨 추가
- [ ] AI 리뷰 진행 상태 확인
- [ ] AI 리뷰 통과 확인
  - [ ] 통과 시: dev 브랜치로 자동 머지 확인
  - [ ] 거절 시: 피드백 확인 → 수정 → re-review 라벨 추가

### Dev 검증
- [ ] dev 서버 접속 (dev.semicolon.team)
- [ ] 기능 동작 확인
- [ ] UI/UX 확인
- [ ] 데이터 흐름 확인
- [ ] 에러 처리 확인
- [ ] 성능 확인
- [ ] 브라우저 호환성 확인 (Chrome, Safari, Firefox)
- [ ] 모바일 호환성 확인 (iOS, Android)
- [ ] Console 에러 없음
- [ ] Network 요청 정상
- [ ] Status: 진행중 → 리뷰요청

### 토요일 리뷰 대비
- [ ] 리뷰 일정 확인
- [ ] 리뷰 자료 준비 (필요 시)
- [ ] 온라인 참석 계획

문의 및 지원


🧪 QA (Quality Assurance)

주요 역할

  • 스테이지 서버 테스트
  • 회귀 테스트
  • 배포 승인/거절

워크플로우

graph LR
    A[stg 배포] --> B[테스트 계획]
    B --> C[기능 테스트]
    C --> D[회귀 테스트]
    D --> E{결과}
    E -->|성공| F[승인]
    E -->|실패| G[리버트 요청]

    style A fill:#fff9e6
    style B fill:#fff4e6
    style C fill:#fff4e6
    style D fill:#fff4e6
    style E fill:#ffe6e6
    style F fill:#e7ffe7
    style G fill:#ffe6e6
Loading

상세 프로세스

1. 테스트 계획 수립

테스트 범위:

  • 신규 기능
  • 회귀 테스트 (기존 기능)

테스트 시나리오:

  • 정상 시나리오
  • 경계 조건
  • 예외 상황

테스트 환경:

  • 브라우저: Chrome 최신, Safari 최신, Firefox 최신
  • 모바일: iOS 16+, Android 12+
  • 네트워크: 정상, 느린 3G

2. 테스트 항목

항목 테스트 내용
기능 동작 모든 사용자 스토리 시나리오 테스트
회귀 테스트 기존 기능 영향도 확인
크로스 브라우저 Chrome, Safari, Firefox 테스트
모바일 테스트 iOS, Android 테스트
성능 테스트 응답 시간, 동시 접속 테스트
보안 테스트 권한, 인증, 데이터 보호 확인
접근성 테스트 키보드 네비게이션, 스크린 리더

3. 버그 발견 시

Bug 리포트 작성:

  1. command-center에 Bug 이슈 생성
  2. 긴급도, 발생 빈도, 재현 단계 명시

PSM 판단:

  • 경미한 버그: 다음 이터레이션에 수정
  • 심각한 버그: 즉시 리버트

4. 최종 승인/거절

✅ 승인:

  • 모든 테스트 통과
  • 프로덕션 배포 대기

❌ 거절:

  • 리버트 커밋 생성
  • stg에서 롤백
  • 다음 이터레이션에 재상정

체크리스트

## QA 테스트 체크리스트

### 테스트 계획
- [ ] 테스트 범위 정의
- [ ] 테스트 시나리오 작성
- [ ] 테스트 환경 구성
- [ ] 테스트 일정 수립

### 테스트 실행
- [ ] 기능 동작 확인
- [ ] 회귀 테스트 실행
- [ ] 크로스 브라우저 테스트 (Chrome, Safari, Firefox)
- [ ] 모바일 테스트 (iOS, Android)
- [ ] 성능 테스트
- [ ] 보안 테스트
- [ ] 접근성 테스트

### 버그 관리
- [ ] 버그 발견 시 Bug 리포트 작성
- [ ] 긴급도/발생 빈도 명시
- [ ] PSM에게 보고

### 최종 승인
- [ ] 최종 승인/거절 결정
- [ ] 승인 시: 프로덕션 배포 대기
- [ ] 거절 시: 리버트 요청 + 피드백 전달

문의 및 지원


🔗 관련 문서


마지막 업데이트: 2025-01-06 관리자: Semicolon Dev Team