Przejdź do treści

poznan — inicjatywy obywatelskie

Baza wiedzy, szablonów pism i kampanii dla mieszkańców Poznania: hałas tramwajowy, rowery, uspokojenie ruchu, transparentność (UDIP), kompetencje organów, jakość życia.

[!TIP] Nie musisz umieć programować. Całość jest dostępna jako zwykła strona z wyszukiwarką: https://swistaczek.github.io/poznan/

Repo obsługuje dwie grupy:

  • Mieszkańcy i aktywiści — czytają stronę w przeglądarce, kopiują szablony pism, sprawdzają terminy i adresatów.
  • Kontrybutorzy — klonują repo, używają Claude Code do generowania pism, prowadzenia researchu i obsługi kampanii.

Wybierz swoją ścieżkę poniżej.

🏛️ Jestem mieszkańcem / aktywistą

1. Znajdź swój temat

INDEKS.md to mapa całego repo. Wybierasz obszar (hałas, rowery, uspokojenie ruchu, transparentność, instytucje) i wchodzisz w index.md — dostajesz uporządkowany zestaw źródeł i szablonów.

Obszary aktualnie pokryte:

Obszar Po co
research/halas/ hałas tramwajowy i drogowy — normy, pomiary, immisje cywilne, zdrowie
research/uspokojenie-ruchu/ Tempo 30, woonerfy, fizyczne interwencje
research/rowery/ polityka rowerowa Poznania, audyt CROW
research/transparentnosc/ UDIP, skargi na bezczynność, dostęp do danych
research/instytucje/ kto za co odpowiada (mapa kompetencji)

2. 📝 Napisz pismo z gotowego szablonu

Szablony są w szablony/ podzielone na obszary. Przykład — chcesz złożyć wniosek o informację publiczną (UDIP):

  1. Wejdź do szablony/transparentnosc/.
  2. Wybierz wzór (np. wniosek-udip-podstawowy.md).
  3. Skopiuj treść, wypełnij pola {{IMIE_NAZWISKO}}, {{ADRES}}, {{DATA}}, {{ADRESAT}}, {{PRZEDMIOT_SPRAWY}}.
  4. Wyślij e-mailem lub przez ePUAP (adresy niżej).

Lista szablonów rośnie — jeśli brakuje ci wzoru pod konkretną sprawę, załóż issue albo zobacz ścieżkę kontrybutora niżej.

3. Dowiedz się, do kogo pisać

  • ADRESY.md — szybka tabela: UMP, ZDM, MPK, WIOŚ, RDOŚ, Wojewoda, sądy, RPO.
  • research/instytucje/ — pełna mapa kompetencji (kto jest właściwy rzeczowo i miejscowo — kluczowe, bo niewłaściwy adresat = miesiące zwłoki).

[!WARNING] Pozycje z markerem [do weryfikacji] w ADRESY.md wymagają sprawdzenia w BIP przed wysyłką — sprawdź adres, skrytkę ePUAP i datę aktualności.

4. Sprawdź terminy

TERMINY.md — tabela procesowa: UDIP (14 dni), KPA (1–2 miesiące), skarga do WSA (30 dni), wniosek o uzasadnienie wyroku (7 dni — krytyczny termin), apelacja cywilna, petycje.

5. Sprawdź aktywne kampanie

Kampania Obszar
dabrowskiego/ ul. Dąbrowskiego (Jeżyce) — hałas tramwajowy

Każda kampania ma własny REJESTR.md z listą pism wysłanych i odpowiedzi — możesz zobaczyć, co już poszło, i podpiąć się ze swoim adresem w treści.

6. Jak pomóc bez technicznych kompetencji

  • Linkuj konkretne strony (publiczna wersja) w mediach społecznościowych, prasie, rozmowach z radnymi — każda strona ma stabilny URL.
  • Edytuj przez przeglądarkę — na stronie publicznej, u góry każdego artykułu jest ikona ołówka, która otwiera plik w edytorze GitHuba (wymaga darmowego konta).
  • Zgłoś brakujący temat, błąd lub nowe źródło przez GitHub Issues.
  • Wyślij pismo wzorowane na szablonie i wróć z odpowiedzią organu — zasilamy bazę precedensami i orzecznictwem.

Kontakt: @swistak na X/Twitter · GitHub Issues.

💻 Jestem kontrybutorem / deweloperem

1. Zainstaluj Claude Code

Claude Code to CLI asystent AI od Anthropic, który czyta pliki w repo, rozumie lokalne konwencje (ten repo ma CLAUDE.md z regułami pisania pism) i generuje treść zgodną z nimi. W praktyce: mówisz „wygeneruj wniosek UDIP do MPK o protokoły odbioru torowiska" — Claude Code znajduje odpowiedni szablon, wypełnia pola, dodaje podstawę prawną, zaznacza pola do weryfikacji.

