@azerogluemin/ai-bootstrap 0.2.1

package/templates/skills/youtube-thumbnail-designer/knowledge/topic-enrichment-research.md

@@ -0,0 +1,241 @@
+# Topic-Specific Enrichment Research — Per-Thumbnail Protocol (Sərt qayda)
+
+> Stylistics.md **brand DNA** (locked palette, font, composition) verir — bütün thumbnail-larda eyni. Lakin hər thumbnail-ın **konkret mövzusu** unikal vizual zənginləşdirmə tələb edir: topic-specific colors, icons, props, location-specific elements. **Template tətbiqi qadağan** — hər thumbnail üçün **research-driven enrichment** məcburidir.
+
+## Fundamental qayda
+
+Stylistics-də locked olanlar **invariant** (hər thumbnail-da eyni):
+- Brand palette (məs. yellow + black + white)
+- Brand font family (məs. Bangers / Anton)
+- Brand composition formulas (3 variant formula)
+- Safe zones, host identity, logo position
+
+Hər thumbnail-da əlavə olunan **topic enrichment** (variant):
+- Topic-spesifik **icon və ya badge** (məs. ⚽ futbol üçün, ₼ qiymət üçün, ⚠️ trafik üçün)
+- Topic-spesifik **color accent** (məs. Real Madrid white-navy-gold, fitness energy orange, finance green)
+- Topic-spesifik **prop və ya small image** (məs. trophy silhouette, gym dumbbell, microphone, dollar bill)
+- Topic-spesifik **background location** (məs. specific stadium, specific Bakı intersection, specific brand context)
+- Topic-spesifik **cultural references** (məs. Azerbaijani manat symbol ₼, AZ flag, regional architecture)
+
+Template + topic enrichment = world-class thumbnail. Yalnız template = amateur.
+
+---
+
+## Per-thumbnail research procedure (4 addım)
+
+### Addım 1 — Topic extraction (transkriptdən / ssenaridən)
+
+Hər variant üçün **mövzu specifics** çıxarılır:
+- Konkret event nədir? (məs. "Real Madrid biz olardıq" → Real Madrid Champions League referencesi)
+- Konkret yer adı var? (məs. "28 mol qarşısı" → Bakı 28 May metro intersection)
+- Konkret brand / şəxs / qrup var? (məs. "Tramp atışma" → Trump campaign event)
+- Konkret obyekt var? (məs. "parikinə güvənib oğurluq" → wig, theft props)
+- Konkret rəqəm / valyuta? (məs. "200 manat" → AZ manat symbol ₼)
+- Konkret mədəni reference? (məs. "Çempionlar Liqası" → UEFA CL trophy, stars, sound effect)
+
+### Addım 2 — Visual research (lazım gəlsə WebSearch)
+
+Mövzu spesifik vizual elementlər araşdırılır:
+
+**Sport teams / clubs:**
+- Kit colors (məs. Real Madrid = white kit, navy crest, gold accents)
+- Stadium aesthetic (məs. Bernabéu interior, Camp Nou)
+- Trophy / cup specific (məs. UEFA CL big-ear trophy, FA Cup)
+- Iconic numbers (məs. Real Madrid "15" CL titles, Jordan #23)
+
+**Brands / products:**
+- Brand colors (məs. Apple = silver/space-grey, Samsung = blue, Tesla = red-white)
+- Product silhouettes
+- Logo aesthetics (lakin CLAUDE.md "Brand logo qaydası" — POST-COMPOSITE only, AI generation-da yox)
+
+**Geographic locations:**
+- City-specific architecture (məs. Bakı = Flame Towers, Soviet-era apartments, boulevard)
+- Specific intersections / landmarks (məs. 28 May metro, Fountain Square, Nizami küç)
+- Cultural specifics (məs. armudu istəkanı, kimono, traditional clothing)
+- Per CLAUDE.md "Geographic/Landmark accuracy research" — internet research **məcburi** specific location varsa
+
+**Cultural / national:**
+- National colors (məs. AZ flag = mavi-qırmızı-yaşıl)
+- Currency symbols (məs. ₼ AZ manat, ₺ TR lira, $ USD)
+- Traditional objects (məs. samovar, tar, lavash)
+- Local idioms / catchphrases (məs. "Ay millət")
+
+**Topic categories (icons / colors):**
+- Money / finance → ₼ $ € ₿ + green (gain) / red (loss) / gold
+- Time / urgency → ⏰ ⏳ + countdown red
+- Safety / warning → ⚠️ ⛔ + yellow-black hazard
+- Sport → ⚽ 🏀 🏆 + team colors
+- Food → 🍞 🍕 + warm appetizing tones
+- Tech → 🖥️ 📱 🔋 + dark + brand colors
+- Travel → ✈️ 📍 🗺️ + sky blue + sunset
+- Music → 🎤 🎵 + neon stage lights
+- Health → 💊 💉 🩺 + clinical white + green
+- Politics → 🏛️ 🇦🇿 + national colors
+
+### Addım 3 — Decision matrix (nə əlavə olunur, nə yox)
+
+Hər topic element üçün soruş:
+
+| Element | Əlavə et? |
+|---|---|
+| Topic recognition-i instant artırırmı? | ✅ ƏLAVƏ ET |
+| Composition artıq doludursa və element bloklayır? | ❌ ETMƏ |
+| Element təkrardırsa (host artıq tutur, bg artıq göstərir)? | ❌ ETMƏ |
+| Element generic emoji clip-art görünür? | ❌ Custom vector formatda yenidən düşün, yoxsa skip |
+| Element cultural confusion / insensitivity yaradır? | ❌ ETMƏ |
+| Element brand-specific (məs. real Real Madrid logo)? | ❌ AVOID — generic reference istifadə et (məs. "white kit football team" not "Real Madrid logo") — CLAUDE.md "Brand logo qaydası" tətbiq |
+
+Bu icon-and-graphic-elements.md decision matrix ilə birgə işləyir, lakin **fərqli scope**: bu fayl mövzu-spesifik enrichment, o fayl ümumi icon usage.
+
+### Addım 4 — Prompt-a inteqrasiya
+
+Seçilən topic enrichment elementlər prompt-a **konkret olaraq** yazılır:
+
+```
+TOPIC ENRICHMENT (this thumbnail's specific elements):
+- Color accent (topic-derived): <hex + topic justification>
+  e.g. "#FFD700 gold (Champions League trophy / Real Madrid era reference)"
+- Background topic anchor: <specific scene + topic justification>
+  e.g. "blurred white-clad football team celebrating with silver big-ear trophy, golden stadium lights — generic enough to suggest Real Madrid energy without team logo"
+- Icon / badge (if applicable): <description + position + topic justification>
+  e.g. "small gold star badge with '15' (Champions League titles count reference) — top-right area, 8% frame height"
+- Prop / object: <description if needed>
+  e.g. "subtle trophy silhouette in background gradient"
+- Cultural specific: <description if needed>
+  e.g. "Azerbaijani manat ₼ currency symbol on price-related text"
+```
+
+---
+
+## Per-thumbnail example walkthroughs
+
+### Example 1 — Variant B "REAL MADRİD BİZ OLARDIQ!" (cvn-ay-millet)
+
+**Topic extraction:** "Real Madrid" = Spanish football club, Champions League dominant, 15 CL titles, white kit ("Los Blancos"), Bernabéu stadium
+
+**Visual research:**
+- Real Madrid kit: white shirts + white shorts (full white identity)
+- Crest colors: navy blue (#001D3D) + gold (#FFD700) + red accent
+- Champions League trophy: silver "big-ear" trophy
+- Bernabéu stadium: white-trimmed iconic stadium
+- Iconic number reference: "15" CL titles (as of 2024-2025)
+- Madrid city colors: red + gold (Madrid flag)
+
+**Decision matrix:**
+- ✅ Background: generic European football stadium aerial with white-clad players celebrating with silver trophy (suggests Real Madrid without team branding)
+- ✅ Color accent: **GOLD #FFD700** (CL trophy color) instead of generic stylistics yellow — topic-specific signal
+- ✅ Star/number element: subtle "15" or star pattern in background (CL anthem stars reference)
+- ❌ Real Madrid actual logo (brand legal risk + AI logo fidelity issue)
+- ❌ Specific player faces (recognizable likeness issue)
+- ❌ White football emoji ⚽ (redundant with background)
+
+**Prompt enrichment add:**
+- Topic color: #FFD700 GOLD (CL trophy) — punchline word "REAL MADRİD" in gold instead of generic yellow
+- Topic bg: white-uniformed football team celebrating silver big-ear trophy in golden stadium lights
+- Topic prop: faint star pattern in background gradient (CL Champions anthem stars)
+
+### Example 2 — Variant A "İKİ GÜN ARD-ARDA?!" (pedestrian fine repeat)
+
+**Topic extraction:** Repeated pedestrian fine offender, Bakı central intersection (transcript mentions "28 mol qarşısı" = 28 May metro intersection)
+
+**Visual research:**
+- Bakı 28 May metro intersection: central busy multi-lane road, traffic light, pedestrian crossing
+- Traffic safety symbology: yellow + black hazard pattern, red traffic light
+- AZ traffic police: high-visibility yellow vest + dark uniform
+- Pedestrian crossing signs: white pedestrian silhouette on blue square (international)
+- AZ manat ₼ symbol (fine amount reference)
+- Dash-cam aesthetic: timestamp overlay, surveillance footage feel
+
+**Decision matrix:**
+- ✅ Background: specific 28 May metro intersection blurred (city recognition)
+- ✅ Small ⚠️ warning triangle icon in corner (instant "traffic violation" recognition)
+- ✅ Color accent: traffic safety YELLOW (already in palette OK) + warning red
+- ❌ Specific police officer (legal/recognizability)
+- ❌ Specific car license plates (recognizability)
+- ✅ Optional: small ₼ "fine" badge if space allows
+
+**Prompt enrichment add:**
+- Topic bg: specifically blurred 28 May metro intersection (Soviet-era + modern mix architecture, multi-lane boulevard, pedestrian crossing visible)
+- Topic icon: small yellow warning triangle ⚠️ in top-right corner area (12% frame height)
+- Topic color reinforcement: dash-cam timestamp overlay aesthetic adds surveillance credibility
+
+### Example 3 — Variant C "BU İNSANLAR BAŞA DÜŞMÜR" (sermon)
+
+**Topic extraction:** Pedestrian safety sermon, "these people" reference, host direct address
+
+**Visual research:**
+- Bakı specific busy intersections (Fountain Square, Nizami küç, 28 May, Targovi)
+- Crosswalk markings (white stripes)
+- Mixed-demographic pedestrians (business casual + casual + elderly + youth)
+- Crowd composition aesthetic
+
+**Decision matrix:**
+- ✅ Background: specific Bakı intersection wide-shot with diverse pedestrians (recognition + accuracy)
+- ✅ Crosswalk stripes visible in bg (semantic anchor — "they're not using crosswalks")
+- ❌ Icon overlay (sermon style + crowd bg = composition full)
+- ❌ Specific recognizable individuals (use blurred composite)
+- ✅ Color accent: editorial red (#B00020) on accusation word — already in plan
+
+**Prompt enrichment add:**
+- Topic bg: specifically Bakı central intersection (mention boulevard / Targovi / Fountain Square aesthetic), crosswalk markings visible, mixed-demographic pedestrians mid-crossing wide-shot
+
+---
+
+## When skipping research is OK
+
+Research is **default-mandatory**, lakin atlanma şərtləri:
+
+- **Abstract topic** (philosophy, opinion, internal thought) — heç bir konkret event/object yoxdur → topic enrichment minimal, brand palette dominant
+- **Pure host commentary** with no external reference (host just sharing personal view) → background can be neutral gradient + reaction face
+- **Topic onsuz da artıq vizual açıqdır** — məsələn ssenari konkret action göstərir, bg + face yetərlidir
+
+Lakin bu hallarda da prompt-da **açıq qeyd olunmalıdır**: "Topic abstract — no specific topic enrichment beyond brand palette. Background: neutral [stylistics-derived]."
+
+---
+
+## Anti-patterns (avoid)
+
+1. **"Generic gym background"** (when topic is specific fitness sketch) → research what specific exercise/equipment was discussed
+2. **"Stylized colors"** when topic has known brand/team colors → use the real topic colors
+3. **"Universal icon"** when topic has cultural/local-specific symbol → use the local
+4. **Random emoji dump** instead of researched topic icon → custom topic-derived element
+5. **Same background pattern across all variants** → each variant gets topic-driven differentiation
+6. **Skip research due to "stylistics handles it"** → stylistics handles invariants, NOT topic enrichment
+
+---
+
+## Workflow integration
+
+`storyboard-builder` skill-də olan SKILL.md Addım B5 (production cell brief) format-da TOPIC ENRICHMENT bölməsi məcburidir:
+
+```
+**TOPIC ENRICHMENT (this thumbnail's specific elements — Addım B5 research output):**
+- Topic extraction: <konkret event/object/location/brand from script/transcript>
+- Visual research findings: <bullet list of topic-specific visuals>
+- Decision matrix application:
+  - Bg topic anchor: <decision>
+  - Icon/badge: <decision>
+  - Color accent: <decision>
+  - Prop/object: <decision>
+  - Cultural specific: <decision>
+- Prompt integration: <konkret sözlər prompt-a əlavə olunur>
+```
+
+---
+
+## Cross-references
+
+- `world-class-design-baseline.md` — niche DNA + reference channels (invariant)
+- `icon-and-graphic-elements.md` — ümumi icon decision matrix (universal)
+- `professional-techniques.md` — 12 design principles (universal)
+- `variant-differentiation.md` — 5-axis variant difference rule
+- CLAUDE.md "Geographic/Landmark accuracy research qaydası" — internet research mandatory for specific real-world locations
+- CLAUDE.md "Brand logo / brand mark qaydası" — POST-COMPOSITE, AI generation-da yox
+
+---
+
+## Niyə bu fayl yaradıldı
+
+İstifadəçinin 2026-05-22 göstərişi (cvn-ay-millet test): "yenə eyni şeylər edirik standart thumbnail yaradılır. Mən dedim bu bir qayda olmalıdır hər thumbnail yaradılanda ordakı mövzuya uyğun araşdırma et sonra lazım olarasa icon lazım olarasa kiçik başqa şəkil və s kimi şeylər əlavə etməliyik. Hər thumbnaildə movzuya uyğun rəng və ya başqa nələr olmalıdırsa thubnaildə onuda prompta yazmalısan."
+
+Skill stylistics.md (locked brand DNA) tətbiq edirdi, lakin **per-thumbnail topic-specific enrichment** etmirdi. Hər thumbnail "Real Madrid biz olardıq" üçün eyni generic stylistics tətbiq olunurdu — gold trophy colors, white kit reference, CL star pattern enrichment yox idi. Bu fayl topic research-ı sərt qayda kimi sistemə tikir.

package/templates/skills/youtube-thumbnail-designer/knowledge/typography.md

@@ -0,0 +1,194 @@
+# Typography — Font ailələri + AZ glyph dəstəyi + niche tövsiyələri
+
+> Thumbnail tipoqrafiya **2-əhəmiyyət**dir: oxunur mu (mobil 120px test) + brand DNA-sını daşıyır mı. Bu fayl niche-ə görə font tövsiyələri, AZ-spesifik glyph dəstəyi, vizual model üçün təsvir formulalarını saxlayır.
+
+## Contents
+
+1. Mobil oxunma əsas qaydaları
+2. Font kateqoriyaları (4 ailə)
+3. Niche → tövsiyə cədvəli
+4. AZ glyph dəstəyi (Ə, Ş, Ç, Ö, Ü, Ğ)
+5. Vizual model üçün font təsviri (prompt-da nə yazılır)
+6. Text effects (stroke, shadow, outline)
+
+---
+
+## 1. Mobil oxunma əsas qaydaları
+
+- **Letter spacing: -1% to -3%** (sıx) — geniş tracking-də mobil-də blur olunur
+- **All-caps üstün** — kiçik hərflərdə x-height itir, mobil 120px-də ölünmür
+- **Stroke kritikdir** — qara outline 4-8px, mətni hər fondan ayırır
+- **Drop shadow opsional** — depth artırır, lakin stroke-suz işləmir
+- **Font weight: black/heavy minimum** — regular/medium thumbnail-də çox incədir
+- **Max 5 söz** — 6+ söz mobil-də oxunmaz
+- **Letter case mix QADAĞAN** — yalnız ALL-CAPS və ya yalnız Title Case, qarışdırma
+
+---
+
+## 2. Font kateqoriyaları (4 ailə)
+
+### A. Bold Condensed Sans (ən yayılmış)
+- **Misallar:** Anton, Bebas Neue, Oswald, Roboto Condensed Black, Barlow Condensed
+- **Görünüş:** uzun və dar hərflər, all-caps optimal
+- **Best for:** news, drama, shock-reaction formul
+- **AZ glyph dəstəyi:** Anton (✓ tam), Bebas Neue (✓ tam), Oswald (✓ tam), Roboto Condensed (✓ tam)
+- **Vizual model təsviri:** "bold condensed sans-serif, all-caps, tight letter spacing, slim aspect ratio"
+
+### B. Heavy Display (impact-focused)
+- **Misallar:** Impact, Arial Black, Helvetica Black, Inter Black, Plus Jakarta Sans Black
+- **Görünüş:** geniş, qalın, dominant
+- **Best for:** edu, how-to, real-vs-AI formul
+- **AZ glyph dəstəyi:** Impact (⚠️ Ə qismən), Arial Black (✓ tam), Helvetica Black (✓ tam), Inter Black (✓ tam), Plus Jakarta Sans (✓ tam)
+- **Vizual model təsviri:** "heavy display sans-serif, wide x-height, all-caps, dominant visual weight"
+
+### C. Geometric Modern (premium / minimal)
+- **Misallar:** Montserrat Black, Poppins Black, DM Sans Bold, Manrope Bold
+- **Görünüş:** geometric round, modern, balanced
+- **Best for:** podcast, music, clean-center formul, atmospheric content
+- **AZ glyph dəstəyi:** Montserrat (✓ tam), Poppins (✓ tam), DM Sans (✓ tam), Manrope (✓ tam)
+- **Vizual model təsviri:** "geometric sans-serif, rounded terminals, balanced weight, modern minimal aesthetic"
+
+### D. Slab/Display Special (statement)
+- **Misallar:** Bungee, Rubik Mono One, Black Ops One, Russo One
+- **Görünüş:** xüsusi, eye-catching, brand-ləşdirici
+- **Best for:** music, gaming, vlog (personality-driven channels)
+- **AZ glyph dəstəyi:** Bungee (⚠️ qismən — Ş/Ə var, Ğ yoxdur), Rubik Mono One (✓ tam), Black Ops One (⚠️ qismən), Russo One (✓ tam)
+- **Vizual model təsviri:** "stylized display sans-serif, distinctive character shapes, statement typography"
+
+### E. Comic / Comedy Display (sketch, parody, gaming reaction)
+- **Misallar:** Bangers, Permanent Marker, Luckiest Guy, Ultra, Modak
+- **Görünüş:** comic-book reaction, hand-drawn marker, chunky cartoon, balloon letters — exaggerated emotion vehicle
+- **Best for:** **comedy**, **sketch**, **parody**, **gaming reaction**, **slapstick** (sərt: ciddi niche-lərdə qadağan)
+- **AZ glyph dəstəyi:** Bangers (✓ tam — Google Fonts Latin Extended-A, Ə U+018F), Permanent Marker (✓ tam), Luckiest Guy (⚠️ Ə qismən — yoxla per project), Ultra (✓ tam), Modak (⚠️ Latin minimal — Ə yox)
+- **Vizual model təsviri:** "comic-book reaction display font, bouncy uneven baseline, slightly tilted letters, thick uniform strokes, hand-drawn comic energy"
+- **Niyə category ayrıdır:** comedy genre signal **fundamental fərqlidir** — Anton/Bebas Neue (editorial) comedy-yə zidd, dramatik news vibe verir. Bangers comic-book panel-də olur kimi reaction-energy daşıyır.
+
+---
+
+## 3. Niche → tövsiyə cədvəli (world-class baseline)
+
+| Niche | Primary | Fallback | Sub-text | Mənbə |
+|---|---|---|---|---|
+| **comedy / sketch / parody** | **Bangers** | Permanent Marker | Inter Bold | world-class-design-baseline.md §2 |
+| **hybrid (commentary-comedy)** | **Anton** (editorial base) + accent word in **Bangers** | Bebas Neue | Inter SemiBold | world-class-design-baseline.md §1b (Trevor Noah / John Oliver pattern) |
+| commentary | Anton | Impact | Inter SemiBold | (commentary = editorial) |
+| edu / education / science | Inter Black | Bebas Neue | Inter SemiBold | world-class-design-baseline.md §6 (Veritasium) |
+| vlog / lifestyle | Caveat | Poppins SemiBold | Inter Medium | world-class-design-baseline.md §4 (Casey Neistat) |
+| podcast | Montserrat Black | DM Sans Bold | DM Sans Regular | (podcast = clean modern) |
+| how-to | Inter Black | Roboto Condensed Black | Inter SemiBold | (how-to = utility) |
+| drama | Bebas Neue | Anton | Roboto Condensed Bold | (drama = editorial intensity) |
+| **serial-drama** | **Bebas Neue** (massive episode title) | Anton, Cinzel (prestige) | Inter SemiBold | world-class-design-baseline.md §1c (Netflix/Turkish serials) |
+| music | Bungee | Russo One | Inter Bold | world-class-design-baseline.md §7 |
+| news | Roboto Condensed Black | Anton | Inter SemiBold | (news = editorial) |
+| tech / reviews | Inter Bold | SF Pro Display | Inter Medium | world-class-design-baseline.md §3 (MKBHD) |
+| gaming | Bangers | Russo One | Inter Bold | world-class-design-baseline.md §5 |
+| sports / fitness | Anton | Bebas Neue | Inter SemiBold | world-class-design-baseline.md §8 |
+| beauty / fashion | Poppins SemiBold | Cormorant | Inter Medium | world-class-design-baseline.md §9 |
+| finance / business | Inter Bold | Anton | Inter SemiBold | world-class-design-baseline.md §10 |
+
+`stylistics.md` Sahə 4 (heading) və Sahə 5 (subtext) bu cədvəldən götürülür — istifadəçi başqasını üstün tutsa, override edilir.
+
+**Sərt qayda:** Comedy niche-də **Anton, Bebas Neue, Impact istifadə etmə** — editorial signal comedy energy-ni öldürür. World-class baseline → Bangers.
+
+---
+
+## 4. AZ glyph dəstəyi (Ə, Ş, Ç, Ö, Ü, Ğ)
+
+Azərbaycan dilində 6 əlavə glyph var ki, bütün font ailələrində tam render olunmur:
+
+| Font | Ə | Ş | Ç | Ö | Ü | Ğ | Status |
+|---|---|---|---|---|---|---|---|
+| Anton | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | Tam dəstək |
+| Bebas Neue | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | Tam dəstək |
+| Oswald | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | Tam dəstək |
+| Impact | ⚠️ | ✓ | ✓ | ✓ | ✓ | ⚠️ | Qismən — Ə və Ğ köhnə versiyada zəif |
+| Inter Black | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | Tam dəstək |
+| Montserrat Black | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | Tam dəstək |
+| Bungee | ✓ | ✓ | ✓ | ✓ | ✓ | ❌ | Ğ render olmur |
+| Russo One | ✓ | ✓ | ✓ | ✓ | ✓ | ⚠️ | Ğ zəif diacritic |
+| **Bangers** | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | Tam dəstək (Google Fonts Latin Extended-A) — **comedy default** |
+| **Permanent Marker** | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | Tam dəstək — comedy alternative |
+| **Luckiest Guy** | ⚠️ | ✓ | ✓ | ✓ | ✓ | ⚠️ | Ə və Ğ qismən — per project yoxla |
+| **Ultra** | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | Tam dəstək — retro comedy/sitcom |
+| **Caveat** | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | Tam dəstək — vlog handwritten |
+| **Poppins** | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | Tam dəstək — beauty / clean modern |
+
+**Decision rule (`stylistics.md` Sahə 2-də locked):**
+- AZ glyph > 2 olan mətn üçün **Anton, Bebas Neue, Inter Black, Montserrat Black** üstün tut
+- Bungee/Impact yalnız Ğ-siz mətndə işlət
+
+**Image model side:**
+- **Ideogram v3** — text rendering üçün industry leader, AZ glyph dəstəyi güclü
+- **Nano Banana 2** — orta dəstək (qismən səhv render edə bilər)
+- **GPT-Image-2** — diacritics-də zəif
+- **Flux 1 Pro** — orta
+- **Midjourney v7** — zəif text rendering ümumi
+
+**Sərt qayda:** Stylistics-də `text > 4 words` VƏ YA `AZ glyph count > 2` → primary model `Ideogram v3` olur (project default override).
+
+---
+
+## 5. Vizual model üçün font təsviri
+
+AI image model-i Anton, Bebas Neue, Montserrat **adlarını bilməyəcək**. Model üçün vizual təsvir lazımdır. Bu lookup-da hər font ailəsi üçün model-friendly təsvir:
+
+| Font/family | AI image model üçün təsvir |
+|---|---|
+| Anton, Bebas Neue, Oswald | "bold condensed sans-serif, all-caps, tight letter spacing, slim vertical proportions, no serifs" |
+| Impact, Helvetica Black | "heavy display sans-serif, wide x-height, all-caps, dominant visual weight, no serifs" |
+| Inter Black, Plus Jakarta Sans Black | "geometric modern sans-serif, balanced proportions, all-caps, heavy weight, contemporary" |
+| Montserrat Black, Poppins Black | "geometric sans-serif, rounded terminals, all-caps, heavy weight, modern minimal aesthetic" |
+| Bungee, Rubik Mono One | "stylized display sans-serif, distinctive character shapes, equal stroke widths, statement typography" |
+| Black Ops One, Russo One | "military-stencil display sans-serif, angular, all-caps, bold strokes" |
+| **Bangers** | "comic-book reaction display font, bouncy uneven baseline, slightly tilted letters, thick uniform strokes, hand-drawn comic energy, like classic Marvel/DC sound-effect lettering" |
+| **Permanent Marker** | "handwritten marker brush font, casual rebellious vibe, irregular stroke endings, slightly ragged edges, mid-thick weight, like a real marker on cardboard" |
+| **Luckiest Guy** | "chunky cartoon display font, rounded balloon letterforms, friendly playful character, thick uniform strokes, all-caps youth-appeal aesthetic" |
+| **Ultra** | "heavy retro slab serif, condensed, 1970s sitcom title aesthetic, strong horizontal serifs, all-caps" |
+| **Caveat** | "casual handwritten script, friendly slant, varying stroke weight, like a real handwritten note, warm vlog-style personality" |
+
+`stylistics.md` Sahə 4-də həm **font adı (istifadəçi üçün)** həm də **vizual təsvir (model üçün)** saxlanır — image-prompt-engineer-ə ötürülərkən vizual təsvir prompt-a daxil edilir.
+
+---
+
+## 6. Text effects (universal)
+
+Thumbnail mətni **hər zaman** bu effekt stack-i istifadə edir (kontrast üçün):
+
+### Stack (top-to-bottom rendering order):
+1. **Drop shadow** (background) — y+8px, blur 4-6px, #000 @ 50% opacity
+2. **Stroke / outline** — 4-8px solid, kontrast rəng (dark mətndə white stroke, white mətndə dark stroke)
+3. **Fill** — palette colour (primary və ya accent)
+
+### Stroke qalınlıq seçimi:
+- Mətn font size > 100px → stroke 6-8px
+- Mətn font size 60-100px → stroke 4-6px
+- Mətn font size < 60px → stroke 3-4px
+
+### Drop shadow kontekst:
+- Dark background + light text → drop shadow lazımdır (depth üçün)
+- Light background + dark text → stroke kifayətdir, drop shadow opsional
+- Photo background → həm stroke həm drop shadow məcburi
+
+### Vizual model üçün prompt formulu:
+```
+"<TEXT> rendered in <font description from §5>, color <hex from palette>,
+with thick <stroke px> solid outline in <stroke color>, subtle drop shadow
+y+8px blur 4px black 50% opacity. All-caps, tight letter spacing -2%."
+```
+
+---
+
+## Image model side — text rendering güvənliyi
+
+Hər model üçün text rendering güvənlik səviyyəsi:
+
+| Model | Text quality | AZ glyph | Tövsiyə |
+|---|---|---|---|
+| Ideogram v3 | ★★★★★ | ✓ | Default for text-heavy |
+| Recraft v3 | ★★★★ (vector + text) | ✓ | Brand typography |
+| Flux 1 Pro | ★★★ | Orta | Acceptable |
+| Nano Banana 2 | ★★★ | Orta | Acceptable, lakin text > 4 söz risklidir |
+| GPT-Image-2 | ★★★ | Zəif | Avoid AZ-də |
+| Midjourney v7 | ★★ | Zəif | Avoid text-heavy |
+
+`stylistics.md` Sahə 11 (image model preference) bu cədvələ əsasən locked qərar verilir.