/release-plan

/release-plan

Amaç

Bir sonraki release için plan + CHANGELOG draft + readiness raporu + tag/publish adımları üret. Sürpriz olmadan ship etmek için checklist.

Ne Zaman Kullanılır

• Tag / version cut zamanı
• Hotfix prod'a girecek (kısa form)
• Multi-service koordineli release
• Code freeze giriş/çıkış
• Sunset (eski sürüm kapatma) planı
• Feature flag aç/kapat sırası

Input

• [version] (opsiyonel, autodetect — git describe --tags --abbrev=0 + bump kararı)
• [scope] opsiyonel (mono-repo'da hangi servis)

Delege

release-manager lider — semver/CHANGELOG/readiness/tag. Alt-delege:

• architecture-decision-writer — breaking change ADR
• migration-planner — schema/infra migration
• deployment-strategist — rollout (canary/rolling/blue-green) seçimi
• runbook-author — rollback runbook
• dependency-risk-auditor — CVE/license, dep delta
• security-reviewer — yeni endpoint/permission

release-management skill'i prosedürü taşır.

Beklenen Davranış

1. rules/git-commit.md + rules/cicd.md + rules/observability.md yükle.
2. Önceki tag tespit (git describe --tags --abbrev=0).
3. Commit listesi: git log <prev>..HEAD --no-merges --format="%h %s".
4. Semver bump kararı (commit type'larına göre):
   • feat! veya BREAKING CHANGE: → major
   • feat: → minor
   • fix: / perf: → patch
5. CHANGELOG draft (Keep a Changelog formatı, kullanıcı dilinde).
6. Readiness checklist (code/doc/deploy/iletişim).
7. Multi-service ise deploy sırası + compatibility window.
8. Sunset/deprecation lifecycle (T-90/T-30/T-0).
9. Feature flag durumu inventory.
10. Rollback komutu planda yazılı (test edilmiş).
11. Tag mesajı + GitHub Release draft.
12. Kullanıcı onayı: tag push + release publish.

Yasaklar

• Tag push otomatik — kullanıcı onayı zorunlu (agents/shared/escalation-matrix.md).
• Migration + deploy aynı PR — ayrı PR, önce merge.
• Breaking change saklama — CHANGELOG'da explicit.
• latest tag prod deploy önerme (rules/cicd.md).
• Force push release sırasında — history rewrite.
• Subject == hash release notes'ta — kullanıcı dilinde etki yaz.
• Sunset duyurusu deploy ile aynı gün — 90/30/0 lifecycle.
• Feature flag default-on prod'a doğrudan — progressive rollout.

Örnek Kullanım

/release-plan                          # autodetect (next bump)
/release-plan v2.0.0                   # specific version
/release-plan --scope api-svc          # mono-repo
/release-plan --hotfix v1.3.3          # patch hotfix

Örnek Çıktı

# Release Plan: v2.0.0 (api-svc)

## Semver Kararı
- Bump: **major** (1.3.2 → 2.0.0)
- Kanıt:
  - 3 `feat!` commit (BREAKING)
  - 12 feat, 18 fix, 9 refactor
  - 47 commit / 23 PR

## Breaking Changes
- [ ] `POST /v1/orders` `total` field zorunlu yapıldı (önce optional + default)
  - Mitigation: `Sunset: 2026-11-12` header + `/v2/orders` paralel.
- [ ] OAuth scope reorganization: `read:orders` + `write:orders` (önce `orders:rw`)
  - Mitigation: SDK upgrade guide.
- [ ] `User.address` shape change (`AddressV2`)
  - Mitigation: `/v1` legacy proxy, deprecation 90 gün.

## CHANGELOG Draft
```markdown
## [2.0.0] - 2026-05-15

### Added
- Subscription order tipi (`feat(orders): add subscription strategy`)
- Cursor pagination tüm liste endpoint'lerinde
- Rate limit header RFC standartı

### Changed
- **BREAKING**: `POST /v1/orders` `total` zorunlu — eski client'lar fail
- **BREAKING**: OAuth scope `orders:rw` → `read:orders` + `write:orders`
- **BREAKING**: `User.address` shape → `AddressV2`
- `OrderProcessor` refactor: cyclomatic 38 → 6 (StrategyPattern)

### Fixed
- Race condition idempotency cache (concurrent retry duplicate charge)
- Memory leak `WebsocketHub` reconnect senaryosunda

### Deprecated
- `/v1/*` endpoint'leri → `Sunset: 2026-11-12`
- `User.address` (string) → `User.address_v2`

### Security
- CVE-2026-XXXX `requests` 2.32.0 → 2.33.1 (response splitting)

Readiness Checklist

Code

• CI yeşil (5 son run)
• Coverage %72 → %74
• Test paketi ana iş kolu yeşil
• Benchmark sapma -%3 (iyileşme)
• gitleaks/trivy/grype clean
• Dependency audit clean

Doc

• CHANGELOG güncel
• README breaking change yansıyor
• Migration guide (docs/migration/v1-to-v2.md)
• OpenAPI v2 yayında
• Runbook v2 alert eşikleri güncel

Deploy

• Migration PR'ları merge edildi (3 adet, sırasıyla)
• Feature flag subscription_orders default off
• Canary stratejisi (5/25/50/100, abort eşik %1 fail)
• Health probe + readiness gate
• Rollback komutu test edildi (drill 2026-05-08)

İletişim

• Release notes Slack #engineering (T-1 gün)
• Customer breaking change email (T-30 gün — geçti, T-0 reminder)
• Status page güncel

Multi-Service Koordinasyon

• Deploy sırası: migration-svc → api-svc v2.0.0 → checkout-svc v1.7.0 → frontend v3.4.0.
• Compatibility window: 6 ay (v1 API paralel).
• Cross-service feature flag: subscription_orders (api + checkout + frontend).

Rollback Planı

# api-svc rollback (helm)
helm rollback api-svc 0 -n production
kubectl -n production rollout status deploy/api-svc

# DB migration: irreversible — restore from backup gerekli
# Mitigation: migration backward compatible (schema add, drop sonra)

# Frontend: önceki SHA ile rebuild + deploy
helm upgrade frontend charts/frontend --set image.tag=<prev-sha>

Sunset

• v1 API → Sunset: 2026-11-12 (T+180 gün).
• Header her response'a: Sunset: Wed, 12 Nov 2026 00:00:00 GMT.
• Deprecation log + customer notification 30 günlük interval.

Tag + Release

git tag -a v2.0.0 -m "Release v2.0.0

Major release with breaking API changes, subscription orders,
cursor pagination, and OAuth scope reorganization. v1 API
sunset 2026-11-12.

See CHANGELOG.md for details."

# Onay sonrası:
git push origin v2.0.0
gh release create v2.0.0 \
  --title "v2.0.0 — Subscription orders + breaking API" \
  --notes-file release-notes-v2.0.0.md \
  --target main

⚠ Kullanıcı onayı zorunlu: tag push + GitHub Release publish.