surfup

12 zasad projektu

12 praktycznych zasad dotyczących kontekstu repozytorium, SEO, bezpieczeństwa i weryfikowalnych zmian.

Potraktuj te kroki jako listę roboczą i dostosuj je do danych, zakresu oraz ograniczeń projektu.

Kontekst i zakres

  • Przeczytaj najpierw obowiązujące instrukcje projektu, jeśli istnieją (na przykład .cursor/rules lub CLAUDE.md); sprawdź też README i manifest, jeśli są dostępne.
  • Przed zmianami krótko opisz obecną architekturę i wskaż tylko potrzebne pliki.
  • Określ cel jako jeden weryfikowalny rezultat; nie rozszerzaj zadania bez powodu.
  • Przed zmianą API ustal jego użytkowników, format żądania i odpowiedzi oraz wymagania zgodności.

Jakość i bezpieczeństwo

  • Dla każdego pola wejściowego określ walidację formatu, długości i niebezpiecznych wartości.
  • Nie umieszczaj sekretów w kodzie, logach, danych testowych, przykładach ani publikowanych zasobach frontendu.
  • Na stronach wyszukiwania sprawdź title, description, canonical, robots, nagłówki, linki i źródłowy HTML.
  • Zachowaj teksty właściwe dla każdej wersji językowej, regionalne przykłady kontaktów i równoważne adresy URL.
  • Elementy interaktywne muszą obsługiwać klawiaturę, mieć nazwy dla technologii asystujących i widoczny fokus.

Weryfikacja i raportowanie

  • Uruchamiaj tylko kontrole potwierdzające zmienione zachowanie; nie twierdź, że uruchomiono niewykonane polecenia.
  • Porównaj wynik z kryteriami odbioru; sprawdź błędne scenariusze i widok mobilny.
  • W raporcie podaj zmiany, polecenia i faktyczne wyniki, znane ograniczenia oraz sposób wycofania.

Najnowsze materiały

Wszystkie materiały

Praktyczne artykuły i poradniki SurfUp.

Poradnik · 10 min

Strony „co to jest…” i odpowiedzi AI: utracone kliknięcia czy popyt

Sekcja informacyjna banku straciła 24% wizyt, popyt spadł o 13%. Jak odróżnić kliknięcia utracone na rzecz bloku AI od spadku popytu i jak to zmierzyć.

Czytaj
Poradnik · 8 min

Ruch spadł po aktualizacji Google

Jak ustalić, czy spadek ruchu wynika z aktualizacji Google, sezonowości czy awarii witryny. Oś czasu aktualizacji z 2026 r., test z sześciu pytań i plan na pierwsze 14 dni.

Czytaj
Poradnik · 9 min

Spadł popyt czy serwis stracił: uzgadnianie ruchu z Wordstat

Popyt na lokaty spadł o 75%, ruch o 37%; w kartach popyt −35%, ruch −63%. Jak uzgodnić ruch z popytem i nie obwiniać serwisu za rynek.

Czytaj