merge: system promocji social media gk-sm + kampania #65

Silnik publikacji (pyldz social), skille gk-sm-1..4 + retro, renderer grafik
HTML->puppeteer->PNG, cron 9:00/17:00 Europe/Warsaw, YouTube live.

Kampania #65 jest odnotowana w status.json jako opublikowana ręcznie, więc
pierwszy run crona po tym mergu nie wypchnie jej ponownie.

Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com>

Author: Grzegorz Kocjan

.claude/skills/gk-sm-1-brief/SKILL.md

@@ -0,0 +1,82 @@
+---
+name: gk-sm-1-brief
+description: >
+  Faza 1 promocji meetupu Python Łódź w social media — brief: preset, zakres,
+  kanały, decyzje. Użyj gdy startujemy promocję spotkania: "promocja meetupu",
+  "wystartujmy social media do #NN", "zaplanuj posty do spotkania #NN",
+  "brief promocji", "kampania meetupu". Czyta page/content/spotkania/<nr>/index.md
+  + dane prelegentów, pisze social/brief.md. Pierwszy skill sekwencji gk-sm-*.
+---
+
+# gk-sm-1-brief — brief promocji (faza 1)
+
+Ustala CO promujemy, JAKIM presetem i na JAKICH kanałach — zanim powstanie
+jakikolwiek tekst. Wyjście to krótki dokument decyzji, nie treści.
+
+**Kontrakt z procesem:** faza 1. Wejście: `page/content/spotkania/<nr>/index.md`
+(+ `page/data/speakers/*.yaml`, dane sponsora). Wyjście:
+`page/content/spotkania/<nr>/social/brief.md`. Następny: **gk-sm-2-seria**.
+
+## Presety
+
+- **P1 — klasyczny meetup** (prelekcje z prelegentami):
+  ogłoszenie → post per prelekcja (z oznaczeniem prelegenta) → reminder →
+  last call → dzień spotkania.
+- **P2 — Lightning Talks + Open Spaces** (edycje letnie; wzorzec: ręczna seria
+  #65 `page/content/spotkania/65/descriptions/social-series.md`):
+  ogłoszenie → posty edukacyjne „czym jest LT/OS" → call for speakers →
+  reminder → last call → dzień spotkania.
+- **P3 — pojedynczy post** (ad-hoc: ankieta, nagranie, ogłoszenie).
+
+## Proces
+
+1. Przeczytaj `index.md` spotkania: format, data, godzina, miejsce,
+   prelekcje/LT, sponsor. Edycja letnia ⇒ P2 (patrz `tasks/lessons.md`).
+2. Zbierz prelegentów: `page/data/speakers/<id>.yaml` — w tym pole
+   `instagram:` (handle bez @) do oznaczeń na IG oraz profil LinkedIn z sekcji
+   `social:`. Braki wypisz w briefie jako „do uzupełnienia / pominięcia".
+3. Kanały standardowe: FB + IG + Discord (automat, cron 9:00/17:00 PL)
+   oraz LinkedIn (pakiet wklejki z gk-sm-4). YT live zakłada gk-sm-4.
+   Odchyłki zapisz jawnie w sekcji Decyzje.
+4. Ustal etapy (liczba i cele postów) oraz okno czasowe: od dziś do dnia
+   spotkania, sloty tylko 9:00 lub 17:00.
+5. Zbierz linki: strona spotkania, zapisy (meetup.com), formularz LT (dla P2),
+   Discord. Brak linku = placeholder `[LINK]` + pozycja na liście braków.
+6. Pokaż brief userowi, zbierz uwagi, popraw. **Jawna akceptacja** kończy fazę.
+
+## Format social/brief.md
+
+```markdown
+# Brief promocji — Python Łódź #<nr> (<data> · <miejsce>)
+
+Preset: P1|P2|P3 · Kanały: FB, IG, Discord (automat) + LinkedIn (wklejka) · YT live: tak/nie
+
+## Etapy (robocze)
+| # | ~data | slot | cel |
+|---|-------|------|-----|
+
+## Prelegenci i oznaczenia
+| kto | IG handle | LinkedIn |
+|-----|-----------|----------|
+
+## Linki
+- strona: … · zapisy: … · formularz LT: … · Discord: …
+
+## Braki / do uzupełnienia
+## Decyzje i odchyłki
+```
+
+## Feedback loop (obowiązuje)
+
+- **Na starcie fazy**: przeczytaj `tasks/feedback.md` i zastosuj wpisy ze statusem
+  `nowy` dotyczące tej fazy, zanim cokolwiek wyprodukujesz.
+- **Po każdej korekcie usera** (zrobiłeś coś nie tak, jak chciał): dopisz wpis
+  `[data] | gk-sm-1-brief | co poszło nie tak | jak ma być | nowy`.
+- Wpisy do skilli promuje wyłącznie gk-sm-retro — nie edytuj SKILL.md w trakcie fazy.
+
+## Definition of Done
+
+- `social/brief.md` istnieje: preset, etapy z celami, kanały, linki.
+- Braki danych jawnie wylistowane.
+- User zaakceptował brief.
+- → Następny skill: **gk-sm-2-seria**.

.claude/skills/gk-sm-2-seria/SKILL.md

@@ -0,0 +1,73 @@
+---
+name: gk-sm-2-seria
+description: >
+  Faza 2 promocji meetupu Python Łódź — seria postów: jeden kanoniczny tekst
+  per post, iteracyjnie z userem. Użyj po zaakceptowanym briefie lub gdy
+  trzeba poprawić teksty: "napisz posty", "seria postów", "teksty do promocji",
+  "popraw posty do #NN". Czyta social/brief.md, pisze social/posts.md
+  w formacie parsowalnym przez publisher. Drugi skill sekwencji gk-sm-*.
+---
+
+# gk-sm-2-seria — kanoniczne teksty postów (faza 2)
+
+Zamienia brief w gotowe teksty. **Jeden kanoniczny tekst per post** — NIE
+warianty per platforma. Różnice platformowe są mechaniczne i stosuje je
+publisher (`src/pyldz/social/transforms.py`): na IG linki zamieniają się w
+„🔗 Link w bio → pythonlodz.org" + stałe hashtagi; FB/Discord/LinkedIn dostają
+tekst bez zmian. Wyjątek: rzadki `override` per platforma (np. `@everyone`
+dla Discorda).
+
+**Kontrakt z procesem:** faza 2. Wejście: `social/brief.md`. Wyjście:
+`social/posts.md`. Następny: **gk-sm-3-grafiki**.
+
+## Format social/posts.md (kontrakt z publisherem — nie zmieniaj!)
+
+```markdown
+# Posty — Python Łódź #<nr>
+
+## post: <id-kebab-case>
+
+<pełny kanoniczny tekst — linki pełnymi URL-ami, @handle prelegentów IG w treści>
+
+### override: discord
+
+<opcjonalny pełny tekst zastępczy, np. z @everyone>
+```
+
+Id posta: `[a-z0-9][a-z0-9-]*` (np. `save-the-date`, `lightning-talk`,
+`last-call`). Override tylko gdy transformacja mechaniczna nie wystarcza.
+
+## Zasady tekstów
+
+- Ton Python Łódź: przyjazny, luźny, otwarty, „zero spiny". Emoji z umiarem.
+  Myślnik: „-". Wzorzec jakości: `page/content/spotkania/65/descriptions/social-series.md`.
+- Każdy post ma jeden cel (z etapów briefu) i jedno CTA.
+- Linki pełnymi URL-ami w treści (IG-transform zajmie się resztą).
+- Prelegenci: w treści `@handle` (IG) — publisher zostawia; na FB to plain text
+  (zgodnie ze specem, ograniczenie Mety); LinkedIn dostanie instrukcję tagów
+  w gk-sm-4.
+- Placeholder na link do YT live: wpisz `[LINK DO LIVE]` w postach dnia
+  spotkania — gk-sm-4 podmieni po założeniu transmisji.
+
+## Model współpracy (obowiązuje)
+
+- **Nigdy jednostrzałowo.** Dla kluczowych postów pokaż 3–4 kontrastowe
+  warianty → zbierz reakcję per wariant → syntezuj.
+- Pokazuj pełne brzmienie (nie skróty) — to dokładny tekst, który pójdzie
+  w świat. **Jawna akceptacja pełnego brzmienia każdego posta.**
+- Po akceptacji sprawdź parsowalność:
+  `uv run python -c "from pathlib import Path; from pyldz.social.posts_md import parse_posts_md; print(list(parse_posts_md(Path('page/content/spotkania/<nr>/social/posts.md').read_text())))"`
+
+## Feedback loop (obowiązuje)
+
+- **Na starcie fazy**: przeczytaj `tasks/feedback.md` i zastosuj wpisy ze statusem
+  `nowy` dotyczące tej fazy, zanim cokolwiek wyprodukujesz.
+- **Po każdej korekcie usera** (zrobiłeś coś nie tak, jak chciał): dopisz wpis
+  `[data] | gk-sm-2-seria | co poszło nie tak | jak ma być | nowy`.
+- Wpisy do skilli promuje wyłącznie gk-sm-retro — nie edytuj SKILL.md w trakcie fazy.
+
+## Definition of Done
+
+- `social/posts.md` w poprawnym formacie (parser zwraca wszystkie posty).
+- Każdy etap briefu ma post; każdy post zaakceptowany w pełnym brzmieniu.
+- → Następny skill: **gk-sm-3-grafiki**.

.claude/skills/gk-sm-3-grafiki/SKILL.md

@@ -0,0 +1,70 @@
+---
+name: gk-sm-3-grafiki
+description: >
+  Faza 3 promocji meetupu Python Łódź — grafiki do postów przez
+  HTML+CSS → puppeteer → PNG. Użyj po zaakceptowanych tekstach lub do poprawy
+  grafik: "grafiki do postów", "zrób grafiki", "popraw grafikę do #NN",
+  "kreacje social media". Czyta social/posts.md, pisze social/images/final/.
+  Trzeci skill sekwencji gk-sm-*.
+---
+
+# gk-sm-3-grafiki — grafiki postów (faza 3)
+
+Produkuje grafiki brandowe przez `tools/social/render.mjs` (HTML+CSS →
+puppeteer → PNG). **Tekst zawsze warstwą HTML** (nigdy wypalony w tle) —
+łatwa iteracja i pełna kontrola typografii.
+
+**Kontrakt z procesem:** faza 3. Wejście: `social/posts.md` (+ brief).
+Wyjście: `social/images/final/*.png`. Następny: **gk-sm-4-harmonogram**.
+
+## Produkcja
+
+1. Szablony: `tools/social/templates/*.html` (start: `announcement.html`).
+   Nowy typ posta ⇒ nowy szablon w tym katalogu (commitowany — rośnie biblioteka).
+2. Job JSON + render:
+   ```bash
+   node tools/social/render.mjs job.json
+   # job: template, name, outDir, formats ["4x5","1x1","16x9"], fields, background?
+   ```
+   Formaty z jednego szablonu; podstawowy format postów to **4:5**.
+   (Pierwsze użycie na maszynie: `npm install --prefix tools/social`.)
+3. Tła: stock (Pexels/Unsplash) → zapisz źródłowy plik w `social/images/stock/`
+   z notką pochodzenia (`social/images/stock/README.md`: plik → URL źródła,
+   licencja) — albo własne zdjęcia/assety z repo.
+4. Brand (wymusza szablon): granat `#001F3F`, żółty `#FFD700`,
+   logo `page/assets/images/logo.png`, fonty OpenSans z `page/assets/fonts/`.
+
+## Reguły czytelności (z dumtek — odrzucaj, co ich nie spełnia)
+
+- **Data i miejsce NA grafice** — nie licz, że ktoś doczyta w tekście.
+- Wysoki kontrast napis/tło; czcionka czytelna na telefonie (podgląd w 25%).
+- Mało tekstu: kicker + hasło + data/miejsce. Ściana tekstu = antywzorzec.
+- Zbyt „ładne"/artystyczne kosztem czytelności = antywzorzec.
+
+## Model współpracy (obowiązuje)
+
+- Pokazuj obrazy, nie opisy hexów. Do akceptacji renderuj **mockup w feedzie**:
+  ```bash
+  node tools/social/mockup.mjs <grafika.png> <plik-z-tekstem-posta> <mockup.png>
+  ```
+- 2–3 kontrastowe warianty dla grafik kluczowych → reakcja per wariant →
+  synteza → **jawna akceptacja zestawu**.
+- Zaakceptowane → `social/images/final/<post-id>-<format>.png` (nazwa pliku
+  = id posta z posts.md + format). Odrzucone + źródłowe job JSON →
+  `social/images/archive/`.
+
+## Feedback loop (obowiązuje)
+
+- **Na starcie fazy**: przeczytaj `tasks/feedback.md` i zastosuj wpisy ze statusem
+  `nowy` dotyczące tej fazy, zanim cokolwiek wyprodukujesz.
+- **Po każdej korekcie usera** (zrobiłeś coś nie tak, jak chciał): dopisz wpis
+  `[data] | gk-sm-3-grafiki | co poszło nie tak | jak ma być | nowy`.
+- Wpisy do skilli promuje wyłącznie gk-sm-retro — nie edytuj SKILL.md w trakcie fazy.
+
+## Definition of Done
+
+- Każdy post z serii ma grafikę w `social/images/final/` (min. 4:5),
+  nazwaną `<post-id>-4x5.png`.
+- Data i miejsce na grafikach eventowych; mockupy pokazane; zestaw
+  zaakceptowany przez usera.
+- → Następny skill: **gk-sm-4-harmonogram**.

.claude/skills/gk-sm-4-harmonogram/SKILL.md

@@ -0,0 +1,85 @@
+---
+name: gk-sm-4-harmonogram
+description: >
+  Faza 4 promocji meetupu Python Łódź — harmonogram publikacji, YT live,
+  pakiet LinkedIn, dry-run i uzbrojenie crona. Użyj po zaakceptowanych
+  grafikach: "harmonogram postów", "zaplanuj publikacje", "odpal promocję",
+  "załóż live na YouTube", "pakiet LinkedIn". Pisze social/schedule.yaml
+  + social/linkedin-paste.md, zakłada YT live, robi dry-run, commituje do main.
+  Czwarty skill sekwencji gk-sm-*.
+---
+
+# gk-sm-4-harmonogram — kalendarz, YT live, wklejka, uzbrojenie (faza 4)
+
+Ostatnia faza przed automatem: układa kalendarz, zakłada transmisję,
+generuje pakiet ręcznej wklejki i uzbraja cron przez commit do `main`.
+
+**Kontrakt z procesem:** faza 4. Wejście: `social/posts.md` +
+`social/images/final/`. Wyjście: `social/schedule.yaml` +
+`social/linkedin-paste.md` (+ link YT w postach). Następny: gk-sm-retro
+(po meetupie).
+
+## Proces
+
+1. **Kalendarz**: przypisz każdemu postowi datę + slot (tylko **9:00** lub
+   **17:00** Europe/Warsaw), kanały, grafikę i tagi IG. Format
+   `schedule.yaml` (kontrakt z publisherem — patrz niżej).
+2. **YT live** (jeśli brief mówi „tak"):
+   ```bash
+   uv run pyldz social yt-create-live --title "Python Łódź #<nr> — <tytuł>" \
+     --start "<YYYY-MM-DD HH:MM>" --description-file page/content/spotkania/<nr>/descriptions/youtube-live.md
+   ```
+   Zwrócony link wstaw w `posts.md` w miejsce `[LINK DO LIVE]`.
+   (Pierwsze użycie: otworzy się OAuth w przeglądarce; token → `.yt_token.json`.)
+3. **Pakiet LinkedIn**: `social/linkedin-paste.md` — dla każdego posta
+   z kanałem `linkedin`: data+slot, pełny tekst (kanoniczny lub override),
+   którą grafikę załączyć, kogo oznaczyć (profile LinkedIn prelegentów
+   z briefu — tagowanie ręcznie w UI natywnego schedulera, do 3 mies. w przód).
+   Opcjonalnie sekcja YT Community (brak API — też wklejka).
+4. **Dry-run** — pokaż userowi DOKŁADNE payloady:
+   ```bash
+   uv run pyldz social dry-run --meetup <nr>
+   ```
+   Uwaga: dry-run pokazuje tylko posty due „teraz"; harmonogram przyszły
+   zweryfikuj czytając schedule.yaml na głos (post × kanał × slot × grafika).
+5. **Akceptacja → uzbrojenie**: po jawnej akceptacji całości commit + push
+   do `main` (posts.md, schedule.yaml, images/final/, linkedin-paste.md).
+   Publikacja = merge do main; cron (`.github/workflows/social-publish.yaml`,
+   sloty 9:00/17:00 PL) przejmuje resztę i nadrabia zaległe sloty.
+   Deploy strony (GitHub Pages) musi zajść przed pierwszym slotem —
+   grafiki muszą być publicznie dostępne pod
+   `https://pythonlodz.org/spotkania/<nr>/social/…` (FB/IG ciągną URL).
+
+## Format social/schedule.yaml (kontrakt z publisherem — nie zmieniaj!)
+
+```yaml
+meetup: "<nr>"
+timezone: Europe/Warsaw
+posts:
+  - post: <id z posts.md>
+    channels: [facebook, instagram, discord, linkedin]
+    scheduled: 2026-07-08 09:00:00      # czas lokalny Europe/Warsaw
+    image: images/final/<post-id>-4x5.png   # względem social/
+    ig_tagged: [<ig-handle-bez-@>]           # opcjonalne
+```
+
+Zasady: IG wymaga `image`; `linkedin` w `channels` = tylko do pakietu wklejki
+(publisher pomija); posty przeszłe bez wpisu w `status.json` publikują się
+w najbliższym runie (świadomie — tak działa nadrabianie).
+
+## Feedback loop (obowiązuje)
+
+- **Na starcie fazy**: przeczytaj `tasks/feedback.md` i zastosuj wpisy ze statusem
+  `nowy` dotyczące tej fazy, zanim cokolwiek wyprodukujesz.
+- **Po każdej korekcie usera** (zrobiłeś coś nie tak, jak chciał): dopisz wpis
+  `[data] | gk-sm-4-harmonogram | co poszło nie tak | jak ma być | nowy`.
+- Wpisy do skilli promuje wyłącznie gk-sm-retro — nie edytuj SKILL.md w trakcie fazy.
+
+## Definition of Done
+
+- `schedule.yaml` waliduje się (`uv run pyldz social dry-run --meetup <nr>`
+  działa bez błędu), każdy post ma slot 9:00/17:00 i grafikę tam, gdzie trzeba.
+- YT live założony, link wstawiony w posty (jeśli dotyczy).
+- `linkedin-paste.md` kompletny (teksty + daty + grafiki + kogo oznaczyć).
+- User zaakceptował harmonogram; całość scommitowana i wypchnięta na `main`.
+- Po meetupie: **gk-sm-retro**.

.claude/skills/gk-sm-manifest.md

@@ -0,0 +1,23 @@
+# gk-sm — manifest wersji
+
+System promocji meetupów w social media. Spec:
+`docs/superpowers/specs/2026-07-10-social-media-system-design.md`.
+Sekwencja: gk-sm-1-brief → gk-sm-2-seria → gk-sm-3-grafiki →
+gk-sm-4-harmonogram → (po meetupie) gk-sm-retro.
+
+| Skill | Wersja |
+|---|---|
+| gk-sm-1-brief | 1.1.0 |
+| gk-sm-2-seria | 1.1.0 |
+| gk-sm-3-grafiki | 1.1.0 |
+| gk-sm-4-harmonogram | 1.1.0 |
+| gk-sm-retro | 1.1.0 |
+
+## CHANGELOG
+
+### 1.1.0 — 2026-07-10
+- Feedback loop: każda faza czyta `tasks/feedback.md` na starcie i dopisuje wpis
+  po każdej korekcie usera; gk-sm-retro promuje sprawdzone wpisy do SKILL.md.
+
+### 1.0.0 — 2026-07-10
+- Pierwsze wydanie sekwencji gk-sm-* (wzorzec: dumtek/fb-ads-system gk-fb-*).

.claude/skills/gk-sm-retro/SKILL.md

@@ -0,0 +1,44 @@
+---
+name: gk-sm-retro
+description: >
+  Retro promocji meetupu Python Łódź po spotkaniu — co zadziałało, ekstrakcja
+  klocków wielokrotnego użytku, lekcje. Użyj po meetupie: "retro promocji",
+  "podsumuj promocję #NN", "co zadziałało w postach". Czyta social/ meetupu,
+  pisze blocks/social/ + tasks/lessons.md. Zamyka sekwencję gk-sm-*.
+---
+
+# gk-sm-retro — retro promocji (po meetupie)
+
+Zamyka cykl: wyciąga z kampanii to, co warto zużyć ponownie, i lekcje na
+kolejne edycje. Bez analityki zasięgów (poza zakresem systemu) — retro
+opiera się na obserwacjach usera i przebiegu procesu.
+
+**Kontrakt z procesem:** wejście: `page/content/spotkania/<nr>/social/`
+(+ `status.json` — co i kiedy faktycznie poszło). Wyjście: `blocks/social/`
++ wpisy w `tasks/lessons.md` (+ ew. poprawki skilli gk-sm-*).
+
+## Proces
+
+1. Przejrzyj `status.json`: czy wszystkie posty poszły? Które sloty padły /
+   były nadrabiane? Błędy z runów crona (GitHub Actions → „Social publish").
+2. Zapytaj usera: które posty/grafiki zadziałały (komentarze, zapisy,
+   zgłoszenia LT), co było za dużo/za mało, co ręczne bolało.
+3. **Ekstrakcja klocków** → `blocks/social/<nazwa>.md`: sprawdzone fragmenty
+   tekstów (call-to-action, explainery LT/OS, struktury postów), szablony
+   grafik warte powtórzenia (wskaż plik w `tools/social/templates/`),
+   działające sekwencje etapów. Klocek = plik z treścią + notka kiedy używać.
+4. **Przegląd feedbacku** → `tasks/feedback.md`: przejdź wszystkie wpisy `nowy`.
+   Powtarzające się lub potwierdzone przez usera → wpisz na stałe do odpowiedniego
+   `gk-sm-*/SKILL.md`, podbij wersję w `.claude/skills/gk-sm-manifest.md`
+   (semver + wpis w CHANGELOG) i zmień status wpisu na `wdrożone`.
+   Jednorazowe/nieaktualne → status `odrzucone`. Każdą promocję pokaż userowi
+   do akceptacji przed edycją skilla.
+5. **Lekcje** → `tasks/lessons.md` w formacie repo:
+   `[data] | co poszło nie tak | reguła na przyszłość` (rzeczy spoza procesu gk-sm).
+
+## Definition of Done
+
+- Klocki wielokrotnego użytku w `blocks/social/` (min. te wskazane przez usera).
+- `tasks/feedback.md` przejrzany: zero wpisów `nowy` (wszystkie `wdrożone` albo
+  `odrzucone`); wdrożone mają odzwierciedlenie w SKILL.md + manifeście.
+- Lekcje dopisane do `tasks/lessons.md`.

.env.example

@@ -6,3 +6,10 @@ GOOGLE_SHEETS__TOKEN_CACHE_PATH=.client_secret.token.json
 # Application Configuration
 DEBUG=false
 DRY_RUN=false
+
+# Social publisher (gk-sm) — sekrety produkcyjne żyją w GitHub Secrets
+META_PAGE_ID=
+META_ACCESS_TOKEN=
+IG_USER_ID=
+DISCORD_WEBHOOK_URL=
+SITE_BASE_URL=https://pythonlodz.org