Wszystko, czego potrzebujesz, żeby zacząć działać w Generacji Innowacji: jak pracujemy, gdzie rozmawiamy i co robi Twój krąg.
Wywołujemy pozytywne zmiany społeczne przez technologię, edukację i odpowiedni leadership.
Wspierając młodzież, budujemy kulturę innowacji. Wzmacniamy społeczeństwo technologią: tworzymy rozwiązania, które wspierają ludzi i organizacje w przestrzeni społecznej.
Ekosystem, Technologia, Talenty i Społeczeństwo.
Nie mamy menedżerów. Pracujemy jawnie, na kanałach dostępnych dla wolontariuszy i praktykantów.
Każdy krąg ma lidera. Napisz do niego, gdy szukasz zadania albo masz własny projekt.
Lider każdego kręgu jest podany w opisie kanału kręgu na Discordzie.
Nasz aktywny produkt: quizy obywatelskie, z których skorzystało 4,5 mln+ osób. Wersję 2.0 budujemy przed wyborami parlamentarnymi jesienią 2027.
Działaj.org, Asystent NGO (NGO Manager), myPolitics Polls, myPolitics UA i Wiarygodne IT. Nie rozwijamy ich, a ich repozytoria zostały jako archiwum.
Quizy, badania, programy wideo i platformy w jednym przeglądzie.
Asystent AI fundacji: Claude Code połączony z naszym Discordem. Przygotowuje i sprawdza, a zatwierdza człowiek.
Dołącz do Discorda i załóż wątek na #onboarding. Razem wybierzemy krąg, w którym zaczniesz.
Oprócz Engineering działają u nas kręgi Marketing, Produkt (UX, UI, Portfolio), Relations i People. Wybierz swój nad listą sekcji.
Opisz go na kanale #produkt. Inicjatywy całej fundacji spisujemy w repozytorium product.
Traktuj AI jak partnera w myśleniu: testuj, analizuj i sprawdzaj wynik. Człowiek prowadzi, AI wspiera.
Praktyki są w 100% zdalne. Ustalamy zakres zadań, a Ty decydujesz, kiedy je robisz.
Na Discordzie i w dokumentach organizacyjnych piszemy po polsku. Na GitHubie, w zadaniach i dokumentacji technicznej - po angielsku.
Pytaj i opisuj postępy na kanale kręgu lub projektu, a nie w prywatnej wiadomości. Wtedy każdy może pomóc.
Tu jest cała społeczność i praca kręgów.
Bez roli możesz tylko reagować na wiadomości. Napisz prywatnie do Adriana Orłowa lub Oskara Barcza, żeby dostać rolę przyjaciel.
Załóż tu wątek, gdy chcesz zacząć działać. Ustalimy wszystkie szczegóły.
#aktualności - ogłoszenia, #wydarzenia-i-wyjazdy - relacje i wyjazdy, #kudos - podziękowania.
#development - tworzenie oprogramowania i zgłoszenia błędów, #pochwal-sie - Twoje projekty. Do tego #offtop, #memy, #pets i #2137.
Na przykład #produkt, #engineering, #marketing i #mypolitics-... Widzą je osoby z rolą wolontariusz lub praktykant.
Załóż wątek na forum #press-release: kontekst w punktach i, jeśli możesz, zdjęcia. Resztą zajmie się marketing.
Domyślnie dostajesz oznaczenie przy każdym działaniu GI. Zmienisz to reakcją pod wiadomością GI Bota na #hello-world.
Statut, sprawozdania, Polityka Ochrony Małoletnich, polityka refleksyjnego korzystania z AI i kryteria oceniania praktyk.
Trzy wersje logo, cztery kolory i krój Poppins. Używaj oryginalnych plików SVG, bez przerysowywania i zmiany kolorów.
#000000tło wiodące#D91919kolor wiodący#231F20na jasnym tle#FFFFFFtekst i znakUżywamy prawdziwych zdjęć, zrzutów ekranu produktów i materiałów marki. Obrazów z generatorów AI nie używamy.
Każdy z GI może publikować na gi.org.pl/blog aktualności, teksty i devlogi. Piszemy po polsku, a publikację zatwierdza zarząd.
Dokumenty, szablony i pełne pakiety plików logo.
Dokumenty fundacji piszemy na szablonie z logo w nagłówku i stopce. Szablon jest na Dysku fundacji.
Inicjatywy całej fundacji, ich status i decyzje spisujemy w repozytorium product, w folderze gi/docs.
W repozytoriach i materiałach roboczych nie zapisujemy danych osobowych praktykantów i wolontariuszy. Zamiast nazwisk podajemy role.
Standardy techniczne są na licencji CC BY-NC 4.0, a workflowy front-endu na MIT. Licencję repozytorium znajdziesz w pliku LICENSE.
Krąg
Przygotowujemy posty i grafiki fundacji na podstawie briefów. Rozmawiamy na kanale #marketing.
Każdy brief to osobny wątek na forum: kontekst w punktach i zdjęcia do publikacji.
Console
Generator grafik do postów w przeglądarce: wpisujesz tekst, dodajesz zdjęcie i pobierasz PNG.
Nie ma kont ani bazy danych: odświeżenie strony czyści szkic.
Standard i News. Tekst w gwiazdkach, np. *nowy*, dostaje kolor akcentu.
Oznaczenie programu, z którego finansujemy działanie: PROO albo Fundusz Młodzieżowy. Grafika może też nie mieć belki.
Wytyczne NIW-CRSO wymagają też informacji o finansowaniu w tekście posta - belka na grafice jej nie zastępuje.
Post może mieć kilka grafik. Na Instagramie pójdzie też jako relacja w formacie 9:16.
Publikacja
Grafiki trafiają do kanałów fundacji przez Buffer. Publikuje wyznaczona osoba z marketingu.
Grafiki tylko ze zdjęć, zrzutów ekranu i materiałów marki. Logo i kolory według identyfikacji wizualnej w Dokumentach.
Krąg
Obejmuje podkręgi UX, UI i Portfolio. Lider: Adrian Orłów, kanał #produkt.
#mypolitics-produkt, #mypolitics-sejmownik, #mypolitics-dane, #mypolitics-stats i #athena-design.
Dokumentacja i projekty
Koncepty, moduły, specyfikacje i zadania myPolitics na gi.org.pl/produkt. Strona powstaje z repozytorium product.
Kolejność: docs, potem spec, potem tasks. Pomysł uzgadniamy w docs, opisujemy w spec i dopiero wtedy dzielimy na zadania.
Projekty interfejsu myPolitics.
Jak podłączyć Figmę do Claude Code przez figma-bridge, opisujemy w sekcji Gieniek na Twoim komputerze.
Z ramki w Figmie bierzemy układ, odstępy, kolory i teksty. Nazwy komponentów i tokeny bierzemy z kodu i sąsiednich komponentów.
athena to wspólna biblioteka komponentów naszych front-endów. Nowy element interfejsu ma do niej pasować.
Krąg
Lider: Oskar Barcz, kanał #engineering. Projekty mają własne kanały: #mypolitics-app, #mypolitics-engineering i #athena-development.
Stack i standardy
Nasze standardy front-endu, back-endu, AI i Gita, każdy z uzasadnieniem. Obowiązują w każdym projekcie.
TypeScript, React / Next.js, Vite, Tailwind CSS, axios, zod, Vitest, Storybook, Playwright, Zustand i Biome.
Inną technologię w nowym projekcie zatwierdza najpierw lider techniczny.
TypeScript, Node.js, NestJS, Prisma, PostgreSQL, cucumber-js, ESLint / Prettier i Docker.
Słowa MUST, SHOULD i MAY w dokumentach technicznych znaczą to, co w RFC 2119. Ważne decyzje technologiczne mają swój zapis z uzasadnieniem.
Nowy projekt zacznij od szablonu: Vite + React albo NestJS + Prisma + PostgreSQL.
Roadmapy krok po kroku: od JavaScriptu i Gita po Reacta i back-end.
Git i proces
Ustaw prawdziwe imię i nazwisko, e-mail w domenie gi.org.pl, 2FA i podpisywanie commitów. Pull requesta z niepodpisanymi commitami nie da się scalić.
git config --global user.name "Imię Nazwisko"
git config --global user.email "twoj-adres@gi.org.pl"
git config --global gpg.format ssh
git config --global user.signingkey ~/.ssh/id_ed25519.pub
git config --global commit.gpgsign trueKażdą zmianę zaczynasz na nowej gałęzi od najnowszego main:
git checkout main
git pull
git checkout -b nazwa-galeziProjekty testujemy na Ubuntu 24 i macOS. Windows bywa problematyczny - używasz go na własną odpowiedzialność.
Fundacja przygotowuje też konfigurację Ubuntu dla maszyn wirtualnych wolontariuszy: repozytorium gi-os.
Biorąc zadanie, przesuń je na In progress i przypisz siebie. W pull requeście podlinkuj issue i nie dodawaj etykiet, projektów ani milestone'ów.
Każdy pull request przechodzi review. Recenzent komentuje i zatwierdza, a scala autor.
Implement calculation results cache. Opis dodaj tylko wtedy, gdy recenzent musi coś wiedzieć.main.Nie zostawiaj zatwierdzonego pull requesta bez scalenia - to opóźnia pracę.
Komentarz w review zaczyna się od etykiety (issue, suggestion, question, nitpick, praise) i może mieć dopisek blocking lub non-blocking.
suggestion (non-blocking): this could reuse the existing formatter.
issue (blocking): the request is sent twice on every render.Zanim pull request front-endu obejrzy człowiek, osobny model AI sprawdza kod, zgodność ze standardami i typowe błędy. Jego ocena jest doradcza.
clean - brak uwag.advisory - tylko uwagi nieblokujące.changes - jest uwaga blokująca, check nie przechodzi.human review - zmianę musi ocenić człowiek, np. gdy dotyka CI albo zależności.Zielony pre-check to nie akceptacja. Etykiety pre-check to jedyny wyjątek od zasady „bez etykiet w pull requestach”.
W części repozytoriów commity i tytuły pull requestów zaczynają się od feat:, fix:, docs:, ci: lub chore:. Sprawdź README lub CONTRIBUTING repozytorium.
Narzędzia
Zadania projektów w GitHub Projects, od In progress po review.
Kod jest otwarty. Nowy moduł to wpis w CONSOLE_MODULES, a nowy szablon - folder z komponentem i wpis w GRAPHIC_TEMPLATES.
Publiczne
Dokumentacja produktów i fundacji: koncepty, specyfikacje, zadania, roadmapa i identyfikacja wizualna.
Standardy techniczne: front-end, back-end, AI, Git i code review.
Nowy front-end myPolitics 2.0: React, Vite i Tailwind CSS.
Biblioteka komponentów naszych front-endów.
Console, w tym generator grafik.
Worker, który publikuje grafiki z Console przez Buffer.
Wspólne workflowy GitHub Actions dla front-endu, w tym AI pre-check.
vite-project-boilerplate i nestjs-project-boilerplate: start front-endu i back-endu.
Konfiguracja Ubuntu dla maszyn wirtualnych wolontariuszy.
Małe akcje do CI: końce linii, uprawnienia plików, wersje i wydania.
Wtyczka Discorda dla Claude Code z rolami dla nadawców i domyślną odmową. Na niej działa Gieniek.
Prywatne (po dołączeniu)
Produkcyjna wersja myPolitics, działająca dziś na mypolitics.pl.
Nowy back-end ankiet myPolitics: API producenta i consumer liczący wyniki.
Umiejętności Gieńka jako wtyczka Claude Code. Dostęp przez zespół fundacji na GitHubie, po dołączeniu.
Pozostałe
dzialaj-org, ngo-manager, wiarygodne-it i mypolitics-polls. Repozytoria zakończonych produktów, których nie rozwijamy.
Pełna lista publicznych repozytoriów organizacji.
Program dla klas i szkół. Poznajemy się na żywo, ustalamy zakres i prowadzimy grupę przez realne zadania.
Lider: Oskar Barcz, kanał #praktyki-systemowe. Każdy cykl praktyk ma własny kanał, np. #praktyki-2026-07.
Dla studentów, którzy chcą rozwijać konkretne kompetencje. Zadania, mentoring i tempo dobieramy do celu.
Praktykanci pracują przy tym samym produkcie i przechodzą to samo review co doświadczeni inżynierowie.
W review przypisujesz opiekunów praktyk ze swojej dziedziny. Koordynatorzy muszą wiedzieć o zadaniach robionych wspólnie.
Kryteria oceniania podczas praktyk są publiczne, na stronie z dokumentami fundacji.
Lider: Adrian Orłów, kanał #relations. Zakres zadań ustalisz z liderem kręgu.
Kanał #people. Lidera znajdziesz w opisie kanału.
Zanim zaczniesz
Claude Code z wtyczką gieniek-skills. Na Discordzie odpowiada wybranym osobom, a Ty uruchomisz te same umiejętności u siebie.
Post z briefu, dokument na szablonie fundacji, odnalezienie materiałów albo zmiana w kodzie. Gieniek zna procedury fundacji.
Program, w którym rozmawiasz z Claude, a on czyta pliki w wybranym folderze i korzysta z narzędzi. Wtyczkę Gieńka uruchamiasz z terminala.
Repozytorium gieniek-skills jest prywatne. Dostęp dostajesz po dołączeniu, przez zespół fundacji na GitHubie: poproś o dodanie na #onboarding.
Konta Claude z planem Pro, Max, Ultra, Team lub Enterprise albo konta Console. Plan darmowy nie obejmuje Claude Code.
Systemy: macOS 13+, Windows 10 (1809+), Ubuntu 20.04+, Debian 10+. Na Windowsie warto doinstalować Git for Windows.
Konfiguracja
Uruchom polecenie instalacji, a w nowym oknie terminala sprawdź claude --version.
curl -fsSL https://claude.ai/install.sh | bashirm https://claude.ai/install.ps1 | iexbrew install --cask claude-code
winget install Anthropic.ClaudeCodeUruchom claude w folderze projektu i zaloguj się w przeglądarce.
cd moj-projekt
claudeGdy Twoje konto GitHub jest już w zespole fundacji, sklonuj prywatne repozytorium i uruchom Claude Code z katalogiem wtyczki.
Klonujesz swoim kontem GitHub, np. po zalogowaniu przez gh auth login.
git clone https://github.com/gi-org-pl/gieniek-skills.git
claude --plugin-dir ./gieniek-skillsUmiejętności są dostępne jako /gieniek:nazwa-umiejetnosci, a Claude wczytuje je sam, gdy zadanie pasuje do ich opisu.
Aktualizacja: git pull w katalogu repozytorium, a w działającej sesji /reload-plugins (albo restart).
Repozytorium jest prywatne: git clone zadziała dopiero po dodaniu Twojego konta do zespołu fundacji na GitHubie. Instalacja z marketplace'u wtyczek nie jest przygotowana.
10 procedur fundacji. Większość działa na Twoich kontach, trzy wymagają dostępu do dokumentów fundacji, jedna jest tylko dla bota.
social-publishing - z briefu z #press-release do gotowych postów i tekstów na grafikę z Console.foundation-document - dokument na szablonie fundacji w Google Docs.resource-map - gdzie fundacja trzyma dokumenty, repozytoria i kanały oraz które produkty są aktywne.github-work - issues, pull requesty, commity i odpowiedzi na review w repozytoriach gi-org-pl.interface-design - jak budować interfejs w mypolitics-app i athena, żeby pasował do reszty.work-queue - długie i ciężkie zadania: kolejka, dziennik na dysku, powrót po awarii.internships - dokumentacja praktyk i liczenie godzin; wymaga dostępu do dokumentów praktyk.grant-purchase - dokumenty zakupu lub zwrotu kosztów z grantu; wymaga dostępu do dokumentów grantu.grant-status - wskaźniki, budżet i dowody grantu; wymaga dostępu do dokumentów grantu.discord-conduct - jak bot pisze na Discordzie; tylko dla bota.Opcjonalnie: MCP i narzędzia
Konektor do pracy nad stroną gi.org.pl. Podłączasz go na claude.ai, a Claude Code widzi go po zalogowaniu tym samym kontem.
Most figma-bridge łączy Claude Code z aplikacją Figma na komputerze. Potrzebujesz aplikacji Figma (macOS lub Windows), Node.js i Claude Code.
W Figmie w przeglądarce wtyczki deweloperskiej nie zaimportujesz - potrzebna jest aplikacja na komputer.
manifest.json z folderu plugin/./mcp pokazuje figma-bridge jako połączony.claude mcp add figma-bridge -- npx -y @gethopp/figma-mcp-bridgeclaude mcp add figma-bridge -- cmd /c npx -y @gethopp/figma-mcp-bridgeJak korzystać:
list_files - klucz pliku zmienia się między sesjami.1190-9207 robi się 1190:9207. Nigdy nie czytaj całej strony.Konektory Google na claude.ai, podłączone Twoim kontem. Claude widzi tylko pliki, do których masz dostęp.
Przez gh Claude Code tworzy issues i pull requesty. Zainstaluj gh i zaloguj się swoim kontem GitHub.
gh auth login
gh auth statusRozszerzenie, z którym Claude otwiera strony, klika i czyta konsolę, np. żeby sprawdzić zmianę w aplikacji. Działa na Twoich sesjach, więc pilnuj, gdzie go wpuszczasz.
claude --chrome/chrome pokazuje stan połączenia i uprawnienia do stron.
Łączy Claude Code z Discordem przez własnego bota. Tak działa Gieniek fundacji, a do pracy u siebie jej nie potrzebujesz.
Zasady
Te same co w całej fundacji: AI pomaga, człowiek zatwierdza.
Tak. Działają u nas kręgi Marketing, Produkt (UX, UI, Portfolio), Relations i People.
Nie. Zaczynasz od podstaw i standardów, a potem wybierasz kierunek.
Napisz w swoim wątku na #onboarding albo do lidera kręgu.
Tak, tego oczekujemy, ale refleksyjnie. Za efekt odpowiadasz Ty, a Twoją pracę sprawdza człowiek.
Zareaguj pod wiadomością GI Bota na #hello-world i wybierz, o czym chcesz dostawać oznaczenia.
Na #produkt. Opisz problem i to, co chcesz zbudować.
Na forum #pochwal-sie, w osobnym wątku.
Na kanale #development.
Po angielsku. Tytuł pull requesta piszesz w czasie teraźniejszym, np. Implement calculation results cache.
Zapytaj na Discordzie.
Dołącz do DiscordaNapisz na #onboarding - odpowiemy i pomożemy zacząć.
