이슈 타입과 워크플로우 설정

들어가며

Jira를 쓰면서 기본 이슈 타입만 써왔는데, 팀 상황에 맞게 이슈 타입과 워크플로우를 커스터마이징하면 훨씬 효율적으로 관리할 수 있다. 설정 방법을 제대로 정리해둔다.

---

이슈 타입 (Issue Type)

기본 제공 이슈 타입

Jira에서 기본으로 제공하는 이슈 타입이다.

이슈 타입	아이콘 색	설명
Epic	보라	큰 기능 묶음
Story	초록	사용자 관점의 기능 요구사항
Task	파랑	일반 개발 작업
Bug	빨강	버그 리포트
Subtask	파랑	상위 이슈의 하위 작업

Jira 스페이스 설정 → 업무 유형 (Epic / Feature / Task / Subtask)

이슈 타입 추가/수정

팀 특성에 맞게 이슈 타입을 추가할 수 있다.

프로젝트 설정 → 업무 유형 → 업무 유형 추가

예를 들어 디자인 팀과 협업하는 경우:

Design Review  : 디자인 검토 작업
Documentation  : 문서 작성 작업
Spike          : 기술 조사/연구 작업

---

워크플로우 (Workflow)

워크플로우란?

이슈가 생성부터 완료까지 거치는 상태(Status)와 전환(Transition)의 흐름이다.

기본 워크플로우:
To Do → In Progress → Done

워크플로우 커스터마이징

팀 개발 프로세스에 맞게 상태를 추가할 수 있다.

개발팀 워크플로우 예시:
To Do → In Progress → In Review → QA → Done

백로그 포함:
Backlog → To Do → In Progress → In Review → Done

워크플로우 설정 방법

프로젝트 설정 → 보드 → 열 및 상태

Jira 보드 설정 → 열 및 상태 (IDEA / TO DO / IN PROGRESS 컬럼 관리)

상태(Status) 추가

열 및 상태 → 상태 추가 → 이름 입력
예: "In Review", "QA", "Blocked"

전환(Transition) 설정

전환은 이슈가 한 상태에서 다른 상태로 이동하는 규칙이다.

In Progress → In Review  : 개발 완료 후 리뷰 요청
In Review → In Progress  : 리뷰 피드백으로 재작업
In Review → Done         : 리뷰 승인 후 완료
In Progress → Blocked    : 블로커 발생 시

---

상태 카테고리

Jira의 모든 상태는 세 가지 카테고리 중 하나에 속한다.

카테고리	색상	설명	예시 상태
To Do	회색	아직 시작 안 됨	To Do, Backlog, Open
In Progress	파랑	진행 중	In Progress, In Review, QA
Done	초록	완료	Done, Closed, Resolved

카테고리는 번다운 차트, 스프린트 완료 등 Jira 리포트에 영향을 준다.

---

실전 워크플로우 예시

소규모 팀 (3~5명)

To Do → In Progress → Done

단순하게 유지하는 게 오히려 효율적이다.

중간 규모 팀 (코드 리뷰 있음)

To Do → In Progress → In Review → Done

코드 리뷰 + QA 있는 팀

To Do → In Progress → In Review → QA → Done
                ↑           |
                └── Rejected ┘

Blocked 상태 포함

To Do → In Progress → In Review → Done
              ↕
           Blocked

---

워크플로우 설정 시 주의사항

- 상태가 너무 많으면 관리가 복잡해진다. 5개 이하 권장
- 모든 상태는 Done 카테고리로 이어지는 경로가 있어야 한다
- 팀원 모두가 동의한 워크플로우여야 실제로 지켜진다
- 처음엔 단순하게 시작하고 필요에 따라 추가하는 게 낫다

---

정리

항목	설명
이슈 타입	Epic, Story, Task, Bug, Subtask 기본 제공
이슈 타입 추가	프로젝트 설정 → 업무 유형 → 추가
워크플로우	이슈 상태와 전환의 흐름
상태 카테고리	To Do / In Progress / Done 세 가지
워크플로우 편집	프로젝트 설정 → 보드 → 열 및 상태