kortext 2.2.3 → 3.1.0

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.

package/workflows/09-maintenance-cycle.md

@@ -1,133 +0,0 @@
-# Maintenance Cycle (`!maintenance`)
-
-Bu akış, production'daki sistemin rutin bakımını gerçekleştirir. Sprint başlangıcında veya +prime'ın `!maintenance` komutuyla tetiklenir. Yeni özellik geliştirme içermez; sadece mevcut sistemin sağlığını korumaya yönelik kontroller ve temizlik işlemleri yapılır.
-
-## Girdi ve Çıkış
-
-- **Başlangıç koşulu:** Production deployment'ı tamamlanmış ve sistem çalışır durumda olmalıdır.
-- **Girdi:** Aktif `workspace/memory/learned.md`, `workspace/memory/decisions.md`, `workspace/memory/backlog/` ve mevcut bağımlılık listesi.
-- **Çıktı:** Güncellenen bağımlılık listesi, temizlenmiş teknik borç listesi, aktif learned.md önerileri ve `workspace/reports/status-reports.md` güncellemesi.
-- **Sonraki akış:** Aksiyona alınacak item varsa `04-development-cycle.md`.
-
-## Bakım Kategorileri
-
-Bakım döngüsü dört kategoride kontrol yapar. Her kategori bağımsız yürütülebilir.
-
----
-
-### Kategori 1 — Bağımlılık Güncelleme Kontrolü
-
-**Sorumlu:** +devops-engineer, +backend-developer, +frontend-developer
-
-1. Projenin `workspace/references/tech-stack.md` dosyasındaki bağımlılıkları kontrol et.
-2. Major ve minor güncellemeleri listele; breaking change içerenleri işaretle.
-3. Güvenlik açığı bildirilen bağımlılıkları ayrıca listele — bunlar `!maintenance` beklemez, normal döngüde Bug olarak açılmalıdır.
-4. Güncelleme kararını `workspace/memory/decisions.md`'ye kaydet:
-   - Hangi bağımlılıklar güncellenecek?
-   - Hangilerinin güncellenmesi erteleniyor ve neden?
-5. Güncelleme kapsam dışıysa backlog'a Debt item aç.
-
-> [!TIP]
-> Major version güncellemesi daima breaking change riski taşır. Staging ortamında test edilmeden production'a taşıma.
-
----
-
-### Kategori 2 — Teknik Borç Gözden Geçirmesi
-
-**Sorumlu:** +engineering-manager
-
-1. `workspace/memory/backlog/debt-dashboard.md` içindeki tüm Debt item'larını gözden geçir.
-2. Her item için şunu değerlendir:
-   - Hala geçerli mi?
-   - Önceliği değişti mi?
-   - Bir sonraki döngüde yapılabilir mi?
-3. Kapatılabilecek (artık geçersiz) Debt item'larını Done yap ve kapat.
-4. Yeni tespit edilen teknik borçları `kortext-backlog-add.py --type debt` ile ekle.
-5. Öncelikleri `workspace/reports/status-reports.md`'ye yansıt.
-
----
-
-### Kategori 3 — Learned.md Gözden Geçirmesi
-
-**Sorumlu:** +operation-manager, +engineering-manager
-
-Bu aşama sistemin hafızasını aktif hale getirir.
-
-1. `workspace/memory/learned.md` dosyasını oku.
-2. Son 30 gün içindeki kayıtları gözden geçir.
-3. Her kayıt için sor:
-   - Bu dersden alınan önlem uygulandı mı?
-   - Eğer uygulanmadıysa neden? Backlog Debt item açılmalı mı?
-4. Aksiyona alınan dersler için `workspace/memory/learned.md` dosyasında ilgili kayda not ekle:
-   ```
-   **Aksiyon:** [alınan önlem / açılan Debt ID]
-   ```
-
----
-
-### Kategori 4 — Sistem Sağlık Kontrolü
-
-**Sorumlu:** +devops-engineer, +qa-engineer
-
-1. Kortext backlog sağlık raporunu çalıştır:
-   ```
-   python scripts/kortext-backlog-health.py
-   ```
-2. Context tutarlılığını kontrol et:
-   ```
-   python scripts/kortext-context-check.py
-   ```
-3. Monitoring dashboard'larını kontrol et:
-   - Hata oranı (5xx) son hafta trend?
-   - Response time (p95) SLA dahilinde mi?
-   - Disk/bellek kullanımı normal seviyelerde mi?
-4. Sonuçları `workspace/reports/delivery-reports.md` dosyasına yaz.
-
----
-
-### Kategori 5 — Güvenlik Taraması
-
-**Sorumlu:** +security-engineer
-
-1. Bağımlılıklarda bilinen güvenlik açığı var mı kontrol et.
-2. `workspace/references/security-rules.md` güncel mi kontrol et.
-3. Secrets scanning altyapısının hala çalıştığını doğrula (pre-commit hook, CI pipeline).
-4. Tespit edilen güvenlik açıkları varsa hemen Bug item aç — `!maintenance` tamamlanmasını bekleme.
-5. Sonucu `workspace/reports/security-reports.md` dosyasına yaz.
-
----
-
-## Raporlama
-
-| Dosya | Sorumlu | İçerik |
-|---|---|---|
-| `workspace/reports/status-reports.md` | +operation-manager | Bakım özeti: tamamlanan, ertelenen, yeni açılan itemlar |
-| `workspace/memory/decisions.md` | +engineering-manager | Bağımlılık güncelleme ve borç önceliklendirme kararları |
-| `workspace/reports/security-reports.md` | +security-engineer | Güvenlik taraması sonucu |
-| `workspace/reports/delivery-reports.md` | +devops-engineer | Sistem sağlık metrikleri |
-
----
-
-## Bildirim
-
-> [!NOTE] BAKIM BAŞLADI
-> +prime,
-> Rutin bakım döngüsü başladı.
-> Kategoriler: Bağımlılık | Teknik Borç | Learned | Sistem Sağlık | Güvenlik
-> Tamamlandığında rapor sunulacak.
-
-> [!NOTE] BAKIM TAMAMLANDI
-> +prime,
-> Rutin bakım tamamlandı.
-> **Güncellenen bağımlılıklar:** [sayı]
-> **Kapatılan borçlar:** [sayı]
-> **Yeni açılan itemlar:** [sayı]
-> **Güvenlik:** [Temiz / X açık tespit edildi]
-> Detaylar: `workspace/reports/status-reports.md`
-> Komutunu bekliyorum.
-
-> [!NOTE] BAKIM BLOKLANDI
-> +prime,
-> Bakım döngüsünde karar gerektiren durum tespit edildi.
-> **Konu:** [kısa açıklama]
-> Komutunu bekliyorum.

