GitHub Issues & Projects로 일감 관리

들어가며

Issues와 Projects를 단순히 할 일 목록 정도로만 써왔는데, 제대로 활용하면 팀 전체의 작업 흐름을 한눈에 파악할 수 있다.
기능을 제대로 정리해둔다.

---

GitHub Issues

Issue란?

버그 리포트, 기능 요청, 작업 단위를 기록하는 공간이다.
PR과 연결해서 코드 변경과 작업을 추적할 수 있다.

Issue 작성

제목: [bug] 로그인 페이지에서 새로고침 시 토큰 초기화 됨
      [feat] 소셜 로그인 구현
      [docs] README 업데이트

본문 구성 예시:

## 문제 상황
로그인 후 페이지 새로고침 시 토큰이 초기화되어 로그아웃 됨

## 재현 방법
1. 로그인
2. F5 새로고침
3. 로그아웃 상태 확인

## 예상 동작
새로고침 후에도 로그인 상태 유지

## 환경
- OS: macOS 14
- Browser: Chrome 124

Issue Template

.github/ISSUE_TEMPLATE/ 디렉토리에 템플릿 파일을 만들면 Issue 작성 시 자동으로 양식이 채워진다.

mkdir -p .github/ISSUE_TEMPLATE

# 버그 리포트 템플릿
cat > .github/ISSUE_TEMPLATE/bug_report.md << 'EOF'
---
name: Bug Report
about: 버그를 제보해주세요
labels: bug
---

## 문제 상황

## 재현 방법

## 예상 동작

## 환경
EOF

Issue 주요 기능

Assignees  : 담당자 지정
Labels     : bug, feature, documentation, help wanted 등
Milestone  : 특정 버전/스프린트에 묶기
Projects   : 프로젝트 보드에 연결

Issue와 PR 연결

PR 본문이나 커밋 메시지에 키워드를 사용하면 PR merge 시 Issue가 자동으로 닫힌다.

Closes #42
Fixes #42
Resolves #42

---

GitHub Projects

Projects란?

Issues와 PR을 칸반 보드, 테이블, 로드맵 형태로 시각화하는 프로젝트 관리 도구다.

보드 뷰 종류

뷰	설명	적합한 상황
Board	칸반 형태 (Todo / In Progress / Done)	스프린트 관리
Table	스프레드시트 형태	전체 작업 목록 관리
Roadmap	타임라인 형태	일정 계획

커스텀 필드

Projects에서 기본 필드 외에 커스텀 필드를 추가할 수 있다.

Priority    : P1 / P2 / P3
Sprint      : Sprint 1 / Sprint 2
Story Points: 1 / 2 / 3 / 5 / 8
Status      : Todo / In Progress / Review / Done

자동화

Projects에서 특정 이벤트 발생 시 자동으로 상태를 변경할 수 있다.

Item added to project  →  Status: Todo로 설정
PR opened              →  Status: In Progress로 변경
PR merged              →  Status: Done으로 변경
Issue closed           →  Status: Done으로 변경

---

실제 활용 흐름

1. Issue 생성 (기능 요청 또는 버그 리포트)
        ↓
2. Issue를 Project 보드에 추가
        ↓
3. 담당자 지정, 우선순위 설정
        ↓
4. feature 브랜치 생성 후 작업
        ↓
5. PR 생성 (본문에 Closes #이슈번호)
        ↓
6. 코드 리뷰 → merge
        ↓
7. Issue 자동 close, Project 상태 자동 Done

---

Labels 체계 잡기

기본 Labels 외에 팀에 맞는 체계를 만들어두면 필터링이 편하다.

타입    : feat, bug, docs, refactor, test, chore
우선순위 : P1, P2, P3
상태    : blocked, in-review, wont-fix
크기    : size/S, size/M, size/L

---

정리

기능	설명
Issue	버그, 기능 요청, 작업 단위 기록
Issue Template	일관된 Issue 작성 양식
Closes #번호	PR merge 시 Issue 자동 close
Projects Board	칸반 형태 작업 시각화
Projects Table	전체 작업 목록 관리
커스텀 필드	Priority, Sprint, Story Points 등
자동화	이벤트 기반 상태 자동 변경