GitHub Milestone 상세 템플릿

 

 

 

GITHUB MILESTONE TEMPLATE

Project Management

GitHub 마일스톤 관리 가이드: 설계부터 회고까지

포스트 요약: 프로젝트의 가시성을 높이고 목표 달성률을 극대화하는 GitHub Milestone 표준 템플릿을 공유합니다. 기본 정보부터 사후 회고까지 프로젝트 매니지먼트의 전 과정을 담았습니다.

#GitHub #Milestone #Agile #DevOps

마일스톤 설계 가이드라인

성공적인 마일스톤은 구체적인 완료 기준(Definition of Done)과 검증 가능한 산출물을 포함해야 합니다. 아래 템플릿은 깃허브 Issue 본문에 그대로 복사하여 사용할 수 있도록 최적화되었습니다.

GitHub Milestone 상세 템플릿

📋 Milestone Full Template (Markdown)

 

 

 

# 🧭 Milestone — <마일스톤명>
> 예: M1. 음성 민원 접수 파이프라인 구축  
> 예: M2. AI(STT + RAG) 자동 분류 안정화

---

## 0️⃣ 기본 정보 (Basic Info)
- **마일스톤 ID:** - **마일스톤 명:** - **기간:** - 시작일: 
  - 종료일: 
- **담당자(Owner):** - **관련 프로젝트:** - **상태:** - [ ] Planned
  - [ ] In Progress
  - [ ] Blocked
  - [ ] Completed
  - [ ] Deferred

---

## 1️⃣ 마일스톤 목표 (Objective)
### 핵심 목표 (One-liner)
- 이 마일스톤이 **끝났을 때 달성되어야 하는 상태**

### 비즈니스 / 프로젝트 관점 목표
- 왜 이 단계가 필요한가
- 상위 목표와의 연결 관계

---

## 2️⃣ 범위 정의 (Scope)
### 포함 범위 (In Scope)
- 이번 마일스톤에서 반드시 완료해야 하는 작업
- 기능 / 시스템 / 문서

### 제외 범위 (Out of Scope)
- 이번 단계에서는 다루지 않는 것
- 다음 마일스톤으로 미루는 항목

---

## 3️⃣ 주요 산출물 (Deliverables)
| 구분 | 산출물 | 설명 |
|---|---|---|
| Code | | |
| API | | |
| Document | | |
| Infra | | |

> ✅ 산출물은 **실제 존재해야 하며 검증 가능해야 함**

---

## 4️⃣ 작업 분해 (Work Breakdown)
### 핵심 작업 목록
- [ ] Task 1: 
- [ ] Task 2: 
- [ ] Task 3: 

### 연관 Issue / PR
- Issue: 
- PR: 

---

## 5️⃣ 일정 및 의존성 (Schedule & Dependency)
### 주요 일정
- 설계 완료: 
- 구현 완료: 
- 테스트 완료: 
- 리뷰/정리: 

### 의존성
- 선행 조건: 
- 외부 의존 요소: 

---

## 6️⃣ 완료 기준 (Definition of Done)
> 이 조건을 **모두 만족해야 마일스톤 완료**

- [ ] 기능 정상 동작
- [ ] 테스트 통과
- [ ] 문서 작성 완료
- [ ] 코드 리뷰 완료
- [ ] 배포 가능 상태

---

## 7️⃣ 리스크 및 대응 전략 (Risk & Mitigation)
| 리스크 | 영향도 | 대응 방안 |
|---|---|---|
| | | |

---

## 8️⃣ 검증 및 테스트 전략 (Validation)
### 테스트 범위
- 단위 테스트: 
- 통합 테스트: 
- 수동 테스트: 

### 검증 방법
- 어떤 기준으로 “완료”를 판단하는가

---

## 9️⃣ 운영 및 배포 영향 (Operation Impact)
- **배포 필요 여부:** - [ ] 필요
  - [ ] 불필요
- **운영 영향:** - [ ] 없음
  - [ ] 있음 (상세)

---

## 🔟 회고 및 결과 (Retrospective)
> 완료 후 작성

### 잘 된 점
- 

### 개선할 점
- 

### 다음 마일스톤에 반영할 사항
- 

---

## 🔗 관련 링크
- 관련 문서: 
- 관련 Issue: 
- 관련 PR: 

Last Updated: 2026. 03. 17

TOP