package/workspace/memory/backlog/BXX-[bug-name].md

@@ -1,2 +0,0 @@
-> [!NOTE]
-> Bu şablon `workspace/templates/BXX-[bug-name].md` adresine taşınmıştır.

package/workspace/memory/backlog/DXX-[debt-name].md

@@ -1,2 +0,0 @@
-> [!NOTE]
-> Bu şablon `workspace/templates/DXX-[debt-name].md` adresine taşınmıştır.

package/workspace/memory/backlog/README.md

@@ -1,31 +0,0 @@
-# Backlog Klasörü
-
-Backlog item dosyalarının tutulduğu klasör.
-
-## Dashboard'lar
-- `epic-dashboard.md` — Aktif epic'lerin durum tablosu
-- `version-dashboard.md` — Sürüm planlama tablosu
-- `debt-dashboard.md` — Teknik borç tablosu
-
-## Item Dosyaları
-Item dosyaları prefix'lerle adlandırılır:
-- `TXX-` — Task (geliştirme görevi)
-- `BXX-` — Bug (hata)
-- `DXX-` — Debt (teknik borç)
-- `EXX-` — Epic (büyük iş kalemi)
-- `SXX-` — Spike (araştırma)
-- `HXX-` — Hotfix (production yaması)
-
-## Templates
-Yeni item oluşturmadan önce `../../../workspace/templates/` altındaki şablonları kullan:
-- `TXX-[task-name].md`
-- `BXX-[bug-name].md`
-- `DXX-[debt-name].md`
-- `EXX-[epic-name].md`
-- `SXX-[spike-name].md`
-- `HXX-[hotfix-name].md`
-
-Veya `scripts/kortext-backlog-add.py` ile otomatik oluştur.
-
-## Doğrulama
-Bu klasörün bootstrap'i `scripts/kortext-consistency-check.py` tarafından doğrulanır. Yukarıdaki üç dashboard dosyası eksik olursa kontrol başarısız olur.

