18강. Issues, Projects, Milestones로 작업 관리

?1. 이번 강의에서 해결할 문제

코드부터 수정하면 왜 필요한 변경인지, 완료 기준이 무엇인지 잊기 쉽습니다. 구현 전에 작업을 작게 정의하고 PR과 연결합니다.

✓2. 학습 목표

✓이 강의를 마치면

• 재현 조건과 완료 기준이 있는 Issue를 작성합니다.
• Label, Assignee, Milestone의 역할을 구분합니다.
• Project 보드에서 작업 상태를 추적합니다.

◇3. 핵심 개념

Issue는 문제나 작업의 대화 단위입니다. Label은 종류·우선순위, Assignee는 담당자, Milestone은 여러 Issue의 목표 시점을 표현합니다. Projects는 여러 저장소의 Issue와 PR을 표·보드·로드맵 형태로 추적할 수 있습니다.

§4. 단계별 명령어와 예시

작업 대상: GitHub git-learning-site 저장소

GitHub 웹에서 Issues → New issue를 열고 다음 내용을 작성합니다. UI와 Projects 기능은 변경될 수 있으므로 GitHub 공식 Issues/Projects 문서를 기준으로 메뉴를 찾습니다.

Issue 본문 예시

## 문제
프로필 페이지에서 학습 목표를 찾기 어렵다.

## 완료 기준
- [ ] 학습 목표 제목이 보인다.
- [ ] 모바일에서 가로 스크롤이 없다.
- [ ] npm run build가 통과한다.

Issue 번호가 #12라면 브랜치와 커밋에 문맥을 연결합니다.

PowerShell

Set-Location C:\dev\git-learning-site
git switch main
git pull --ff-only
git switch -c issue-12-learning-goals
Add-Content README.md "`n## 다음 학습 목표"
git add README.md
git commit -m "docs: add learning goals refs #12"

PR 본문에 Closes #12를 쓰면 병합될 때 Issue가 자동으로 닫힐 수 있습니다.

→5. 명령어가 동작하는 이유

Issue 번호는 GitHub가 저장소 안의 작업을 식별하는 참조입니다. 지원되는 종료 키워드와 기본 브랜치에 병합된 PR이 연결되면 GitHub가 상태를 자동 변경합니다. Project는 이 항목의 상태 필드를 시각화합니다.

!6. 자주 하는 실수와 안전한 해결법

!자주 하는 실수

• 제목만 있는 Issue: 배경, 완료 기준, 검증 방법을 적습니다.
• 한 Issue에 여러 기능: 독립적으로 완료·검증할 수 있도록 나눕니다.
• 웹 UI 위치를 고정된 진리로 암기: 기능 이름으로 찾고 공식 문서의 최신 화면을 확인합니다.

✎7. 직접 실습

✎직접 실습

1. 버그와 문서 개선 Issue를 하나씩 작성합니다.
2. documentation, bug Label을 구분하고 하나의 Milestone에 묶습니다.
3. Project에 추가해 Todo → In progress → Done으로 옮깁니다.

?8. 이해 점검 질문 3개

?이해 점검

1. Issue의 완료 여부를 객관적으로 판단하게 하는 항목은 무엇인가요?
2. Milestone과 Project는 각각 어떤 범위를 표현하나요?
3. PR 병합 시 Issue를 자동 종료하는 본문 표현의 예는 무엇인가요?

■9. 핵심 요약

■핵심 요약

Issue로 문제와 완료 기준을 먼저 정의하고, PR과 연결해 구현 근거를 남깁니다. Label, Milestone, Project는 작업을 찾고 묶고 흐름으로 보는 서로 다른 도구입니다.