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
📋 목차
👤 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
상세 프로세스
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 멘션)
문의 및 지원
- Epic 작성 가이드: Process-Phase-1-Epic-Creation
- AI Epic 생성 에이전트: Epic-Creation-Agent
-
Slack 채널:
#epic-support
👥 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
상세 프로세스
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 탭에서 실행 |
실행 프로세스:
-
dry_run: true로 테스트 - Artifacts에서 생성 결과 확인
- 문제 없으면
dry_run: false로 재실행 - 생성된 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 문서, 사용자 가이드 작성 |
리뷰 결과:
- ✅ 승인:
dev→stg머지 → 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 브랜치로 머지 - [ ] 거절 시: 리버트 커밋 생성 + 피드백 전달
문의 및 지원
- Epic to Tasks 가이드: Process-Phase-2-Task-Creation
- Epic to Tasks 자동화: Epic-To-Tasks-Automation
-
Slack 채널:
#psm-support
💻 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
상세 프로세스
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. 구현 및 커밋
개발 프로세스:
- 로컬 환경 설정
- 기능 구현
- 테스트 작성 (80%+ 커버리지)
- 로컬 테스트 (lint, typecheck, test)
- Gitmoji 커밋
Gitmoji 커밋 규칙:
| Gitmoji | 설명 | 예시 |
|---|---|---|
| ✨ | 새 기능 | ✨ #123: 사용자 로그인 기능 구현 |
| 🐛 | 버그 수정 | 🐛 #123: 로그인 토큰 만료 처리 버그 수정 |
| ✅ | 테스트 추가 | ✅ #123: 로그인 테스트 추가 |
| ♻️ | 리팩토링 | ♻️ #123: 로그인 로직 함수 분리 |
자세한 규칙: Team Codex - 커밋 메시지 규칙
4. AI 리뷰
트리거 방법 (3가지):
- ⭐ Draft PR → "Ready for review" 버튼 클릭 (권장)
-
ready-for-review라벨 추가 -
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: 진행중 → 리뷰요청 ### 토요일 리뷰 대비 - [ ] 리뷰 일정 확인 - [ ] 리뷰 자료 준비 (필요 시) - [ ] 온라인 참석 계획
문의 및 지원
- 개발 가이드: Process-Phase-3-Development
- 코드 컨벤션: Dev-Conventions-Code
- 테스트 규칙: Dev-Conventions-Testing
-
Slack 채널:
#dev-support
🧪 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
상세 프로세스
1. 테스트 계획 수립
테스트 범위:
- 신규 기능
- 회귀 테스트 (기존 기능)
테스트 시나리오:
- 정상 시나리오
- 경계 조건
- 예외 상황
테스트 환경:
- 브라우저: Chrome 최신, Safari 최신, Firefox 최신
- 모바일: iOS 16+, Android 12+
- 네트워크: 정상, 느린 3G
2. 테스트 항목
| 항목 | 테스트 내용 |
|---|---|
| 기능 동작 | 모든 사용자 스토리 시나리오 테스트 |
| 회귀 테스트 | 기존 기능 영향도 확인 |
| 크로스 브라우저 | Chrome, Safari, Firefox 테스트 |
| 모바일 테스트 | iOS, Android 테스트 |
| 성능 테스트 | 응답 시간, 동시 접속 테스트 |
| 보안 테스트 | 권한, 인증, 데이터 보호 확인 |
| 접근성 테스트 | 키보드 네비게이션, 스크린 리더 |
3. 버그 발견 시
Bug 리포트 작성:
- command-center에 Bug 이슈 생성
- 긴급도, 발생 빈도, 재현 단계 명시
PSM 판단:
- 경미한 버그: 다음 이터레이션에 수정
- 심각한 버그: 즉시 리버트
4. 최종 승인/거절
✅ 승인:
- 모든 테스트 통과
- 프로덕션 배포 대기
❌ 거절:
- 리버트 커밋 생성
- stg에서 롤백
- 다음 이터레이션에 재상정
체크리스트
## QA 테스트 체크리스트 ### 테스트 계획 - [ ] 테스트 범위 정의 - [ ] 테스트 시나리오 작성 - [ ] 테스트 환경 구성 - [ ] 테스트 일정 수립 ### 테스트 실행 - [ ] 기능 동작 확인 - [ ] 회귀 테스트 실행 - [ ] 크로스 브라우저 테스트 (Chrome, Safari, Firefox) - [ ] 모바일 테스트 (iOS, Android) - [ ] 성능 테스트 - [ ] 보안 테스트 - [ ] 접근성 테스트 ### 버그 관리 - [ ] 버그 발견 시 Bug 리포트 작성 - [ ] 긴급도/발생 빈도 명시 - [ ] PSM에게 보고 ### 최종 승인 - [ ] 최종 승인/거절 결정 - [ ] 승인 시: 프로덕션 배포 대기 - [ ] 거절 시: 리버트 요청 + 피드백 전달
문의 및 지원
- QA 가이드: Process-Phase-4-Deployment
- 테스트 규칙: Dev-Conventions-Testing
-
Slack 채널:
#qa-support
🔗 관련 문서
- Collaboration-Process: 전체 협업 프로세스
- Process-Phase-1-Epic-Creation: Epic/Bug 작성
- Process-Phase-2-Task-Creation: Task 생성 및 검수
- Process-Phase-3-Development: 개발 및 AI 리뷰
- Process-Phase-4-Deployment: Dev 검증 및 배포
마지막 업데이트: 2025-01-06 관리자: Semicolon Dev Team