github-samples · Azkel · Sep 9, 2026 · Sep 14, 2026 · Sep 9, 2026 · Sep 10, 2026
diff --git a/.github/copilot-instructions.md b/.github/copilot-instructions.md
@@ -9,7 +9,7 @@ This repo hosts the **workshop content** for **Copilot Workshops**, published as
 - `docs/` — **Source Markdown for all lessons. Edit here.** Browsable directly on github.com; no build required.
   - `README.md` — Workshop landing page (also the site home via `slug: index` frontmatter).
   - `cli/`, `vscode/`, `cloud/`, `app/` — Per-harness lessons (Copilot CLI / VS Code / Cloud agent / GitHub Copilot app). Each folder's landing page is a `README.md` (routed via a `slug:` matching the folder path). Each harness opens with its own `0-prerequisites.md` setup lesson; the CLI and VS Code harnesses set up a codespace, while the app and cloud harnesses cover the setup their flow needs (for the app, installing Node.js locally and creating the project from the template).
-  - `es-es/`, `ja-jp/`, `ko-kr/`, `pt-br/`, `zh-cn/` — Localized content at the locale-root paths required by Starlight. Translated pages mirror the English path beneath each locale directory; untranslated pages use Starlight's English fallback.
+  - `es-es/`, `ja-jp/`, `ko-kr/`, `pl-pl/`, `pt-br/`, `zh-cn/` — Localized content at the locale-root paths required by Starlight. Translated pages mirror the English path beneath each locale directory; untranslated pages use Starlight's English fallback.
   - `_images/` — Screenshots and diagrams (shared across all locales).
 - `website/` — Optional Astro + Starlight site that publishes `docs/` to GitHub Pages (loader `base: '../docs'`). Only needed to self-host or preview the rendered site.
   - `astro.config.mjs` — Site config including the manually maintained sidebar and the `locales` block. The legacy `/shared/0-prereqs/` → home (`/`) redirect is a full-HTML redirect page at `src/pages/shared/0-prereqs.astro` (not an `astro.config.mjs` `redirects` entry, which would emit a stub with no `<html>` element that Pagefind can't index). Prerequisites are now per-harness (`/<harness>/0-prerequisites/`), so the old shared-prereqs URL forwards to the home page.

diff --git a/.github/skills/localizations/rules/pl-pl.md b/.github/skills/localizations/rules/pl-pl.md
diff --git a/AUTHORING.md b/AUTHORING.md
@@ -16,7 +16,7 @@ copilot-workshops/
 │   ├── vscode/                  ← VS Code lessons (0-prerequisites.md + numbered exercises)
 │   ├── cloud/                   ← Cloud agent lessons (0-prerequisites.md + numbered exercises)
 │   ├── app/                     ← GitHub Copilot app lessons (setup folded into Exercise 1)
-│   ├── es-es/ ja-jp/ ...        ← Translated locale trees (currently the app harness)
+│   ├── es-es/ ja-jp/ ko-kr/ pl-pl/ pt-br/ zh-cn/  ← Translated locale trees (app + cli)
 │   └── _images/                 ← Screenshots and diagrams (shared across locales)
 ├── website/                     ← Optional Astro + Starlight publisher
 │   ├── astro.config.mjs         ← Site URL, base path, locales, sidebar

diff --git a/README.md b/README.md
@@ -22,7 +22,7 @@ For PR/CI rules, see **[CONTRIBUTING.md](./CONTRIBUTING.md)**.
 - **`docs/`** — **Lesson source (plain Markdown). Edit here.** Browsable directly on github.com, no build required.
   - `README.md` — Workshop landing page (also the published site's home via `slug: index`).
   - `cli/`, `vscode/`, `cloud/`, `app/` — Per-harness lessons (Copilot CLI / VS Code / cloud agent / GitHub Copilot app). Each codespace-based harness opens with its own `0-prerequisites.md` setup lesson, and a folder `README.md` (routed via a `slug:` matching the folder) is its landing page.
-  - `es-es/`, `ja-jp/`, `ko-kr/`, `pt-br/`, `zh-cn/` — Translated locale trees (currently the app harness).
+  - `es-es/`, `ja-jp/`, `ko-kr/`, `pl-pl/`, `pt-br/`, `zh-cn/` — Translated locale trees (currently the app and CLI harnesses).
   - `_images/` — Screenshots and diagrams (shared across all locales).
 - **`website/`** — Optional Astro + Starlight site that publishes `docs/` to GitHub Pages. Only needed to self-host or preview the rendered site.
   - `astro.config.mjs` — Site URL, base path, `locales` block, sidebar.

diff --git a/docs/pl-pl/README.md b/docs/pl-pl/README.md
@@ -0,0 +1,43 @@
+---
+slug: pl-pl
+title: "Praktyczne warsztaty z agentami GitHub Copilot"
+authors:
+  - geektrainer
+  - azkel
+lastUpdated: 2026-09-09
+---
+
+Niedawne rozszerzenia możliwości GitHub Copilot dają programistom potężne narzędzia podczas pracy na każdym etapie cyklu życia oprogramowania (SDLC). Obejmują pracę ze zgłoszeniami, pull requestami na GitHubie, interakcję z usługami zewnętrznymi oraz oczywiście tworzenie kodu. Te warsztaty opierają się na tych funkcjach, pokazując praktyczne przypadki użycia i wskazówki, jak w pełni wykorzystać te narzędzia.
+
+> [!CAUTION]
+> Ponieważ GitHub Copilot jest probabilistyczny, a nie deterministyczny, dokładny kod, zmienione pliki itd. mogą się różnić. W efekcie możesz zauważyć drobne różnice między zrzutami ekranu i fragmentami kodu w tych warsztatach a tym, co widzisz. To oczekiwane i wynika z natury tej klasy narzędzi.
+>
+> Jeśli coś wygląda na uszkodzone lub nie działa poprawnie, poproś mentora o pomoc!
+
+## Wybierz środowisko
+
+GitHub Copilot czeka na Ciebie tam, gdzie pracujesz. Wybierz środowisko dopasowane do sposobu, w jaki chcesz budować, i przejdź przez ćwiczenia implementujące zadania z backlogu Tailspin Toys. Każde środowisko zaczyna się od konfiguracji Twojej maszyny - wybierz tę, którą preferujesz.
+
+### 🖥️ [VS Code](../vscode/)
+
+GitHub Copilot w **Visual Studio Code** i GitHub Codespaces. Pracuj w trybie agenta Copilot Chat, z serwerami MCP i agentami niestandardowymi bez opuszczania edytora, którego już używasz — idealne, gdy chcesz wpleść pomoc AI bezpośrednio w IDE.
+
+### 💻 [Copilot CLI](cli/)
+
+**GitHub Copilot CLI** — asystent oparty na agentach działający w terminalu. Zainstaluj go, podłącz serwery MCP, generuj kod w trybie planowania i twórz własne skille, agentów niestandardowych oraz polecenia — wszystko z wiersza poleceń, bez przełączania się do edytora graficznego.
+
+### 🤖 [Copilot App](app/)
+
+**Aplikacja GitHub Copilot** — aplikacja desktopowa oparta na Copilot CLI. Uruchamiaj równoległe sesje agentów, przełączaj tryby sesji, współpracuj na kanwach i zarządzaj zgłoszeniami oraz pull requestami w GitHubie natywnie — wykorzystując między innymi **Agent Merge**, który tworzy pull requesty z opcją rebase, implementuje uwagi z przeglądu, poprawki CI i scala zmiany pomiędzy gałęziami.
+
+### ☁️ [Copilot Cloud Agent](../cloud/)
+
+**Agent chmurowy Copilot** — asynchroniczny partner programistyczny, który pracuje nad zgłoszeniami GitHub w tle. Przypisuj pracę, prowadź go agentami niestandardowymi, monitoruj postęp w panelu agentów i przeglądaj otwierane przez niego pull requesty.
+
+## Scenariusz
+
+Jesteś nowym programistą w Tailspin Toys, fikcyjnej firmie oferującej crowdfunding gier planszowych o tematyce deweloperskiej — ogromny rynek! Backlog zespołu jest już stworzony jako zgłoszenia w GitHubie, gotowe do podjęcia — zarówno prace funkcjonalne (np. filtrowanie i paginacja), jak i poprawa jakości (np. dostępność i standardy kodowania). Będziesz pracować iteracyjnie, eksplorując zarówno witrynę, jak i możliwości Copilota, aby dokończyć zadania.
+
+## Rozpocznij
+
+Wybierz środowisko powyżej, aby zacząć — każde rozpoczyna się od instrukcji jak skonfigurować środowisko potrzebne do rozpoczęcia pracy.
diff --git a/docs/pl-pl/app/0-prerequisites.md b/docs/pl-pl/app/0-prerequisites.md
@@ -0,0 +1,86 @@
+---
+title: "Lekcja 0 - Wymagania wstępne"
+description: "Przygotuj się do warsztatów z GitHub Copilot: zainstaluj Node.js dla projektu Tailspin Toys i utwórz własną kopię repozytorium na podstawie szablonu."
+authors:
+  - geektrainer
+  - azkel
+lastUpdated: 2026-09-09
+---
+
+Aplikacja GitHub Copilot to aplikacja desktopowa — centralny hub zarówno dla Copilota, jak i GitHuba. Zapewnia szybki dostęp do zgłoszeń i pull requestów oraz oczywiście pozwala budować wykorzystując GitHub Copilot. Podczas tego warsztatu będziesz pracować lokalnie, korzystając zarówno z aplikacji Tailspin Toys opartej na Astro, jak i z aplikacji GitHub Copilot. Zanim zaczniesz, upewnijmy się, że Node.js jest zainstalowany na Twoim komputerze, a potem zainstalujemy aplikację Copilot.
+
+Podczas tej lekcji:
+
+- zainstalujesz Node.js, aby testy projektu mogły działać na Twoim komputerze.
+- utworzysz własną kopię projektu Tailspin Toys wykorzystując szablon.
+
+## Zainstaluj Node.js
+
+W niektórych lekcjach agent buduje funkcje i uruchamia lokalnie zestaw testów Tailspin Toys, co wymaga **[Node.js][nodejs]** — jedynego środowiska uruchomieniowego (runtime), którego projekt potrzebuje. Zainstaluj wersję **22 lub nowszą**; bieżące wydanie **LTS** to bezpieczny wybór.
+
+Najprostsza opcja na każdej platformie to oficjalny instalator:
+
+1. W systemie operacyjnym otwórz okno terminala: Windows Terminal, terminal macOS lub to, czego zwykle używasz.
+2. Uruchom poniższe polecenie, aby potwierdzić, że masz zainstalowany co najmniej Node.js 22 lub nowszy:
+
+    ```shell
+    node --version
+    ```
+
+3. Jeśli widzisz `v22` lub wyższy numer, możesz przejść do następnej sekcji!
+
+> [!TIP]
+> Te kroki wykonaj tylko wtedy, gdy nie masz zainstalowanego Node albo potrzebujesz aktualizacji.
+
+4. Otwórz [stronę pobierania Node.js][node-download].
+5. Pobierz wersję **LTS** dla swojego systemu operacyjnego.
+6. Uruchom instalator i zaakceptuj domyślne ustawienia. W Windows pozostaw zaznaczoną opcję **Add to PATH**.
+7. Po instalacji otwórz nowe okno terminala.
+8. Potwierdź instalację w nowym oknie terminala, uruchamiając:
+
+    ```bash
+    node --version
+    ```
+
+9. Powinieneś zobaczyć `v22.x.x` lub wyższą wersję.
+
+> [!TIP]
+> Wolisz kontenery? Jeśli masz zainstalowanego **[Dockera][docker]**, możesz użyć [kontenera deweloperskiego][dev-containers] z repozytorium zamiast instalować Node.js lokalnie. W takim wypadku, nie instaluj go na lokalnym systemie operacyjnym.
+
+## Skonfiguruj repozytorium
+
+Warsztaty będą prowadzone na własnej kopii projektu Tailspin Toys. Utwórz ją teraz za pomocą [repozytorium szablonu][template-repository]. Nowe repozytorium zawiera wszystkie pliki potrzebne w tych warsztatach — w następnej lekcji podłączysz je do aplikacji.
+
+1. W nowym oknie przeglądarki przejdź do repozytorium tych warsztatów na GitHubie: `https://github.com/github-samples/tailspin-toys`.
+2. Utwórz własną kopię repozytorium, wybierając przycisk **Use this template** na stronie repozytorium. Następnie wybierz **Create a new repository**.
+
+    ![Przycisk Use this template z wybraną z listy rozwijanej opcją Create a new repository](../../_images/app-0-use-template.png)
+
+3. Jeśli uczestniczysz w warsztacie w ramach wydarzenia prowadzonego przez GitHuba lub Microsoft, postępuj zgodnie z instrukcjami mentorów. W przeciwnym razie możesz utworzyć nowe repozytorium w organizacji, w której masz dostęp do GitHub Copilot.
+
+    ![Formularz Create a new repository z github-samples/tailspin-toys wybranym jako szablon i wypełnioną nazwą repozytorium](../../_images/app-0-create-repository.png)
+
+4. Zanotuj ścieżkę utworzonego repozytorium (**organization-or-user-name/repository-name**) — będziesz się do niej odwoływać później w trakcie zadań.
+
+> [!NOTE]
+> Gdy tworzysz repozytorium z szablonu, backlog zgłoszeń (issues) GitHub jest tworzony automatycznie. Będziesz pracować na tych zgłoszeniach przez cały warsztat — nie musisz nic zgłaszać samodzielnie.
+
+## Podsumowanie i kolejne kroki
+
+Jesteś gotowy! Zainstalowałeś Node.js, aby projekt mógł się budować i być testowany na Twojej maszynie, oraz utworzyłeś własną kopię repozytorium Tailspin Toys.
+
+W następnym kroku zainstalujesz aplikację GitHub Copilot, podłączysz właśnie utworzone repozytorium i zapoznasz się z interfejsem aplikacji. Przejdź do [Lekcji 1 - Instalacja aplikacji GitHub Copilot][next-lesson].
+
+## Zasoby
+
+- [Pobierz Node.js][node-download]
+- [Tworzenie repozytorium z szablonu][template-repository]
+- [O aplikacji GitHub Copilot][about-copilot-app]
+
+[next-lesson]: ../1-install-copilot-app/
+[nodejs]: https://nodejs.org/
+[node-download]: https://nodejs.org/en/download
+[docker]: https://www.docker.com/products/docker-desktop/
+[dev-containers]: https://code.visualstudio.com/docs/devcontainers/containers
+[template-repository]: https://docs.github.com/repositories/creating-and-managing-repositories/creating-a-template-repository
+[about-copilot-app]: https://docs.github.com/copilot/concepts/agents/github-copilot-app
diff --git a/docs/pl-pl/app/1-install-copilot-app.md b/docs/pl-pl/app/1-install-copilot-app.md
@@ -0,0 +1,101 @@
+---
+title: "Lekcja 1 - Instalacja aplikacji GitHub Copilot"
+description: "Zainstaluj aplikację GitHub Copilot, podłącz właśnie utworzone repozytorium, zapoznaj się z obszarem roboczym i wypróbuj szybki czat."
+authors:
+  - geektrainer
+  - azkel
+lastUpdated: 2026-09-09
+---
+
+**[Aplikacja GitHub Copilot][about-copilot-app]** to aplikacja desktopowa pozwalająca budować oprogramowanie za pomocą agentów. Jest zbudowana na bazie GitHub Copilot CLI i integruje się natywnie z GitHubem, więc repozytoria, gałęzie i potoki CI działają od samego początku. Jest zaprojektowana pod przepływy, w których kierujesz kilkoma agentami równolegle, każdy we własnym izolowanym obszarze roboczym — zamiast robić całą pracę samodzielnie oraz pod automatyzację powtarzalnych zadań. Jeżeli Node.js jest już zainstalowany, a kopia projektu gotowa, kolejnym krokiem jest instalacja aplikacji i podłączenie tego repozytorium.
+
+Podczas tej lekcji:
+
+- zainstalujesz aplikację GitHub Copilot i zalogujesz się do niej.
+- dodasz projekt do aplikacji wykorzystując swoje repozytorium na GitHubie.
+- zapoznasz się z obszarem roboczym, w tym z backlogiem, który szablon dla Ciebie przygotował.
+- wypróbujesz szybki czat, aby dowiedzieć się więcej o samej aplikacji.
+
+## Scenariusz
+
+Twój zespół wdraża agentów AI, aby przerabiać rosnący backlog. Aplikacja Copilot gwarantuje centralne miejsce do kierowania tą pracą — podejmowanie zgłoszeń (issues), uruchamianie agentów, przeglądanie zmian i scalanie pull requestów. W ramach tej lekcji zainstalujesz aplikację, podłączysz się i swobodnie rozpoczniesz rozmowę o projekcie z agentami.
+
+> [!NOTE]
+> Wymagany jest odpowiedni plan Copilot — Copilot Student lub dowolny płatny plan (Pro, Pro+, Business lub Enterprise). Jeśli korzystasz z Copilot Business lub Copilot Enterprise, administrator musi włączyć dostęp do **Copilot CLI**, zanim będziesz w stanie poprawnie skorzystać z aplikacji.
+
+## Zainstaluj i skonfiguruj aplikację GitHub Copilot
+
+Aby korzystać z aplikacji GitHub Copilot, pierwszym krokiem — jak można się spodziewać — jest jej instalacja. Dostępne są wersje dla Windows, macOS i Linux. Zainstalujmy aplikację, uwierzytelnijmy się i dodajmy nasze repozytorium Tailspin Toys.
+
+1. W przeglądarce otwórz [stronę startową aplikacji GitHub Copilot][download-app].
+2. Pobierz aplikację dla swojej platformy i zainstaluj ją zgodnie z instrukcjami na stronie startowej.
+3. Otwórz aplikację po instalacji.
+4. Wybierz **Sign in to GitHub** i postępuj zgodnie z instrukcjami, aby się uwierzytelnić. Jeśli używasz GitHub Enterprise Server, wybierz **Use GitHub Enterprise** i wprowadź adres serwera, gdy zostaniesz o to poproszony.
+5. Po uwierzytelnieniu zostaniesz zapytany o podłączenie repozytoriów. Wybierz właśnie utworzone repozytorium Tailspin Toys, które powinno mieć nazwę `<YOUR_GITHUB_HANDLE>/tailspin-toys`.
+6. Wybierz **Continue**, aby kontynuować wprowadzenie.
+7. Gdy zostaniesz poproszony o motyw, wybierz ten, który najbardziej Ci odpowiada, a następnie wciśnij **Finish**.
+
+> [!NOTE]
+> Jeśli Twoja kopia Tailspin Toys nie pojawiła się na liście automatycznie, możesz dodać ją po zakończeniu procesu konfiguracji aplikacji. Po zakończeniu aplikacja Copilot przeniesie Cię na ekran główny. Stamtąd możesz wybrać **Choose from GitHub**, wyszukać repozytorium po nazwie (\<YOUR_GITHUB_HANDLE\>/tailspin-toys), a następnie je wybrać. Repozytorium zostanie dodane do aplikacji Copilot!
+
+## Zapoznaj się z obszarem roboczym
+
+Gdy projekt jest już pobrany, poświęć chwilę na rozpoznanie, co jest gdzie w wyświetlanym interfejsie. Aplikacja dzieli wszystko na kilka obszarów na pasku bocznym:
+
+- **Sessions** — miejsce, w którym agenci wykonują pracę. Każda sesja działa we własnym izolowanym obszarze roboczym, więc możesz uruchomić kilka sesji naraz bez kolizji zmian. Pierwszą sesję rozpoczniesz w następnej lekcji.
+- **Quick chats** — lekkie rozmowy do pytań i burzy mózgów, które nie potrzebują własnej gałęzi ani obszaru roboczego. Wypróbujesz jedną na końcu tej lekcji.
+- **My work** — Twoje zgłoszenia i pull requesty, udostępnione dzięki **natywnej integracji z GitHubem**. Stąd możesz przeglądać i filtrować zgłoszenia oraz pull requesty, sprawdzać status CI, uruchamiać sesję ze zgłoszenia i przeglądać pull requesty — bez opuszczania aplikacji.
+- **Automations** — zapisane zadania agenta uruchamiane według harmonogramu lub na żądanie. Jedną utworzysz pod koniec warsztatu.
+
+### Znajdź przygotowany backlog
+
+Ponieważ aplikacja integruje się natywnie z GitHubem, praca czekająca w repozytorium pojawia się bezpośrednio w aplikacji. Gdy utworzyłeś repozytorium, backlog zgłoszeń został dla Ciebie złożony — potwierdźmy, że tam jest.
+
+1. Wybierz **My work** na pasku bocznym.
+2. Szablon przygotował osiem zgłoszeń w backlogu. To środowisko skupia się na poniższych trzech — potwierdź, że je widzisz:
+
+   - Allow users to filter games by category and publisher
+   - Update our repository coding standards
+   - Implement pagination on the game list page
+
+3. Wybierz zgłoszenie, aby przeczytać szczegóły. Każde zgłoszenie jest też punktem startowym sesji agenta — rozpoczniesz pracę z tych zgłoszeń później w trakcie zadań.
+
+> [!NOTE]
+> Lista elementów w My work jest automatycznie filtrowana, aby pokazywać tylko elementy z repozytoriów dodanych do aplikacji Copilot. Chcesz zobaczyć elementy pracy z innych repozytoriów? Dodaj je do aplikacji!
+
+## Wypróbuj szybki czat
+
+Dobry sposób, by oswoić się z aplikacją, to użyć jej do nauki o *samej aplikacji* — a **szybki czat** jest do tego idealnym narzędziem. Szybkie czaty pozwalają zadać pytanie lub zrobić burzę mózgów bez tworzenia gałęzi ani worktree, więc są doskonałe do szybkiego, jednorazowego pytania — bez sesji.
+
+1. Na pasku bocznym wybierz **+** obok **Quick chats**, aby otworzyć nowy czat.
+2. Zapytaj aplikację, jak działają jej własne sesje:
+
+   ```plaintext
+   How does the GitHub Copilot app use worktrees?
+   ```
+
+3. Przeczytaj odpowiedź w widoku rozmowy. Zobaczysz, że każda sesja działa we własnym izolowanym git worktree — to właśnie pozwala uruchamiać kilku agentów równolegle bez kolizji zmian. Możesz kontynuować rozmowę lub w dowolnym momencie rozpocząć nowy czat.
+
+## Podsumowanie i kolejne kroki
+
+Gratulacje! Zainstalowałeś aplikację GitHub Copilot, podłączyłeś projekt i zbadałeś obszar roboczy. Nauczyłeś się:
+
+- instalować aplikację i logować się do GitHuba.
+- dodawać projekt z jego repozytorium na GitHubie.
+- jak używać interfejsu i znajdować przygotowany backlog w **My work**.
+- używać szybkiego czatu do szybkiego, jednorazowego pytania.
+
+W następnym kroku rozpoczniesz pierwszą sesję agenta i wprowadzisz pierwszą zmianę w projekcie — wyświetlenie oceny za pomocą gwiazdek na kartach gier. Przejdź do [Lekcji 2 - Uruchomienie pierwszej sesji agenta][next-lesson].
+
+## Zasoby
+
+- [O aplikacji GitHub Copilot][about-copilot-app]
+- [Pierwsze kroki z aplikacją GitHub Copilot][getting-started]
+- [Praca z sesjami agenta w aplikacji GitHub Copilot][agent-sessions]
+
+[ex0]: ../0-prerequisites/
+[next-lesson]: ../2-add-star-rating/
+[about-copilot-app]: https://docs.github.com/copilot/concepts/agents/github-copilot-app
+[getting-started]: https://docs.github.com/copilot/how-tos/github-copilot-app/getting-started
+[agent-sessions]: https://docs.github.com/copilot/how-tos/github-copilot-app/agent-sessions
+[download-app]: https://gh.io/app