이슈를 효과적으로 사용하기 위한 핵심 원칙
1. 할당 원칙
- ✅ 현재 담당자에게 할당: 이슈는 현재 실제로 작업을 진행하는 사람에게 항상 할당되어야 함
- ✅ 할당 즉시 확인: 이슈가 할당되면 담당자는 즉시 확인하고 작업 시작 여부를 명시
- ❌ 빈 할당 금지: 담당자가 지정되지 않은 이슈는 방치되기 쉬움
2. 코멘트 작성 원칙
- ✅ 작업 완료 시 코멘트 필수: 작업 완료 후에는 반드시 처리 결과 코멘트 추가
- ✅ 진행 상황 공유: 중간중간 진행 상황을 코멘트로 공유 (특히 장기간 작업 시)
- ✅ 이슈 이동 시 코멘트: 상태 변경 시 (예: 진행 중 → 완료) 변경 이유 명시
- ❌ 무의미한 코멘트 금지: "확인했습니다", "진행 중" 등만 반복하지 않기
3. 상태 관리 원칙
- ✅ 실시간 상태 업데이트: 작업 현황에 따라 상태를 즉시 업데이트
- ✅ 명확한 상태 정의: 팀별로 상태 의미를 명확히 정의하고 일관되게 사용
- ❌ 방치 상태 금지: "진행 중" 상태로 장기간 방치하지 않기
4. 이슈 작성 원칙
- ✅ 명확한 제목: 무엇을 하는지 한눈에 알 수 있는 제목 사용
- ✅ 상세한 설명: 재현 절차, 예상 결과, 실제 결과를 포함한 상세 내용을 기술
- ✅ 필수 필드 작성: 우선순위, 예상 소요 시간, 컴포넌트 등 필수 필드 반드시 작성
- ❌ 불명확한 표현 금지: "문제 있음", "고쳐주세요" 등 불명확한 표현 사용하지 않기
5. 워크플로우 준수 원칙
- ✅ 정의된 워크플로우 따르기: 팀에서 정한 워크플로우를 엄격히 준수
- ✅ 리뷰 프로세스 준수: 코드 리뷰, QA 과정 등 필요한 절차 생략하지 않기
- ✅ 일관된 프로세스: 모든 팀원이 동일한 프로세스 따라 작업하기
예시: 이상적인 이슈 처리 플로우
- 이슈 생성 → 담당자 할당 + 우선순위 설정
- 작업 시작 → 상태 "진행 중" 변경 + 시작 코멘트
- 진행 중 → 중간 진행 상황 comment 작성 (필요시)
- 작업 완료 → 상태 "완료" 변경 + 상세한 처리 결과 코멘트
- 검토 필요시 → 상태 "검토 중" 변경 + 검토자 할당