kortext 2.2.3 → 3.1.0

package/workspace/memory/handover.md

@@ -1,40 +0,0 @@
-# Handover Reports
-
-> [!TODO]
-> - Kullanım Kuralı: Yeni kayıtlar dosyanın **en üstüne** eklenir; eski kayıtlar silinmez.
-> - Her görev kapanışında doldurulması zorunludur — handover tamamlanmadan görev Done'a çekilemez.
-> - Oturum başlangıcında bu dosyayı `kortext-session-start.py` ile özetle: `python scripts/kortext-session-start.py`
-
-<!-- ŞABLON — kopyala, doldur, bu yorum satırını sil -->
-## Handover: [task-id] — [task-name]
-
-> [!INFO]
-> - **Author:** [+ajan] 
-> - **To:** [devralan +ajan veya "Yok" — görev Done]
-> - **Date:** [DD.MM.YY-HH:MM]
-> - **Status:** [Tamamlandı / Bloklandı / Kısmen tamamlandı]
-
-### ✅ Completed *(zorunlu)*
-
-- [Ne yapıldı? Tek cümleyle özetle, gerekirse madde madde.]
- 
-### Changed Files *(zorunlu)*
-
-- `[dosya-yolu]` — [ne değişti]
-
-### Kritik Bağlam *(zorunlu — en az 1 madde)*
-
-- [Bir sonraki ajanın **mutlaka** bilmesi gereken bilgi. Workaround, kritik bağımlılık, beklenmedik davranış, alınan karar. Boş bırakma — "Yok" yaz.]
-
-### Watch-outs & Decisions *(varsa)*
-
-- [Kırılgan nokta, teknik borç, ileride sorun çıkabilecek alan. `workspace/memory/decisions.md`'ye referans ver.]
-
-### Last Commit *(zorunlu)*
-
-- `[commit-hash]` — `[commit-mesajı]`
-
-### Next Steps *(zorunlu)*
-
-- [Devralan ajan ne yapacak? Yoksa "Yok" yaz — boş bırakma.]
-

package/workspace/memory/learned.md

@@ -1,21 +0,0 @@
-# Knowledge Base
-
-## Öğrenim: [Hata/Problem Başlığı veya Konu]
-
-**Author:** [+ajan] | **Status:** [Waiting], [`Approved/Rejected` | [YYYY-MM-DD:HH:MM]] | **Approver:** [+ajan]
-
-### Problem
-
-- [Yaşanan sorunun veya tespit edilen eksikliğin ne olduğu]
-
-### Root Cause
-
-- [Sorunu oluşturan kök sebep (Örn: Yanlış package versiyonu, eksik config vb.)]
-
-### Solution
-
-- [Uygulanan çözüm yolu (Çalıştırılan komutlar, güncellenen dosya yolları vb.)]
-
-### Prevention
-
-- [Bu hatanın bir daha yaşanmaması için projeye dahil edilen kural veya önlemler]

package/workspace/references/access.md

@@ -1,47 +0,0 @@
----
-status: uninitialized
-owner: +operation-manager
-last_review: 2026-05-17
----
-
-# Access & Service Configuration
-
-> [!INFO]
-> - status: [draft/approved] | [DD.MM.YY-HH:MM]
-> - author: +devops-engineer, +prime
-> - approver: +prime
-
----
-
-## Lokal Geliştirme Araçları
-
-- [Araç adı] — [kurulum notu]
--  [MCP Sunucu adı] — [kurulum notu]
-
-## Versiyon Kontrolü
-
-- GitHub Repo: [+prime dolduracak]
-- Organization: [+prime dolduracak]
-
-## Hosting & Deployment
-
-- Production URL: [+prime dolduracak]
-- Staging URL: [+prime dolduracak]
-- Platform: [Firebase Hosting / Vercel / AWS]
-
-## Sunucu Erişimi
-
-- SSH Root: [+prime dolduracak]
-- Domain: [+prime dolduracak]
-
-## Veritabanı
-
-- Provider: [Firebase / Supabase / PostgreSQL]
-- Production Instance: [+prime dolduracak]
-- Staging Instance: [+prime dolduracak]
-
-## Diğer Servisler
-
-- Analytics: [Google Analytics / Mixpanel]
-- CDN: [Cloudflare]
-- Mail: [SendGrid / Resend]

package/workspace/references/api-reference.md

@@ -1,59 +0,0 @@
----
-status: uninitialized
-owner: +engineering-manager
-last_review: 2026-05-17
----
-
-# API Reference
-
-> [!INFO]
-> - status: [draft/approved] | [DD.MM.YY-HH:MM]
-> - author: +engineering-manager
-> - reviewer: +backend-developer
-
----
-
-## Authentication
-
-- **Type:** [Örn: Bearer Token, OAuth2, API Key]
-- **Headers:** 
-
-## Base URLs
-
-- **Production:** `https://api.example.com/v1`
-- **Staging/Test:** `https://staging-api.example.com/v1`
-
-## Endpoints
-
-### [Modül Adı / Grup Adı]
-#### `GET /path/to/resource` (Açıklama)
-- **Parameters / Query:**
-- `param` (type): [Açıklama]
-- **Request Body:** (Eğer varsa)
-```json
-{
-  "key": "value"
-}
-```
-- **Response Data (Success 2xx):**
-```json
-{
-  "data": "value"
-}
-```
-- **Response Data (Error 4xx/5xx):**
-```json
-{
-  "error": "Message"
-}
-```
-
-## Error Codes & Formatting
-
-- **200:** Success
-- **400:** Bad Request
-- **401:** Unauthorized
-- **403:** Forbidden
-- **404:** Not Found
-- **500:** Internal Server Error
-- vb.

package/workspace/references/blueprint.md

@@ -1,29 +0,0 @@
----
-status: uninitialized
-owner: +prime
-last_review: 2026-05-17
----
-
-# Product Roadmap & Vision
-
-> [!INFO]
-> - status: [draft/approved] | [DD.MM.YY-HH:MM]
-> - author: +prime
-
----
-
-## Product Vision & Goals
-
-- [Ürünün ana amacı ve vizyonu]
-
-## Target Audience & Personas
-
-- [Hangi kullanıcı kitlelerine hitap ediliyor?]
-
-## Key Performance Indicators (KPIs)
-
-- [Başarı kriterleri nelerdir?]
-
-## Future Scope & Out of Scope
-
-- [Neler kapsam dışında?]

package/workspace/references/content-strategy.md

@@ -1,39 +0,0 @@
----
-status: uninitialized
-owner: +copywriter
-last_review: 2026-05-17
----
-
-# Content Strategy & Microcopy
-
-> [!INFO]
-> - status: [draft/approved] | [DD.MM.YY-HH:MM]
-> - author: +copywriter
-> - approver: +prime
-
----
-
-## Brand Voice & Tone
-
-- **Tone:** [Örn: Profesyonel, Samimi, Neşeli, Ciddi]
-- **Dos & Don'ts:** 
- - **Yap:** [Örn: Kullanıcıyı yönlendirici basit cümleler kur]
- - **Yapma:** [Örn: Aşırı teknik jargona boğma]
-
-## Microcopy (UI Interface Texts)
-
-- **Primary Buttons:** [Örn: 'Devam Et', 'Kaydet', 'Hemen Başla']
-- **Secondary Buttons:** [Örn: 'İptal', 'Geri Dön']
-- **Empty States:** [Örn: 'Henüz burada kayıt yok, ilk kaydı oluştur!']
-- **Success Messages:** [Örn: 'Başarıyla kaydedildi.']
-
-## Error Messages
-
-- **Validation Errors:** [Örn: 'Bu alan zorunludur.', 'Geçersiz e-posta formatı.']
-- **Server/System Errors:** [Örn: 'Sunucuya bağlanılamadı, lütfen tekrar deneyin.']
-
-## Email & Notification Templates
-
-### [Bildirim Türü / Senaryo]
-- **Subject / Başlık:** 
-- **Body / İçerik:**

package/workspace/references/db-schema.md

@@ -1,51 +0,0 @@
----
-status: uninitialized
-owner: +db-admin
-last_review: 2026-05-17
----
-
-# Database Schema
-
-> [!INFO]
-> - status: [draft/approved] | [DD.MM.YY-HH:MM]
-> - author: +db-admin
-> - approver: +engineering-manager
-
----
-
-## Database Overview
-
-- **Database Engine:** [Örn: PostgreSQL, MongoDB]
-- **ORM / ODM:** [Örn: Prisma, Mongoose]
-- **Migrations Tool:** [Örn: Prisma Migrate, TypeORM]
-
-## Conventions & Standards
-
-- **Table Naming:** [Örn: snake_case (çoğul)]
-- **Column Naming:** [Örn: snake_case / camelCase]
-- **Primary Keys:** [Örn: UUID / Auto-increment integer]
-- **Timestamps:** `created_at`, `updated_at` (Zorunlu)
-
-## Entity-Relationship (ERD) Structure
-
-### Table: `[table_name]`
-- **Description:** [Tablonun işlevi]
-- **Columns:**
-- `id` (PK, UUID)
-- `[column_name]` ([type], [nullable/unique]) - [Description]
-- **Relations:** 
-- `[FK/Relation]` -> `[Related Table]`
-
-### Table: `[table_name_2]`
-- **Description:** [Tablonun işlevi]
-- **Columns:**
-- `id` (PK)
-...
-
-## Indexes & Performance Optimizations
-
-- **[table_name]:** `[column_name]` (Index Type) -> Nedeni
-
-## Security Policies / Row-Level Security
-
-- [Örn: RLS Kuralları, Hassas verilerin şifrelenmesi]

package/workspace/references/design-system.md

@@ -1,107 +0,0 @@
----
-status: uninitialized
-owner: +designer
-last_review: 2026-05-17
----
-
-# Design System (Strict & Tokenized Specification)
-
-> [!INFO]
-> - status: [draft/approved] | [DD.MM.YY-HH:MM]
-> - author: +designer
-> - reviewer: +frontend-developer
-> - approver: +prime
-
----
-
-## Core Tokens (Atomic Values)
-
-> [!WARNING] **FE KURALI:**
->  Kod içerisinde ham değer (HEX, px, rem) kullanımı yasaktır. Sadece aşağıdaki değişken isimleri kullanılacaktır.
-
-### Color Palette & Functional Mapping
-
-| Token Name | HEX / RGB | Usage Context |
-| :--- | :--- | :--- |
-| `--color-bg-main` | `[VALUE]` | Sayfa ana arka planı |
-| `--color-bg-surface` | `[VALUE]` | Kartlar, modallar, section'lar |
-| `--color-text-base` | `[VALUE]` | Standart metin içeriği |
-| `--color-text-muted` | `[VALUE]` | Placeholder, yardımcı metinler |
-| `--color-primary` | `[VALUE]` | Ana butonlar, aktif linkler |
-| `--color-primary-hover`| `[VALUE]` | Hover durumu (Zorunlu) |
-| `--color-border` | `[VALUE]` | Ayırıcı çizgiler ve input border |
-| `--color-success` | `[VALUE]` | Başarı mesajları ve ikonları |
-| `--color-error` | `[VALUE]` | Hata mesajları ve input hata durumu |
-
-### Spacing Scale (8px Grid Rule)
-
-> [!WARNING] **FE KURALI:**
->  Margin ve Padding değerleri sadece bu skaladan seçilebilir. Ara değer (13px, 7px vb.) kullanımı yasaktır.
-
-- `--space-unit`: `8px`
-- `--space-xs`: `4px`  (0.5x)
-- `--space-sm`: `8px`  (1x)
-- `--space-md`: `16px` (2x)
-- `--space-lg`: `24px` (3x)
-- `--space-xl`: `32px` (4x)
-- `--space-2xl`: `48px` (6x)
-
----
-
-## Typography (The Vertical Rhythm)
-
-> [!WARNING] **FE KURALI:**
-> Font-size tek başına yeterli değildir. Line-height ve Weight değerleri her rol için sabittir.
-
-| Role | Font-Family | Size (px) | Line-Height | Weight | Letter-Spacing |
-| :--- | :--- | :--- | :--- | :--- | :--- |
-| `H1` | `[Family]` | `40px` | `1.2` | `700` | `-0.02em` |
-| `H2` | `[Family]` | `32px` | `1.2` | `600` | `-0.01em` |
-| `Body` | `[Family]` | `16px` | `1.5` | `400` | `normal` |
-| `Small` | `[Family]` | `12px` | `1.4` | `400` | `0.01em` |
-| `Label` | `[Family]` | `14px` | `1` | `500` | `0.02em` |
-
----
-
-## Layout & Grid (Structural Constraints)
-
-| Property | Value | Description |
-| :--- | :--- | :--- |
-| `--container-max` | `1200px` | İçeriğin merkezleneceği maksimum genişlik |
-| `--gutter` | `24px` | Sütunlar arası boşluk |
-| `--screen-sm` | `640px` | Mobile breakpoint |
-| `--screen-md` | `768px` | Tablet breakpoint |
-| `--screen-lg` | `1024px` | Desktop breakpoint |
-| `--safe-area` | `16px` | Mobil cihazlar için minimum kenar boşluğu |
-
----
-
-## UI Components (Strict Atoms)
-
-### Buttons
-- **Border-Radius:** `--radius-btn`: `[px]`
-- **Heights:** `Small: 32px`, `Default: 44px`, `Large: 56px`
-- **States (Zorunlu):**
-- *Focus:* `outline: 2px solid --color-primary`, `offset: 2px`
-- *Active:* `transform: scale(0.98)`
-- *Disabled:* `opacity: 0.5`, `cursor: not-allowed`
-
-### Inputs
-- **Border:** `1px solid --color-border`
-- **Focus State:** `border-color: --color-primary`, `box-shadow: [Value]`
-- **Border-Radius:** `--radius-input`: `[px]`
-
-### Effects & Elevation
-- `--shadow-sm`: `[CSS Box Shadow Value]`
-- `--shadow-md`: `[CSS Box Shadow Value]`
-- `--transition-base`: `all 0.2s ease-in-out`
-
----
-
-##  Technical Implementation Directives (Red Lines)
-
-1. **No Magic Numbers:** Tasarımda tanımlı olmayan her değer reddedilecektir. Yapmadan önce danışın.
-2. **Icon Mapping:** Sadece `[İkon Seti Adı]` kütüphanesi kullanılacaktır. İkon boyutları `16/24/32px` dışında olamaz.
-3. **Variable Injection:** Designer bu dosyayı onayladığında, +frontend-developer tüm değerleri `CSS Variables` veya `Tailwind Config` dosyasına aktaracaktır.
- 4. **Consistency:** Tüm "shadow", "blur" ve "transition" değerleri bu dosyada belirtilen CSS kodları dışında yazılamaz.
- 5. **Zero Tolerance for Hardcoding:** CSS dosyalarında HEX kodu tespiti kritik hata (Blocker) sayılacaktır.

package/workspace/references/dictionary.md

@@ -1,42 +0,0 @@
----
-status: uninitialized
-owner: +engineering-manager
-last_review: 2026-05-17
----
-
-# Coding Dictionary & Standards
-
-> [!INFO]
-> - status: [draft/approved] | [DD.MM.YY-HH:MM]
-> - author: +engineering-manager
-> - approver: +prime
-
----
-
-## Naming Conventions
-
-- **Variables & Functions:** [`camelCase, snake_case`]
-- **Classes & Interfaces:** [`PascalCase`]
-- **Constants:** [`UPPER_SNAKE_CASE`]
-- **Files & Directories:** [`kebab-case`]
-- **Database Tables:** [`snake_case, plural/singular`]
-
-## Code Quality & Formatting
-
-- **Linter & Formatter:** [Örn: ESLint + Prettier ayarları]
-- **Indent:** [Örn: 2 spaces]
-- **Quote Mark:** [Örn: Single quotes ('')]
-
-## Project Terminology (Domain Language)
-
-- **[Kullanılan Terim]:** [Açıklama / Bizim uygulamamızdaki anlamı]
-- *Örnek:* **Client:** Uygulamayı kullanan müşteri (User demeyeceğiz).
-- *Örnek:* **Cart:** Alışveriş sepeti (Basket demeyeceğiz).
-
-## Commenting & Documentation Rules
-
-- [Örn: JSDoc kullanılacak, kodun "ne" yaptığı değil, "neden" yaptığı yorumlanacak]
-
-## Error Handling Pattern
-
-- [Genel try/catch veya error response fırlatma standartları]

package/workspace/references/file-system.md

@@ -1,42 +0,0 @@
----
-status: uninitialized
-owner: +engineering-manager
-last_review: 2026-05-17
----
-
-# File System & Architecture
-
-> [!INFO]
-> - status: [draft/approved] | [DD.MM.YY-HH:MM]
-> - author: +engineering-manager
-> - approver: +prime
-
----
-
-## High-Level Folder Structure
-
-```
-[Project Root]/
-├── src/
-│   ├── components/    → [Açıklama]
-│   ├── pages/         → [Açıklama]
-│   ├── utils/         → [Açıklama]
-│   └── api/           → [Açıklama]
-├── public/            → [Açıklama]
-└── [Config Files]     → (package.json, tsconfig.json vb.)
-```
-
-## Directory Rules
-
-- [**`/components/`:** Yalnızca tekrar kullanılabilir UI elemanlarını barındırır.]
-- [**`/pages/` veya `/app/`:** Sadece sayfa/route yönetimini barındırır.]
-- [**`/utils/`:** Saf (pure) yardımcı fonksiyonlar bulunur (state içermez).]
-
-## Path Aliases
-
-- [Örn: `@components/*` -> `src/components/*`]
-- [Örn: `@utils/*` -> `src/utils/*`]
-
-## Feature-Based vs Type-Based Structure
-
-- [Projenin yapısı (domain-driven, feature-sliced, vb.) hangisine uyacaksa açıklaması]

package/workspace/references/growth-strategy.md

@@ -1,46 +0,0 @@
----
-status: uninitialized
-owner: +growth-expert
-last_review: 2026-05-17
----
-
-# Growth & Analytic Strategy
-
-> [!INFO]
-> - status: [draft/approved] | [DD.MM.YY-HH:MM]
-> - author: +growth-expert
-> - approver: +prime
-
----
-
-## Analytics Goals & Metrics
-
-- **Kuzey Yıldızı Metriği (North Star):** [Temel başarı ölçütü, örn: Aktif İşlem Yapan Kullanıcı]
-- **Birincil Hedefler:** [Örn: %10 dönüşüm oranı, Günlük 5K MAU]
-
-## Tracking Setup & Tools
-
-- **Analitik Araçları:** [Örn: Google Analytics 4, Mixpanel, Amplitude]
-- **Tag Yönetimi:** [Örn: Google Tag Manager (GTM)]
-- **Hata Takibi:** [Örn: Sentry, Datadog]
-
-## Key Events to Track (Event Taxonomy)
-
-[Tüm olaylar (events) aşağıdaki örnek gibi isimlendirme kurallarına (Örn: `Object_Action`) uymalıdır.]
-[- `user_signed_up`: Kullanıcı başarılı kayıt olduğunda (**Parameters:** method, tier)]
-[- `purchase_completed`: Kullanıcı ödeme yaptığında (**Parameters:** amount, currency)]
-[- `[event_name]`: [Tetiklenme durumu ve parametreleri]]
-
-## SEO & ASO Strategy
-
-- **On-Page SEO:** [H1 etiketleri, meta description kuralları, schema.org yapısı]
-- **URL Structure:** [Örn: /kategori/urun-adi (Kebab-case, SEO friendly)]
-- **Sitemap & Robots.txt:** [Oluşturulma ve endeksleme politikası]
-
-## User Acquisition & Funnel
-
-- [A/B Test planları, funnel aşamaları (Acquisition, Activation, Retention...)]
-
-## Epics & Tasks
-
-[`workspace/memory/backlog/` altındaki düz backlog yapısına eklenecek Epic ve görev listesi (ölçümleme araçlarının entegrasyonu, eventlerin eklenmesi, SEO/GEO için yapılması gerekenler vb.)]

package/workspace/references/legal-strategy.md

@@ -1,35 +0,0 @@
----
-status: uninitialized
-owner: +compliance-expert
-last_review: 2026-05-17
----
-
-# Legal & Compliance Strategy
-
-> [!INFO]
-> - status: [draft/approved] | [DD.MM.YY-HH:MM]
-> - author: +compliance-expert
-> - approver: +prime
-
----
-
-## Compliance Scope
-
-[Projenin kapsamına göre uyum hedefleri (KVKK, GDPR, CCPA vb.)]
-
-## Identified Risks (Risk Analizi)
-
-- [Risk durumu - Örn: Kullanıcının konum bilgisinin açık tutulması]
-
-## Required Approvals & Consents
-
-- [Örn: Kayıt olurken Gizlilik Sözleşmesi Onayı (Zorunlu)]
-- [Çerez Yönetimi (Cookie Policy) nasıl kurgulanacak?]
-
-## Technical Integration Requests
-
-- [Örn: Veritabanındaki `password` ve `tc_no` alanları mutlaka Hash'lenmeli.]
-
-## Epics & Tasks
-
-[`workspace/memory/backlog/` altındaki düz backlog yapısına eklenecek Epic ve görev listesi]

package/workspace/references/required-skills.md

@@ -1,11 +0,0 @@
----
-status: uninitialized
-owner: +operation-manager
-last_review: 2026-05-17
----
-
-| **AJAN** | **AJAN** |  **AJAN** | **AJAN** |
-| :---: | :---: | :---: |:---:|
-|  [skill] | [skill] | [skill] | [skill] |
-|  [skill] | [skill] | [skill] | [skill] |
-|  [skill] | [skill] | [skill] | [skill] |

package/workspace/references/security-rules.md

@@ -1,34 +0,0 @@
----
-status: uninitialized
-owner: +security-engineer
-last_review: 2026-05-17
----
-
-# Security Rules
-
-> [!INFO]
-> - status: [draft/approved] | [DD.MM.YY-HH:MM]
-> - author: +security-engineer
-> - approver: +engineering-manager
-
----
-
-## Security Overview
-
-- [Projenin kullanacağı tech stack raporu özeti ve bulguları]
-- [Dikka edilmesi gereken konular]
-
-## Vulnerability Findings
-
-| Risk Level | Finding | Description | Recommendation |
-|---|---|---|---|
-| [High/Med] | [Örn: XSS açığı] | [Hangi dosyada, nasıl oluşuyor] | [Çözüm önerisi] |
-| [Low] | [Örn: Outdated package] | [Eski kütüphane] | [Update npm package] |
-
-## Action Plan
-
-- [Bulgular doğrultusunda analiz aşamasında yapılması gerekenler]
-
-## Security Rules
-
-- [Proje genelinde uyulacak olan güvenlik kuralları]

package/workspace/references/tech-stack.md

@@ -1,49 +0,0 @@
----
-status: uninitialized
-owner: +engineering-manager
-last_review: 2026-05-17
----
-
-# Tech Stack & Infrastructure
-
-> [!INFO]
-> - status: [draft/approved] | [DD.MM.YY-HH:MM]
-> - author: +engineering-manager
-> - approver: +prime
-
----
-
-## Core Technologies
-
-- **Frontend:** [Dil, Framework, Sürüm — Örn: TypeScript, React 18, Next.js 14, Kotlin, SwiftUI]
-- **Backend:** [Dil, Framework, Sürüm — Örn: Node.js 20, NestJS]
-- **Database:** [Veritabanı, Sürüm — Örn: PostgreSQL 16, Redis]
-
-## Architecture Pattern
-
-- [Örn: Mikroservis mi, Monolit mi, Serverless mı? Hangi dizayn (MVC vb) kullanılacak?]
-
-## Tooling & Prerequisites
-
-- **Package Manager:** [Örn: npm, yarn, pnpm]
-- **Environment:** [Örn: Docker Desktop, Node v20+]
-- **Testing:** [Örn: Jest, Cypress, Playwright]
-- **Tools:** [Örn: Postman, Antigravity vb.]
-- **MPC's:** [Örn: Vercel MCP, Firebase MCP]
-
-## Infrastructure & Deployment (CI/CD)
-
-- **Cloud Provider:** [Örn: AWS, Vercel, Google Cloud]
-- **CI/CD Platform:** [Örn: GitHub Actions, GitLab CI]
-- **Containerization:** [Örn: Docker]
-
-## Third-Party Services & Integrations
-
-- **Auth:** [Örn: Firebase, NextAuth, Auth0]
-- **Payments:** [Örn: Stripe, Iyzico]
-- **Storage/CDN:** [Örn: AWS S3, Cloudflare]
-
-## Security & Policies
-
-- [Hassas verilerin nasıl saklanacağı, özel gitignore kuralları vb.]
-- [Güvenlik Kuralları: `workspace/references/security-rules.md`]