kortext 1.0.0 → 2.2.3

package/workflows/04-development-cycle.md

@@ -0,0 +1,203 @@
+# Development Cycle (`!start development`)
+
+Bu akış, seçilen backlog item'ının uygulanmasını ve `Review` aşamasına kadar ilerlemesini yönetir.
+
+## Girdi ve Çıkış
+
+- **Başlangıç koşulu:** Düz backlog içinde assignee'si belirlenmiş ve bağımlılıkları çözümlenmiş bir item bulunmalıdır.
+- **Girdi:** İlgili backlog item dosyası, onaylı referanslar ve mevcut handover/context kayıtları.
+- **Çıkış:** Uygulanmış değişiklik, `Test`/`Review` geçiş kayıtları ve güncel handover.
+- **Sonraki akış:** Test için `05-test-cycle.md`; onay sonrası deployment ihtiyacına göre `06-deployment-cycle.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ı |
+|---|---|---|---|
+| Pick & Plan | Assignee ajan | `scripts/kortext-item-start.py <item> --agent <persona> --summary "..."` | Item `In Progress`, `workspace/memory/context/<agent>-active.md`, otomatik git commit |
+| Implementation (PR açma) | Assignee ajan | `scripts/kortext-item-transition.py <item> --to Test` | Status `Test`, otomatik git commit |
+| PR commit | (otomatik) | `hooks/git-pre-commit.sh` zinciri (secret-scanner → lint → size → backlog-sync → handover → snapshot) | Commit accept/reject |
+| Verification (fail) | Gate sahibi ajan | `scripts/kortext-item-transition.py <item> --to "In Progress"` | Status `In Progress`, otomatik git commit |
+| Verification (pass) | Son gate ajanı | `scripts/kortext-item-transition.py <item> --to Review` | Status `Review`, otomatik git commit |
+| Final Review (request changes) | Item approver | `scripts/kortext-item-transition.py <item> --to "In Progress"` | Status `In Progress`, otomatik git commit |
+| Final Review (approve) | Item approver | `!approve` komutu (manuel) | +prime / approver onayı |
+| Deployment & Closing | +devops-engineer | `scripts/kortext-handover.py` → `scripts/kortext-item-check.py` → `scripts/kortext-item-transition.py --to Done` → `scripts/kortext-backlog-sync.py` | Handover, gate kontrol, `Done` geçişi, dashboard sync, git commit zinciri |
+
+> [!INFO] 
+> - Süreç başladığında ajanlar backlog item ID'leri üzerinden ilerler.
+> - Her ajan göreve başlarken `../workspace/memory/context/[agent-name]-active.md` dosyasını oluşturur veya günceller; görev bitince kendi aktif görev dosyasını siler.
+> - Karşılaşılan sorunların çözümleri ilgili ajan tarafından `../workspace/memory/learned.md` dosyasına işlenir.
+> - Süreçte `../rules/branching.md` kuralları uygulanır.
+> - Assignee ajan item dosyasının durumunu güncellemekten sorumludur.
+> - Crossroads: Geliştirme sırasında birden fazla çözüm yolu varsa:
+> 	- Seçenekler listelenir, öneri belirtilir
+> 	- +prime'a sunulur
+> 	- +prime karar vermeden inisiyatif alınmaz
+> - +prime yalnızca kendisine atanmış kontrol/onay işi olduğunda, Epic tamamlandığında veya büyük iş/kavşak/checkpoint durumunda bilgilendirilir.
+> - Ajanların kendi aralarındaki normal geliştirme, doğrulama ve düzeltme devrinde +prime'a bildirim verilmez.
+> - Checkpoint (kritik dönüm noktalarında): Önemli ve test edilebilir dönüm noktalarında (örn: "Login backend tamamlandı")
+> 	- Büyük işse veya +prime onayı gerekiyorsa +prime'a kısa durum özeti verilir.
+> 	- "devam" veya "onay" komutu beklenir.
+> 	- **İstisna:** Ardışık küçük backend görevlerinde (UI değişikliği içermeyen) onay istenmez.
+> 	- **UI değişikliği varsa:** Kod derinleşmeden önce tasarım yapısı açıklanır ve +prime onayı alınır.
+
+## Backlog Item Tipleri
+
+- **Epic:** `E` prefix'i ile takip edilir ve ortak iş hedefini temsil eder. Epic detayları `epic-dashboard.md` içinde tutulur.
+- **Task:** `T` prefix'i ile takip edilir. Yeni geliştirme veya planlı uygulama işidir.
+- **Bug:** `B` prefix'i ile takip edilir. Mevcut davranışın yanlış çalışmasıdır.
+- **Debt:** `D` prefix'i ile takip edilir. Teknik borç, refactor, mimari iyileştirme, test açığı veya operasyonel borçtur.
+
+## Backlog Dosya Yapısı
+
+Backlog tek seviyeli dosya yapısı kullanır. Version, Epic, Task, Bug ve Debt için ayrı klasör açılmaz.
+
+```text
+../workspace/memory/backlog/
+├── version-dashboard.md
+├── epic-dashboard.md
+├── debt-dashboard.md
+├── TXX-[task-name].md
+├── BXX-[bug-name].md
+└── DXX-[debt-name].md
+```
+
+## Item Akışları
+
+### Aşama (Status) Tanımları
+
+| Aşama | Açıklama |
+|---|---|
+| **To Do** | Sahibi belli ama sırası gelmemiş ya da blokeri çözülmemiş item'ların aşamasıdır. |
+| **In Progress** | Aktif olarak yürütülen item'ların aşamasıdır. Tamamlanınca Test'e taşınır. |
+| **Test** | Code review ve item dosyasındaki Review Gates kontrollerinin yürütüldüğü aşamadır. Tüm kontroller bitince Review'a taşınır. |
+| **Review** | +prime ya da yetkili ajanın nihai uygunluk değerlendirmesi yaptığı aşamadır. |
+| **Done** | Tüm doğrulama süreçlerinden geçmiş, approver tarafından onaylanmış item'ların aşamasıdır. |
+
+### Epic Workflow 
+
+To Do (Hazırlık) → In Progress (Geliştirme) → Done (Tamamlandı)
+- **Geliştirme:** Epic'e bağlı ilk Task veya Bug `In Progress` olduğunda Epic `epic-dashboard.md` içinde `In Progress` yapılır. Epic için ayrı klasör veya branch açılmaz; çalışma düz backlog item dosyaları ve item branch'leri üzerinden yürür.
+- **Tamamlandı:** Epic'e bağlı tüm Task ve Bug item'ları `Done` olduğunda Epic `Done` yapılır. Süreç bitiminde `../workspace/reports/status-reports.md` güncellenir.
+
+### Task Workflow
+
+To Do (Bekleme/Planlama) → In Progress (Uygulama) → Test (Doğrulama) → Review (Final Review) → Done (Kapanış)
+- **Bekleme:** Item backlog içerisinden seçilip rafine edilmiş olarak çalışılmayı bekler (To Do).
+- **Uygulama:** Item atanan ajan (Assignee) işi üzerine alır ve kodlama/tasarım sürecini gerçekleştirir (In Progress).
+- **Doğrulama:** Tamamlanan iş code review ve item dosyasındaki Review Gates kontrollerinden geçer. Hata varsa item `In Progress` olarak assignee ajana geri döner.
+- **Onay:** Doğrulama adımlarından başarıyla geçen iş Approver tarafına onay için sunulur (Review).
+- **Kapanış:** Onay (approve) alan iş `development` branch'ine merge edilir (Done).
+
+### Bug Workflow
+
+To Do (Tespit) → In Progress (Çözüm) → Test (Doğrulama) → Review → Done
+- **Tespit & Raporlama:** Bug tespit edildiğinde tespit eden ajan veya +engineering-manager `../workspace/memory/backlog/BXX-[bug-name].md` item dosyasını oluşturur ve bug'ı `epic-dashboard.md` içinde ilgili Epic satırıyla ilişkilendirir.
+- **Atama:** +engineering-manager ilgili Bug'ı çözecek doğru ajana atar.
+- **Çözüm:** İlgili ajan hatayı kodda çözer (In Progress).
+- **Doğrulama:** Kod, testi yapan kişiye geri döner (Test).
+- **Kapanış:** Doğrulanırsa Bug kapatılır (Done).
+
+### Debt Workflow
+
+To Do (Borç ekleme) → In Progress (Borç ödeme) → Test (Doğrulama) → Review → Done
+- **Borç ekleme:** Teknik borç tespit edildiğinde tespit eden ajan veya +engineering-manager `../workspace/memory/backlog/DXX-[debt-name].md` item dosyasını oluşturur ve borcu `debt-dashboard.md` içinde listeler.
+- **Atama:** +engineering-manager ilgili borcu ödeyecek doğru ajana atar.
+- **Çözüm:** İlgili ajan borcu öder (In Progress).
+- **Doğrulama:** Tamamlanan iş code review ve item dosyasındaki Review Gates kontrollerinden geçer. Hata varsa item `In Progress` olarak assignee ajana geri döner.
+- **Kapanış:** Onay (approve) alan iş `development` branch'ine merge edilir (Done).
+
+## Pick & Plan (İşi Alma)
+
+**Sorumlu:** Ajan (Assignee)
+1. `../workspace/memory/backlog/version-dashboard.md`, `../workspace/memory/backlog/epic-dashboard.md` ve `../workspace/memory/backlog/debt-dashboard.md` dosyalarından kendisine atanmış `To Do` item'ı bulur.
+2. İlgili `TXX-[task-name].md`, `BXX-[bug-name].md` veya `DXX-[debt-name].md` item dosyasını açar.
+3. Item dosyasındaki `Dependencies` bölümünü kontrol eder. `Blocked By` alanında tamamlanmamış item varsa işe başlamaz.
+4. `../scripts/kortext-item-start.py` aracıyla item statüsünü `In Progress` yapar ve `../workspace/memory/context/[agent-name]-active.md` dosyasını oluşturur veya günceller.
+
+> [!Example]
+> [+ajan] | [item-id] | In Progress | [DD.MM.YY-HH:MM]
+> [Item adı] — Implementation başlıyor
+   
+> [!TIP] Handoff: Yok — bu adım kendi içinde tamamlanır, ajan doğrudan **Implementation**'a geçer.
+
+## Implementation (Kodlama)
+
+**Sorumlu:** Ajan (Assignee)
+1. `../rules/branching.md` kuralına göre `feature/` branch'i açar.
+
+> [!TIP] Branching kuralına göre:
+> ```bash
+> git pull origin development
+> git checkout -b feature/[item-id]
+> ```
+> Branch ismi küçük harf, kebab-case ve item ID içermelidir. Örn: `feature/t01-login-form`
+
+2. `../workspace/references/` altındaki onaylı referanslara sadık kalarak işi uygular.
+3. Gerekli unit testleri yazar ve yerelde çalıştırır.
+4. Codebase'e commit atar. Commit mesajları `../workspace/references/dictionary.md` standartlarına uymalıdır.
+5. PR açar ve `../scripts/kortext-item-transition.py` aracıyla item statüsünü `Test` aşamasına taşır.
+> [!TIP] Handoff: PR açıldığında item dosyası `Test` yapılır ve ilgili doğrulama ajanlarına context aktarılır.
+
+## Verification (Doğrulama & Test)
+
+Bu aşamanın uygulama detayı `05-test-cycle.md` içinde tanımlanır. `04-development-cycle.md` yalnızca lifecycle geçişini tarif eder.
+
+1. PR açıldığında item dosyası `Test` statüsünde olmalıdır.
+2. Doğrulama süreci `05-test-cycle.md` standardına göre yürütülür.
+3. Test cycle başarısız olursa `../scripts/kortext-item-transition.py` aracıyla item `In Progress` statüsüne geri döner ve assignee ajana atanır.
+4. Test cycle başarılı olursa `../scripts/kortext-item-transition.py` aracıyla item `Review` statüsüne taşınır.
+
+> [!TIP]
+> Eğer item kritik bir özellikse veya +prime onayı gerektiriyorsa (UI onayı gibi), +prime'a atanır ve bildirim verilir.
+> Doğrulama detayları, gate sonuçları ve raporlama kuralları için tek kaynak `05-test-cycle.md` dosyasıdır.
+
+## Final Review (Son Kontrol)
+
+**Sorumlu:** Item approver
+1. Item dosyasındaki Acceptance Criteria, Review Gates sonuçları, PR ve test çıktıları incelenir.
+2. Hata varsa `Request Changes` verilir; item `In Progress` olarak assignee ajana geri döner.
+3. Item approver +prime ise kontrol işi +prime'a bildirilir ve onay beklenir.
+4. Hata yoksa item onaylanır ve +devops-engineer'a atanır.
+
+## Deployment & Closing (Kapanış)
+
+**Sorumlu:** +devops-engineer
+1. Onay verildiğinde PR `development` branch'ine merge edilir.
+2. CI/CD pipeline çalışır ve kod Staging ortamına çıkar.
+3. `../scripts/kortext-handover.py` aracıyla `../workspace/memory/handover.md` dosyasına yeni devir kaydı eklenir. Handover tamamlanmadan item `Done` yapılamaz.
+4. `../scripts/kortext-item-check.py` aracıyla acceptance criteria, review gates, handover ve context kapanışı kontrol edilir.
+5. `../scripts/kortext-item-transition.py` aracıyla item `Done` yapılır.
+6. `../scripts/kortext-backlog-sync.py` aracıyla dashboard drift kontrol edilir.
+7. `../workspace/memory/backlog/version-dashboard.md`, `../workspace/memory/backlog/epic-dashboard.md` veya `../workspace/memory/backlog/debt-dashboard.md` ilgili item statüsüne göre güncellenir.
+
+> [!TIP] Dosyanın en üstüne aşağıdaki alanlar doldurularak yeni bir kayıt eklenir:
+> - **Completed:** Ne yapıldı?
+> - **Changed Files:** Değiştirilen dosyalar ve ne değiştiği
+> - **Watch-outs & Decisions:** Bilinen kırılgan nokta veya workaround varsa
+> - **Last Commit:** Son commit hash ve mesajı
+> - **Next Steps:** Sıradaki ajan ne yapacak? (yoksa "Yok")
+   
+8. `../workspace/memory/context/[agent-name]-active.md` dosyasını siler. Başka ajanların aktif görev dosyalarına dokunmaz.
+
+## Bildirim
+
+Duruma göre yalnızca ilgili bildirimi gönder.
+
+> [!NOTE] PRIME KONTROLÜ BEKLENİYOR
+> +prime,
+> `../workspace/memory/backlog/[TXX|BXX|DXX]-[item-name].md` için Final Review sana atandı.
+> Acceptance Criteria, Review Gates sonuçları, PR ve test çıktıları hazır.
+> Doğruysa onayını bekliyorum.
+
+> [!NOTE] EPIC TAMAMLANDI
+> +prime,
+> `[epic-id]` tamamlandı.
+> `../workspace/reports/status-reports.md` güncellendi.
+
+> [!NOTE] CHECKPOINT
+> +prime,
+> `../workspace/memory/backlog/[TXX|BXX|DXX]-[item-name].md` için kritik dönüm noktasına gelindi.
+> [kısa durum özeti]
+> Devam için onayını bekliyorum.

package/workflows/05-test-cycle.md

@@ -0,0 +1,123 @@
+# Test Cycle
+
+Bu akış, `04-development-cycle.md` içindeki `Test` statüsünün nasıl yürütüleceğini tanımlar. Amaç, item'ın `Review` aşamasına geçmeden önce gerekli doğrulama kayıtlarını üretmek ve blokajları doğru ajana geri döndürmektir.
+
+## Girdi ve Çıkış
+
+- **Başlangıç koşulu:** Item dosyası `Test` statüsünde olmalı ve PR/CI çıktıları hazır bulunmalıdır.
+- **Girdi:** Item dosyası, acceptance criteria, review gates, PR ve CI kanıtları.
+- **Çıkış:** `../workspace/reports/test-reports.md` içinde doğrulama kaydı ve item için `In Progress` veya `Review` kararı.
+- **Sonraki akış:** Başarılıysa `04-development-cycle.md` içindeki Final Review adımı; başarısızsa item yeniden assignee ajana döner.
+
+## 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ı |
+|---|---|---|---|
+| Test başlangıç (status doğrulama) | Doğrulayan ajan | `scripts/kortext-item-check.py <item>` | Acceptance Criteria + Review Gates kontrolü (read-only) |
+| Code review fail | +engineering-manager | `scripts/kortext-item-transition.py <item> --to "In Progress"` | Status `In Progress`, otomatik git commit |
+| Code review pass | +engineering-manager | (rapor `../workspace/reports/test-reports.md`'ye yazılır) | Test raporu güncel |
+| Quality control gate | +qa-engineer | (gate sonucu test-reports.md) | Gate sonuç kaydı |
+| Security check gate | +security-engineer | (gate sonucu test-reports.md + gerekirse security-reports.md) | Gate sonuç kaydı |
+| Design review gate | +designer | (gate sonucu test-reports.md) | Gate sonuç kaydı |
+| Herhangi gate fail | Gate sahibi ajan | `scripts/kortext-item-transition.py <item> --to "In Progress"` | Status `In Progress`, otomatik git commit |
+| Tüm gate'ler pass | Son gate ajanı | `scripts/kortext-item-transition.py <item> --to Review` | Status `Review`, otomatik git commit |
+
+## Genel Prensipler
+
+- Test cycle yalnızca item dosyası `Test` statüsündeyken çalışır.
+- Test sonuçlarının ana kaydı `../workspace/reports/test-reports.md` dosyasına yazılır.
+- Code review her item için zorunludur.
+- `Quality control`, `Security check` ve `Design review` yalnızca item dosyasındaki `Review Gates` içinde işaretliyse çalıştırılır.
+- Başarısız doğrulama varsa item `In Progress` yapılır ve assignee ajana geri atanır.
+- +prime yalnızca kendisine atanmış kontrol/onay işi olduğunda, büyük/kritik blokajda veya kavşak durumunda bilgilendirilir.
+
+## Girdi
+
+- `../workspace/memory/backlog/[TXX|BXX|DXX]-[item-name].md`
+- PR linki ve CI çıktıları
+- Item dosyasındaki `Acceptance Criteria`
+- Item dosyasındaki `Review Gates`
+- Gerekli referans dosyaları: `../workspace/references/`
+
+## Test Katmanları
+
+### Local Checks
+
+**Sorumlu:** Assignee ajan
+
+Bu kontroller assignee ajan tarafından PR açılmadan önce tamamlanmış olmalıdır. Test cycle içinde bu kayıtların varlığı kontrol edilir:
+- Linting
+- Unit tests
+- Statik analiz veya type check
+- Değişiklik kapsamındaki minimum manuel doğrulama
+
+### Pull Request / CI
+
+**Sorumlu:** +engineering-manager
+
+PR açıldığında aşağıdaki kontroller incelenir:
+- Build sonucu
+- Unit/integration test sonucu
+- CI logları
+- Kodun referans dosyalarına ve proje standartlarına uygunluğu
+
+### Review Gates
+
+| Gate | Sorumlu | Çıktı |
+|---|---|---|
+| Code review | +engineering-manager | `../workspace/reports/test-reports.md` |
+| Quality control | +qa-engineer | `../workspace/reports/test-reports.md` |
+| Security check | +security-engineer | `../workspace/reports/test-reports.md` |
+| Design review | +designer | `../workspace/reports/test-reports.md` |
+
+> [!NOTE]
+> `Security check` sonucunda ayrıntılı güvenlik kaydı gerekiyorsa ek detay `../workspace/reports/security-reports.md` dosyasına yazılır. Ana geçiş kararı yine `../workspace/reports/test-reports.md` içinde özetlenir.
+
+## Akış
+
+1. Item dosyasının `Status` alanının `Test` olduğunu doğrula.
+2. Item dosyasındaki `Acceptance Criteria` maddelerini oku.
+3. Item dosyasındaki `Review Gates` maddelerini oku.
+4. PR ve CI sonuçlarını incele.
+5. Code review sonucunu `../workspace/reports/test-reports.md` dosyasına yaz.
+6. Code review başarısızsa `../scripts/kortext-item-transition.py` aracıyla item'ı `In Progress` yap ve assignee ajana geri ata.
+7. Code review başarılıysa işaretli `Quality control`, `Security check` ve `Design review` gate'leri ilgili ajanlara yönlendir.
+8. Code review sonrası gate'ler birbirinden bağımsızsa paralel yürütülebilir.
+9. Her gate sonucu `../workspace/reports/test-reports.md` dosyasına yazılır.
+10. Herhangi bir gate başarısızsa:
+   - `../scripts/kortext-item-transition.py` aracıyla item dosyasını `In Progress` yap.
+   - Hata listesini item dosyasındaki `Work Log` veya `Notes` alanına ekle.
+   - Item'ı assignee ajana geri ata.
+11. Tüm zorunlu kontroller geçerse `../scripts/kortext-item-transition.py` aracıyla item dosyasını `Review` statüsüne taşı.
+12. `../workspace/memory/context/[agent-name]-active.md` dosyasını ilgili doğrulama ajanı günceller.
+
+## Blokaj Kuralı
+
+Normal test hataları +prime'a bildirilmez. Ajanlar arası düzeltme döngüsü içinde çözülür.
+
++prime'a yalnızca şu durumlarda bildirim verilir:
+- Blokaj item kapsamını değiştiriyorsa.
+- Çözüm için birden fazla yol varsa ve karar gerekiyorsa.
+- Risk büyük/kritik olarak işaretlendiyse.
+- Final Review veya özel onay +prime'a atanmışsa.
+
+## Bildirim
+
+Normal test fail için bildirim gönderme. Item `In Progress` yapılır, assignee ajana geri atanır ve detaylar `../workspace/reports/test-reports.md` içine yazılır.
+
+Duruma göre yalnızca ilgili bildirimi gönder:
+
+> [!NOTE] TEST BLOKAJI
+> +prime,
+> `../workspace/memory/backlog/[TXX|BXX|DXX]-[item-name].md` test aşamasında karar gerektiren blokaja girdi.
+> Rapor: `../workspace/reports/test-reports.md`
+> Karar: [kısa karar konusu]
+> Komutunu bekliyorum.
+
+> [!NOTE] PRIME KONTROLÜ BEKLENİYOR
+> +prime,
+> `../workspace/memory/backlog/[TXX|BXX|DXX]-[item-name].md` için test kontrolü sana atandı.
+> Rapor: `../workspace/reports/test-reports.md`
+> Doğruysa onayını bekliyorum.

package/workflows/06-deployment-cycle.md

@@ -0,0 +1,224 @@
+# 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`