[!NOTE] Komendy instalacyjne zmieniają się — zamiast kopiować z tego README, sprawdź oficjalne źródła:

  • Strona produktu: https://claude.ai/code
  • Dokumentacja: https://docs.claude.com/

Zazwyczaj wymaga konta Anthropic i Node.js. Sprawdź aktualny install-flow w docs.

2. Sklonuj repo i otwórz w Claude Code

git clone https://github.com/swistaczek/poznan.git
cd poznan
claude          # uruchom Claude Code w tym katalogu

Claude Code automatycznie wczyta CLAUDE.md (konwencje) oraz nested CLAUDE.md w podkatalogach (lokalne reguły dla szablony/, research/, dabrowskiego/).

3. Co Claude Code potrafi w tym repo

  • Generuje pisma — bierze szablon z szablony/<obszar>/, wypełnia, zapisuje w <kampania>/<obszar>/pisma/YYYY-MM-DD_ADRESAT_temat.md, dopisuje do REJESTR.md.
  • Wyciąga fakty z researchu — research/<obszar>/wyniki-*.md to 40–80 KB gęstego tekstu; Claude Code Grepuje po sygnaturach orzeczeń, art. ustaw, datach.
  • Weryfikuje spójność — sprawdza czy adresat jest właściwy rzeczowo (mapa w research/instytucje/), czy termin zgadza się z KPA/UDIP, czy podstawa prawna cytowana precyzyjnie.
  • Prowadzi panel ekspertów (patrz sekcja niżej) przed decyzjami strategicznymi.

4. Dodaj nową kampanię

<miejsce>/
  CLAUDE.md              # lokalne reguły (krótkie — tylko specyfika miejsca)
  <obszar>/
    REJESTR.md           # dziennik pism wysłanych i odpowiedzi
    pisma/               # kopie szablonów z wypełnionymi polami
    odpowiedzi/          # skany/PDFy/transkrypty odpowiedzi organów

Wypełnianie szablonów: zobacz szablony/CLAUDE.md — zasada „jedno źródło prawdy", kopia do kampanii z frontmatterem type: sent.

5. Dodaj nowy research

  1. Napisz brief eksperta w research/prompty/NN-<obszar>.md — persona top 1%, zakres, „czego NIE chcemy".
  2. Uruchom eksperta (Claude Code z Agent tool albo zewnętrzny LLM).
  3. Zapisz wynik w research/<obszar>/wyniki-NN-<temat>.md. Pamiętaj o limicie pliku (cel ≤ 12 KB, twardy limit ~40 KB — patrz CLAUDE.md).
  4. Dodaj wpis do research/<obszar>/index.md.

6. Lokalny podgląd strony (opcjonalne)

Strona publikowana automatycznie z main przez GitHub Actions (workflow). Do lokalnego podglądu:

python -m venv .venv
source .venv/bin/activate
pip install -r requirements-docs.txt
mkdocs serve    # http://127.0.0.1:8000/poznan/

Szczegóły (build strict, troubleshooting, rozszerzenia): docs-local.md.

Stos: MkDocs Material + pluginy search (fallback EN stemmer — PL niewspierany) i awesome-pages. Konfiguracja w mkdocs.yml.

Struktura repo (high-level)

research/<obszar>/          wiedza referencyjna, reużywalna między kampaniami
research/prompty/           briefy 01–NN dla ekspertów (persona + zakres)
szablony/<obszar>/          wzory pism (jedno źródło prawdy)
<kampania>/<obszar>/        konkretna sprawa (np. dabrowskiego/halas/)
ADRESY.md                   adresaci organów
TERMINY.md                  terminy KPA / UDIP / p.p.s.a. / KPC
INDEKS.md                   mapa nawigacyjna
CLAUDE.md                   konwencje dla Claude Code
mkdocs.yml, .pages, *.md    konfiguracja strony publicznej

Pełne drzewo z linkami: INDEKS.md.

Konwencje (skrót)

Pełna wersja: CLAUDE.md. W dwóch zdaniach:

  • Wszystko po polsku (treść, commity, nazwy plików); nazwy plików w kebab-case bez polskich znaków i spacji.
  • Dokumenty źródłowe (research/, notatki) — gęsty styl, fakty, liczby, sygnatury; pisma urzędowe (<kampania>/pisma/) — pełny protokół urzędowy (zwroty grzecznościowe mają wartość procesową).
  • Każdy podkatalog może mieć własny CLAUDE.md z lokalnymi regułami.
  • Cytuj akty prawne dokładnie: akt, Dz.U., art./§/ust., data wersji.

Hierarchia wartości

