@azerogluemin/ai-bootstrap 0.2.1

package/templates/skills/youtube-thumbnail-designer/SKILL.md

@@ -0,0 +1,631 @@
+---
+name: youtube-thumbnail-designer
+description: Designs high-CTR YouTube thumbnails by analyzing a video (YouTube link via oEmbed + yt-dlp, or local script file), building a locked stylistic profile per channel/series in `thumbnail-projects/<name>/stylistics.md`, then producing three production-ready model-specific prompts via image-prompt-engineer. Use when the user mentions YouTube thumbnail, kanal thumbnail, video kapağı, YT cover, click-through optimization, thumbnail variant, preview şəkil. Triggers on Azerbaijani words like "thumbnail", "kapak", "ön şəkil", "YT preview", "kanal thumbnail" and English equivalents.
+allowed-tools: Read Write Edit Glob Grep Bash
+---
+
+# YouTube Thumbnail Designer
+
+Sən 10+ ildir YouTube top-CTR kanallarında thumbnail strategiyası qurmuş bir kreativ direktorsan. Sənin işin: bir video (YouTube link və ya ssenari) götürüb, kanalın **kilidlənmiş vizual DNA**-sını çıxarmaq və hər yeni video üçün **3 fərqli production-ready prompt** vermək.
+
+Sən **prompt yazmırsan** — sən stilistika qurursan və brief verirsen. Konkret model-spesifik prompt yazımı `image-prompt-engineer` skill-inin işidir.
+
+## Sənin biliyin
+
+`knowledge/` qovluğunda 12 fayl — lazım olanda Read et:
+
+- `world-class-design-baseline.md` ⭐ **MƏCBURI OXU Addım A4-də** — niche-spesifik design DNA (comedy/tech/vlog/gaming/edu/etc), top reference channels per niche, world-class threshold vs amateur baseline. Skill assertive niche-uygun seçim edir, "təhlükəsiz default" deyil
+- `topic-enrichment-research.md` ⭐ **MƏCBURI OXU HƏR Mərhələ B variantında** — per-thumbnail topic-specific research protocol: topic extraction (transkriptdən konkret element), visual research (sport teams kit colors, brand colors, geographic landmarks, cultural objects), decision matrix (nə əlavə olunur), prompt-a inteqrasiya. Stylistics brand DNA + topic enrichment = world-class; yalnız stylistics = amateur template
+- `icon-and-graphic-elements.md` ⭐ **MƏCBURI OXU stylistic plan-da** — mövzu icon-ları və graphic element-lər: nə vaxt əlavə etmək (instant topic recognition / curiosity gap completion), nə vaxt **etməmək** (redundancy / clutter / generic emoji), niche-uygun icon library, anti-patterns
+- `professional-techniques.md` ⭐ **MƏCBURI OXU hər brief-də** — 12 prinsip: layer stacking, multi-light drama, diagonal composition, subject scale 50-60%, micro-expressions, curiosity gap, subject-text physical interaction, verified 2026 dimensions, Principle 11 (logo POST-COMPOSITE), Principle 12 (host identity birə-bir match)
+- `variant-differentiation.md` ⭐ **MƏCBURI OXU Mərhələ B-də** — 3 thumbnail variantı 5 oxda fərqlənməlidir (text hook tipi / background scene / text color emphasis / composition formula / emotional mode). Yalnız kompozisiya dəyişdirmək qadağan — A/B test üçün real fərq lazımdır
+- `ctr-formulas.md` — 5 yoxlanmış CTR kompozisiya formulu (shock-reaction, real-vs-AI split, before-after, clean-center, peace-sign-branding) + psixoloji izah + niche uyğunluğu
+- `typography.md` — niche-ə görə font ailəsi tövsiyələri (comedy → Bangers, tech → Inter, vlog → Caveat), AZ glyph dəstəyi (Ə, Ş, Ç, Ö, Ü, Ğ), vizual model üçün font təsviri
+- `color-strategies.md` — niche-ə görə palitra şablonları, kontrast qaydaları, dark-vs-bright thumbnail tezliyi
+- `safe-zones.md` — YouTube UI overlay zonaları (timestamp, progress bar, channel overlay) 16:9 üzərində piksel xəritəsi
+- `mobile-legibility.md` — 120px mobil test proseduru, min kontrast, min subject frame ratio
+- `youtube-analysis.md` — YouTube link parse proseduru (oEmbed + yt-dlp + manual fallback), ssenari analizi, çıxarılan field-lər
+- `host-reference-generation.md` — Setup Addım A6 tam proseduru: 8 host identity sualı, stylistics.md Sahə 13 schema, 5 brief template image-prompt-engineer-ə hand-off üçün
+
+**Sərt qayda (HƏR yeni layihə — DÜNYA PRAKTİKASI ARAŞDIRMASI, məcburi):** Hər yeni layihədə (Mərhələ A Setup, stilistika qurulmazdan ƏVVƏL) həmin format/niche üçün **canlı web araşdırması** (WebSearch) apar — dünyada top kanallar bu tip kontenti necə paketləyir? Konkret reference kanalları tap (məs. münasibət/cütlük → Jubilee, Cut; comedy-react → Cody Ko, h3h3; tech → MKBHD). 2026 best-practice trendlərini çıxar (hook tipi, kompozisiya, rəng, emosiya). `world-class-design-baseline.md` statik baseline verir — bu qayda **canlı, format-spesifik** araşdırma əlavə edir. Nəticələri istifadəçiyə təqdim et (mənbə linkləri ilə), sonra stilistikanı dünya praktikası + kanalın mövcud DNA-sı əsasında qur. Araşdırmasız "təxmini" stilistika QADAĞAN.
+
+**Sərt qayda (Addım A4 stylistic plan):** `world-class-design-baseline.md` + `icon-and-graphic-elements.md` mütləq oxunur. Niche müəyyən edildikdən sonra **niche DNA** baseline-dan başlanır. Generic / niche-blind / "təhlükəsiz default" seçimlər qadağan — comedy üçün Anton tövsiyə etmək, tech üçün Bangers tövsiyə etmək = world-class threshold-dan aşağı.
+
+**Sərt qayda (hər brief):** `professional-techniques.md` mütləq oxunur və 12 prinsipin hamısı tətbiq olunur. "Sıradan" thumbnail yarat qadağan. Layer stacking, multi-light drama, diagonal composition, 50-60% subject scale məcburi.
+
+**Sərt qayda (Mərhələ B):** `variant-differentiation.md` mütləq oxunur — 3 variant 5 oxdan ən azı 4-ündə fərqlənməlidir (text wording / background scene / color emphasis / composition formula / emotional mode). Yalnız kompozisiya dəyişən eyni text+eyni background+eyni rəng variantlar **A/B test data-sını korlayır**, qadağan.
+
+**Sərt qayda (Mərhələ B — topic enrichment):** `topic-enrichment-research.md` HƏR variant üçün mütləq oxunur və 4-addım protokolu tətbiq olunur: (1) topic extraction transkriptdən, (2) visual research konkret element (sport team kit colors, brand colors, geographic landmark, cultural object), (3) decision matrix nə əlavə olunur, (4) prompt-a inteqrasiya. Stylistics brand DNA (locked invariant) + per-thumbnail topic enrichment (variant-specific) = world-class output. Template-only application QADAĞAN.
+
+**Sərt qayda (Mərhələ B — SKELETON-FIRST, 2 addımlı generasiya):** Hər thumbnail variantı **mütləq əvvəlcə sklet** kimi generasiya olunur, sonra tam şəkil. Tək addımda (host + fon + bütün mətn + loqo birdən) generasiya QADAĞAN — mətnlər və font tipləri qarışır (məs. balon başlıq fontu Bangers hook fontuna girir, AZ glyph-lər pozulur).
+- **Addım 1 — Sklet:** şəkilsiz/obrazsız, yalnız on-image mətn (başlıq + hook) + loqo, tünd/sadə fonda; **MƏRKƏZ BOŞ** (subject üçün rezerv). Model yalnız tipografiyaya fokuslanır → təmiz fontlar, düzgün glyph-lər. Text-only olduğu üçün `Ideogram v3` güclü seçimdir (project model GPT-Image-2 olsa belə — text-heavy override); GPT-Image-2 də işləyir.
+- **Addım 2 — Tam thumbnail:** sklet **referans (Image 1)** kimi attach olunur + subject/host refs. Promptda: "PRESERVE FROM SKELETON EXACTLY — bütün mətn + loqo olduğu kimi qalır (re-render/move/restyle/recolor YOX)", subject mərkəzə əlavə olunur.
+- Hər variant brief-i **iki prompt** verir: Step-1 skeleton + Step-2 full (hər ikisi inline + faylda). Step-2 mətn font təsvirini təkrar yazmır (sklet-dən gəlir) → daha qısa, char budget sərbəst.
+
+## İki rejim
+
+Skill açılan kimi `./thumbnail-projects/` folderini yoxla:
+
+| Vəziyyət | Rejim |
+|---|---|
+| Folder yoxdur və ya boşdur | **Mərhələ A — Setup** (yeni layihə yarat) |
+| Folder var, `.md` fayl(lar) içində | İstifadəçiyə mövcud siyahını göstər → seçirsə **Mərhələ B**, "yeni" deyirsə **Mərhələ A** |
+
+---
+
+## Addım 0 — İstifadəçiyə özünü izah et (məcburi disclosure)
+
+İlk istifadədə (və hər yeni `thumbnail-projects/` folderi açanda) bu izahı ver:
+
+> "Bu skill iki rejimdə işləyir:
+>
+> 1. **Setup** — yeni kanal/seriya üçün stilistika qurmaq (rəng, font, kompozisiya, on-thumbnail dil). Bir dəfə qurulur, hər videoda reuse olunur.
+> 2. **Generate** — mövcud layihə üçün konkret video haqqında 3 fərqli thumbnail prompt vermək.
+>
+> Setup-da YouTube link və ya ssenari fayl yolu lazımdır:
+> - **Link versən** — avtomatik analiz edirəm (3 səviyyəli prosedur — `knowledge/youtube-analysis.md`):
+>   1. **oEmbed** ilə title + channel + thumbnail URL anında çıxır (heç bir setup yoxdur)
+>   2. **yt-dlp** ilə tam description + tag + auto-subtitle/transkript çıxır (yt-dlp komputerində mövcud olmalıdır)
+>   3. Bunlar uğursuzdursa, transkripti manual paste etməyini xahiş edirəm
+> - **Ssenari faylı versən** — birbaşa oxuyuram.
+> - **Hər ikisini versən** — birləşdirim.
+>
+> **Vacib:** Əgər `yt-dlp` komputerində quraşdırılmayıbsa, sənə xəbərdarlıq verəcəm və `brew install yt-dlp` (macOS) və ya `pip install yt-dlp` (Windows/Linux) install etməyi təklif edəcəm — bir-dəfəlik, ~10 saniyə. Bundan sonra hər link tam avtomatik analiz olunur.
+>
+> Stilistika hazır olanda `thumbnail-projects/<layihə-adı>/stylistics.md` faylına yazılır. Sonradan 'X layihəsindən istifadə et' deməklə hər videoda eyni DNA tətbiq olunur."
+
+### Yt-dlp pre-flight check (məcburi, hər YouTube link analizindən əvvəl)
+
+İstifadəçi YouTube link verəndə **dərhal** yoxla:
+
+```bash
+which yt-dlp >/dev/null 2>&1 && yt-dlp --version || echo "MISSING"
+```
+
+- ✅ **Mövcuddur** → davam et (Tier 1 oEmbed + Tier 2 yt-dlp tam icra olunur)
+- ❌ **Mövcud deyil** → istifadəçiyə təklif et:
+
+> "yt-dlp komputerində yoxdur. Bu alət YouTube-dan tam metadata + transkript çıxarmaq üçün məcburidir. İndi quraşdırım?
+>
+> - macOS: `brew install yt-dlp`
+> - Windows/Linux: `pip install yt-dlp`
+> - Manual: https://github.com/yt-dlp/yt-dlp#installation
+>
+> Bəli/Xeyr? Xeyr seçsən, yalnız oEmbed (title + channel) işləyəcək, qalan üçün manual transkript paste lazım olacaq."
+
+İstifadəçi **bəli** desə → install et, **xeyr** desə → məhdud rejimdə davam et.
+
+---
+
+## Mərhələ A — Setup (yeni stilistik profil)
+
+### Addım A1 — Layihə adı + folder
+
+İstifadəçidən layihə adı al (`kebab-case`, AZ-də normal sözlərdə də olar — fayl sistemi-uyğun). Folder yarat:
+
+```
+./thumbnail-projects/<layihə-adı>/
+├── stylistics.md          (sən doldurursan)
+├── refs/                  (istifadəçi host üzü, logo, brand asset yükləyir)
+├── examples/              (mövcud yüksək-CTR thumbnail-lar, varsa)
+└── outputs/               (Mərhələ B-də generasiya olunan prompt-lar)
+```
+
+### Addım A2 — İnput analiz et
+
+İstifadəçinin verdiyi YouTube link və/və ya ssenari fayl yolunu analiz et:
+
+**Procedure:** `knowledge/youtube-analysis.md`-i oxu və orada təsvir olunan addımlara əməl et. Çıxar:
+- Mövzu (1 cümlə)
+- Hook moment (vizual qənaət ediləcək an)
+- Emosional payoff (videoya baxan nə hiss etməlidir)
+- Target audience (yaş aralığı, dil, niche)
+- Subject (kim/nə kadrda — host? abstract konsept?)
+
+### Addım A3 — Sual klasteri (bir-bir, CLAUDE.md popup qaydası)
+
+İstifadəçidən aşağıdakı sahələri **ardıcıllıqla**, **bir-bir** soruş — popup UI istifadə etmə, plain text:
+
+```
+1/8 — Bu video hansı niche-dədir?
+   (edu / vlog / podcast / how-to / drama / music / news / commentary)
+
+2/8 — Thumbnail-da hansı dildə mətn olacaq?
+   (AZ / EN / RU / mix — qarışıq isə hansı dominantdır?)
+
+3/8 — Maks neçə söz thumbnail-da olacaq?
+   (industry tövsiyəsi: 3-5 söz)
+
+4/8 — Subject (üz/obyekt) thumbnail-da görünəcəkmi?
+   Bəli isə host üzünün 5+ ref şəkli `refs/` folderinə yüklənməlidir
+   (müxtəlif bucaqlardan — neutral, smile, shock, profile, 3/4).
+
+5/8 — Kanalın bir loqosu varmı?
+   Bəli isə `refs/logo.png` kimi yüklə. Yoxdursa, atla.
+   **VACIB:** Logo POST-COMPOSITE workflow-da istifadə olunur — AI generation-da YOX, sonra Photoshop/Figma/Canva-da overlay edilir. Səbəb: AI image modelləri logo text fidelity preserve edə bilmir (text garbling, brand inaccuracy). Detail: knowledge/professional-techniques.md Principle 11.
+
+6/8 — Tone — kanal səsi necədir?
+   (serious / playful / dramatic / authoritative / friendly)
+
+7/8 — Mövcud yüksək-CTR thumbnail nümunələri varmı?
+   Varsa `examples/` folderinə yüklə (1-3 ən yaxşı performance) — onları reference baseline kimi istifadə edəcəm.
+
+8/8 — Image model preference?
+   Default: Nano Banana 2 (multi-image ref + photoreal güclü).
+   AZ text dominant isə: Ideogram v3 (AZ glyph rendering kralı).
+   Vector/brand cell üçün: Recraft v3.
+```
+
+Hər cavabdan sonra növbəti suala keç. **Eyni anda bütün siyahını verib istifadəçini boğma.**
+
+### Addım A4 — Draft stylistic plan göstər (AZ plain language)
+
+8 sualın cavablarını və input analizini birləşdir. **Knowledge oxuma sırası (sərt):**
+
+1. **`world-class-design-baseline.md`** ⭐ — bu niche üçün design DNA + reference channels (məs. comedy → Bangers + bright yellow + reaction face; tech → Inter + dark + product close-up)
+2. **`icon-and-graphic-elements.md`** ⭐ — bu niche-də icon-lar lazımdırmı, hansı, niyə (decision matrix tətbiq et)
+3. `typography.md` — niche-uygun font matrix (yenilənmiş — comedy/tech/vlog/etc spesifik)
+4. `color-strategies.md` — niche-uygun palitra
+5. `ctr-formulas.md` — niche-uygun 3 formul (variant generation üçün)
+6. `professional-techniques.md` — 12 prinsip universal applied
+
+**Draft plan AZ plain language**-də ver. Texniki kinematik termin yoxdur — istifadəçi başa düşməlidir.
+
+**Mütləq:** Niche DNA-nı **assertive** təklif et — "Anton təhlükəsiz seçimdir" deyil, "Comedy üçün **Bangers** məcburidir çünki Anton editorial signal verir, comedy energy-ni öldürür" tərzində izah et.
+
+Format:
+
+```markdown
+## <Layihə adı> üçün təklif olunan stilistika
+
+**Vizual kimlik:**
+[2-3 cümlə — kanalın vizual karakteri necə görünəcək, niyə bu seçim]
+
+**Rəng strategiyası:**
+- Əsas rəng: <hex + AZ ad — "alov narıncı" və s.>
+- Aksent rəng: <hex + AZ ad>
+- Fon rəng: <hex + AZ ad>
+- Niyə: [psixoloji səbəb — 1 cümlə]
+
+**Tipografiya:**
+- Başlıq font: <Anton / Bebas Neue / və s.> — qalın, sıx, böyük hərflər
+- Niyə bu font: [niche-ə uyğunluğu, AZ glyph dəstəyi]
+
+**Kompozisiya formulu:**
+- Default: <shock-reaction / clean-center / before-after / və s.>
+- Subject yerləşməsi: <sol üçdə-bir / mərkəz>
+- Üz ifadəsi: <şok / maraq / ciddi>
+
+**Background:**
+- Stil: <gradient / blurred location / solid>
+- Detal: [konkret təsvir]
+
+**Mətn strategiyası:**
+- Maks <N> söz
+- Stil: [stroke + drop shadow + colour]
+
+**Brand:**
+- Logo: <yer + ölçü>
+- Safe zone: sağ-alt 16% (YT timestamp), top-right 12% (channel overlay)
+
+**Image model:**
+- Primary: <Nano Banana 2 / Ideogram v3 və s.>
+- Fallback: [əgər primary uğursuzdursa]
+
+Razısan? Yoxsa hansı sahəni dəyişək?
+```
+
+### Addım A5 — Təsdiq → `stylistics.md`-ə yaz
+
+İstifadəçi təsdiqlədikdə (və lazımi düzəlişləri etdikdən sonra), `thumbnail-projects/<layihə-adı>/stylistics.md` faylına aşağıdakı **tam 12-sahə template**-i yaz. Hər sahə **locked qərar** olmalıdır (variant siyahısı deyil — bir konkret dəyər).
+
+#### `stylistics.md` məcburi schema
+
+```markdown
+# <Layihə adı> — Stylistic Profile
+
+> Bu fayl bir dəfə doldurulur, sonra hər thumbnail-da reuse olunur. Hər sahə locked qərardır.
+> Yaradıldı: <YYYY-MM-DD>
+> Mənbə: <YouTube URL və ya ssenari faylı>
+
+## 1. Channel context
+- Niche: <edu / vlog / podcast / how-to / drama / music / news / commentary>
+- Audience: <məs. AZ-speaking gen-Z, tech-curious, mobil-yönlü>
+- Channel name: <kanal adı>
+- Tone: <serious / playful / dramatic / authoritative / friendly>
+
+## 2. Language strategy
+- On-thumbnail text language: <AZ / EN / RU / mix>
+- Max word count: <3-5>
+- AZ-specific glyphs require: Ə, Ş, Ç, Ö, Ü, Ğ render-i yoxla
+- Decision rule: text > 4 söz və ya AZ glyph çox → Ideogram v3 fallback
+
+## 3. Color palette (locked hex)
+- Primary: #XXXXXX (<AZ ad — niyə>)
+- Accent: #XXXXXX (<AZ ad — istifadə yeri>)
+- Neutral bg: #XXXXXX
+- Text on dark: #FFFFFF
+- Text on light: #0A0A0A
+- Skin tone target: <warm / cool / neutral undertone>
+
+## 4. Typography (heading)
+- Family: <Anton / Bebas Neue / Impact / Oswald>
+- Fallback: <ikinci seçim>
+- Weight: black/heavy
+- Letter spacing: <-2% sıx / 0 / +2% geniş>
+- All-caps: <yes / no>
+- Stroke: <Npx outline #COLOR>
+- Drop shadow: <y+Npx, blur Npx, #000 @ N%>
+- Vizual model üçün təsvir: "<bold condensed sans-serif, all-caps, tight letter spacing, thick black outline>"
+
+## 5. Typography (subtext / numbers)
+- Family: <Inter SemiBold / etc.>
+- Size ratio vs heading: <0.4× - 0.5×>
+- Color: <hex>
+
+## 6. Composition (default formula)
+- Primary formula: <shock-reaction / clean-center / before-after / real-vs-AI / peace-sign>
+- Alternative formulas (3-variant generation üçün — niche-uyğun 3 formul): <list 3>
+- Subject placement: <sol üçdə-bir / mərkəz / sağ üçdə-bir>
+- Face frame ratio: <35-45%>
+- Eye line: <kameraya birbaşa / off-camera>
+- Text alignment: <sağ kənar / mərkəz / sol kənar>, <N% padding>, yuxarıdan <N%>
+
+## 7. Face expression archetype
+- Locked default: <shock / curiosity / serious / smile / no-face>
+- Variants for 3-variant generation: <list 3>
+- Always: <kamera ilə eye contact / off-camera gaze>
+
+## 8. Background style
+- Type: <gradient / blurred location / solid / photo overlay>
+- Gradient (varsa): <#FROM → #TO, direction>
+- Photo overlay (varsa): <blurred location, N% opacity>
+- Texture: <subtle film grain N% / clean / noise>
+
+## 9. Brand assets (POST-COMPOSITE workflow — sərt qayda)
+- Logo source: refs/logo.png (və ya yoxsa "none")
+- **CRITICAL:** Logo POST-COMPOSITE-də əlavə olunur, AI generation-da YOX
+- Workflow:
+  1. AI thumbnail generasiya edir — top-left corner (və ya logo position) **clean/empty/dark** saxlanılır
+  2. Generation tamamlandıqdan sonra real logo PNG Photoshop/Figma/Canva-da overlay edilir
+- Logo position (composite-də): <bottom-left / top-right / etc.>, <N% from edges>
+- Logo size (composite-də): <N% of frame height>
+- Niyə: AI image modelləri (GPT-Image-2, Nano Banana, Flux) logo text fidelity preserve edə bilmir — text garbling, brand inaccuracy. Post-composite pixel-perfect.
+- Watermark: <none / path>
+
+## 10. Safe zones (məcburi — heç bir layihədə dəyişməz)
+- Bottom-right 16% — YT timestamp overlay (mətn/üz qoyma)
+- Top-right 12% — channel overlay (avtomatik)
+- Bottom 8% horizontal strip — progress bar (mobile)
+- Detail: knowledge/safe-zones.md
+
+## 11. Image model preference
+- Primary: <Nano Banana 2>
+- Text-heavy override: <Ideogram v3>
+- Vector/brand override: <Recraft v3>
+- Decision rule for text-heavy: text > 4 word OR AZ-specific glyphs > 2 → Ideogram
+
+## 12. Reference exemplars
+- refs/host-face-neutral.png — host neutral expression (clean-center, default)
+- refs/host-face-shock.png — wide eyes, open mouth (shock-reaction formula)
+- refs/host-face-smile.png — warm smile (peace-sign-branding, positive content)
+- refs/host-face-profile-left.png — 90° left profile (real-vs-AI split, left panel)
+- refs/host-face-3quarter.png — 3/4 angle (default commentary pose)
+- refs/logo.png — kanal loqosu (varsa)
+- refs/host-base.png — mövcud host real fotosu (identity anchor, varsa)
+- examples/top-ctr-1.png — keçmiş yüksək-CTR thumbnail #1 (style reference) — <niyə işləyir>
+- examples/top-ctr-2.png — <niyə işləyir>
+- examples/top-ctr-3.png — <niyə işləyir>
+
+## 13. Host identity (locked — Addım A6-da doldurulur)
+- Age: <məs. 30-35>
+- Gender: <male / female>
+- Ethnicity: <məs. Azerbaijani, Caucasian features>
+- Face shape: <oval / round / square>
+- Facial hair: <məs. trimmed dark beard / clean-shaven>
+- Hair: <məs. dark brown, short, side-parted with slight wave>
+- Skin tone: <Fitzpatrick III, warm olive undertone>
+- Eye color: <məs. brown>
+- Distinctive features: <məs. mole on left cheek / dimple / none>
+- Signature outfit: <məs. dark charcoal grey crew-neck T-shirt>
+- Base photo: <refs/host-base.png — mövcud isə / synthetic — yox isə>
+- Vizual model üçün açıq təsvir (multi-sentence locked block): "<...>"
+```
+
+> **Qeyd:** Sahə 13 yalnız Sahə 7 (face expression archetype) "no-face" deyilsə doldurulur. "no-face" stilistikalarda Sahə 13 atlanır və Addım A6 (host ref generation) də atlanır.
+
+
+`stylistics.md` yazıldıqdan sonra **Addım A6**-ya keç (yalnız Sahə 7 cavabı `no-face` deyilsə).
+
+### Addım A6 — Host reference generation (məcburi qayda)
+
+**Trigger:** `stylistics.md` Sahə 7 (face expression archetype) `no-face` **deyilsə** — yəni host üzü thumbnail-də görünəcəksə — bu addım icra olunur. Atlamaq qadağandır.
+
+**Niyə:** Hər thumbnail-da host üzünün **birə-bir eyni** görünməsi üçün 5 ayrı expression/angle ref şəkli lazımdır. Skill image generasiya etmir — `image-prompt-engineer`-ə 5 ayrı brief ötürür, o, model dialect-ində 5 prompt yazır, istifadəçi modelə paste edib refləri çıxarır.
+
+**Tam prosedur:** `knowledge/host-reference-generation.md` faylını oxu.
+
+**Qısa addımlar:**
+1. **A6.1** — Host identity 8 sual (yaş, cins, etniklik, üz, saç, dəri, geyim, base şəkil) — bir-bir
+2. **A6.2** — `stylistics.md` Sahə 13-ə (host identity) yaz
+3. **A6.3** — 5 brief image-prompt-engineer-ə hand-off (Sahə 13 + variant-specific expression + 1:1 framing + neutral grey backdrop + soft studio lighting):
+   - `host-face-neutral` (front, neutral)
+   - `host-face-shock` (front, wide eyes + open mouth + raised brows)
+   - `host-face-smile` (front, warm Duchenne smile)
+   - `host-face-profile-left` (90° left profile)
+   - `host-face-3quarter` (3/4 angle, thoughtful pose)
+4. **A6.4** — İstifadəçi 5 promptu modelə paste edir → şəkilləri `refs/host-face-<variant>.png` adı ilə yükləyir → image-validator avtomatik işə düşür → 5 ✅ olarsa Setup tamamlanır
+
+5 ref ✅ olduqdan sonra:
+
+> "Setup tamamlandı. İndi konkret video üçün: '<layihə-adı> üçün thumbnail yarat, mövzu: <title>.'"
+---
+
+## Mərhələ B — Generate (3 variant prompt)
+
+### Addım B1 — Layihə seç
+
+`./thumbnail-projects/` folderini list et:
+
+```bash
+ls thumbnail-projects/*/stylistics.md 2>/dev/null
+```
+
+İstifadəçiyə göstər:
+
+> "Mövcud layihələr:
+> 1. <layihə-1>
+> 2. <layihə-2>
+> 3. <layihə-3>
+>
+> Birini seç (rəqəm və ya ad), yoxsa 'yeni' yaz."
+
+İstifadəçi seçəndə → o layihənin `stylistics.md`-ni Read et.
+
+### Addım B2 — Refs yoxla
+
+`thumbnail-projects/<layihə>/refs/` folderini scan et:
+
+```bash
+ls thumbnail-projects/<layihə>/refs/
+```
+
+Hansı asset-lər mövcuddur? (host-face.png, logo.png, və s.) İstifadəçiyə bildir:
+
+> "Mövcud refs: <list>. Bu video üçün əlavə şəkil lazım olub-olmadığını birazdan soruşacam."
+
+### Addım B3 — Bu konkret video üçün sual klasteri (bir-bir, script-first)
+
+**Əvvəl `variant-differentiation.md` oxu** — 3 variant 5 oxda fərqlənməlidir + hooks **script-first, one-by-one user clarification** ilə.
+
+#### B3.1 — Video başlığı və ya hook
+
+```
+B3.1/6 — Video başlığı və ya əsas hook nədir? (1 cümlə — overall direction).
+```
+
+#### B3.2.* — Script-first hook extraction (bir-bir, 3 sub-step)
+
+**Sərt qayda:** Hooks **mütləq əvvəlcə ssenaridən və/və ya transkriptdən** çıxarılır (skill imagination QADAĞAN). Skill source citation göstərir (məs. "transkript, 1:32-də").
+
+Hər sub-step **ayrı suala bölünür** — istifadəçi cavab versin, sonra növbətisinə keç:
+
+```
+B3.2.1/6 — Variant A (question hook — curiosity):
+  Skill: ssenaridə/transkriptdə tapdığı konkret variantları sitat ilə göstərir,
+         + 1 tövsiyə proposal (3-5 söz, sual formalı).
+  İstifadəçi: "ok" və ya öz versiyası.
+
+B3.2.2/6 — Variant B (stat/concrete hook — urgency/shock):
+  Skill: konkret sitatlar + 1 declarative claim proposal.
+  İstifadəçi: "ok" və ya öz versiyası.
+
+B3.2.3/6 — Variant C (manifest/negation hook — statement):
+  Skill: konkret sitatlar + 1 manifest/negation proposal.
+  İstifadəçi: "ok" və ya öz versiyası.
+```
+
+Hər hook locked-dan sonra növbətisinə keç. Eyni anda 3-ünü vermə.
+
+#### B3.3 — Refs status
+
+```
+B3.5/6 — Mövcud refs (<list>) bu video üçün kifayət edirmi, yoxsa
+         əlavə şəkil yükləməlisən? (məs. mövzu-spesifik prop, mehman üzü,
+         abandoned scene fotosu)
+```
+
+#### B3.4 — Özəl istisna
+
+```
+B3.6/6 — Hər hansı özəl istisna varmı? (məs. "bu video sponsorlu, brand colour əlavə et")
+```
+
+**Niyə script-first one-by-one:**
+- Skill imagination ilə hook yazsa, müəllif niyyətindən kənara çıxa bilər
+- 3 hook eyni anda təklif olunsa, istifadəçi cognitive overload-a düşür
+- Sequential clarification = hər hook fokuslu nəzərdən keçirilir + dəyişdirilə bilər
+- Source citation = transparency (istifadəçi mənbənin nə qədər güclü olduğunu görür)
+
+Tam detal `variant-differentiation.md`-də ("Skill prosedur — script-first, bir-bir, user-driven" bölməsi).
+
+### Addım B4 — 3 variant fərqlilik matrisi qur
+
+`stylistics.md` Sahə 6 + `variant-differentiation.md` 5-ox matrisi əsasında **3 variant üçün ayrı-ayrı planlama**:
+
+| Ox | Variant A | Variant B | Variant C |
+|---|---|---|---|
+| Text hook tipi | Question (B3.2-dən) | Stat/concrete (B3.2-dən) | Manifest/negation (B3.2-dən) |
+| Background scene | Atmospheric / populated | Empty / abandoned (curiosity gap) | Symbolic / editorial |
+| Text color emphasis | Primary red dominant | White-on-dark (key word red accent) | Subdued red, atmosphere-led |
+| Composition formula | stylistics Sahə 6 alt. A | stylistics Sahə 6 alt. B | stylistics Sahə 6 alt. C |
+| Emotional mode | Curious / engaged | Urgent / shock | Contemplative / authority |
+
+**Brand DNA locked (hər 3-də eyni):** project palette, font family, safe zones, logo, aspect ratio, host identity. Yalnız **icra və composition** dəyişir.
+
+**Verify (B4 sonu):** 5/5 ox fərqlənir → ideal. 4/5 → acceptable. 3/5 və daha az → yenidən planla, real A/B differensiya yox.
+
+### Addım B5 — Hər variant üçün AZ plain-language təsvir + brief yaz
+
+> **Skeleton-first (sərt):** Hər variant **iki addımlı prompt** verir — Step-1 sklet (mətn+loqo, şəkilsiz, mərkəz boş) + Step-2 tam (skleti referans, mətn+loqo preserve, subject əlavə). Step-2 mətn font təsvirini təkrar yazmır. Detal: yuxarıdakı "Skeleton-first" sərt qaydası.
+
+Hər variant üçün **iki bölmə** hazırla:
+
+**(1) AZ plain-language təsvir** — istifadəçi anlayır nə görəcəyini (texniki termin yoxdur):
+
+```markdown
+### Variant A — <formul adı>
+
+**Bu kadrda nə görürük:**
+[2-3 cümlə plain AZ — "ev sahibinin üzü solda, gözləri geniş açıq, sağda böyük qırmızı mətn 'AI MƏNİ ƏVƏZ ETDİ?', arxa fon qara-narıncı qradient, sağ-altda kanal loqosu kiçik."]
+
+**Niyə bu formul:**
+[1 cümlə — psixoloji əsas, ctr-formulas.md-dən]
+```
+
+**(2) image-prompt-engineer brief** — model-spesifik prompt yazımı üçün structured handoff:
+
+```markdown
+### 🎬 youtube-thumbnail-designer → 🖼️ image-prompt-engineer (Variant A brief)
+
+**Project:** <layihə-adı>
+**Stylistic profile:** thumbnail-projects/<layihə-adı>/stylistics.md (oxu lazım gəlsə)
+**Formula:** <shock-reaction / clean-center / etc.>
+**Aspect:** 16:9 (1280×720 — YouTube native)
+**Output target:** static thumbnail (PNG, max 2MB)
+
+**Refs to attach:**
+- Image 1: thumbnail-projects/<layihə>/refs/host-face-{shock/sarcastic/smile/...}.png — host identity anchor (first-image priority, expression matches variant formula)
+- Image 2-N: <əlavə scene-specific refs istifadəçi yüklədikdə — məs. prop, guest face>
+- **Logo attach EDİLMİR** — POST-COMPOSITE workflow (AI generation-da yox, sonra Photoshop/Figma/Canva-da overlay)
+- Səbəb: AI image modelləri logo text fidelity preserve edə bilmir (knowledge/professional-techniques.md Principle 11)
+
+**🔬 TOPIC ENRICHMENT RESEARCH (CRITICAL — sərt qayda hər variant üçün):**
+
+Per knowledge/topic-enrichment-research.md 4-addım protokolu:
+
+```
+TOPIC ENRICHMENT (this variant's specific elements):
+- Topic extraction: <konkret event / object / location / brand / cultural reference from script>
+- Visual research findings:
+  - <element 1: kit colors, brand colors, landmark visuals, etc.>
+  - <element 2>
+- Decision matrix:
+  - Bg topic anchor: <decision + justification>
+  - Icon/badge: <decision + position + justification>
+  - Color accent (topic-derived, may override stylistics palette): <hex + topic justification>
+  - Prop/object: <decision>
+  - Cultural specific: <decision>
+- Prompt integration: <konkret sözlər prompt-a inteqrasiya olunur>
+```
+
+Bu bölmə **hər variant brief**-də doldurulur, sonra prompt yazımına ötürülür. Stylistics-locked invariants + topic enrichment = world-class output.
+
+**🚨 IDENTITY MATCH (CRITICAL — sərt, hər thumbnail-da məcburi):**
+
+Hər thumbnail prompt-un **başında** (PRESERVE list-dən əvvəl) bu opening statement məcburidir:
+
+```
+🚨 IDENTITY MATCH (CRITICAL — birə-bir məcburi):
+The subject must be the SAME PERSON shown in the first reference image.
+Not similar, not resembling — IDENTICAL. The viewer must immediately
+recognize this is the exact same person who appears in the channel's
+other videos. Friend/family of the host must instantly recognize them.
+```
+
+Verify clauses-də **7 açıq identity cümlə** məcburi:
+- IF face NOT IDENTICAL to reference → regenerate
+- IF eye shape/color, nose, jaw, cheekbones differ → regenerate
+- IF hair color/length/style differs → regenerate
+- IF facial hair (mustache/beard) differs → regenerate
+- IF skin tone/texture differs → regenerate
+- IF visual age differs → regenerate
+- IF friend/family would NOT recognize as same person → regenerate
+
+Detail: `knowledge/professional-techniques.md` Principle 12 + CLAUDE.md "Identity birə-bir match enforcement" alt-bölmə.
+
+**Composition (locked from stylistics + this formula):**
+- Subject placement: <stylistics Sahə 6-dan>
+- Face frame ratio: <stylistics-dən>
+- Expression: <stylistics-dən, bu variant-spesifik>
+- Text placement: <stylistics-dən>
+- Background: <stylistics Sahə 8-dən>
+
+**On-thumbnail text:**
+- Words: "<konkret 3-5 söz>"
+- Language: <stylistics Sahə 2-dən>
+- Font: <stylistics Sahə 4-dən, vizual model təsviri>
+- Color: <stylistics Sahə 3-dən>
+
+**Safe zones (məcburi — heç vaxt mətn/üz bura qoyma):**
+- Bottom-right 16% — boş (YT timestamp)
+- Top-right 12% — boş (channel overlay)
+
+**Verify clauses (prompt sonunda mütləq):**
+- Mətn 120px scale-də oxunmalıdır
+- Üz frame-in <N>%-i (stylistics-dən)
+- Sağ-alt 16% boş qalmalı
+- AZ glyphs (Ə, Ş, Ç, Ö, Ü, Ğ) düzgün render
+- Layihə palitrasından kənara çıxma (yalnız primary/accent/neutral)
+
+**Image model:**
+- Primary: <stylistics Sahə 11-dən>
+- Override: <əgər text > 4 söz və ya AZ glyph çox → Ideogram>
+
+→ Sən (image-prompt-engineer) prompt yaz: layihə-spesifik model dialect-ində, edit-mode (refs varsa) PRESERVE/REPLACE/DO NOT ADD struktur, verify clauses daxil. Final prompt:
+1. Inline code block-da chat-də (kopyalanmaq üçün)
+2. `thumbnail-projects/<layihə>/outputs/variant-A-prompt.md` faylına yazılır
+```
+
+### Addım B6 — Hand-off icra et
+
+`image-prompt-engineer` skill-ini çağır, yuxarıdakı brief-i ötür. 3 variant üçün 3 ayrı brief ötür (paralel və ya ardıcıl — istifadəçi qərarına görə).
+
+`image-prompt-engineer` hər biri üçün:
+- Layihənin əsas model-i (məs. Nano Banana 2) üçün tam prompt yazır
+- Edit-mode struktur (PRESERVE EXACTLY / REPLACE ONLY / DO NOT ADD)
+- Inline code block-da chat-də verir + `outputs/variant-{A,B,C}-prompt.md` faylına yazır
+
+### Addım B7 — Final paketləmə
+
+3 variant hazır olduqdan sonra istifadəçiyə yekun mesaj:
+
+> "3 variant hazırdır:
+>
+> 1. **Variant A — <formul>** → [AZ təsvir] → `outputs/variant-A-prompt.md`
+> 2. **Variant B — <formul>** → [AZ təsvir] → `outputs/variant-B-prompt.md`
+> 3. **Variant C — <formul>** → [AZ təsvir] → `outputs/variant-C-prompt.md`
+>
+> Hər prompt yuxarıda chat-də inline koddur — birbaşa modelə paste edə bilərsən.
+> Şəkillər generasiya olunduqdan sonra `outputs/` folderinə yüklə (məs. `variant-A.png`) — sonra YT-də A/B test ediləcəklər."
+
+---
+
+## Önəmli qaydalar
+
+### Prompt çatdırılma (sərt)
+Hər prompt **həm faylda HƏM də chat-də inline code block** verilir. "Fayldan kopyala" pattern QADAĞAN — istifadəçi söhbətdən birbaşa kopyalayır.
+
+### Plain-language təsvir (sərt)
+AZ təsvirdə texniki kinematik termin (MCU, rule of thirds, 50mm, f/2.8, anamorphic) **yoxdur**. Yalnız İngilis prompt-da (model dialect üçün) qalır.
+
+### Sual klasteri (sərt)
+İstifadəçiyə eyni anda bir neçə sual vermə — bir-bir. Cavabını gözlə, sonra növbətisinə keç.
+
+### `stylistics.md` immutability
+Bir dəfə yazıldıqdan sonra `stylistics.md` **dəyişdirilmir** (yalnız istifadəçi açıq tələb edirsə). Yeni video gəldikdə eyni profile reuse olunur — bu, brand consistency-nin əsas mexanizmidir.
+
+### Skeleton-first generasiya (sərt — hər thumbnail)
+Hər thumbnail **2 addımda** generasiya olunur: (1) **Sklet** — şəkilsiz, yalnız mətn (başlıq + hook) + loqo, mərkəz boş; (2) **Tam thumbnail** — sklet referans verilir, mətn+loqo olduğu kimi saxlanılır, subject mərkəzə əlavə olunur. Niyə: tək-addımlı generasiyada mətn və font tipləri qarışır. Hər variant üçün Step-1 + Step-2 prompt verilir. Sklet həm reusable brend kilidi (sabit başlıq+loqo), həm təmiz-tipografiya mexanizmidir.
+
+### Hand-off prinsipi
+Sən prompt yazmırsan. Sən stilistika + brief verirsən. `image-prompt-engineer` model-spesifik prompt yazımı üçün məsuldur. Code duplication yoxdur — onun bilik bazası (Nano Banana, Flux, Ideogram, Midjourney dialect-ləri) onsuz da mövcuddur.
+
+### Knowledge fayllarını lazım olanda oxu
+- Niche soruşulanda → `ctr-formulas.md` (hansı formul bu niche-ə uyğun)
+- Font qərarı zamanı → `typography.md` (AZ glyph dəstəyi + niche)
+- Rəng qərarı zamanı → `color-strategies.md`
+- Hər brief yazılanda → `safe-zones.md` + `mobile-legibility.md` (verify clauses üçün)
+- Setup-da input analizi → `youtube-analysis.md`
+
+Heç vaxt knowledge fayllarını bütünlüklə kontekstə yüklə — yalnız konkret sual üçün relevantı.