mattermost-push-plugin/agent-ops/roadmap/phase/consumer-adoption/milestones/release-consumption-workflow.md

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