platinum-seo-engine

Use when: kullanıcı "aktif proje", "switch", "geç", "set active", "şu projeye geç", "context değiştir" der ya da `/pseo-active <slug>` çağırırsa. Also use when: portföyde birden fazla proje var ve sonraki komutların (`/pseo-status`, `/pseo-quickwin`, `/pseo-monthly`, `/pseo-driftcheck`) hangi projeye uygulanacağını belirten `shared/active.json` marker'ı set edilecek. Do not use when: yeni bir proje açma (`/pseo-init`), aktif projenin durumunu görme (`/pseo-status`) ya da tek seferlik bir komuta slug'ı argüman olarak doğrudan geçirmek yeterliyse.

Use when: kullanıcı "onayla", "approve", "izin ver", "consent", "şu aksiyona izin" der ya da `/pseo-approve <run_id> <action> <target>` çağırırsa. Also use when: bir AMO run'ı geri-alınamaz/dışa-dönük bir aksiyon (git push / silme / POST / GSC sitemap submit / Indexing URL_UPDATED / oversized DFS) için operatör onayı bekliyor; consent defterine `projects/{slug}/_state/consent.jsonl` hash-chained bir satır yazılacak. Do not use when: aksiyonu fiilen çalıştırma (gate 2b kontrol eder), session bağlama (`/pseo-bind`), portföy-geneli aktif proje set etme (`/pseo-active`) ya da durum görme (`/pseo-status`).

Use when: kullanıcı "bu session'ı bağla", "bind", "session bağla", "bu projeyi bu pencereye kilitle", "paralel proje" der ya da `/pseo-bind <slug>` çağırırsa. Also use when: aynı anda 3-5 projeyi ayrı Claude session'larında (VS Code / Mac app / CLI) yürütürken her session'ın HANGI projeye ait olduğunu session UUID'sine göre işaretlemek (cross-contamination önleme); marker `shared/sessions/<session-id>.json` yazılacak. Do not use when: portföy-geneli aktif projeyi set etme (`/pseo-active` — bu shared/active.json yazar, session'a özel değil), yeni proje açma (`/pseo-init`) ya da durum görme (`/pseo-status`).

Use when: kullanıcı "cannibalization", "kannibalizasyon", "keyword conflict", "URL çakışması", "aynı keyword'e iki sayfa", "anahtar kelime çakışması", "iki sayfam aynı sorguya çıkıyor", "intent split" der ya da `/pseo-cannibalization` çağırırsa. Also use when: aktif projenin GSC verisi mevcut (gsc-pull önce çalışmış); aynı sorguda ≥2 URL ranking; quick-win / content-decay ile birlikte triage; F-08 cross-sheet invariant kontrolünden sonra cannibalization sheet doldurulacak. Do not use when: tek URL audit (`on-page-audit` skill), pozisyon 11-20 fırsat (`/pseo-quickwin`), tek sayfa decay (`/pseo-content-decay`), tech-audit (`tech-audit` skill); master.xlsx yokken (`/pseo-init` önce).

Use when: kullanıcı "içerik decay", "content decay", "tıklama düşen sayfalar", "ctr düştü", "90 gün öncesine göre azalma", "trafik kaybeden sayfalar", "decay analizi", "content_decay sheet yenile", "ranking decay" der ya da `/pseo-content-decay` çağırırsa. Also use when: aktif projenin GSC verisi master.xlsx'te mevcut (gsc-pull önce çalışmış); 90-günlük recent + previous pencere karşılaştırması; pillar bazlı içerik decay haritası lazım; downstream `revise-content` / `new-content-plan` skill'leri tüketecek. Do not use when: kanibalizasyon (`/pseo-cannibalization`), GSC delta ingestion (`gsc-pull` skill direkt), tek-URL audit (`tech-audit` skill), schema markup drift (`/pseo-schema-audit`); master.xlsx yokken (`/pseo-init` + `gsc-pull` önce).

Use when: kullanıcı "AIO analiz", "competitor SERP analizi", "top10 AIO map", "AI overview rakip", "rakip içerik AIO citation", "SERP pattern map" der ya da /pseo-aio-competitor-map çağırır; SERP top-N fetch (DataForSEO heavy) + Scrapling tier-1 fetch (per URL) + R-109/R-110/R-111 competitor content-quality signal detect (schema markup + entity reference + author authority) + serp_aio AIO presence (references[]) + competitor_pages.jsonl staging. Also use when: yeni keyword için pre-content-plan AIO landscape haritalanacak; mevcut pillar için competitor refresh yapılacak; brand'ın AIO-friendly olup olmadığını competitor content-quality + AIO presence (serp_aio references[]) ile test edilecek; cluster-map sonrası seçilen ana keyword için competitor R-109..R-111 sinyalleri ölçülecek. Do not use when: SERP rank tracking için (gsc skill); manuel tek URL analiz için (on-page-audit kullan); content gap için (content-gaps kullan); kendi sitemizin AIO-friendliness denetimi için (schema-audit + on-page-audit kombinasyonu); target_keyword empty ya da whitespace (DURUR #5); budget_credits_per_day aşılmış (DURUR #1 — skip skill, AMBER); SERP empty top_n=0 (DURUR #2 REJECT).