package/workspace/memory/backlog/TXX-[task-name].md

@@ -1,2 +0,0 @@
-> [!NOTE]
-> Bu şablon `workspace/templates/TXX-[task-name].md` adresine taşınmıştır.

package/workspace/memory/backlog/debt-dashboard.md

@@ -1,3 +0,0 @@
-| **ITEM** | **Assignee** | **Status** |
-| :--- | :--- | :--- |
-| [debt-id]: [debt-name] | [+ajan] | [status] |

package/workspace/memory/backlog/epic-dashboard.md

@@ -1,10 +0,0 @@
-> [!INFO] [epic-id]: [epic-name]
-> **Goal:** [epic-goal]
-> **Assignee:** [+ajan]
-> **Status:** [To do|In progress|Done]
-> **Version:** v[x.x]: [version-name]
-
-| **ITEM** | **Title** | **Epic** | **Assignee** | **Status** |
-| :--- | :--- | :--- | :--- | :--- |
-| [task-id] | [task-name] | [epic-id] | [+ajan] | [status] |
-| [bug-id] | [bug-name] | [epic-id] | [+ajan] | [status] |

package/workspace/memory/backlog/version-dashboard.md

@@ -1,7 +0,0 @@
-> [!INFO] v[x.x]: [version-name]
-> **Goal:** [version-goal]
-> **Status:** [To do|In progress|Done]
-
-| **ITEM** | **Assignee** | **Status** |
-| :--- | :--- | :--- |
-| [epic-id]: [epic-name] | [+ajan] | [status] |

package/workspace/memory/context/README.md

@@ -1,35 +0,0 @@
-# Context Klasörü
-
-Aktif ajanların distributed context dosyalarının tutulduğu klasör.
-
-## Yapı
-Her ajan kendi context dosyasına yazar:
-- `[agent-name]-active.md` — Örn. `backend-developer-active.md`, `qa-engineer-active.md`
-
-Şablon: `../../templates/[agent-name]-active.md`
-
-## Yaşam Döngüsü
-1. Ajan göreve başladığında dosyayı oluşturur.
-2. Görev süresince ilerleme bu dosyaya yazılır.
-3. Görev kapanışında dosya **silinir**, handover özeti `../handover.md`'ye taşınır.
-
-## Stale Threshold
-Aktif context dosyalarının "stale" sayılma eşiği: **24 saat** (`KORTEXT_STALE_HOURS_CONTEXT` env var).
-
-Stale dosyalar `scripts/kortext-session-start.py` ve `scripts/kortext-context-check.py` tarafından raporlanır.
-
-## Lock Mekanizması
-Bu klasörde aynı anda birden fazla ajanın yazmasını önlemek için `scripts/kortext-lock.py` kullanılır:
-```bash
-python3 scripts/kortext-lock.py acquire --file workspace/memory/context/backend-developer-active.md --agent backend-developer
-# ... iş yap ...
-python3 scripts/kortext-lock.py release --file workspace/memory/context/backend-developer-active.md
-```
-
-## Format
-Standart context satır formatı:
-```
-### +persona | TXX | Status | HH:MM | kısa özet
-```
-
-Tek bir ajan için birden fazla `-active.md` dosyası bulunması bir hatadır; `kortext-context-check.py` bunu DUPLICATE CONTEXT olarak raporlar.

package/workspace/memory/context/[agent-name]-active.md

@@ -1,2 +0,0 @@
-> [!NOTE]
-> Bu şablon `workspace/templates/[agent-name]-active.md` adresine taşınmıştır.

package/workspace/memory/decisions.md

@@ -1,17 +0,0 @@
-# Architectural Decision Records (ADR)
-
-## ADR-[ID]: [ADR Title]
-**Author:** [+ajan] | **Status:** [Waiting], [`Approved/Rejected` | [YYYY-MM-DD:HH:MM]] | **Approver:** [+ajan]
-
-### Context
-
-- [Kararın veya problemin arka planı, neden böyle bir karar alınmasına ihtiyaç duyulduğu]
-
-### Decision
-
-- [Alınan teknik/süreçsel karar ve uygulanacak yöntem]
-
-### Consequences
-
-- [Olumlu sonuçlar ve avantajlar]
-- [Kararın getirdiği yükümlülükler, dezavantajlar veya teknik borçlar]