# 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 정책