이슈와 프로젝트 관리 — 이슈·라벨·마일스톤·이슈 닫기 키워드

이슈(issue)는 버그와 할 일을 기록하는 단위이고, 라벨·담당자·마일스톤은 이슈를 분류하고 묶는 도구입니다. 커밋과 PR 에 이슈 번호를 남기면 "왜 이 코드가 바뀌었는지" 가 영구히 연결됩니다.

1. 왜 배우는가

버그를 발견하고 바로 코드를 고치면 그 순간은 편하지만, 왜 고쳤는지 기록이 남지 않습니다. 이슈로 먼저 남기면 재현 방법과 논의 과정이 저장소에 함께 보관됩니다. 나중에 같은 문제가 재발해도 과거 이슈를 검색해 원인을 바로 찾습니다.

팀이 커지면 "지금 누가 무엇을 하고 있는지" 를 파악하기 어려워집니다. 라벨·담당자·마일스톤·프로젝트 보드는 이 상태를 화면 하나로 보여주는 GitHub 의 기능입니다. 커밋 메시지에 이슈 번호를 남기는 습관만으로 이 전체 흐름이 자동으로 연결됩니다.

이 레슨은 이슈 작성법과 템플릿, 이슈 번호를 브랜치·커밋에 연동하는 규칙, PR 이 이슈를 자동으로 닫는 키워드, 릴리스 노트를 커밋 이력에서 뽑아내는 방법을 다룹니다.