85 lines
2.8 KiB
Markdown
85 lines
2.8 KiB
Markdown
# Milestone: 릴리스와 소비 방식 정리
|
|
|
|
## 위치
|
|
|
|
- Roadmap: `agent-ops/roadmap/ROADMAP.md`
|
|
- Phase: `agent-ops/roadmap/phase/consumer-adoption/PHASE.md`
|
|
|
|
## 목표
|
|
|
|
여러 소비 프로젝트가 같은 플러그인을 안정적으로 가져다 쓰고 업그레이드할 수 있게 한다. versioning, changelog, dependency pinning, release validation 기준을 정한다.
|
|
|
|
## 상태
|
|
|
|
[계획]
|
|
|
|
## 구현 잠금
|
|
|
|
- 상태: 잠금
|
|
- 결정 필요: 아래 체크리스트
|
|
- [ ] 배포 방식을 private Git dependency, private pub registry, mono workspace 중 무엇으로 운영할지 결정한다
|
|
- [ ] versioning 정책을 SemVer 기반으로 둘지 내부 release tag 기준으로 둘지 결정한다
|
|
|
|
## 범위
|
|
|
|
- 소비 프로젝트 dependency 지정 방식 정리
|
|
- version/tag/changelog 기준 정의
|
|
- breaking change 기준과 migration note 작성 규칙 정의
|
|
- release 전 필수 검증 체크리스트 정의
|
|
|
|
## 필수 기능
|
|
|
|
### Epic: [versioning] 버전 정책
|
|
|
|
소비 프로젝트가 어떤 단위를 pin해야 하는지 정한다.
|
|
|
|
- [ ] [semver] version bump 기준을 정리한다
|
|
- [ ] [tags] release tag naming 기준을 정리한다
|
|
- [ ] [breaking] breaking change 판정 기준을 정리한다
|
|
|
|
### Epic: [release] 릴리스 검증
|
|
|
|
릴리스 전에 통과해야 하는 검증 단계를 정의한다.
|
|
|
|
- [ ] [checklist] release validation checklist를 만든다
|
|
- [ ] [changelog] CHANGELOG 작성 기준을 정리한다
|
|
- [ ] [consumer-smoke] 대표 소비 프로젝트에서 확인할 최소 smoke 범위를 정리한다
|
|
|
|
### Epic: [consumption] 소비 방식
|
|
|
|
여러 프로젝트가 같은 artifact를 안정적으로 참조하게 한다.
|
|
|
|
- [ ] [dependency] Git 또는 registry dependency 예시를 문서화한다
|
|
- [ ] [pinning] branch, tag, commit pinning 권장 기준을 정리한다
|
|
- [ ] [upgrade] 업그레이드 절차와 rollback 기준을 정리한다
|
|
|
|
## 완료 기준
|
|
|
|
- [ ] 소비 프로젝트가 어떤 dependency source와 version을 사용할지 결정되어 있다
|
|
- [ ] 릴리스 전 필수 검증 기준이 문서화되어 있다
|
|
- [ ] breaking change와 migration note 기준이 있다
|
|
- [ ] `CHANGELOG.md` 운영 방식이 정해져 있다
|
|
|
|
## 완료 리뷰
|
|
|
|
- 상태: 없음
|
|
- 요청일: 없음
|
|
- 완료 근거: 없음
|
|
- 리뷰 필요:
|
|
- [ ] 사용자가 완료 결과를 확인했다
|
|
- [ ] archive 이동을 승인했다
|
|
- 리뷰 코멘트: 없음
|
|
|
|
## 범위 제외
|
|
|
|
- 실제 private registry 인프라 구축
|
|
- 소비 프로젝트 전체 migration 수행
|
|
- 자동 배포 secret 구성
|
|
|
|
## 작업 컨텍스트
|
|
|
|
- 관련 경로: `pubspec.yaml`, `CHANGELOG.md`, `README.md`, `.github/**`
|
|
- 표준선(선택): 배포 채널이 결정되기 전에는 Git tag와 changelog 중심의 보수적 운영을 가정한다
|
|
- 선행 작업: 통합 계약 문서화
|
|
- 후속 작업: 플랫폼 확장 판단
|
|
- 확인 필요: 배포 방식, versioning 정책
|