katman-mcp 0.1.0

package/dist/tools/method/data/prompts.js

@@ -0,0 +1,633 @@
+/** Placeholders the prompt bodies may contain; katman_prompt fills them from research/config/scan. */
+export const PLACEHOLDERS = [
+    "brand", "domain", "site_url", "category", "sentence", "not_x", "situation", "situation_url", "competitors",
+    "languages", "app_paths",
+];
+export const PROMPTS = [
+    {
+        id: "P0",
+        tag: { en: "EVERY SESSION", tr: "HER OTURUM" },
+        title: { en: "Context: at the start of every session", tr: "Bağlam: her oturumun başında" },
+        when: {
+            en: "At the start of every coding session on SEO/GEO work, before any code changes.",
+            tr: "SEO/GEO üzerinde çalışılan her oturumun başında, kod değişikliğinden önce.",
+        },
+        body: {
+            tr: `Bu projede SEO (Google, Bing) ve GEO (ChatGPT, Claude, Gemini, Perplexity gibi asistanlarda görünürlük) üzerinde çalışacağız.
+Önce .katman/research.md ve .katman/plan.md dosyalarını oku: müşteri durumları, markanın tek cümlesi, "X değildir" notu ve rakipler research.md'de; sayfa planı plan.md'de.
+Kurallar:
+- research.md'de kaynağı olmayan hiçbir sayı, müşteri yorumu, rakip bilgisi ya da iddia ekleme. Bilmediğin yere [DOLDUR] yaz.
+- Sayfada görünmeyen hiçbir bilgiyi schema'ya, meta açıklamaya ya da llms.txt'ye yazma.
+- Giriş gerektiren uygulama ekranlarına dokunma; yalnızca herkese açık sayfalar.
+- Her değişiklikten sonra hangi dosyada neyi değiştirdiğini liste hâlinde yaz.`,
+            en: `In this project we will work on SEO (Google, Bing) and GEO (visibility in assistants such as ChatGPT, Claude, Gemini and Perplexity).
+First read .katman/research.md and .katman/plan.md: the customer situations, the brand's one sentence, the "not-X" note and the competitors are in research.md; the page plan is in plan.md.
+Rules:
+- Don't add any number, customer review, competitor fact or claim that has no source in research.md. Where you don't know, write [FILL].
+- Never put information into schema, meta descriptions or llms.txt that isn't visible on the page.
+- Don't touch app screens that require login; public pages only.
+- After every change, list which file you changed and what you changed.`,
+        },
+        accept: {
+            en: "The assistant writes no code until it has summarised research.md and you have approved the page plan.",
+            tr: "Asistan research.md’yi özetleyip sayfa planını senden onaylatmadan kod yazmıyor.",
+        },
+        why: {
+            en: "An AI coding tool starts from zero every session; if the rules aren't written down, it makes things up.",
+            tr: "Yapay zekâ kod aracı her oturumda sıfırdan başlar; kurallar yazılı değilse uydurur.",
+        },
+        verifiedBy: [
+            { tool: "katman_research", check: { en: "mode \"show\": research is complete enough to summarise (completeness %, no [FILL] in what the page needs)", tr: "mode \"show\": araştırma özetlenecek kadar dolu (tamamlanma yüzdesi, sayfanın ihtiyaç duyduğu yerde [DOLDUR] yok)" } },
+            { tool: "manual", check: { en: "you approved the page plan in .katman/plan.md before any code change", tr: "kod değişikliğinden önce .katman/plan.md’deki sayfa planını onayladınız" } },
+        ],
+        gates: [],
+        week: 1,
+        changesCode: false,
+    },
+    {
+        id: "P1",
+        tag: { en: "DAY ONE", tr: "İLK GÜN" },
+        title: { en: "Audit: a report without changing code", tr: "Denetim: kod değiştirmeden rapor" },
+        when: {
+            en: "On day one, and on every site you take over: an audit that changes nothing.",
+            tr: "İlk gün ve devraldığınız her sitede: hiçbir şeyi değiştirmeyen denetim.",
+        },
+        body: {
+            tr: `Kodu değiştirme, yalnızca rapor ver. Yayındaki ({site_url}) her herkese açık sayfa için bir tablo çıkar:
+URL | sayfa sunucuda HTML olarak mı üretiliyor, tarayıcıda JavaScript ile mi (SSR / SSG / CSR) | <title> ve uzunluğu | meta description ve uzunluğu | canonical | robots meta | H1 sayısı | alt metni olmayan görsel | og:image | JSON-LD türleri | bu sayfaya link veren sayfa sayısı.
+Ayrıca şunları yanıtla:
+1. robots.txt ve sitemap.xml var mı, nasıl üretiliyor, sitemap'te hangi adresler var?
+2. Bulunmayan bir adres (ör. /olmayan-sayfa) 404 durum kodu mu dönüyor, 200 mü?
+3. Menü ve linkler <a href> mi, yoksa onClick ile mi yönlendiriyor?
+4. Aynı site başka bir adreste de yayında mı (önizleme, staging, *.vercel.app gibi)?
+Sonunda en önemli 10 sorunu, trafiğe etkisine göre sırala. Her biri için hangi dosyanın değişeceğini yaz.`,
+            en: `Don't change any code; report only. For every public page on the live site ({site_url}), produce a table:
+URL | is the page rendered as HTML on the server or with JavaScript in the browser (SSR / SSG / CSR) | <title> and its length | meta description and its length | canonical | robots meta | number of H1s | images without alt text | og:image | JSON-LD types | number of pages linking to this page.
+Also answer:
+1. Do robots.txt and sitemap.xml exist, how are they generated, which URLs are in the sitemap?
+2. Does a URL that doesn't exist (e.g. /this-page-does-not-exist) return a 404 status code or 200?
+3. Are the menu and the links <a href> elements, or do they navigate with onClick?
+4. Is the same site also live at another address (preview, staging, *.vercel.app and similar)?
+Finally, rank the 10 most important problems by their impact on traffic. For each one, say which file will change.`,
+        },
+        accept: {
+            en: "Every public page is in the table; there is a clear answer on at least 404s, rendering and orphan pages.",
+            tr: "Her herkese açık sayfa tabloda; en az 404, render şekli ve yetim sayfalar konusunda net bir cevap var.",
+        },
+        why: {
+            en: "Most of the viral list's 20 items show up in this one report. Start fixing from the report.",
+            tr: "Listenin 20 maddesinin çoğu bu tek raporla görünür. Düzeltmeye rapordan başlayın.",
+        },
+        katmanNote: {
+            en: "Katman produces most of this table for you: katman_scan_code (rendering verdict, routes, onClick links, preview hosts) and katman_audit_site (per-URL checks, soft 404, orphan pages, AI bot access). Build the report from their output.",
+            tr: "Bu tablonun çoğunu Katman üretir: katman_scan_code (render şekli, yollar, onClick linkler, önizleme adresleri) ve katman_audit_site (adres bazında kontroller, sahte 404, yetim sayfalar, yapay zekâ botu erişimi). Raporu onların çıktısından kurun.",
+        },
+        verifiedBy: [
+            { tool: "katman_scan_code", check: { en: "rendering verdict (SSR/SSG/CSR), public vs app routes, onClick navigation, preview-URL patterns", tr: "render kararı (SSR/SSG/CSR), herkese açık ve uygulama yolları, onClick yönlendirme, önizleme adresleri" } },
+            { tool: "katman_audit_site", check: { en: "one row per public URL; soft-404 test; pages with 0 internal links in (orphans)", tr: "herkese açık her adres için bir satır; sahte 404 testi; hiç iç link almayan (yetim) sayfalar" } },
+        ],
+        gates: ["read", "quote", "fit"],
+        week: 1,
+        changesCode: false,
+    },
+    {
+        id: "P2",
+        tag: { en: "IF SPA, DO THIS FIRST", tr: "SPA İSE ÖNCE BU" },
+        title: { en: "Move the text into the HTML (don't hide it in JavaScript)", tr: "Metni HTML’e taşı (JavaScript’e saklama)" },
+        when: {
+            en: "First, if the site is a single-page app (React/Vite, older Lovable, Bolt, Replit, CRA) or the audit shows few words with JavaScript off.",
+            tr: "Site tek sayfa uygulamaysa (React/Vite, eski Lovable, Bolt, Replit, CRA) ya da denetim JavaScript kapalıyken az kelime gösteriyorsa, önce bu.",
+        },
+        body: {
+            tr: `Sayfaların metni JavaScript çalışmadan da HTML'de görünmeli: başlıklar, paragraflar, fiyatlar, SSS cevapları ve linkler.
+Mevcut çatıya göre en küçük değişikliği seç ve neden seçtiğini yaz: sunucu tarafı render (SSR), derleme anında statik üretim (SSG) ya da herkese açık sayfalar için ön-render.
+Uygulama içi ekranları olduğu gibi bırak. Yönlendirmede # parçası değil, gerçek yollar (History API) kullan.
+Bittiğinde her sayfa için şu komutun çıktısında H1'in ve ilk paragrafın metin olarak göründüğünü göster:
+curl -s {site_url}/SAYFA | sed 's/<[^>]*>/ /g' | tr -s ' ' | head -c 600`,
+            en: `Page text must be in the HTML even without JavaScript: headings, paragraphs, prices, FAQ answers and links.
+Pick the smallest change for the current framework and say why you chose it: server-side rendering (SSR), static generation at build time (SSG), or prerendering the public pages.
+Leave the in-app screens as they are. For routing, use real paths (History API), not # fragments.
+When you're done, show for every page that the H1 and the first paragraph appear as text in the output of:
+curl -s {site_url}/PAGE | sed 's/<[^>]*>/ /g' | tr -s ' ' | head -c 600`,
+        },
+        accept: {
+            en: "With JavaScript off, every page's H1 and first paragraph can be read.",
+            tr: "JavaScript kapalıyken her sayfanın H1’i ve ilk paragrafı okunuyor.",
+        },
+        why: {
+            en: "Google runs JavaScript later but still recommends server rendering; per our research notes, ChatGPT's search bot doesn't run JavaScript.",
+            tr: "Google JavaScript’i sonradan çalıştırıyor ama yine de sunucuda render’ı öneriyor; araştırma notumuza göre ChatGPT’nin arama botu JavaScript çalıştırmıyor.",
+        },
+        katmanNote: {
+            en: "Strongest evidence of all GEO tactics: across 500M+ logged fetches, no major AI crawler ran JavaScript. Prerender the same content users see; serving bots different or richer content is cloaking (Google spam policy, which since May 2026 also covers manipulating AI answers).",
+            tr: "Bütün GEO taktikleri içinde kanıtı en güçlü olan bu: 500 milyonu aşan kayıtlı istekte hiçbir büyük yapay zekâ tarayıcısı JavaScript çalıştırmadı. Kullanıcının gördüğü içeriğin aynısını ön-render edin; bota farklı ya da daha zengin içerik göstermek gizlemedir (cloaking; Google’ın spam politikası Mayıs 2026’dan beri yapay zekâ cevaplarını manipüle etmeyi de kapsıyor).",
+        },
+        verifiedBy: [
+            { tool: "katman_audit_site", check: { en: "pages[].wordsJsOff (words in the raw HTML) and pages[].firstParagraph are present for every public page", tr: "her herkese açık sayfada pages[].wordsJsOff (ham HTML’deki kelime) ve pages[].firstParagraph dolu" } },
+            { tool: "katman_scan_code", check: { en: "rendering.verdict is ssr, ssg, hybrid or static-html for the public routes", tr: "herkese açık yollar için rendering.verdict ssr, ssg, hybrid ya da static-html" } },
+        ],
+        gates: ["read"],
+        week: 2,
+        changesCode: true,
+    },
+    {
+        id: "P3",
+        title: { en: "Head tags from one source", tr: "Head etiketleri tek kaynaktan" },
+        when: {
+            en: "Week 2, when titles or descriptions are missing, duplicated, too long, or written in scattered files.",
+            tr: "2. hafta: title ya da açıklamalar eksik, tekrarlı, fazla uzun ya da dağınık dosyalarda yazılıysa.",
+        },
+        body: {
+            tr: `Her sayfanın başlık, açıklama ve paylaşım bilgilerini tek bir dosyadan üret (ör. src/seo/pages.ts). Her sayfada:
+- benzersiz <title>: önce müşterinin durumu, sonra marka ({brand}); yaklaşık 60 karakter
+- benzersiz meta description: research.md'deki "tek cümle" kalıbıyla ("{sentence}"), yaklaşık 150-160 karakter
+- kendi tam adresini gösteren canonical (https, {domain} alan adıyla)
+- <html lang="..."> sayfa hangi dildeyse (sitenin dilleri: {languages})
+- og:title, og:description, og:url, og:image (1200x630, tam adres), og:image:alt, twitter:card = summary_large_image
+- çok dilliyse her dil için hreflang, kendisi dahil, ve x-default
+og:image için markanın renkleriyle 1200x630 bir kart tasarla ve /img/og/ altına koy.
+Sonunda iki sayfanın aynı title ya da description'ı paylaşmadığını kontrol eden bir test yaz.`,
+            en: `Generate every page's title, description and sharing tags from a single file (e.g. src/seo/pages.ts). On every page:
+- a unique <title>: the customer's situation first, then the brand ({brand}); about 60 characters
+- a unique meta description following the "one sentence" pattern in research.md ("{sentence}"); about 150–160 characters
+- a canonical pointing to the page's own full URL (https, on {domain})
+- <html lang="..."> set to the page's language (site languages: {languages})
+- og:title, og:description, og:url, og:image (1200x630, absolute URL), og:image:alt, twitter:card = summary_large_image
+- if the site is multilingual: hreflang for every language, including the page itself, plus x-default
+For og:image, design a 1200x630 card in the brand's colours and put it under /img/og/.
+Finally, write a test that checks no two pages share a title or a description.`,
+        },
+        accept: {
+            en: "The test passes; every page's head comes from one file; the og:image URL opens in a browser.",
+            tr: "Test geçiyor; her sayfanın head’i tek dosyadan geliyor; og:image adresi tarayıcıda açılıyor.",
+        },
+        why: {
+            en: "Titles and descriptions written in scattered files get copied and go stale. The sentence an assistant repeats also comes from this description.",
+            tr: "Başlık ve açıklama dağınık dosyalarda yazılınca kopyalanır ve eskir. Asistanın söylediği cümle de bu açıklamadan gelir.",
+        },
+        verifiedBy: [
+            { tool: "katman_audit_site", check: { en: "title and description present, unique and within length; canonicalSelf; ogImage; lang; reciprocal hreflang", tr: "title ve açıklama var, benzersiz, uzunluk sınırında; canonical kendine; og:image; lang; karşılıklı hreflang" } },
+            { tool: "katman_scan_code", check: { en: "files.headSource points to one head/SEO source", tr: "files.headSource tek bir head/SEO kaynağını gösteriyor" } },
+        ],
+        gates: ["quote"],
+        week: 2,
+        changesCode: true,
+    },
+    {
+        id: "P4",
+        title: { en: "robots.txt and sitemap.xml", tr: "robots.txt ve sitemap.xml" },
+        when: {
+            en: "Week 2, when robots.txt or sitemap.xml is missing, blocks bots, or lists pages that shouldn't be indexed.",
+            tr: "2. hafta: robots.txt ya da sitemap.xml yoksa, botları engelliyorsa ya da dizine girmemesi gereken sayfaları listeliyorsa.",
+        },
+        body: {
+            tr: `Kökte robots.txt oluştur:
+- Arama motorlarına ve yapay zekâ botlarına adıyla izin ver: Googlebot, Bingbot, OAI-SearchBot, ChatGPT-User, GPTBot, ClaudeBot, Claude-User, Claude-SearchBot, PerplexityBot, Perplexity-User.
+- Yalnızca uygulama yollarını kapat (ör. {app_paths}).
+- En alta: Sitemap: {site_url}/sitemap.xml
+sitemap.xml'i sayfa listesinden derleme anında üret: yalnızca 200 dönen, canonical ve indekslenmesini istediğimiz adresler. lastmod yalnızca sayfanın metni değiştiğinde değişsin (her derlemede bugünün tarihi değil).
+Giriş, kayıt, ödeme, teşekkür ve site içi arama sayfalarını sitemap'e koyma; bunlara <meta name="robots" content="noindex,follow"> ekle.
+Dikkat: noindex eklediğin bir sayfayı robots.txt'de kapatma; kapatırsan Google noindex'i göremez.
+Dikkat: çıplak önek yazma (Disallow: /t hem /tr'yi hem /tools'u kapatır); Content-Signal gibi standart dışı satırları yorum olarak yaz. Örnek dosya: Ek A (katman_generate robots.txt bu projeye göre üretir).`,
+            en: `Create robots.txt at the root:
+- Allow search engines and AI bots by name: Googlebot, Bingbot, OAI-SearchBot, ChatGPT-User, GPTBot, ClaudeBot, Claude-User, Claude-SearchBot, PerplexityBot, Perplexity-User.
+- Close only the app paths (e.g. {app_paths}).
+- At the bottom: Sitemap: {site_url}/sitemap.xml
+Generate sitemap.xml from the page list at build time: only URLs that return 200, are canonical and that we want indexed. lastmod changes only when the page's text changes (not today's date on every build).
+Keep login, sign-up, checkout, thank-you and on-site search pages out of the sitemap; give them <meta name="robots" content="noindex,follow">.
+Careful: don't close a page you gave noindex in robots.txt; if you do, Google can't see the noindex.
+Careful: never write bare prefixes (Disallow: /t closes both /tr and /tools); write non-standard lines such as Content-Signal as comments. Sample file: appendix A (katman_generate robots.txt builds it for this project).`,
+        },
+        accept: {
+            en: "robots.txt has no `Disallow: /`; every URL in the sitemap returns 200 and is canonical; no noindex page is in the sitemap.",
+            tr: "robots.txt’de Disallow: / yok; sitemap’teki her adres 200 dönüyor ve canonical; noindex’li sayfa sitemap’te değil.",
+        },
+        why: {
+            en: "robots.txt manages crawling, not the index. One wrong line closes the whole site; a missing permission leaves the assistant bots outside.",
+            tr: "robots.txt taramayı yönetir, dizini değil. Yanlış bir satır bütün siteyi kapatır; eksik bir izin asistan botlarını dışarıda bırakır.",
+        },
+        katmanNote: {
+            en: "robots.txt is a request; the CDN decides at the door. After changing robots.txt, check that AI bots get 200 through your CDN/firewall (book ch. 6).",
+            tr: "robots.txt bir ricadır; kapıdaki kararı CDN verir. robots.txt’yi değiştirdikten sonra yapay zekâ botlarının CDN ya da güvenlik duvarından 200 aldığını kontrol edin (06. bölüm).",
+        },
+        verifiedBy: [
+            { tool: "katman_audit_site", check: { en: "site.robots: blocksAll false, no blockedAiTokens, no invalidLines or bare prefixes; sitemap URLs all 200, canonical, not noindex", tr: "site.robots: blocksAll false, blockedAiTokens boş, geçersiz satır ya da çıplak önek yok; sitemap adreslerinin hepsi 200, canonical, noindex değil" } },
+            { tool: "katman_generate", check: { en: "artifact robots.txt gives the reference file for this project", tr: "robots.txt çıktısı bu projeye göre örnek dosyayı verir" } },
+        ],
+        gates: ["read"],
+        week: 2,
+        changesCode: true,
+    },
+    {
+        id: "P5",
+        title: { en: "Schema (JSON-LD)", tr: "Schema (JSON-LD)" },
+        when: {
+            en: "Week 2, after P3: sitewide Organization and WebSite, plus the right type on each page.",
+            tr: "2. hafta, P3’ten sonra: bütün sitede Organization ve WebSite, her sayfada doğru tip.",
+        },
+        body: {
+            tr: `Sayfalara JSON-LD ekle, yalnızca sayfada görünen bilgiyle:
+- Tüm sitede: Organization (name, url, logo, sameAs: sosyal hesaplar; markanız başka bir şeyle karışıyorsa alternateName ve disambiguatingDescription ile "X değildir": "{not_x}") ve WebSite.
+- Ürün / hizmet sayfası: Service ya da SoftwareApplication; fiyat sayfadaki ile birebir aynı.
+- Yazılar ve rehberler: Article (headline, datePublished, dateModified, author).
+- Alt sayfalar: BreadcrumbList. SSS bölümü olan sayfa: FAQPage.
+JSON-LD'yi sayfa içeriğiyle aynı veriden üret; elle ikinci kez yazma.
+Bittiğinde her sayfanın JSON-LD bloğunun geçerli JSON olduğunu doğrulayan bir test ekle.`,
+            en: `Add JSON-LD to the pages, using only information visible on the page:
+- Sitewide: Organization (name, url, logo, sameAs: social accounts; if your brand gets confused with something, add alternateName and a "not-X" disambiguatingDescription: "{not_x}") and WebSite.
+- Product / service page: Service or SoftwareApplication; the price exactly as on the page.
+- Posts and guides: Article (headline, datePublished, dateModified, author).
+- Sub-pages: BreadcrumbList. A page with an FAQ section: FAQPage.
+Generate the JSON-LD from the same data as the page content; never write it by hand a second time.
+When you're done, add a test that checks every page's JSON-LD block is valid JSON.`,
+        },
+        accept: {
+            en: "Google's Rich Results Test shows no errors; every price and claim in the schema appears word for word on the page.",
+            tr: "Google Zengin Sonuçlar Testi’nde hata yok; schema’daki her fiyat ve iddia sayfada aynen yazıyor.",
+        },
+        why: {
+            en: "Schema doesn't guarantee rich results; the FAQ rich result was retired in May 2026. Its real job: saying who you are in one place a machine will read.",
+            tr: "Schema zengin sonuç garantisi vermez; SSS zengin sonucu Mayıs 2026’da kalktı. Asıl işi: kim olduğunuzu makinenin okuyacağı tek bir yerde söylemek.",
+        },
+        katmanNote: {
+            en: "Treat schema as hygiene, not a lever: a 1,885-page difference-in-differences study found no citation lift. Do it right and quickly, then spend the time on situation pages and mentions.",
+            tr: "Schema’yı kaldıraç değil temizlik işi sayın: 1.885 sayfalık bir fark-içinde-fark çalışması alıntılanmada artış bulmadı. Doğru ve hızlı yapın, zamanı durum sayfalarına ve bahsedilmeye ayırın.",
+        },
+        verifiedBy: [
+            { tool: "katman_audit_site", check: { en: "pages[].jsonLdErrors = 0 and the expected types in pages[].jsonLdTypes", tr: "pages[].jsonLdErrors = 0 ve pages[].jsonLdTypes’ta beklenen tipler" } },
+            { tool: "katman_generate", check: { en: "organization-jsonld / website-jsonld / software-jsonld built from research (not-X in disambiguatingDescription)", tr: "organization-jsonld / website-jsonld / software-jsonld araştırmadan üretilir (not-X disambiguatingDescription’da)" } },
+            { tool: "manual", check: { en: "Rich Results Test (search.google.com/test/rich-results) shows no errors", tr: "Zengin Sonuçlar Testi (search.google.com/test/rich-results) hata göstermiyor" } },
+        ],
+        gates: ["quote"],
+        week: 2,
+        changesCode: true,
+    },
+    {
+        id: "P6",
+        tag: { en: "FOR EACH SITUATION", tr: "HER DURUM İÇİN" },
+        title: { en: "Write a situation page", tr: "Durum sayfası yaz" },
+        when: {
+            en: "Week 3, once for every customer situation in research (start with 3–5).",
+            tr: "3. hafta: araştırmadaki her müşteri durumu için bir kez (önce 3–5 tane).",
+        },
+        body: {
+            tr: `research.md'deki şu durum için yeni bir sayfa yaz: "{situation}"
+URL: {situation_url}
+- H1: müşterinin kendi cümlesi.
+- İlk 1-3 cümle soruya doğrudan cevap: müşteri ne getirir, biz ne yaparız, eline ne geçer, hangi korkusu gereksiz (markanın tek cümlesi: "{sentence}").
+- Hemen deneme alanı ya da tek bir net eylem (kayıt, dosya yükleme, fiyat).
+- Kanıt: research.md'deki sayı, tarihiyle.
+- Nasıl çalışır: 3-5 adım, düz metin.
+- Kimler için değil: 2-3 madde.
+- Dürüst karşılaştırma: alternatifler ve hangisi kime uygun.
+- 5-8 soruluk SSS; sorular müşterinin ağzından.
+- İlgili 3-5 sayfaya metinli link; sayfanın altında güncelleme tarihi ve yazar.
+P3 ve P5'teki kurallara uy. Sayfayı sitemap'e ve ilgili sayfalardan linke ekle.`,
+            en: `Write a new page for this situation from research.md: "{situation}"
+URL: {situation_url}
+- H1: the customer's own sentence.
+- The first 1–3 sentences answer the question directly: what the customer brings, what we do, what they get, which fear is unnecessary (the brand's one sentence: "{sentence}").
+- An immediate try-it area or one clear action (sign-up, file upload, pricing).
+- Proof: the number from research.md, with its date.
+- How it works: 3–5 steps, plain text.
+- Who it's not for: 2–3 bullets.
+- An honest comparison: the alternatives and which one fits whom.
+- An FAQ with 5–8 questions, in the customer's words.
+- Text links to 3–5 related pages; the update date and the author at the bottom of the page.
+Follow the rules in P3 and P5. Add the page to the sitemap and link to it from related pages.`,
+        },
+        accept: {
+            en: "Read on their own, the first three sentences answer the question; no [FILL] is left on the page; at least one page links to it.",
+            tr: "İlk üç cümle tek başına okununca soruyu cevaplıyor; sayfada [DOLDUR] kalmadı; en az bir sayfadan link alıyor.",
+        },
+        why: {
+            en: "On the sample site, 59% of ChatGPT visitors landed on two situation pages; 8 of the 17 paying customers came from one of them.",
+            tr: "Örnek sitede ChatGPT ziyaretçilerinin %59’u iki durum sayfasına indi; ödeme yapan 17 müşterinin 8’i birinden geldi.",
+        },
+        katmanNote: {
+            en: "Put the key claim in the H1 and the first ~200 characters: ChatGPT's index is reported to keep about 200 characters around the H1. Publish 5–10 such pages a week at most; mass-produced intent pages count as scaled content abuse.",
+            tr: "Asıl iddiayı H1’e ve ilk ~200 karaktere koyun: ChatGPT’nin dizininin H1 çevresinde yaklaşık 200 karakter tuttuğu bildiriliyor. Haftada en fazla 5–10 böyle sayfa yayınlayın; seri üretilmiş niyet sayfaları ölçekli içerik istismarı (scaled content abuse) sayılır.",
+        },
+        verifiedBy: [
+            { tool: "katman_lint_content", check: { en: "page_type \"situation\": first sentences answer, no placeholders, FAQ 5–8, not-for, alternatives, ≥3 internal links", tr: "page_type \"situation\": ilk cümleler cevap veriyor, yer tutucu yok, SSS 5–8, kimler için değil, alternatifler, ≥3 iç link" } },
+            { tool: "katman_audit_site", check: { en: "urls mode after deploy: 200, wordsJsOff, firstParagraph, internalLinksIn ≥ 1, inSitemap", tr: "yayından sonra urls modu: 200, wordsJsOff, firstParagraph, internalLinksIn ≥ 1, inSitemap" } },
+        ],
+        gates: ["fit", "quote"],
+        week: 3,
+        changesCode: true,
+    },
+    {
+        id: "P7",
+        title: { en: "A comparison guide that names competitors", tr: "Rakipleri de sayan karşılaştırma rehberi" },
+        when: {
+            en: "Week 3, once research lists at least 3 competitors with a source and a date.",
+            tr: "3. hafta: araştırmada kaynağı ve tarihi olan en az 3 rakip varken.",
+        },
+        body: {
+            tr: `"{category} için hangi araçlar var?" sorusuna tarafsız bir rehber yaz.
+- research.md'deki rakipleri say ({competitors}). Her birinin ne yaptığını ve fiyatını kendi sitesinden al; kaynak linkini ve kontrol tarihini yanına yaz.
+- Bizi listenin başına koyma. Her araç için "kime uygun" ve "neyi yapmıyor" yaz; bizim için de.
+- En üste 2-3 cümlelik kısa cevap koy: hangi durumda hangi araç.
+- Article + ItemList schema; güncelleme tarihi görünür olsun.`,
+            en: `Write a neutral guide answering "Which {category} tools are there?"
+- Cover the competitors in research.md ({competitors}). Take what each one does and its price from its own website; put the source link and the date you checked next to it.
+- Don't put us at the top of the list. For every tool write "who it fits" and "what it doesn't do" — for us too.
+- At the top, put a 2–3 sentence short answer: which tool for which situation.
+- Article + ItemList schema; the update date must be visible.`,
+        },
+        accept: {
+            en: "Every competitor fact has a source and a date next to it; our own gaps are written down too.",
+            tr: "Her rakip bilgisinin yanında kaynak ve tarih var; bizim eksiğimiz de yazılı.",
+        },
+        why: {
+            en: "The sample site's two list guides got 24 visitors from ChatGPT in their first week. Per our research notes, assistants often skip the author's brand in lists where the author ranks itself first (Ahrefs).",
+            tr: "Örnek sitenin iki liste rehberi ilk haftada ChatGPT’den 24 ziyaretçi aldı. Araştırma notumuza göre kendini birinci yazan listelerde yazarın markası sık sık atlanıyor (Ahrefs).",
+        },
+        katmanNote: {
+            en: "Self-ranked \"best X\" lists now backfire: when a brand's own list was cited, the brand was left out of the recommendation 69% of the time, and such lists carry spam-policy risk since 2026. Be on the list, don't be the referee.",
+            tr: "Kendini birinci yazan “en iyi X” listeleri artık ters tepiyor: markanın kendi listesi alıntılandığında markanın %69 oranında öneriden çıkarıldığı görüldü; 2026’dan beri bu listeler spam politikası riski de taşıyor. Listede olun, hakem olmayın.",
+        },
+        verifiedBy: [
+            { tool: "katman_lint_content", check: { en: "page_type \"comparison\": a source and a date near every competitor, our own gaps written, brand not ranked first, update date", tr: "page_type \"comparison\": her rakibin yanında kaynak ve tarih, kendi eksiğimiz yazılı, marka birinci sırada değil, güncelleme tarihi" } },
+            { tool: "katman_visibility_run", check: { en: "later: \"best\" and \"alternative\" questions of the question set", tr: "sonra: soru setindeki “en iyi” ve “alternatif” soruları" } },
+        ],
+        gates: ["fit", "mention"],
+        week: 3,
+        changesCode: true,
+    },
+    {
+        id: "P8",
+        title: { en: "llms.txt and the \"not-X\" note", tr: "llms.txt ve “X değildir” notu" },
+        when: {
+            en: "Week 3, once the one sentence, the pricing and the not-X note are settled in research.",
+            tr: "3. hafta: tek cümle, fiyat ve “X değildir” notu araştırmada netleşince.",
+        },
+        body: {
+            tr: `Kökte /llms.txt oluştur (düz metin, Markdown):
+# {brand}
+> {sentence}
+Sonra: markanın ne olmadığı ("{not_x}"), fiyatlar, kimin için olduğu, en önemli 10-20 sayfanın linki ve her birine bir cümle.
+llms.txt'yi sayfalarla aynı veri dosyasından üret; llms.txt'deki her fiyat ve iddia sitede birebir aynı olsun.`,
+            en: `Create /llms.txt at the root (plain text, Markdown):
+# {brand}
+> {sentence}
+Then: what the brand is not ("{not_x}"), the prices, who it's for, links to the 10–20 most important pages with one sentence each.
+Generate llms.txt from the same data file as the pages; every price and claim in llms.txt must match the site exactly.`,
+        },
+        accept: {
+            en: "Not a single price or claim conflicts between llms.txt and the pages.",
+            tr: "llms.txt ile sayfalar arasında çelişen tek bir fiyat ya da iddia yok.",
+        },
+        why: {
+            en: "On the sample site, llms.txt once stated a different price than a feature page; we fixed it. Per our research notes Google doesn't use llms.txt; the file is for assistants.",
+            tr: "Örnek sitede llms.txt bir ara özellik sayfasından farklı fiyat yazıyordu; düzelttik. Araştırma notumuza göre Google llms.txt kullanmıyor; bu dosya asistanlar içindir.",
+        },
+        katmanNote: {
+            en: "Cheap to ship, never a lever: a 300k-domain study found no effect on citations. Do it after rendering (P2) is fixed, keep it short, and keep it identical to the pages.",
+            tr: "Yapması ucuz, ama kaldıraç değil: 300 bin alan adılık bir çalışma alıntılanmaya etkisini bulamadı. Render (P2) düzeldikten sonra yapın, kısa tutun, sayfalarla birebir aynı tutun.",
+        },
+        verifiedBy: [
+            { tool: "katman_generate", check: { en: "artifact llms.txt rebuilt from research (same sentence, pricing, not-X, live situation pages)", tr: "llms.txt çıktısı araştırmadan yeniden üretilir (aynı cümle, fiyat, “X değildir”, yayındaki durum sayfaları)" } },
+            { tool: "katman_lint_content", check: { en: "the one-sentence check compares the page, research and llms.txt", tr: "tek cümle kontrolü sayfayı, araştırmayı ve llms.txt’yi karşılaştırır" } },
+            { tool: "katman_audit_site", check: { en: "site.llmsTxt.exists and the research-consistency findings", tr: "site.llmsTxt.exists ve araştırma tutarlılığı bulguları" } },
+        ],
+        gates: ["quote"],
+        week: 3,
+        changesCode: true,
+    },
+    {
+        id: "P9",
+        title: { en: "Images: alt text, size, compression", tr: "Görseller: alt metin, boyut, sıkıştırma" },
+        when: {
+            en: "Week 2, when images lack alt, width or height, or weigh more than 200 KB.",
+            tr: "2. hafta: görsellerde alt, width ya da height eksikse veya 200 KB’ı geçiyorsa.",
+        },
+        body: {
+            tr: `Tüm <img> etiketlerini tara:
+- Bilgi taşıyan görsele içeriğini anlatan kısa alt metin yaz; süs görseline alt="".
+- Her görsele width ve height ver (sayfa kaymasın).
+- İlk ekrandaki büyük görsel hariç loading="lazy".
+- Görselleri gösterildikleri boyutun en fazla 2 katına küçült; WebP, AVIF ya da sıkıştırılmış PNG kaydet.
+Önce/sonra dosya boyutlarını tablo olarak ver.`,
+            en: `Go through every <img> tag:
+- Give images that carry information a short alt text describing what they show; decorative images get alt="".
+- Give every image a width and a height (so the page doesn't shift).
+- loading="lazy" on everything except the large image on the first screen.
+- Shrink images to at most 2x the size they're displayed at; save them as WebP, AVIF or compressed PNG.
+Give the before/after file sizes as a table.`,
+        },
+        accept: {
+            en: "No <img> without alt text; no image over 200 KB; CLS below 0.1.",
+            tr: "Alt metni olmayan <img> yok; 200 KB’ı geçen görsel yok; CLS 0,1’in altında.",
+        },
+        why: {
+            en: "Images are usually the heaviest part of a page; this is where speed and LCP improve.",
+            tr: "Görseller genelde sayfanın en ağır parçası; hız ve LCP buradan düzelir.",
+        },
+        verifiedBy: [
+            { tool: "katman_scan_code", check: { en: "images without alt, width or height in the source", tr: "kaynakta alt, width ya da height’ı olmayan görseller" } },
+            { tool: "katman_audit_site", check: { en: "pages[].imagesMissingAlt = 0", tr: "pages[].imagesMissingAlt = 0" } },
+            { tool: "manual", check: { en: "Lighthouse (mobile) for CLS", tr: "CLS için Lighthouse (mobil)" } },
+        ],
+        gates: ["read"],
+        week: 2,
+        changesCode: true,
+    },
+    {
+        id: "P10",
+        title: { en: "Internal links and broken links", tr: "İç linkler ve kırık linkler" },
+        when: {
+            en: "Week 2, when pages get no internal links, links are broken, or menus navigate with onClick.",
+            tr: "2. hafta: sayfalar iç link almıyorsa, linkler kırıksa ya da menüler onClick ile yönlendiriyorsa.",
+        },
+        body: {
+            tr: `Tüm herkese açık sayfaların iç link haritasını çıkar.
+1. Hiçbir sayfadan link almayan (yetim) sayfaları listele; her birine ana sayfadan, altbilgiden ya da ilgili bir sayfadan metinli link ver.
+2. Link metni "tıklayın" ya da "devamı" değil, hedef sayfanın konusu olsun.
+3. Tüm iç linkleri kontrol et: 404 ya da yönlendirme zinciri varsa linki doğrudan son adrese çevir.
+4. Menüde ve kartlarda onClick yönlendirmesi varsa <a href> ile değiştir.
+Önce/sonra: her sayfanın aldığı iç link sayısı.`,
+            en: `Map the internal links of all public pages.
+1. List the pages that get no link from any page (orphans); give each one a text link from the home page, the footer or a related page.
+2. Link text should be the target page's topic, not "click here" or "read more".
+3. Check every internal link: if one hits a 404 or a redirect chain, point it straight at the final URL.
+4. If menus or cards navigate with onClick, replace them with <a href>.
+Before/after: the number of internal links each page receives.`,
+        },
+        accept: { en: "0 orphan pages, 0 broken internal links.", tr: "Yetim sayfa 0, kırık iç link 0." },
+        why: {
+            en: "On the sample site this was the reason 35 pages weren't indexed: no page referred to them. Linking them from the footer solved it.",
+            tr: "Örnek sitede dizine girmeyen 35 sayfanın sebebi buydu: yönlendiren sayfa yok. Altbilgiye link verince çözüldü.",
+        },
+        verifiedBy: [
+            { tool: "katman_audit_site", check: { en: "pages[].internalLinksIn ≥ 1 for every page (target ≥ 3), 0 broken internal links", tr: "her sayfada pages[].internalLinksIn ≥ 1 (hedef ≥ 3), kırık iç link 0" } },
+            { tool: "katman_scan_code", check: { en: "no onClick navigation or hash routing on public pages", tr: "herkese açık sayfalarda onClick yönlendirmesi ya da # yönlendirmesi yok" } },
+        ],
+        gates: ["read"],
+        week: 2,
+        changesCode: true,
+    },
+    {
+        id: "P11",
+        title: { en: "404s, redirects, preview URLs", tr: "404, yönlendirme, önizleme adresleri" },
+        when: {
+            en: "Week 2, when unknown URLs return 200, redirects are missing, or a preview copy of the site is public.",
+            tr: "2. hafta: olmayan adresler 200 dönüyorsa, yönlendirmeler eksikse ya da sitenin önizleme kopyası açıksa.",
+        },
+        body: {
+            tr: `1. Bulunmayan her adres gerçek 404 durum kodu dönsün. Tek sayfa uygulamada "sayfa bulunamadı" ekranı 200 dönüyorsa sunucuda 404 veren bir adrese yönlendir ya da o ekrana noindex ekle.
+2. Adı değişen sayfalar eski adresten 301 ile yenisine gitsin.
+3. http → https ve www ↔ yalın alan adı tek bir adrese kalıcı olarak yönlensin.
+4. Önizleme ve staging adresleri (ör. proje.vercel.app) ya asıl alan adına 301 ile gitsin ya da noindex dönsün ya da şifreli olsun. robots.txt bunun için yetmez.`,
+            en: `1. Every URL that doesn't exist must return a real 404 status code. If a single-page app's "page not found" screen returns 200, redirect to a URL that returns 404 on the server, or add noindex to that screen.
+2. Renamed pages redirect from the old URL to the new one with a 301.
+3. http → https and www ↔ bare domain redirect permanently to one single address.
+4. Preview and staging addresses (e.g. project.vercel.app) either 301 to the main domain, return noindex, or are password-protected. robots.txt isn't enough for this.`,
+        },
+        accept: {
+            en: "curl on /this-page-does-not-exist → 404; http://, www. and the preview address → the main address, or noindex.",
+            tr: "curl ile /olmayan-sayfa → 404; http://, www. ve önizleme adresi → asıl adres ya da noindex.",
+        },
+        why: {
+            en: "Google counts a 200 that says \"page not found\" as a soft 404, and sees an open demo copy as another version of the same site.",
+            tr: "Google “sayfa yok” diyen 200’ü sahte 404 sayar; açık kalmış bir demo kopyasını da aynı sitenin başka bir hâli olarak görür.",
+        },
+        katmanNote: {
+            en: "404s take about 35% of AI-crawler fetches in large log studies: fix broken URLs and soft 404s before adding pages.",
+            tr: "Büyük kayıt çalışmalarında yapay zekâ tarayıcılarının isteklerinin yaklaşık %35’i 404’e gidiyor: sayfa eklemeden önce kırık adresleri ve sahte 404’leri düzeltin.",
+        },
+        verifiedBy: [
+            { tool: "katman_audit_site", check: { en: "site.soft404 false, site.httpsRedirect and site.hostRedirect true, preview-copy checks pass", tr: "site.soft404 false, site.httpsRedirect ve site.hostRedirect true, önizleme kopyası kontrolleri geçiyor" } },
+            { tool: "katman_scan_code", check: { en: "hosting.previewPatterns lists the preview hosts to redirect or noindex", tr: "hosting.previewPatterns yönlendirilecek ya da noindex yapılacak önizleme adreslerini listeler" } },
+        ],
+        gates: ["read"],
+        week: 2,
+        changesCode: true,
+    },
+    {
+        id: "P12",
+        title: { en: "Speed and mobile", tr: "Hız ve mobil" },
+        when: {
+            en: "Week 2, on the home page and the 3 most important pages.",
+            tr: "2. hafta: ana sayfada ve en önemli 3 sayfada.",
+        },
+        body: {
+            tr: `Ana sayfa ve en önemli 3 sayfa için mobil Lighthouse çalıştır:
+npx lighthouse {site_url}/SAYFA --only-categories=performance,seo,accessibility --form-factor=mobile --view
+Hedef: LCP en fazla 2,5 sn, CLS en fazla 0,1, uzun görevler yok (INP için hedef 200 ms).
+Bulduğun sorunları düzelt: kullanılmayan JavaScript'i ayır, yazı tiplerini önden yükle, görsellere boyut ver, üçüncü taraf betikleri ertele.
+Her sayfada <meta name="viewport" content="width=device-width, initial-scale=1"> olsun; 360 px genişlikte yatay kaydırma olmasın.`,
+            en: `Run mobile Lighthouse on the home page and the 3 most important pages:
+npx lighthouse {site_url}/PAGE --only-categories=performance,seo,accessibility --form-factor=mobile --view
+Target: LCP at most 2.5 s, CLS at most 0.1, no long tasks (INP target 200 ms).
+Fix what you find: split unused JavaScript, preload fonts, give images dimensions, defer third-party scripts.
+Every page needs <meta name="viewport" content="width=device-width, initial-scale=1">; no horizontal scrolling at 360 px width.`,
+        },
+        accept: {
+            en: "On all three pages LCP ≤ 2.5 s and CLS ≤ 0.1; no horizontal scrolling at 360 px.",
+            tr: "Üç sayfada da LCP ≤ 2,5 sn ve CLS ≤ 0,1; 360 px’te yatay kaydırma yok.",
+        },
+        why: {
+            en: "Google indexes the mobile version of the site. 71% of the sample site's ChatGPT visitors were on mobile.",
+            tr: "Google sitenin mobil hâlini dizine alır. Örnek siteye ChatGPT’den gelenlerin %71’i mobildeydi.",
+        },
+        verifiedBy: [
+            { tool: "manual", check: { en: "the Lighthouse command above (mobile), on 4 pages", tr: "yukarıdaki Lighthouse komutu (mobil), 4 sayfada" } },
+            { tool: "katman_audit_site", check: { en: "site.compression (br/gzip), page bytes and response times", tr: "site.compression (br/gzip), sayfa boyutu ve yanıt süreleri" } },
+        ],
+        gates: ["read"],
+        week: 2,
+        changesCode: true,
+    },
+    {
+        id: "P13",
+        title: { en: "Measurement: ChatGPT visitors and bots", tr: "Ölçüm: ChatGPT ziyaretçisi ve botlar" },
+        when: {
+            en: "Week 4, so that assistant visitors and bots are counted correctly.",
+            tr: "4. hafta: asistandan gelen ziyaretçi ve botlar doğru sayılsın diye.",
+        },
+        body: {
+            tr: `1. Analitikte ChatGPT'den gelenleri ayrı bir kanal olarak say: referrer chatgpt.com olanlar VE linkinde utm_source=chatgpt.com olanlar.
+2. Sunucu tarafında, user-agent'a göre bot isteklerini günlük say: GPTBot, OAI-SearchBot, ChatGPT-User, ClaudeBot, Claude-User, PerplexityBot, Googlebot, Bingbot. (Botlar tarayıcıdaki analitik kodunu çalıştırmaz.)
+3. İnsan filtresi ekle: sayfayı kaydıran, 2'den fazla sayfa gören, kaydolan ya da ödeme yapan oturum insan sayılsın; gerisi ayrı tutulsun.
+4. Yönetim panelinde son 7 günü kanal kanal göster.`,
+            en: `1. In analytics, count visitors from ChatGPT as a separate channel: those with referrer chatgpt.com AND those with utm_source=chatgpt.com in the link.
+2. On the server, count bot requests per day by user-agent: GPTBot, OAI-SearchBot, ChatGPT-User, ClaudeBot, Claude-User, PerplexityBot, Googlebot, Bingbot. (Bots don't run the analytics script in the browser.)
+3. Add a human filter: a session counts as human if it scrolled, viewed more than 2 pages, signed up or paid; keep the rest separate.
+4. Show the last 7 days channel by channel in the admin panel.`,
+        },
+        accept: {
+            en: "The ChatGPT channel also counts visits without a referrer; bot counts come from the server.",
+            tr: "ChatGPT kanalı referrer’sız ziyaretleri de sayıyor; bot sayıları sunucudan geliyor.",
+        },
+        why: {
+            en: "79% of the sample site's ChatGPT visitors sent no referrer; a single PDF crawler created 704 fake sessions.",
+            tr: "Örnek sitede ChatGPT ziyaretçilerinin %79’u referrer göndermedi; tek bir PDF tarayıcısı 704 sahte oturum yarattı.",
+        },
+        katmanNote: {
+            en: "Also turn on the official citation reports: the Search Console Gen-AI report (worldwide since 31 Aug 2026) and Bing Webmaster Tools AI Performance (since Feb 2026, shows Copilot citations).",
+            tr: "Resmî alıntı raporlarını da açın: Search Console Gen-AI raporu (31 Ağustos 2026’dan beri dünya genelinde) ve Bing Webmaster Tools AI Performance (Şubat 2026’dan beri; Copilot alıntılarını gösterir).",
+        },
+        verifiedBy: [
+            { tool: "katman_scan_code", check: { en: "analytics.tracksAiChannel is true", tr: "analytics.tracksAiChannel true" } },
+            { tool: "katman_generate", check: { en: "analytics-channel-snippet (human filter + channel rule) and bot-counter-snippet for your platform", tr: "analytics-channel-snippet (insan filtresi + kanal kuralı) ve platformunuza göre bot-counter-snippet" } },
+        ],
+        gates: ["measure"],
+        week: 4,
+        changesCode: true,
+    },
+    {
+        id: "P14",
+        tag: { en: "EVERY RELEASE", tr: "HER YAYINDA" },
+        title: { en: "Final check before publishing", tr: "Yayından önce son kontrol" },
+        when: {
+            en: "Before every release and after every technical fix.",
+            tr: "Her yayından önce ve her teknik düzeltmeden sonra.",
+        },
+        body: {
+            tr: `Yayından önce herkese açık her sayfa için şu kontrolleri çalıştır ve sonucu tablo olarak ver:
+durum kodu 200 | istenmeyen noindex yok | title ve description benzersiz | canonical kendine | og:image açılıyor | JSON-LD geçerli JSON | JavaScript kapalıyken H1 ve ilk paragraf görünüyor | sitemap'te var | en az 1 iç link alıyor.
+Ayrıca: /olmayan-sayfa 404 dönüyor mu; GPTBot, OAI-SearchBot ve ClaudeBot user-agent'ıyla ana sayfa 200 dönüyor mu (403 ise CDN ya da güvenlik duvarı engelliyor).
+HTML yanıtında Content-Encoding br ya da gzip var mı; sayfaya en az 3 iç link geliyor mu (hedef).
+Bu kontrolü bir betik olarak kaydet (ör. npm run seo-check) ki her yayında tekrar çalışsın. Her teknik düzeltmeden sonra da çalıştır: örnek sitede bir düzeltme HTML sıkıştırmasını sessizce kapatmıştı.`,
+            en: `Before publishing, run these checks on every public page and give the result as a table:
+status code 200 | no unwanted noindex | unique title and description | canonical points to itself | og:image opens | JSON-LD is valid JSON | H1 and first paragraph visible with JavaScript off | in the sitemap | receives at least 1 internal link.
+Also: does /this-page-does-not-exist return 404; does the home page return 200 to the GPTBot, OAI-SearchBot and ClaudeBot user-agents (403 means the CDN or firewall is blocking)?
+Does the HTML response carry Content-Encoding br or gzip; does each page receive at least 3 internal links (target)?
+Save this check as a script (e.g. npm run seo-check) so it runs on every release. Also run it after every technical fix: on the sample site, one fix silently turned off HTML compression.`,
+        },
+        accept: {
+            en: "Every cell in the table passes; the script is in the repo.",
+            tr: "Tablonun bütün hücreleri geçti; betik repoda.",
+        },
+        why: {
+            en: "Without this check we wouldn't have seen the missing share card and the bot block on katman.pro.",
+            tr: "Bugün katman.pro’da bu kontrol olmasaydı paylaşım kartı eksikliğini ve bot engelini görmeyecektik.",
+        },
+        katmanNote: {
+            en: "katman_audit_site with urls: [...] is exactly this table. As the release script: `\"seo-check\": \"npx -y katman-mcp audit <your site URL> --strict\"` — it exits with code 2 on critical findings, so CI fails before a broken release ships.",
+            tr: "katman_audit_site’ı urls: [...] ile çağırmak tam olarak bu tabloyu verir. Yayın betiği olarak: `\"seo-check\": \"npx -y katman-mcp audit <site adresiniz> --strict\"` — kritik bulguda 2 koduyla çıkar, böylece bozuk bir yayın gitmeden CI durur.",
+        },
+        verifiedBy: [
+            { tool: "katman_audit_site", check: { en: "urls mode (quick verify): every column passes for every page, AI bots 200, real 404, compression on", tr: "urls modu (hızlı doğrulama): her sayfada her sütun geçiyor, yapay zekâ botları 200, gerçek 404, sıkıştırma açık" } },
+        ],
+        gates: ["read", "quote"],
+        week: 4,
+        changesCode: false,
+    },
+];
+export function getPrompt(id) {
+    const m = /^p?\s*(\d{1,2})$/i.exec(id.trim());
+    const norm = m ? `P${Number(m[1])}` : id.trim().toUpperCase();
+    return PROMPTS.find((p) => p.id === norm);
+}
+export function promptPlaceholders(p) {
+    const found = new Set();
+    for (const text of [p.body.en, p.body.tr]) {
+        for (const m of text.matchAll(/\{([a-z_]+)\}/g)) {
+            if (PLACEHOLDERS.includes(m[1]))
+                found.add(m[1]);
+        }
+    }
+    return [...found];
+}