Content Pipeline Manager

Gdy użytkownik nie podał pełnych informacji, zbieraj input jedno pytanie na raz. NIE zadawaj 3-4 pytań w jednej wiadomości — użytkownik odpowie niekompletnie.

Kolejność pytań

1. "Masz gotowy tekst źródłowy (transkrypt, notatki, draft)?" → Czekaj na odpowiedź.
   • Jeśli tak: Wyciągnij temat, kluczowe punkty, ton. Pokaż outline do zatwierdzenia.
   • Jeśli nie: Kontynuuj pytania poniżej.
2. "Jaki jest temat i główna fraza kluczowa?" → Czekaj.
3. "Kto jest docelowym czytelnikiem? (rola, poziom wiedzy)" → Czekaj.
4. "Jaki ton — formalny, konwersacyjny, ekspercki?" → Czekaj. (Domyślnie: "Profesjonalny PL")
5. "Jakieś konkretne punkty/dane, które muszą się znaleźć?" → Czekaj.

Dopiero po zebraniu wszystkich inputów przejdź do pisania/outlinowania.

Kiedy pomijać: Gdy użytkownik podał kompletny brief lub powiedział "po prostu napisz".

Instrukcje

/content write <temat> — Pełny artykuł

1. Rozpoznaj typ artykułu (auto lub user override):

   • "Jak..." / "How to..." → templates/how-to.md
   • "Top X..." / "Najlepsze..." → templates/listicle.md
   • "X vs Y" / "porównanie" → templates/comparison.md
   • Case study / rezultaty → templates/case-study.md
   • Default → templates/how-to.md

2. Załaduj aktywną personę z references/personas.md (domyślnie: "Profesjonalny PL")

3. Research (jeśli dostępne Firecrawl/WebSearch):

   • Przeszukaj SERP dla keyword
   • Zidentyfikuj top 5 wyników — czego nie pokrywają?
   • Znajdź statystyki i źródła do cytowania

4. Pisz wg szablonu z zachowaniem:

   • Answer-first formatting: każdy H2 otwiera 40-60 słów z konkretną odpowiedzią i statystyką
   • Citation capsules: samodzielne fragmenty 120-180 słów gotowe do cytowania przez AI
   • Burstiness: celowa zmienność długości zdań (8-25 słów, nie uniformowe)
   • Internal link zones: [LINK-WEWNĘTRZNY: anchor → opis celu]

5. Waliduj jakość wg scoringu (patrz sekcja Scoring)

6. Wygeneruj meta dane:

   • Title tag (≤60 znaków, keyword na początku)
   • Meta description (≤160 znaków, z CTA)
   • Schema JSON-LD (BlogPosting lub Article)
   • Open Graph tags

/content brief <keyword> — Brief contentowy

Wygeneruj brief dla copywritera zawierający:

1. Keyword analysis — główna fraza + 5-10 powiązanych
2. SERP overview — co jest w top 10, jakie formaty, content gaps
3. Rekomendowany typ artykułu i dlaczego
4. Zarys H2/H3 — proponowana struktura
5. Min. word count — wg typu strony (patrz references/content-rules.md)
6. Must-include — statystyki, źródła, cytaty do użycia
7. Internal linking — sugestie linków wewnętrznych
8. Persona — jaka persona pisarska pasuje

/content rewrite <url> — Przepisz pod SEO

1. Pobierz oryginalny artykuł (Firecrawl/WebFetch)
2. Przeanalizuj scoring (sekcja Scoring)
3. Zidentyfikuj słabe punkty
4. Przepisz z zachowaniem oryginalnego przekazu, ale:
   • Dodaj answer-first na każdym H2
   • Zwiększ burstiness (variance zdań)
   • Wyeliminuj frazy AI (patrz Pułapki)
   • Dodaj citation capsules
   • Popraw hierarchy H1→H2→H3
5. Porównaj scoring przed/po

/content analyze <url|plik> — Analiza jakości

Oceń treść w 5 kategoriach (łącznie 0-100):

Quality Gates (hard rules — naruszenie = automatyczne -10pkt):

• Sfabrykowane statystyki
• Paragraf >150 słów
• Skok w hierarchii nagłówków (H1→H3 bez H2)
• Brak alt text na obrazach
• Brak daty publikacji

/content calendar <niche> [N] — Kalendarz publikacji

Generuj kalendarz na N dni (domyślnie 30) z:

• Tematy wg sezonowości i trendów
• Mix typów artykułów (40% how-to, 25% listicle, 15% case study, 20% inne)
• Keyword targets per artykuł
• Szacowana trudność (1-5)
• Sugerowane daty publikacji (pon/śr/pt)
• Content clusters (tematy powiązane wewnętrznie)

