Prompt aktualizacji po zmianie w produkcie

Każda zmiana funkcji w club-web wywołuje aktualizację tej bazy. Nie “kiedyś”, tylko w tym samym tygodniu, najlepiej w tym samym PR-ze co kod, jako osobny commit w repo sportigio-docs. W club-web jest skill docs-sync, który prowadzi agenta przez dokładnie ten proces; poniżej ten sam prompt do wklejenia ręcznie.

Prompt

Zmieniliśmy funkcję w club-web. Zaktualizuj bazę wiedzy w repo sportigio-docs.

Co się zmieniło (wklej albo opisz): <diff / opis / numer PR>

Zrób po kolei:
1. Wypisz, których scenariuszy (UC-xxx) dotyczy zmiana. Szukaj po nazwach narzędzi MCP,
   ścieżkach /app/... i nazwach zakładek. Jeśli żaden nie pasuje, zaproponuj nowy
   scenariusz z contributing/template.md i dodaj go do contributing/backlog.md.
2. Dla każdego scenariusza: przeklikaj zmieniony krok na klubie demo Sportigio FC
   (club-web, klub1.sportigio.test.localhost, space 2) albo na produkcji. Nie opisuj
   z pamięci. Jeśli zmiana dotyczy narzędzia MCP, wywołaj je i sprawdź wynik odczytem.
3. Zaktualizuj polską stronę: kroki, nazwy przycisków, tabelę "Przez API / MCP", pułapki,
   pole verified na dzisiejszą datę, sources na zmienione pliki.
4. Zaktualizuj lustra en/ i de/ pod tą samą ścieżką. Ta sama struktura nagłówków.
   Nazwy przycisków po angielsku i niemiecku bierz z resources/lang/{en,de} w club-web,
   nie tłumacz ich sam.
5. Jeśli zmieniły się zrzuty ekranu: zrób nowe z klubu demo (tryb jasny, 1440 px, bez
   paska debugowania i banerów) i podmień pliki w src/assets/screens/.
6. Jeśli zmiana dotyczy narzędzi MCP, zaktualizuj for-agents/tool-map.md (PL/EN/DE).
7. npm run build w sportigio-docs. Build musi przejść.
8. Podsumuj w trzech zdaniach: co zmieniłeś, które strony, co zostało do zrobienia
   (np. zrzut, którego nie dało się zrobić).

Reguły: AGENTS.md w sportigio-docs. Krótkie zdania, nazwy z interfejsu, bez AI slopu,
bez długich pauz, żadnych cen i liczb z pamięci.

Checklista recenzenta

Każda zmieniona strona ma verified z datą z tego tygodnia.
PL, EN i DE mają te same nagłówki H2 w tej samej kolejności.
Nazwy narzędzi w sekcji “Przez API / MCP” istnieją w club-web/docs/mcp-tools.md.
Ścieżki /app/... istnieją (php artisan route:list w club-web).
Zrzuty są z klubu demo i nie pokazują danych prawdziwych klubów.
npm run build przeszedł; dist/llms-full.txt zawiera zmienioną stronę.

Kiedy zakładać nowy scenariusz, a kiedy rozszerzać istniejący

Nowy, gdy klub zadałby o to osobne pytanie (“jak sprzedać bilety na mecz”).
Rozszerzenie, gdy zmienia się krok w istniejącym celu (nowa wersja sekcji, nowe pole w formularzu, nowe narzędzie MCP do tego samego celu).
Nie zakładaj strony dla ekranu, który jest tylko środkiem do celu (np. “zakładka Tagi”). Tagi opisuje scenariusz o aktualnościach.

Rytm

Zmiana funkcji: aktualizacja w tygodniu wdrożenia.
Raz w miesiącu: przegląd stron z verified starszym niż 90 dni. Przeklikaj albo oznacz w tytule “(do weryfikacji)”.
Raz na kwartał: porównanie for-agents/tool-map.md z tools/list i backlog.