Repo trzyma się jednej osi: wolność > transparentność > samorządność > polityka krajowa. W praktyce decyzyjnej oznacza to, co następuje.

  • Wolność. Punktem odniesienia jest mieszkaniec, który chce spać, oddychać, przejść przez ulicę. Każda kampania (hałas Dąbrowskiego, plac Park Ujazdowski) sprowadza się do pytania, gdzie władza — miejska, spółkowa, wojewódzka — zawęziła tę wolność szybciej, niż prawo na to pozwala. Reszta to narzędzia.
  • Transparentność. Pierwsze narzędzie, bo bez niego pozostałe są ślepe. Korzystamy z UDIP (Dz.U. 2001 nr 112 poz. 1198, art. 13 — 14 dni), BIP (art. 8 tej samej ustawy), KPA art. 73 (wgląd w akta), eKRS i MSiG. Materiały o spółkach miejskich (PIM, Aquanet, ZKZL, MTP, MPK) i portrety zarządów powstają wyłącznie w oparciu o źródła publiczne.
  • Samorządność. Zgodnie z art. 4 ust. 3 Europejskiej Karty Samorządu Lokalnego i art. 16 ust. 2 Konstytucji RP — pisma adresujemy najbliższemu właściwemu organowi i eskalujemy w górę dopiero po wyczerpaniu szczebla niższego. Rada osiedla przed radą miasta, rada miasta przed wojewodą, wojewoda przed ministerstwem. Mapa właściwości: research/instytucje/.
  • Polityka krajowa. Na samym końcu i celowo. Krytyka idzie po faktach, nie po barwach: KO (prezydent Jaśkowiak, wiceprezydent Gołek, zarząd PIM), PiS (poseł Czerwiński, interpelacja z 16.04.2026 o kominach w spółkach SP), Polska 2050 (projekty reform nadzoru właścicielskiego). Każdą partię traktujemy jak interesariusza, nie sojusznika ani wroga.

Praktyczna konsekwencja: nie znajdziesz tu treści partyjnych ani języka „naszych" i „onych", znajdziesz nazwiska konkretnych radnych, członków zarządów spółek miejskich i urzędników — z datą głosowania, sygnaturą uchwały i numerem KRS.

Ostatnie zmiany

Lista poniżej odświeża się automatycznie przy każdym buildzie strony (skrypt scripts/mirror-to-docs.sh). Pokazuje 30 ostatnio zmienionych dokumentów — sygnał dla crawlerów (Google, Bing) i punkt orientacyjny dla powracających czytelników.

Panel ekspertów

Przy strategicznych decyzjach (np. wybór strategii procesowej, treść pisma wysokostawkowego) Claude Code uruchamia równolegle 4–6 sub-agentów w rolach top 1% ekspertów — prawo administracyjne, akustyka, zdrowie publiczne, urbanistyka, UDIP — i syntetyzuje wnioski. Persony w research/prompty/. Kryterium użycia: „gdyby rekomendacja okazała się błędna, koszt > kilka minut korekty". Szczegóły: sekcja „Panel ekspertów" w CLAUDE.md.

Licencja

[!NOTE] Propozycja — do potwierdzenia przez maintainera:

  • Treść (research, szablony, analizy): CC-BY-SA-4.0 — wolno kopiować i adaptować pod warunkiem przypisania autorstwa i zachowania licencji.
  • Kod konfiguracyjny (MkDocs, GitHub Actions, skrypty): MIT.

Do czasu dodania pliku LICENSE w repo — traktuj materiały jako referencyjne, nie stanowią porady prawnej. W sprawach wysokostawkowych skonsultuj radcę prawnego lub rzeczoznawcę.

Kontakt i kredyty

  • Maintainer: @swistaczek (GitHub) · @swistak (X/Twitter).
  • Zgłoszenia: GitHub Issues.
  • Treści generowane przez AI — znaczna część materiału researchowego w tym repo (w szczególności research/instytucje/ — portrety, aneksy OSINT, deep-dive, teorie śledcze, werdykty) jest generowana lub współ-redagowana przez Claude (model Anthropic) w środowisku Claude Code. Z dużą szansą zawierają błędy faktograficzne, mylne interpretacje sygnatur orzeczeń, nieaktualne dane personalne lub halucynowane linki/cytaty. Każdy fakt cytowany dalej (w piśmie urzędowym, artykule prasowym, wniosku UDIP, postępowaniu sądowym) wymaga niezależnej weryfikacji w źródle pierwotnym: BIP, KRS, MSiG, eKRS RDF, orzecznictwo (saos.org.pl, NSA, SN, GKO), prasa branżowa. Pliki nie są poradą prawną. Korekty zgłaszaj przez Issues — zasilamy bazę precedensami i sprostowaniami.

Kontrybucje (każda forma — tekst, korekta, weryfikacja adresów, opowiedzenie o sprawie) mile widziane.