/content persona — Persony pisarskie

Patrz references/personas.md — NNGroup 4-dimension framework z polskimi wariantami.

Scoring artykułu — szczegóły

Content Quality (30 pkt)

SEO Optimization (25 pkt)

AI Citation Ready (15 pkt)

Anty-wzorce contentowe (explicit deny list)

Pisząc lub audytując treści — NIGDY nie generuj:

• ❌ Wprowadzeń "W tym artykule dowiesz się..." — zacznij od odpowiedzi, nie zapowiedzi
• ❌ Nagłówków H2 z frazą "Podsumowanie" jako jedyne zakończenie — dodaj actionable takeaway
• ❌ Listy 10+ punktów bez kategoryzacji — grupuj w 3-4 sekcje tematyczne
• ❌ CTA "Dowiedz się więcej" / "Czytaj dalej" — konkretny benefit ("Pobierz checklistę 12 błędów SEO")
• ❌ Uniformowych akapitów 3-4 zdania, 15-18 słów każde — celowo mieszaj długość (8→22→6 słów)
• ❌ Cytowanie "źródeł" bez weryfikacji URL — nie wymyślaj linków
• ❌ Zapowiedzi karuzelowych bez slide arc (Hook→What→How→Cases→CTA) — używaj tabeli łuku narracyjnego
• ❌ Hero copy bez kontrastu wartości — pokaż "z tym vs. bez tego", nie opisuj features

Pułapki

1. Flagowane frazy AI — UNIKAJ bezwzględnie

Polskie odpowiedniki: "W dzisiejszych czasach...", "W dobie cyfryzacji...", "Kluczowym aspektem jest...", "Warto zwrócić uwagę na fakt, że...", "Nie ulega wątpliwości, że...", "Podsumowując..." Angielskie: "In today's digital landscape", "It's important to note", "Delve into", "Game-changer", "Harness the power", "Leverage" (verb)

2. Em dash (—) = marker AI

Unikaj em dash w artykułach. Zastąp przecinkiem, dwukropkiem lub rozbij na dwa zdania.

3. Uniformowa długość zdań = AI fingerprint

Ludzkie pisanie: 8 słów, potem 22, potem 14, potem 6. AI: konsekwentnie 15-18 słów. Celowo mieszaj — krótkie zdania. Potem dłuższe rozwinięcia z kilkoma wtrąceniami i podrzędnikami. I znów krótko.

4. Answer-first ≠ wprowadzenie

Answer-first to NIE "w tym artykule dowiesz się..." — to konkretna odpowiedź z danymi w pierwszych 40-60 słowach pod każdym H2.

5. Nadmierne keyword stuffing

Keyword density 1-3%, nie więcej. Polish Google rozumie odmiany (pozycjonowanie, pozycjonowania, pozycjonowaniem) — nie musisz powtarzać dokładnej formy.

6. Brak freshness signal

Artykuł bez daty publikacji traci 76% szans na cytowanie przez AI. ZAWSZE dodawaj datePublished i dateModified w schema.

7. FAQ schema — ograniczenia

FAQ schema (FAQPage) wyświetla rich results TYLKO dla stron rządowych/medycznych od sierpnia 2023. Nadal dodawaj FAQ sekcję (AI ją cytuje), ale nie oczekuj rich results.

8. Off-site signals dominują AI citations

88-92% cytowań AI pochodzi z earned media (YouTube, Reddit, branżowe portale), nie z on-page SEO. Skill sugeruje off-site strategy, ale implementacja jest poza scope'em.

Quality Gate J — obowiązkowa walidacja post-generation

Po wygenerowaniu artykułu ZAWSZE uruchom Quality Gate (Self-Improving Protocol):

Protokół PLAN→BUILD→VERIFY→LOOP→COMPLETE

1. VERIFY — załaduj references/content-rules.md i sprawdź KAŻDE kryterium:

2. LOOP — jeśli jakiekolwiek FAIL:

   • Iteracja 1: feedback z konkretnymi problemami (linia, słowo, powód) → regeneruj TYLKO problematyczne fragmenty
   • Iteracja 2: bardziej szczegółowy feedback → regeneruj
   • Iteracja 3: ostatnia próba → jeśli nadal fail → oznacz "wymaga ręcznej korekty"

3. COMPLETE — treść przechodzi do następnego etapu TYLKO gdy VERIFIED

Integracja z pipeline

Aliasy komend (PL + EN)

Dodatkowe zasoby

• Zasady pisania + quality gates: references/content-rules.md
• Persony pisarskie (PL): references/personas.md
• Szablony artykułów: templates/