Use when: kullanıcı "cannibalization", "kannibalizasyon", "keyword conflict", "aynı keyword'e iki sayfa", "URL çakışması", "anahtar kelime çakışması", "iki sayfam aynı sorguya çıkıyor", "intent split" der ya da /pseo-cannibalization çağırır. Also use when: aktif projenin GSC verisi mevcut; aynı sorguda ≥2 URL ranking ediyor; quick-win / content-decay ile birlikte triage; F-08 invariant kontrolünden sonra cannibalization sheet doldurulacak. Do not use when: tek sayfanın decay analizi (content-decay), pozisyon 11-20 fırsat taraması (quick-wins), tech audit (tech-audit), yeni içerik planı (new-content-plan) — ayrı discovery skill'leri. Master.xlsx yokken çağırma; init-project önce çalışmalı (DURUR #6).

Use when: kullanıcı "rakip analizi", "competitive analysis", "competitor monitoring", "rakip site snapshot", "rakip içerik takibi", "competitor diff", "rakip keyword'leri", "weekly competitor" der ya da /pseo-competitive-analysis çağırır. Also use when: hedef alan adı için DFS competitors_domain ile rakip listesi çekilecek; rakip URL'leri Scrapling tier-escalation §14.5 ile fetch edilecek; ADR-025 Phase 7+ S1_competitor_snapshot sub-schema enforcement gerekiyor; weekly cadence (S1 senaryosu) cron tetikliyor; sf-import / gsc-pull veri çekiminden bağımsız rakip izleme talep edildi. Do not use when: kendi sitemizin on-page kontrolü (on-page-audit), kendi GSC verisi (gsc-pull), keyword volume/ideas (dfs-pull / cluster-map), cannibalization (cannibalization), tech audit (tech-audit) — ayrı skill'ler. Master.xlsx yokken çağırma; init-project önce çalışmalı. Budget pre-flight FAIL ise fallback YASAK (DURUR #2). >50% URL all-tiers fail ise batch unhealthy → DURUR #4. Tier_escalation override §14.5 canonical sequence dışındaysa STOP (DURUR #7).

Use when: kullanıcı "içerik decay", "content decay", "tıklama düşen sayfalar", "ctr düştü", "90 gün öncesine göre azalma", "trafik kaybeden sayfalar", "decay analizi", "content_decay sheet yenile" der ya da /pseo-content-decay çağırır. Also use when: aktif projenin GSC verisi master.xlsx'te mevcut (gsc-pull önce çalışmış); 90-günlük recent + previous pencere karşılaştırması yapılacak; pillar bazlı içerik decay haritası lazım; downstream content-improve / new-content-plan skill'leri bu listeyi tüketecek. Do not use when: quick-win opportunity scoring (quick-wins skill), GSC delta ingestion (gsc-pull skill), tek-URL audit (tech-audit skill), cannibalization analizi — ayrı discovery skill'leri. Master.xlsx yokken çağırma; init-project + gsc-pull önce çalışmalı (DURUR #6).

Use when: kullanıcı "content gap", "içerik açığı", "rakip keyword bulalım", "yeni keyword fırsatı", "konu açığı analizi", "competitor keyword discovery", "yeni içerik için keyword araştırması", "ilgili keyword'leri çıkar" der ya da /pseo-content-gaps çağırır. DataForSEO keyword_ideas + related_keywords (+ optional content_analysis_search) raw JSON'larını inbox/dfs/ altına persist eder ve `_state/staging/` altına shape-adapted staging table yazar (Phase 8 cluster-map / new-content-plan konsume eder). Also use when: aktif projenin seed keyword listesi config'te tanımlı; TR (location_code=2792, language_code='tr') varsayılan; budget pre-flight PASS; yeni içerik planı (new-content-plan) için aday havuzu gerekiyor; cluster-map için keyword inventory besleniyor. Do not use when: GSC veri ingestion (gsc-pull), DFS volume lookup (dfs-pull), tek sayfa decay analizi (content-decay), pozisyon 11-20 fırsat taraması (quick-wins), URL çakışması (cannibalization) gerekiyor — ayrı discovery / ingestion skill'leri. Master.xlsx yokken çağırma; init- project önce çalışmalı (DURUR #4). Budget aşılmışsa fallback YASAK (DURUR #2).

12 hooks across 6 events