kortext 3.0.0 → 3.1.0

package/workflows/06-deployment-cycle.md

@@ -1,224 +0,0 @@
-# Deployment Cycle (`!deploy prod`)
-
-Bu akış, onaylı değişiklikleri staging ve production ortamlarına güvenli şekilde taşır.
-
-## Girdi ve Çıkış
-
-- **Başlangıç koşulu:** Release kapsamındaki item'lar tamamlanmış, test kayıtları hazır ve +prime production onayı alınmış olmalıdır.
-- **Girdi:** Test, security, delivery ve release kanıtları.
-- **Çıkış:** Deployment kaydı, release notes, izleme sonucu ve gerekirse rollback tetikleyicisi.
-- **Sonraki akış:** Başarılıysa kapanış; hata varsa `07-rollback-pipeline.md`.
-
-## Otomasyon Çağrıları
-
-> [!TIP] Bu tablo workflow adımlarının hangi script/hook'a bağlandığını gösterir. Tek-kaynak referans: `../settings/INTEGRATION-MAP.md`.
-
-| Adım | Tetikleyici Persona | Script / Hook | Beklenen Çıktı |
-|---|---|---|---|
-| Release Go onayı | +delivery-manager | `!approve` (manuel) | +prime onayı kaydı |
-| Pre-Deployment kontrol | +devops-engineer | `scripts/kortext-consistency-check.py` (release readiness) | Tutarsızlık raporu (yoksa exit 0) |
-| Staging deploy tetik | (CI/CD) | `development` branch push (otomatik) | Staging artifact + release candidate tag |
-| Staging fail | +qa-engineer | (deployment durdur, rapor `../workspace/reports/test-reports.md`) | Süreç durur, +prime'a `DEPLOYMENT DURDU` bildirimi |
-| Production deploy | +devops-engineer | `git tag -a v[A.B.C] -m "release: v[A.B.C]"` + proje-spesifik deploy komutları | Live production, semantik tag |
-| Production deploy hook | (otomatik) | `hooks/git-pre-push.sh` (branch-guard) | Main/master push kontrolü |
-| Post-deploy fail (metric eşik aşımı) | +devops-engineer | `!trigger-rollback` → `workflows/07-rollback-pipeline.md` | Rollback workflow başlar |
-| Post-deploy success | +devops-engineer | (rapor `../workspace/reports/delivery-reports.md` + `release-notes.md`) | Deployment kapanış raporları |
-| Item Done geçişi | +devops-engineer | `scripts/kortext-handover.py` → `scripts/kortext-item-transition.py --to Done` → `scripts/kortext-backlog-sync.py` | Item kapanış zinciri, otomatik git commit |
-
-> [!TIP] Bu akış `../rules/branching.md` ve `05-test-cycle.md` ile entegre çalışır. Her aşamada elde edilen onaylar atlanmadan sırayla tamamlanmalıdır.
-
-## Release Kararı (Go / No-Go)
-
-**Sorumlu:** +delivery-manager
-1. Deployment başlatılmadan önce +delivery-manager ilgili ajanlardan release readiness onayı alır:
-
-| Kontrol | Sorumlu | Kaynak |
-|---|---|---|
-| Test coverage %80+ ve kritik bug yok | +qa-engineer | `../workspace/reports/test-reports.md` |
-| Güvenlik açığı yok | +security-engineer | `../workspace/reports/security-reports.md` |
-| API dokümantasyonu güncel | +engineering-manager | `../workspace/references/api-reference.md` |
-| Branch temiz, conflict yok | +devops-engineer | Git log |
-| Production environment hazır | +devops-engineer | `../workspace/references/access.md` |
-| DB migration'ları hazırlanmış ve test edilmiş | +db-admin | — |
-| Rollback planı belirlenmiş | +devops-engineer | `../workspace/reports/delivery-reports.md` |
-
-> [!WARNING]
-> **Hepsinden yeşil ışık geldiyse → Go.** Herhangi bir kriter geçemediyse → No-Go, sorun çözülene kadar deployment ertelenir.
-> **+prime onayı zorunludur.** +delivery-manager Go kararını `!approve` ile +prime'a sunar; onay gelmeden Pre-Deployment Hazırlığı'na geçilmez.
-
-### Ara Bildirim
-
-> [!NOTE] RELEASE ONAYI BEKLENİYOR
-> +prime, 
-> `[project-name]` için production release hazırlığı tamamlandı.
-> Go/No-Go özeti `../workspace/reports/delivery-reports.md` içinde.
-> Production deployment için onayını bekliyorum.
-
-## Pre-Deployment Hazırlığı
-
-**Sorumlu:** +devops-engineer
-
-### Ortam Değişkenleri Kontrolü
-
-1. +devops-engineer `.env.example` içindeki gerekli production key listesini çıkarır.
-2. Ajanlar `.env.production` veya gerçek secret değerlerini okumaz, yazmaz ve raporlamaz.
-3. Eksik görünen yapılandırma varsa yalnızca key adı raporlanır; değer istenmez.
-4. `../workspace/references/access.md` üzerindeki servis URL'lerinin production değerleri kontrol edilir.
-5. +prime veya insan operator production environment'ın hazır olduğunu onaylar.
-6. Production environment onayı gelmeden deployment devam etmez.
-
-### Veritabanı Migration Hazırlığı
-
-> [!TIP] 
-> Bu adım migration içermeyen deployment'larda atlanır.
-> Migration sırasında veri kaybı riski varsa → +prime onayı zorunludur, devam etme.
-
-**Sorumlu:** +db-admin
-1. Migration dosyalarının ileri alma ve geri alma yolunu içerdiğini doğrula.
-2. Staging ortamında migration'ı çalıştır; başarıyla tamamlandığını ve geri alınabilir olduğunu test et.
-3. Production veritabanı için snapshot/dump alınacağını doğrula.
-4. Yedeğin erişilebilir bir konumda saklandığını doğrula.
-5. Migration ve backup sonucu `../workspace/reports/delivery-reports.md` dosyasına yazılır.
-
-### Artifact Hazırlığı
-
-**Sorumlu:** +devops-engineer
-
-1. Son kararlı artifact/image rollback referansı olarak işaretlenir.
-2. Production artifact/image release versiyonu ile hazırlanır.
-3. Artifact bilgisi, registry/path, versiyon ve rollback referansı `../workspace/reports/delivery-reports.md` dosyasına yazılır.
-4. Gerçek build/publish komutları proje dokümantasyonu veya CI/CD yapılandırmasından alınır; bu workflow içine genel komut kopyalanmaz.
-
-## Staging Doğrulaması
-
-> [!TIP] **Tetikleyici:** `development` branch'ine yapılan merge'ler.  
-
-**Sorumlu:** +devops-engineer ve +qa-engineer
-1. CI/CD pipeline otomatik olarak `development` branch'ini Staging ortamına deploy eder.
-2. Artifact veya image build edilir ve release candidate olarak işaretlenir. Örn: `v1.0.0-rc1`.
-3. +qa-engineer'a Staging ortamının hazır olduğu bildirilir.
-4. +qa-engineer Staging doğrulamasını `05-test-cycle.md` standardına göre yürütür.
-5. Smoke, E2E, migration ve manuel QA sonuçları `../workspace/reports/test-reports.md` dosyasına yazılır.
-6. Staging sonucu `PASS` olmadan Production Deployment aşamasına geçilmez.
-
-## Production Deployment
-
-> [!TIP] **Tetikleyici:** +prime onayı sonrası `main` branch'e alınan release değişikliğiyle başlar. Semantik tag başarılı production doğrulamasından sonra oluşturulur.  
-> **Onay:** +prime onayı Release Kararı aşamasında alınmış olmalıdır.
-
-### DB Migration (Varsa)
-
-- Migration proje dokümantasyonu veya CI/CD yapılandırmasındaki production migration komutu ile uygulanır.
-- Migration başarısız olursa → Rollback Senaryosu'na geç, deploy durdur.
-- Migration başarılıysa → sonraki adıma geç.
-
-### Traffic Geçişi
-
-Proje altyapısına göre tek deployment stratejisi seçilir ve `../workspace/reports/delivery-reports.md` içine yazılır.
-
-| Strateji | Ne zaman kullanılır? | Rollback beklentisi |
-|---|---|---|
-| Blue/Green | Kesintisiz geçiş ve hızlı geri dönüş gerekiyorsa | Eski ortam hazır tutulur |
-| Rolling Update | Orkestrasyon altyapısı varsa | Platform rollback mekanizması kullanılır |
-| VM / Compose | Basit veya tek sunuculu altyapı varsa | Önceki artifact/image geri alınır |
-
-+devops-engineer seçilen stratejiye göre proje-spesifik deploy komutlarını uygular. Komutlar bu workflow içinde genellenmez; gerçek komutlar proje dokümantasyonu, CI/CD yapılandırması veya `../workspace/reports/delivery-reports.md` içinde tutulur.
-
-### Post-Deploy Smoke Test (Production)
-
-**Sorumlu:** +qa-engineer
-Deploy tamamlandıktan hemen sonra production üzerinde doğrulama yapılır:
-
-- [ ] Ana sayfa ve kritik sayfalar yükleniyor
-- [ ] Kullanıcı login/logout akışı çalışıyor
-- [ ] Veri okuma işlemleri (liste, detay) başarılı
-- [ ] Veri yazma işlemleri (form submit, kayıt oluşturma) başarılı
-- [ ] Ödeme veya kritik iş akışı çalışıyor (varsa)
-- [ ] API endpoint'leri 200 dönüyor (etkilenen modüller)
-- [ ] DB migration başarıyla uygulandı ve veriler tutarlı
-- [ ] Hata oranı (5xx) beklenen seviyelerde
-
-## Post-Deploy İzleme
-
-**Sorumlu:** +devops-engineer
-
-Deployment sonrası **minimum 15 dakika** monitoring dashboard'ları izlenir:
-
-| Metrik | Eşik | Aksiyon |
-|---|---|---|
-| Hata oranı (5xx) | Deployment öncesine göre +%5'in üzeri | Rollback Senaryosu |
-| Response time (p95) | 2 katına çıkma veya SLA aşımı | Rollback Senaryosu |
-| Kritik iş akışı hataları | Herhangi bir hata | Rollback Senaryosu |
-| Otomatik monitoring alarmı | Alert tetiklenmesi | Rollback Senaryosu |
-
-15 dakika sorunsuz geçerse deployment başarılı kabul edilir.
-
-## Rollback Senaryosu
-
-Deployment sonrası yukarıdaki eşiklerden herhangi biri aşılırsa +devops-engineer derhal `07-rollback-pipeline.md` akışını başlatır.
-
-> [!TIP] **P0 durumunda** +devops-engineer +prime onayını beklemeksizin rollback'i başlatabilir; onay eş zamanlı alınır.
-
-##  Post-Deployment Görevleri
-
-**Tetikleyici:** Post-Deploy İzleme süresi sorunsuz tamamlandı.
-
-### Release Tag
-
-**Sorumlu:** +devops-engineer
-
-Production deployment ve post-deploy izleme başarıyla tamamlandıktan sonra semantik versiyon tag'i oluşturulur.
-
-```bash
-git tag -a v[A.B.C] -m "release: v[A.B.C]"
-git push origin v[A.B.C]
-```
-
-### SEO ve Analytics
-
-**Sorumlu:** +growth-expert
-- `sitemap.xml` güncellenip search engine'e gönderilir (Google Search Console).
-- `robots.txt` production ortamı için doğrulanır.
-- Analytics ve tag manager yapılandırmasının aktif olduğu kontrol edilir.
-
-### Raporlama
-
-| Dosya | Sorumlu | İçerik |
-|---|---|---|
-| `../workspace/reports/delivery-reports.md` | +devops-engineer | Build info, image tag, deploy zamanı, ortam, migration durumu |
-| `../workspace/reports/release-notes.md` | +delivery-manager | Kullanıcıya yönelik yeni özellikler, bug düzeltmeleri, breaking changes |
-| `../workspace/memory/context/[agent-name]-active.md` | +devops-engineer | Aktif deployment kaydı kapatılır |
-
-## Bildirim
-
-Duruma göre yalnızca ilgili bildirimi gönder.
-
-> [!NOTE] RELEASE ONAYI BEKLENİYOR
-> +prime,
-> `[project-name]` v[A.B.C] production deployment için hazır.
-> Go/No-Go özeti: `../workspace/reports/delivery-reports.md`
-> Sürüm notları: `../workspace/reports/release-notes.md`
-> Onayını bekliyorum.
-
-> [!NOTE] DEPLOYMENT TAMAMLANDI
-> +prime,
-> `[project-name]` v[A.B.C] canlıya deploy edildi.
-> Strateji: [Blue/Green / Rolling / VM-Compose]
-> DB Migration: [Uygulandı / Uygulanmadı]
-> Post-Deploy İzleme: [süre] sorunsuz geçti.
-> Detaylar: `../workspace/reports/delivery-reports.md`
-> Sürüm notları: `../workspace/reports/release-notes.md`
-
-> [!NOTE] DEPLOYMENT DURDU
-> +prime,
-> `[project-name]` v[A.B.C] deployment süreci durduruldu.
-> Sebep: [No-Go / Staging fail / Environment eksik / Migration riski / Diğer]
-> Detaylar: `../workspace/reports/delivery-reports.md`
-> Komutunu bekliyorum.
-
-> [!NOTE] ROLLBACK BAŞLADI
-> +prime,
-> `[project-name]` v[A.B.C] için rollback başlatıldı.
-> Sebep: [kısa sebep]
-> Akış: `07-rollback-pipeline.md`
-> Detaylar: `../workspace/reports/delivery-reports.md`

