IT관련

🚀 GitHub Issue 관리: Create Sub-issue vs Add Existing Issue

파란하늘999 2026. 2. 24. 13:28

GitHub의 상위 이슈(Parent Issue) 화면에서는 업무를 세분화하기 위해 두 가지 방식을 제공합니다.

 

이 기능들은 주로 거대한 작업 단위인 **'에픽(Epic)'**을 관리할 때 유용합니다.

1. Create Sub-issue (새 하위 이슈 생성)

이 방식은 현재 보고 있는 상위 이슈 내에서 새로운 할 일이 생겼을 때 사용합니다.

  • 사용 상황: 프로젝트를 쪼개다 보니 새로 처리해야 할 구체적인 작업이 식별되었을 때.
  • 특징: * 상위 이슈 페이지에서 즉시 제목만 입력하여 생성 가능합니다.
    • 생성과 동시에 현재 이슈가 'Parent'로 자동 지정됩니다.
    • 번거롭게 이슈 번호를 외우거나 검색할 필요가 없어 워크플로우가 끊기지 않습니다.

2. Add Existing Issue (기존 이슈 추가)

이미 만들어진 이슈를 현재 이슈의 하위 항목으로 연결하고 싶을 때 사용합니다.

  • 사용 상황: 개별적으로 생성했던 이슈들이 알고 보니 하나의 큰 목표(상위 이슈) 아래에 포함되어야 할 때.
  • 특징:
    • #이슈번호 또는 이슈 제목을 검색하여 선택합니다.
    • 기존에 논의되던 기록과 담당자, 라벨이 그대로 유지된 채 상위 이슈 아래로 귀속됩니다.
    • 이미 진행 중인 작업들을 하나의 그룹으로 묶어 진행률(Progress)을 파악하기 좋습니다.

💡 한눈에 비교하는 요약 테이블

구분 Create Sub-issue Add Existing Issue
핵심 목적 새로운 세부 작업 생성 기존 작업의 그룹화
입력 사항 새로운 이슈 제목 기존 이슈 번호 또는 제목 검색
연결 시점 생성과 동시에 연결 선택 시점에 연결
추천 상황 기획 단계에서 업무 분할 시 흩어진 업무를 통합 관리할 시
반응형