kortext 3.0.0 → 3.1.0

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/.locks/workspace_handover.md.lock

@@ -1,3 +0,0 @@
-agent: agent1
-file: workspace/handover.md
-time: 2026-05-17T22:12:37.416963

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]

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.