package/workflows/07-rollback-pipeline.md

@@ -1,203 +0,0 @@
-# Rollback Pipeline
-
-Bu akış, production deployment sonrası kritik hata tespit edildiğinde sistemi son kararlı sürüme güvenli şekilde döndürmek için kullanılır.
-
-## Girdi ve Çıkış
-
-- **Başlangıç koşulu:** Production sonrası kritik eşiklerden en az biri aşılmış olmalıdır.
-- **Girdi:** Delivery kayıtları, monitoring sinyalleri, smoke test sonucu ve son kararlı artifact bilgisi.
-- **Çıkış:** Güvenli geri dönüş, blocked release kaydı, learned kaydı ve ilgili Bug item.
-- **Sonraki akış:** Sorun sürüyorsa `08-hotfix-pipeline.md`; kalıcı düzeltme gerekiyorsa `04-development-cycle.md`.
-
-**Sorumlu:** +devops-engineer teknik yürütmeden, +operation-manager kriz koordinasyonundan sorumludur.
-
-## Rollback Kararı
-
-+devops-engineer aşağıdaki eşiklerden biri aşıldığında rollback kararını başlatır:
-
-| Tetikleyici | Eşik |
-|---|---|
-| Hata oranı (5xx) | Deployment öncesine göre %5'in üzerine çıktı |
-| Response time (p95) | 2 katına çıktı veya SLA limitini aştı |
-| Kritik iş akışı | Login, ödeme veya veri kaydı tamamen bozuldu |
-| Monitoring alarmı | Deployment sonrası otomatik alert tetiklendi |
-| Post-deploy smoke test | Herhangi bir kritik test başarısız oldu |
-
-**Karar yetki sırası:** +devops-engineer -> +operation-manager -> +prime
-
-P0 durumda +devops-engineer +prime onayını beklemeksizin rollback'i başlatabilir; +prime onayı eş zamanlı alınır.
-
-## Triage
-
-Rollback kararından önce veya P0 durumda rollback başlatılırken en fazla 5 dakika içinde şunlar belirlenir:
-
-- [ ] Hatanın kaynağı bu deployment mı, yoksa bağımlı bir servis mi?
-- [ ] DB migration uygulandı mı?
-- [ ] Rollback'in kendisi veri kaybına yol açar mı?
-- [ ] Hotfix daha hızlı ve daha güvenli çözüm mü? Bkz. `08-hotfix-pipeline.md`.
-
-DB migration uygulandıysa ve geri alınamaz türdeyse rollback durdurulur; +prime kararı olmadan devam edilmez.
-
-## Kullanıcı Bildirimi
-
-**Sorumlu:** +operation-manager, +copywriter
-
-P0/P1 etkisi varsa teknik adımlar ile paralel olarak kullanıcı iletişimi hazırlanır:
-- Etkilenen kullanıcılara durum sayfası, e-posta veya in-app bildirim hazırlanır.
-- Dış iletişim yalnızca +prime onayıyla yayınlanır.
-- Mesaj kısa, durumu kabul eden ve çözümün sürdüğünü belirten formatta olur.
-
-## Kod Rollback
-
-**Sorumlu:** +devops-engineer
-
-- `main` geçmişi bozulmaz.
-- Force push yapılmaz.
-- `git reset --hard` kullanılmaz.
-- Hatalı merge veya commit revert edilir.
-- Geri dönüş yapılacak son kararlı tag/artifact `../workspace/reports/delivery-reports.md` içinden doğrulanır.
-- Merge commit revert edilecekse parent seçimi doğrulanır; emin olunmadan revert yapılmaz.
-- Birden fazla commit geri alınacaksa revert sırası ve etki alanı `../workspace/reports/delivery-reports.md` içinde kaydedilir.
-- Kod rollback PR veya emergency change olarak izlenebilir olmalıdır; yapılan işlem audit trail bırakmalıdır.
-
-> [!WARNING]
-> `main` geçmişini değiştiren destructive git komutları yasaktır. Rollback için revert veya platformun güvenli rollback mekanizması kullanılır.
-
-## DB Migration Rollback
-
-**Sorumlu:** +db-admin
-
-DB migration uygulandıysa rollback öncesinde şunlar yapılır:
-
-1. Deployment öncesi snapshot/dump erişilebilir mi doğrula.
-2. Migration için geri alma yolu var mı doğrula.
-3. Geri alma yolu yoksa migration irreversible kabul edilir.
-4. Irreversible migration varsa +prime kararı olmadan rollback devam etmez; hotfix değerlendirilir.
-5. Geri alma uygulanırsa migration öncesi ve sonrası kritik tablo/kayıt kontrolleri yapılır.
-6. Veri kaybı riski veya müşteri etkisi varsa +operation-manager ve +prime bilgilendirilir.
-7. DB rollback sonucu `../workspace/reports/delivery-reports.md` dosyasına yazılır.
-
-## Deployment Rollback
-
-**Sorumlu:** +devops-engineer
-
-1. Rollback stratejisi `../workspace/reports/delivery-reports.md` içindeki deployment stratejisine göre seçilir.
-2. Önceki başarılı artifact/image/tag doğrulanır.
-3. Proje-spesifik rollback komutu CI/CD yapılandırması veya proje dokümantasyonundan alınır.
-4. Platform rollback'i tamamlanana kadar deployment izlenir.
-5. Rollback sırasında kullanılan artifact/tag, ortam, başlangıç/bitiş zamanı ve operatör `../workspace/reports/delivery-reports.md` dosyasına yazılır.
-
-## Post-Rollback Doğrulama
-
-**Sorumlu:** +qa-engineer, +devops-engineer
-
-Rollback tamamlandıktan sonra production üzerinde smoke test yapılır:
-
-- [ ] Ana sayfa ve kritik sayfalar yükleniyor
-- [ ] Kullanıcı login/logout akışı çalışıyor
-- [ ] Veri okuma işlemleri başarılı
-- [ ] Veri yazma işlemleri başarılı
-- [ ] Ödeme veya kritik iş akışı tamamlanabilir durumda
-- [ ] API endpoint'leri 200 dönüyor
-- [ ] Hata oranı rollback öncesi seviyeye indi
-- [ ] Response time normale döndü
-- [ ] DB migration revert başarıyla uygulandı veya gerekli değil
-
-15 dakika boyunca monitoring dashboard izlenir. Hata oranı düşmüyorsa +operation-manager escalation başlatır ve +prime bilgilendirilir.
-
-Doğrulama sonucu `../workspace/reports/test-reports.md` içine yeni kayıt olarak eklenir. Rollback başarılı sayılmadan önce smoke test sonucu `PASS` olmalıdır.
-
-## Hatalı Sürümü Dondur
-
-**Sorumlu:** +devops-engineer
-
-Hatalı release tekrar deploy edilmesin diye sürüm `../workspace/reports/delivery-reports.md` içinde `blocked release` olarak işaretlenir.
-
-Git tag veya registry işaretleme gerekiyorsa proje-spesifik güvenli yöntem kullanılır; force push veya history rewrite yapılmaz.
-
-`blocked release` kaydında en az şu bilgiler olmalıdır:
-- Hatalı sürüm veya artifact
-- Bloklama sebebi
-- Rollback zamanı
-- İlgili Bug item
-- Tekrar deploy için gereken koşul
-
-## Kök Neden Analizi
-
-**Sorumlu:** +devops-engineer koordinasyonunda ilgili geliştirici ajan
-
-Rollback başarıyla tamamlandıktan sonra `../workspace/memory/learned.md` dosyasına yeni kayıt eklenir:
-
-```md
-## [YYYY-MM-DD] - Rollback: v[A.B.C] -> v[A.B.X]
-
-**Tetikleyici:** [Hangi eşik aşıldı?]
-**Tespit Süresi:** [Deploy zamanı] -> [Rollback kararı]
-**Toplam Etki Süresi:** [Kullanıcıların etkilendiği süre]
-
-### Kök Neden
-[Hangi değişiklik hataya yol açtı?]
-
-### Tespit
-[Hata nasıl ve kim tarafından fark edildi?]
-
-### Rollback Kararı
-[Hotfix neden seçilmedi? Rollback'in gerekçesi neydi?]
-
-### Önlem
-[Bu hatanın staging'de yakalanması için ne yapılmalıydı?]
-```
-
-## Raporlama ve Backlog
-
-| Dosya | Sorumlu | İçerik |
-|---|---|---|
-| `../workspace/reports/delivery-reports.md` | +devops-engineer | Rollback zamanı, sürümler, etki özeti, blocked release |
-| `../workspace/memory/learned.md` | İlgili geliştirici ajan | Post-mortem kaydı |
-| `../workspace/memory/backlog/BXX-[bug-name].md` | +engineering-manager | Rollback'e neden olan hata için Bug item |
-| `../workspace/memory/backlog/epic-dashboard.md` | +engineering-manager | Bug ilgili Epic ile ilişkilendirilir |
-| `../workspace/memory/context/[agent-name]-active.md` | +operation-manager | Aktif rollback kaydı kapatılır |
-
-Rollback tamamlandıktan sonra hata normal geliştirme döngüsüne (`04-development-cycle.md`) alınır. P0/P1 etki devam ediyorsa `08-hotfix-pipeline.md` değerlendirilir.
-
-Bug item oluşturulurken:
-- `Status` değeri `To Do` olmalıdır.
-- `Assignee` +engineering-manager tarafından belirlenir.
-- `Review Gates` en az `Code review` ve `Quality control` içermelidir.
-- Eğer güvenlik veya veri bütünlüğü etkisi varsa `Security check` de eklenir.
-- Hata `../workspace/memory/backlog/epic-dashboard.md` dosyasında ilgili Epic satırıyla ilişkilendirilir.
-
-## Bildirim
-
-Duruma göre yalnızca ilgili bildirimi gönder.
-
-> [!NOTE] ROLLBACK BAŞLADI
-> +prime,
-> `[project-name]` v[A.B.C] için rollback başlatıldı.
-> Sebep: [kısa sebep]
-> Etki: [P0/P1/P2]
-> Detaylar: `../workspace/reports/delivery-reports.md`
-
-> [!NOTE] HOTFIX KARARI BEKLENİYOR
-> +prime,
-> `[project-name]` v[A.B.C] rollback öncesinde karar gerektiriyor.
-> Sebep: [irreversible migration / hotfix daha güvenli / veri kaybı riski]
-> Seçenekler: [rollback / hotfix / bekle]
-> Komutunu bekliyorum.
-
-> [!NOTE] ROLLBACK TAMAMLANDI
-> +prime,
-> `[project-name]` v[A.B.C] sürümünden son kararlı sürüme geri dönüldü.
-> Tetikleyici: [hata özeti]
-> Toplam etki süresi: [süre]
-> DB rollback: [Uygulandı / Uygulanmadı / Gerekli değil]
-> Detaylar: `../workspace/reports/delivery-reports.md`
-> Kök neden kaydı: `../workspace/memory/learned.md`
-> Hata item'ı: `../workspace/memory/backlog/BXX-[bug-name].md`
-
-> [!NOTE] ROLLBACK DURDU
-> +prime,
-> `[project-name]` v[A.B.C] rollback süreci durduruldu.
-> Sebep: [kısa sebep]
-> Detaylar: `../workspace/reports/delivery-reports.md`
-> Komutunu bekliyorum.

package/workflows/08-hotfix-pipeline.md

@@ -1,196 +0,0 @@
-# Hotfix Pipeline
-
-Bu akış, production ortamında tespit edilen kritik hataların rollback yerine hızlı ve kontrollü yamayla çözülmesi için kullanılır.
-
-## Girdi ve Çıkış
-
-- **Başlangıç koşulu:** Rollback uygun değil, riskli ya da yetersiz olmalıdır.
-- **Girdi:** Kritik hata kanıtı, ilgili Bug item ve production etkisi.
-- **Çıkış:** Minimal düzeltme, patch release, learned kaydı ve güncel delivery/test raporları.
-- **Sonraki akış:** Production deploy için `06-deployment-cycle.md`; sorun devam ederse `07-rollback-pipeline.md`.
-
-**Sorumlu:** +operation-manager koordinasyondan, ilgili geliştirici ajan düzeltmeden, +devops-engineer branch/deploy yürütmesinden sorumludur.
-
-## Karar: Hotfix mi, Rollback mi?
-
-Hatayı tespit eden ajan önce `07-rollback-pipeline.md` kararını değerlendirir.
-
-| Durum | Karar |
-|---|---|
-| Son deployment'tan kaynaklanıyor ve hızlıca geri alınabilir | Rollback (`07-rollback-pipeline.md`) |
-| Eski sürümde de vardı veya rollback veri kaybına yol açar | Hotfix |
-| DB migration ile gelen hata; revert veri bütünlüğünü bozar | Hotfix |
-| Hata izole bir modülde ve düzeltme kısa sürede tamamlanabilir | Hotfix |
-
-## Hata Sınıflandırması
-
-+operation-manager hatanın önem seviyesini belirler.
-
-| Seviye | Kriter | Beklenen aksiyon |
-|---|---|---|
-| P0 | Sistem tamamen çöktü, kullanıcıların tamamı etkilendi veya veri kaybı riski var | Hotfix hemen başlar, +prime eş zamanlı bilgilendirilir |
-| P1 | Temel iş akışı bozuldu, kullanıcıların büyük kısmı etkilendi | Hotfix hemen başlar, +prime bilgilendirilir |
-| P2 | Kısmi hata, workaround var veya sınırlı kullanıcı etkileniyor | +prime kararıyla hotfix veya normal geliştirme döngüsü |
-
-## Hazırlık, Item ve Branch
-
-**Sorumlu:** +operation-manager, +engineering-manager, +devops-engineer
-
-1. Hotfix bir Bug item'a bağlanır: `../workspace/memory/backlog/BXX-[bug-name].md`.
-2. P0 durumda Bug item hotfix başladıktan hemen sonra oluşturulabilir; süreç kapanmadan mutlaka kayıt altına alınır.
-3. Bug item `../workspace/memory/backlog/epic-dashboard.md` içinde ilgili Epic satırıyla ilişkilendirilir.
-4. +operation-manager `../workspace/memory/context/[agent-name]-active.md` dosyasını oluşturur veya günceller.
-5. Etkilenen ajanlar göreve çağırılır: ilgili geliştirici ajan, +qa-engineer, gerekirse +security-engineer ve +db-admin.
-6. Hotfix branch `main` üzerinden açılır.
-7. Branch adı `hotfix/[item-id]-[short-name]` formatında olmalıdır. Örn: `hotfix/b07-login-crash`.
-8. Force push veya history rewrite yapılmaz.
-
-## Düzeltme
-
-**Sorumlu:** İlgili geliştirici ajan
-
-1. Hatanın kök nedenini log, hata mesajı ve kod incelemesiyle doğrula.
-2. En minimal, hedefe yönelik düzeltmeyi yap; hotfix kapsamını genişletme.
-3. Değişiklik Bug item'ın Acceptance Criteria maddelerini karşılamalıdır.
-4. Commit mesajı `../workspace/references/dictionary.md` standartlarına uymalıdır.
-5. Değişiklik `hotfix/[item-id]-[short-name]` branch'ine push edilir.
-
-## DB Migration Varsa
-
-**Sorumlu:** +db-admin
-
-- Migration mümkünse geri alınabilir şekilde hazırlanır.
-- Migration uygulanmadan önce backup/snapshot planı doğrulanır.
-- Veri kaybı veya müşteri etkisi riski varsa +prime kararı olmadan devam edilmez.
-- Migration staging ortamında test edilmeden production deploy yapılmaz.
-- Migration sonucu `../workspace/reports/delivery-reports.md` içine yazılır.
-
-## Test ve Güvenlik Kontrolü
-
-**Sorumlu:** +qa-engineer, +security-engineer, +engineering-manager
-
-1. Hotfix branch staging ortamına deploy edilir.
-2. Test süreci `05-test-cycle.md` standardına göre yürütülür.
-3. En az şu kontroller yapılır:
-   - Raporlanan hatanın düzeldiği doğrulanır.
-   - Etkilenen modül test edilir.
-   - Yan etki riski olan komşu modüller test edilir.
-   - Authentication/session akışları kontrol edilir.
-   - Veri okuma/yazma işlemleri doğrulanır.
-   - Etkilenen API endpoint'leri kontrol edilir.
-   - DB migration varsa staging sonucu doğrulanır.
-4. P0/P1 veya güvenlik etkisi olan hotfixlerde +security-engineer kontrolü zorunludur.
-5. Test sonucu `../workspace/reports/test-reports.md` içine yazılır.
-
-## Onay
-
-Merge ve production deploy öncesinde gerekli onaylar tamamlanır:
-
-| Onay | Sorumlu | Zorunluluk |
-|---|---|---|
-| Code review | +engineering-manager | Her hotfix |
-| Smoke test | +qa-engineer | Her hotfix |
-| Security check | +security-engineer | P0/P1 veya güvenlik/veri etkisi varsa |
-| Production approval | +prime | P0/P1 için zorunlu; P2 için karar durumuna göre |
-
-Onay tamamlanmadan production deploy yapılmaz.
-
-## Merge ve Tag
-
-**Sorumlu:** +devops-engineer
-
-- Hotfix değişikliği `main` branch'ine alınır.
-- Aynı değişiklik `development` branch'ine de alınır; gelecek sürümlerde tekrar kaybolmamalıdır.
-- Patch version tag'i oluşturulur. Örn: `v1.0.0` -> `v1.0.1`.
-- Hotfix branch temizliği proje git kurallarına göre yapılır.
-- Merge, tag ve branch bilgisi `../workspace/reports/delivery-reports.md` dosyasına yazılır.
-
-## Production Deploy
-
-**Sorumlu:** +devops-engineer
-
-- Production deploy `06-deployment-cycle.md` içindeki Production Deployment kurallarına göre yapılır.
-- Ajanlar `.env.production` veya gerçek secret değerlerini okumaz, yazmaz ve raporlamaz.
-- Deployment sonrası smoke test production üzerinde tekrar edilir.
-- Hata oranı ve latency en az 15 dakika izlenir.
-- Deployment sonrası sorun devam ederse `07-rollback-pipeline.md` başlatılır.
-
-## Kök Neden Analizi
-
-**Sorumlu:** Düzeltmeyi yapan geliştirici ajan
-
-Hotfix başarıyla deploy edildikten sonra `../workspace/memory/learned.md` dosyasına yeni kayıt eklenir:
-
-```md
-## [YYYY-MM-DD] - Hotfix: [item-id] - [bug-name] (v[A.B.C])
-
-**Severity:** P[0/1/2]
-**Etkilenen Modül:** [modül adı]
-**Etki Süresi:** [tespit zamanı] -> [düzeltme zamanı]
-
-### Kök Neden
-[Hataya ne sebep oldu?]
-
-### Tespit
-[Nasıl ve kim tarafından tespit edildi?]
-
-### Düzeltme
-[Ne değiştirildi?]
-
-### Önlem
-[Benzer hatayı önlemek için ne yapılmalı?]
-```
-
-## Raporlama ve Kapanış
-
-| Dosya | Sorumlu | İçerik |
-|---|---|---|
-| `../workspace/reports/delivery-reports.md` | +devops-engineer | Hotfix build bilgisi, deploy zamanı, tag, strategy |
-| `../workspace/reports/release-notes.md` | +delivery-manager | Kullanıcıya yönelik kısa açıklama |
-| `../workspace/reports/test-reports.md` | +qa-engineer | Smoke test ve gate sonuçları |
-| `../workspace/memory/learned.md` | İlgili geliştirici ajan | Post-mortem kaydı |
-| `../workspace/memory/backlog/BXX-[bug-name].md` | +engineering-manager | Bug item kapanışı |
-| `../workspace/memory/backlog/epic-dashboard.md` | +engineering-manager | Bug status güncellemesi |
-| `../workspace/memory/context/[agent-name]-active.md` | +operation-manager | Aktif hotfix kaydı kapatılır |
-
-Hotfix tamamlandığında Bug item `Done` yapılır. Eğer kapsam büyüdüyse veya kalıcı düzeltme gerekiyorsa yeni Task/Debt item oluşturulur.
-
-## Bildirim
-
-Duruma göre yalnızca ilgili bildirimi gönder.
-
-> [!NOTE] HOTFIX KARARI BEKLENİYOR
-> +prime,
-> `../workspace/memory/backlog/BXX-[bug-name].md` için hotfix kararı gerekiyor.
-> Sebep: [rollback riskli / veri kaybı riski / P2 karar]
-> Seçenekler: [hotfix / rollback / normal geliştirme]
-> Komutunu bekliyorum.
-
-> [!NOTE] HOTFIX BAŞLADI
-> +prime,
-> `../workspace/memory/backlog/BXX-[bug-name].md` için hotfix başlatıldı.
-> Severity: P[0/1/2]
-> Etki: [kısa etki özeti]
-> Detaylar: `../workspace/reports/delivery-reports.md`
-
-> [!NOTE] HOTFIX ONAYI BEKLENİYOR
-> +prime,
-> `../workspace/memory/backlog/BXX-[bug-name].md` için hotfix testleri tamamlandı.
-> Test raporu: `../workspace/reports/test-reports.md`
-> Production deploy için onayını bekliyorum.
-
-> [!NOTE] HOTFIX TAMAMLANDI
-> +prime,
-> `../workspace/memory/backlog/BXX-[bug-name].md` canlıda düzeltildi.
-> Sürüm: v[A.B.C]
-> Etki süresi: [süre]
-> Detaylar: `../workspace/reports/delivery-reports.md`
-> Sürüm notları: `../workspace/reports/release-notes.md`
-> Kök neden kaydı: `../workspace/memory/learned.md`
-
-> [!NOTE] HOTFIX DURDU
-> +prime,
-> `../workspace/memory/backlog/BXX-[bug-name].md` hotfix süreci durduruldu.
-> Sebep: [kısa sebep]
-> Detaylar: `../workspace/reports/delivery-reports.md`
-> Komutunu bekliyorum.