cc-viewer 1.6.182 → 1.6.183

package/concepts/pl/Tool-TaskUpdate.md

@@ -1,123 +1,70 @@
 # TaskUpdate
 
-## Definicja
+Modyfikuje istniejące zadanie — jego status, treść, własność, metadane lub krawędzie zależności. To sposób, w jaki zadania postępują przez swój cykl życia i w jaki praca jest przekazywana między Claude Code, współpracownikami i podagentami.
 
-Aktualizuje status, zawartość lub zależności zadania na liście zadań.
+## Kiedy używać
+
+- Przechodzenie zadania przez przepływ statusów podczas pracy nad nim.
+- Roszczenie zadania przez przypisanie siebie (lub innego agenta) jako `owner`.
+- Dopracowywanie `subject` lub `description` po dowiedzeniu się więcej o problemie.
+- Zapisywanie nowo odkrytych zależności za pomocą `addBlocks` / `addBlockedBy`.
+- Dołączanie ustrukturyzowanych `metadata`, takich jak zewnętrzne ID ticketów lub wskazówki priorytetowe.
 
 ## Parametry
 
-| Parametr | Typ | Wymagany | Opis |
-|------|------|------|------|
-| `taskId` | string | Tak | ID zadania do aktualizacji |
-| `status` | enum | Nie | Nowy status: `pending` / `in_progress` / `completed` / `deleted` |
-| `subject` | string | Nie | Nowy tytuł |
-| `description` | string | Nie | Nowy opis |
-| `activeForm` | string | Nie | Tekst w czasie teraźniejszym ciągłym wyświetlany podczas wykonywania |
-| `owner` | string | Nie | Nowy odpowiedzialny za zadanie (nazwa agenta) |
-| `metadata` | object | Nie | Metadane do scalenia (ustawienie na null usuwa klucz) |
-| `addBlocks` | string[] | Nie | Lista ID zadań zablokowanych przez to zadanie |
-| `addBlockedBy` | string[] | Nie | Lista ID zadań poprzedzających, które blokują to zadanie |
+- `taskId` (string, wymagany): Zadanie do zmodyfikowania. Uzyskaj z `TaskList` lub `TaskCreate`.
+- `status` (string, opcjonalny): Jeden z `pending`, `in_progress`, `completed`, `deleted`.
+- `subject` (string, opcjonalny): Zastępczy tytuł w trybie rozkazującym.
+- `description` (string, opcjonalny): Zastępczy szczegółowy opis.
+- `activeForm` (string, opcjonalny): Zastępczy tekst wskaźnika w czasie ciągłym teraźniejszym.
+- `owner` (string, opcjonalny): Uchwyt agenta lub współpracownika biorącego odpowiedzialność za zadanie.
+- `metadata` (obiekt, opcjonalny): Klucze metadanych do scalenia z zadaniem. Ustaw klucz na `null`, aby go usunąć.
+- `addBlocks` (tablica stringów, opcjonalny): ID zadań, które to zadanie blokuje.
+- `addBlockedBy` (tablica stringów, opcjonalny): ID zadań, które muszą ukończyć się przed tym.
 
 ## Przepływ statusów
 
-```
-pending → in_progress → completed
-```
-
-`deleted` może być ustawiony z dowolnego statusu, trwale usuwa zadanie.
-
-## Scenariusze użycia
-
-**Odpowiednie zastosowanie:**
-- Oznaczanie zadania jako `in_progress` przy rozpoczęciu pracy
-- Oznaczanie zadania jako `completed` po zakończeniu pracy
-- Ustawianie zależności między zadaniami
-- Aktualizacja zawartości zadania przy zmianie wymagań
-
-**Ważne zasady:**
-- Oznaczaj jako `completed` tylko po pełnym ukończeniu zadania
-- W przypadku błędów lub blokad zachowaj status `in_progress`
-- Nie oznaczaj jako `completed` gdy testy nie przechodzą, implementacja jest niepełna lub wystąpiły nierozwiązane błędy
-
-## Uwagi
-
-- Przed aktualizacją należy pobrać najnowszy stan zadania przez TaskGet, aby uniknąć przestarzałych danych
-- Po ukończeniu zadania wywołaj TaskList, aby znaleźć następne dostępne zadanie
-
-## Tekst oryginalny
-
-<textarea readonly>Use this tool to update a task in the task list.
-
-## When to Use This Tool
+Cykl życia jest celowo liniowy: `pending` → `in_progress` → `completed`. `deleted` jest terminalny i używany do wycofywania zadań, nad którymi nigdy nie będzie pracy.
 
-**Mark tasks as resolved:**
-- When you have completed the work described in a task
-- When a task is no longer needed or has been superseded
-- IMPORTANT: Always mark your assigned tasks as resolved when you finish them
-- After resolving, call TaskList to find your next task
+- Ustaw `in_progress` w momencie, gdy faktycznie rozpoczynasz pracę, nie wcześniej. Tylko jedno zadanie naraz powinno być `in_progress` dla danego właściciela.
+- Ustaw `completed` tylko wtedy, gdy praca jest całkowicie ukończona — kryteria akceptacji spełnione, testy przechodzą, wyjście zapisane. Jeśli pojawi się bloker, utrzymuj zadanie w `in_progress` i dodaj nowe zadanie opisujące, co musi zostać rozwiązane.
+- Nigdy nie oznaczaj zadania jako `completed`, gdy testy się nie powodzą, implementacja jest częściowa lub napotkałeś nierozwiązane błędy.
+- Używaj `deleted` dla zadań anulowanych lub zduplikowanych; nie przekształcaj zadania w niepowiązaną pracę.
 
-- ONLY mark a task as completed when you have FULLY accomplished it
-- If you encounter errors, blockers, or cannot finish, keep the task as in_progress
-- When blocked, create a new task describing what needs to be resolved
-- Never mark a task as completed if:
-  - Tests are failing
-  - Implementation is partial
-  - You encountered unresolved errors
-  - You couldn't find necessary files or dependencies
+## Przykłady
 
-**Delete tasks:**
-- When a task is no longer relevant or was created in error
-- Setting status to `deleted` permanently removes the task
+### Przykład 1
 
-**Update task details:**
-- When requirements change or become clearer
-- When establishing dependencies between tasks
+Zrosz zadanie i rozpocznij je.
 
-## Fields You Can Update
-
-- **status**: The task status (see Status Workflow below)
-- **subject**: Change the task title (imperative form, e.g., "Run tests")
-- **description**: Change the task description
-- **activeForm**: Present continuous form shown in spinner when in_progress (e.g., "Running tests")
-- **owner**: Change the task owner (agent name)
-- **metadata**: Merge metadata keys into the task (set a key to null to delete it)
-- **addBlocks**: Mark tasks that cannot start until this one completes
-- **addBlockedBy**: Mark tasks that must complete before this one can start
-
-## Status Workflow
-
-Status progresses: `pending` → `in_progress` → `completed`
-
-Use `deleted` to permanently remove a task.
-
-## Staleness
-
-Make sure to read a task's latest state using `TaskGet` before updating it.
+```
+TaskUpdate(
+  taskId: "t_01HXYZ...",
+  status: "in_progress",
+  owner: "main-agent"
+)
+```
 
-## Examples
+### Przykład 2
 
-Mark task as in progress when starting work:
-```json
-{"taskId": "1", "status": "in_progress"}
-```
+Zakończ pracę i zapisz zależność kolejnego kroku.
 
-Mark task as completed after finishing work:
-```json
-{"taskId": "1", "status": "completed"}
 ```
-
-Delete a task:
-```json
-{"taskId": "1", "status": "deleted"}
+TaskUpdate(
+  taskId: "t_01HXYZ...",
+  status: "completed"
+)
+
+TaskUpdate(
+  taskId: "t_01FOLLOWUP...",
+  addBlockedBy: ["t_01HXYZ..."]
+)
 ```
 
-Claim a task by setting owner:
-```json
-{"taskId": "1", "owner": "my-name"}
-```
+## Uwagi
 
-Set up task dependencies:
-```json
-{"taskId": "2", "addBlockedBy": ["1"]}
-```
-</textarea>
+- `metadata` scalają się klucz po kluczu; przekazanie `null` dla klucza go usuwa. Najpierw wywołaj `TaskGet`, jeśli nie jesteś pewien bieżącej zawartości.
+- `addBlocks` i `addBlockedBy` dopisują krawędzie; nie usuwają istniejących. Destrukcyjna edycja grafu wymaga dedykowanego przepływu pracy — skonsultuj się z właścicielem zespołu przed przepisaniem zależności.
+- Utrzymuj `activeForm` zsynchronizowany, gdy zmieniasz `subject`, aby tekst wskaźnika brzmiał nadal naturalnie.
+- Nie oznaczaj zadania jako `completed`, aby je wyciszyć. Jeśli użytkownik anulował pracę, użyj `deleted` z krótkim uzasadnieniem w `description`.
+- Odczytaj najnowszy stan zadania przez `TaskGet` przed aktualizacją — współpracownicy mogli go zmienić między Twoim ostatnim odczytem a zapisem.

package/concepts/pl/Tool-TeamCreate.md

@@ -1,38 +1,53 @@
 # TeamCreate
 
-## Definicja
+Ustanawia nowy zespół współpracy ze współdzieloną listą zadań i kanałem komunikacji między agentami. Zespół to prymityw koordynacyjny dla pracy wieloagentowej — główna sesja działa jako lider i tworzy nazwanych współpracowników za pomocą narzędzia `Agent`.
 
-Tworzy nowy zespół do koordynacji wielu agentów pracujących nad projektem. Zespoły umożliwiają równoległe wykonywanie zadań poprzez wspólną listę zadań i wymianę wiadomości między agentami.
+## Kiedy używać
+
+- Użytkownik wyraźnie prosi o zespół, rój, załogę lub współpracę wieloagentową.
+- Projekt ma kilka wyraźnie niezależnych strumieni pracy, które korzystają z dedykowanych specjalistów (np. frontend, backend, testy, dokumentacja).
+- Potrzebujesz trwałej wspólnej listy zadań, którą wielu agentów aktualizuje w miarę postępów.
+- Chcesz nazwanych, adresowalnych współpracowników, którzy mogą wymieniać wiadomości przez `SendMessage`, a nie jednorazowych wywołań podagentów.
+
+NIE używaj dla pojedynczego delegowanego wyszukiwania ani jednorazowego równoległego rozrzutu — zwykłe wywołania `Agent` są lżejsze i wystarczające.
 
 ## Parametry
 
-| Parametr | Typ | Wymagany | Opis |
-|----------|-----|----------|------|
-| `team_name` | string | Tak | Nazwa nowego zespołu |
-| `description` | string | Nie | Opis / cel zespołu |
-| `agent_type` | string | Nie | Typ / rola lidera zespołu |
+- `team_name` (string, wymagany): Unikalny identyfikator zespołu. Używany jako nazwa katalogu pod `~/.claude/teams/` oraz jako argument `team_name` przy tworzeniu współpracowników.
+- `description` (string, wymagany): Krótkie zdanie o celu zespołu. Wyświetlane każdemu współpracownikowi przy tworzeniu i zapisywane w konfiguracji zespołu.
+- `agent_type` (string, opcjonalny): Domyślna persona podagenta stosowana do współpracowników, którzy jej nie nadpisują. Typowe wartości to `general-purpose`, `Explore` lub `Plan`.
+
+## Przykłady
+
+### Przykład 1: Utwórz zespół refaktoringu
 
-## Co zostaje utworzone
+```
+TeamCreate(
+  team_name="refactor-crew",
+  description="Refactor the data access layer from raw SQL to Prisma, including migrations and tests.",
+  agent_type="general-purpose"
+)
+```
 
-- **Plik konfiguracyjny zespołu**: `~/.claude/teams/{team-name}/config.json` — przechowuje listę członków i metadane
-- **Katalog listy zadań**: `~/.claude/tasks/{team-name}/` — wspólna lista zadań dla wszystkich członków zespołu
+Po utworzeniu twórz współpracowników za pomocą `Agent` z `team_name: "refactor-crew"` oraz odrębnymi wartościami `name`, takimi jak `db-lead`, `migrations` i `tests`.
 
-Zespoły mają relację 1:1 z listami zadań.
+### Przykład 2: Utwórz zespół dochodzeniowy
 
-## Przepływ pracy zespołu
+```
+TeamCreate(
+  team_name="perf-investigation",
+  description="Identify and rank the top three performance regressions introduced in the last release.",
+  agent_type="Explore"
+)
+```
 
-1. **TeamCreate** — utwórz zespół i jego listę zadań
-2. **TaskCreate** — zdefiniuj zadania dla zespołu
-3. **Agent** (z `team_name` + `name`) — uruchom członków zespołu dołączających do zespołu
-4. **TaskUpdate** — przypisz zadania do członków przez `owner`
-5. Członkowie pracują nad zadaniami i komunikują się przez **SendMessage**
-6. Zamknij członków po zakończeniu, następnie **TeamDelete** dla porządku
+Każdy utworzony współpracownik dziedziczy `Explore` jako swoją domyślną personę, co odpowiada naturze pracy dochodzeniowej tylko do odczytu.
 
-## Powiązane narzędzia
+## Uwagi
 
-| Narzędzie | Przeznaczenie |
-|-----------|---------------|
-| `TeamDelete` | Usuń zespół i katalogi zadań |
-| `SendMessage` | Komunikacja między agentami w zespole |
-| `TaskCreate` / `TaskUpdate` / `TaskList` / `TaskGet` | Zarządzanie wspólną listą zadań |
-| `Agent` | Uruchom członków zespołu dołączających do zespołu |
+- Tylko jeden zespół może być prowadzony naraz z danej sesji. Zakończ lub usuń bieżący zespół przed utworzeniem innego.
+- Zespół odpowiada 1:1 współdzielonej liście zadań. Lider jest właścicielem tworzenia, przypisywania i zamykania zadań; współpracownicy aktualizują status zadań, nad którymi pracują.
+- Konfiguracja zespołu jest zapisywana w `~/.claude/teams/{team_name}/config.json`, a katalog zadań znajduje się obok niej. Te pliki przetrwają między sesjami, aż zostaną jawnie usunięte za pomocą `TeamDelete`.
+- Współpracownicy są tworzeni za pomocą narzędzia `Agent` z pasującym `team_name` oraz odrębnym `name`. `name` staje się adresem używanym przez `SendMessage`.
+- Wybierz `team_name` bezpieczny dla systemu plików (litery, cyfry, myślniki, podkreślenia). Unikaj spacji lub ukośników.
+- Napisz `description` tak, aby całkiem nowy współpracownik, czytając na zimno, zrozumiał cel zespołu bez dalszego kontekstu. Staje się ono częścią promptu startowego każdego współpracownika.

package/concepts/pl/Tool-TeamDelete.md

@@ -1,30 +1,44 @@
 # TeamDelete
 
-## Definicja
+Rozmontowuje obecnie aktywny zespół, usuwając jego katalog konfiguracji i współdzielony katalog zadań. Jest to odpowiednik czyszczący `TeamCreate`, zwykle wywoływany po osiągnięciu celu zespołu i wyłączeniu wszystkich współpracowników.
 
-Usuwa zespół i powiązane katalogi zadań po zakończeniu pracy w ramach współpracy wielu agentów. Jest to odpowiednik porządkujący dla TeamCreate.
+## Kiedy używać
 
-## Zachowanie
+- Zespół ukończył swoją pracę, a końcowy raport został dostarczony użytkownikowi.
+- Zespół został utworzony przez pomyłkę lub jego zakres zmienił się tak drastycznie, że zaczynanie od nowa jest czystsze niż kontynuowanie.
+- Musisz utworzyć nowy zespół, ale jeden jest już aktywny — najpierw usuń stary, ponieważ tylko jeden zespół może być prowadzony naraz.
+- Zespół zestarzał się między sesjami, a jego trwały stan pod `~/.claude/teams/` nie jest już potrzebny.
 
-- Usuwa katalog zespołu: `~/.claude/teams/{team-name}/`
-- Usuwa katalog listy zadań: `~/.claude/tasks/{team-name}/`
-- Czyści kontekst zespołu z bieżącej sesji
+NIE wywołuj, gdy współpracownicy nadal działają — najpierw ich wyłącz za pomocą `SendMessage` z `shutdown_request`, poczekaj na każdy `shutdown_response`, a potem usuń.
 
-**Ważne**: TeamDelete zakończy się błędem, jeśli zespół nadal ma aktywnych członków. Członkowie zespołu muszą najpierw zostać poprawnie zamknięci za pomocą żądań shutdown wysyłanych przez SendMessage.
+## Parametry
 
-## Typowe użycie
+`TeamDelete` nie przyjmuje parametrów w typowym wywołaniu. Działa na obecnie aktywnym zespole należącym do wywołującej sesji.
 
-TeamDelete jest wywoływany na końcu przepływu pracy zespołu:
+## Przykłady
 
-1. Wszystkie zadania są ukończone
-2. Członkowie zespołu są zamykani przez `SendMessage` z `shutdown_request`
-3. **TeamDelete** usuwa katalogi zespołu i zadań
+### Przykład 1: Rutynowe wyłączenie po sukcesie
 
-## Powiązane narzędzia
+1. Rozgłoś prośbę o wyłączenie do zespołu:
+   ```
+   SendMessage(to="*", message={ "type": "shutdown_request" })
+   ```
+2. Poczekaj, aż każdy współpracownik odpowie `shutdown_response`.
+3. Wywołaj `TeamDelete()`, aby usunąć katalog zespołu i katalog zadań.
 
-| Narzędzie | Przeznaczenie |
-|-----------|---------------|
-| `TeamCreate` | Utwórz nowy zespół i jego listę zadań |
-| `SendMessage` | Komunikacja z członkami zespołu / wysyłanie żądań shutdown |
-| `TaskCreate` / `TaskUpdate` / `TaskList` / `TaskGet` | Zarządzanie wspólną listą zadań |
-| `Agent` | Uruchom członków zespołu dołączających do zespołu |
+### Przykład 2: Zastąpienie błędnie skonfigurowanego zespołu
+
+Jeśli `TeamCreate` został wywołany z niewłaściwym `agent_type` lub `description`, najpierw upewnij się, że żaden współpracownik nie został jeszcze utworzony (lub wyłącz ich), a następnie:
+
+```
+TeamDelete()
+TeamCreate(team_name="...", description="...", agent_type="...")
+```
+
+## Uwagi
+
+- `TeamDelete` zawodzi, jeśli jakiś współpracownik jest nadal aktywny. Odpowiedź błędu wymienia żyjących współpracowników — wyślij każdemu z nich `shutdown_request` przez `SendMessage`, zaczekaj na ich `shutdown_response` i spróbuj ponownie.
+- Usunięcie jest nieodwracalne z perspektywy narzędzia. Konfiguracja zespołu w `~/.claude/teams/{team_name}/config.json` oraz jego katalog zadań są usuwane z dysku. Jeśli potrzebujesz zachować listę zadań, wyeksportuj lub skopiuj katalog przed usunięciem.
+- Tylko sesja lidera, która utworzyła zespół, może go usunąć. Utworzony współpracownik nie może wywołać `TeamDelete` na swoim zespole.
+- Usunięcie zespołu nie cofa żadnych zmian systemu plików, które współpracownicy wprowadzili w repozytorium. Są to zwykłe edycje śledzone przez git i muszą być cofnięte osobno, jeśli nie są pożądane.
+- Po pomyślnym powrocie `TeamDelete` sesja może ponownie wywołać `TeamCreate` dla nowego zespołu.

package/concepts/pl/Tool-WebFetch.md

@@ -1,55 +1,50 @@
 # WebFetch
 
-## Definicja
+Pobiera zawartość publicznej strony internetowej, konwertuje HTML na Markdown i uruchamia mały model pomocniczy na wyniku, używając prompta w języku naturalnym, aby wyciągnąć potrzebne informacje.
 
-Pobiera zawartość strony internetowej pod podanym URL, konwertuje HTML na markdown i przetwarza zawartość za pomocą modelu AI zgodnie z promptem.
+## Kiedy używać
+
+- Odczytywanie publicznej strony dokumentacji, wpisu na blogu lub RFC przywołanego w rozmowie.
+- Wyciąganie konkretnego faktu, fragmentu kodu lub tabeli z znanego URL bez ładowania całej strony do kontekstu.
+- Podsumowywanie notatek wydań lub changelogów z otwartego zasobu webowego.
+- Sprawdzanie publicznego odniesienia API biblioteki, gdy źródło nie jest w lokalnym repozytorium.
+- Śledzenie linku, który użytkownik wkleił do czatu, aby odpowiedzieć na pytanie uzupełniające.
 
 ## Parametry
 
-| Parametr | Typ | Wymagany | Opis |
-|------|------|------|------|
-| `url` | string (URI) | Tak | Pełny URL do pobrania |
-| `prompt` | string | Tak | Opis informacji do wyodrębnienia ze strony |
+- `url` (string, wymagany): W pełni uformowany bezwzględny URL. Zwykły `http://` jest automatycznie uaktualniany do `https://`.
+- `prompt` (string, wymagany): Instrukcja przekazywana do małego modelu ekstrakcyjnego. Opisz dokładnie, co wyciągnąć ze strony, np. "list all exported functions" lub "return the minimum supported Node version".
+
+## Przykłady
+
+### Przykład 1: Wyciągnij domyślną wartość konfiguracji
+
+```
+WebFetch(
+  url="https://vitejs.dev/config/server-options.html",
+  prompt="What is the default value of server.port and can it be a string?"
+)
+```
+
+Narzędzie pobiera stronę dokumentacji Vite, konwertuje ją na Markdown i zwraca krótką odpowiedź, np. "Default is `5173`; accepts a number only."
 
-## Scenariusze użycia
+### Przykład 2: Podsumuj sekcję changelogu
 
-**Odpowiednie zastosowanie:**
-- Pobieranie zawartości publicznych stron internetowych
-- Przeglądanie dokumentacji online
-- Wyodrębnianie określonych informacji ze stron internetowych
+```
+WebFetch(
+  url="https://nodejs.org/en/blog/release/v20.11.0",
+  prompt="List the security fixes included in this release as bullet points."
+)
+```
 
-**Nieodpowiednie zastosowanie:**
-- URL wymagające uwierzytelnienia (Google Docs, Confluence, Jira, GitHub itp.) — należy najpierw poszukać dedykowanego narzędzia MCP
-- URL GitHub — preferuj użycie `gh` CLI
+Przydatne, gdy użytkownik pyta "co zmieniło się w Node 20.11", a strona wydania jest długa.
 
 ## Uwagi
 
-- URL musi być pełnym, prawidłowym URL
-- HTTP jest automatycznie aktualizowane do HTTPS
-- Zbyt duża zawartość może zostać podsumowana
-- Zawiera 15-minutowy samoczyszczący się cache
-- Gdy URL przekierowuje na inny host, narzędzie zwraca URL przekierowania — należy ponowić żądanie z nowym URL
-- Jeśli dostępne jest narzędzie web fetch dostarczane przez MCP, preferuj jego użycie
-
-## Tekst oryginalny
-
-<textarea readonly>IMPORTANT: WebFetch WILL FAIL for authenticated or private URLs. Before using this tool, check if the URL points to an authenticated service (e.g. Google Docs, Confluence, Jira, GitHub). If so, you MUST use ToolSearch first to find a specialized tool that provides authenticated access.
-
-- Fetches content from a specified URL and processes it using an AI model
-- Takes a URL and a prompt as input
-- Fetches the URL content, converts HTML to markdown
-- Processes the content with the prompt using a small, fast model
-- Returns the model's response about the content
-- Use this tool when you need to retrieve and analyze web content
-
-Usage notes:
-  - IMPORTANT: If an MCP-provided web fetch tool is available, prefer using that tool instead of this one, as it may have fewer restrictions.
-  - The URL must be a fully-formed valid URL
-  - HTTP URLs will be automatically upgraded to HTTPS
-  - The prompt should describe what information you want to extract from the page
-  - This tool is read-only and does not modify any files
-  - Results may be summarized if the content is very large
-  - Includes a self-cleaning 15-minute cache for faster responses when repeatedly accessing the same URL
-  - When a URL redirects to a different host, the tool will inform you and provide the redirect URL in a special format. You should then make a new WebFetch request with the redirect URL to fetch the content.
-  - For GitHub URLs, prefer using the gh CLI via Bash instead (e.g., gh pr view, gh issue view, gh api).
-</textarea>
+- `WebFetch` zawodzi przy każdym URL wymagającym uwierzytelnienia, ciasteczek lub VPN. Dla Google Docs, Confluence, Jira, prywatnych zasobów GitHub lub wewnętrznych wiki użyj dedykowanego serwera MCP, który zapewnia uwierzytelniony dostęp.
+- Dla czegokolwiek hostowanego na GitHubie (PR, problemy, bloby plików, odpowiedzi API) preferuj CLI `gh` przez `Bash` zamiast scrape'owania UI webowego. `gh pr view`, `gh issue view` i `gh api` zwracają ustrukturyzowane dane i działają na prywatnych repozytoriach.
+- Wyniki mogą być podsumowane, gdy pobrana strona jest bardzo duża. Jeśli potrzebujesz dokładnego tekstu, zawęź `prompt`, aby poprosić o dosłowny fragment.
+- Stosowany jest samoczyszczący się cache na 15 minut na URL. Powtarzające się wywołania tej samej strony podczas jednej sesji są niemal natychmiastowe, ale mogą zwracać nieco przestarzałą zawartość. Jeśli świeżość ma znaczenie, wspomnij o tym w prompcie lub odczekaj cache.
+- Jeśli host docelowy wydaje przekierowanie między hostami, narzędzie zwraca nowy URL w specjalnym bloku odpowiedzi i nie podąża za nim automatycznie. Wywołaj ponownie `WebFetch` z celem przekierowania, jeśli nadal chcesz zawartości.
+- Prompt jest wykonywany przez mniejszy, szybszy model niż główny asystent. Utrzymuj go wąski i konkretny; złożone wieloetapowe rozumowanie lepiej obsłużyć, czytając samodzielnie surowy Markdown po pobraniu.
+- Nigdy nie przekazuj sekretów, tokenów ani identyfikatorów sesji osadzonych w URL — zawartość stron i query stringi odzwierciedlone w wyjściu mogą być logowane przez usługi upstream.

package/concepts/pl/Tool-WebSearch.md

@@ -1,58 +1,51 @@
 # WebSearch
 
-## Definicja
+Wykonuje wyszukiwanie internetowe na żywo i zwraca posortowane wyniki, których asystent używa do osadzenia swojej odpowiedzi w bieżących informacjach poza granicą wiedzy modelu.
 
-Wykonuje zapytanie do wyszukiwarki, zwracając wyniki wyszukiwania w celu uzyskania aktualnych informacji.
+## Kiedy używać
+
+- Odpowiadanie na pytania o bieżące wydarzenia, ostatnie wydania lub najświeższe wiadomości.
+- Szukanie najnowszej wersji biblioteki, frameworka lub narzędzia CLI.
+- Znajdowanie dokumentacji lub wpisów na blogu, gdy dokładny URL jest nieznany.
+- Weryfikowanie faktu, który mógł się zmienić od czasu trenowania modelu.
+- Odkrywanie wielu perspektyw na temat przed pobraniem pojedynczej strony za pomocą `WebFetch`.
 
 ## Parametry
 
-| Parametr | Typ | Wymagany | Opis |
-|------|------|------|------|
-| `query` | string | Tak | Zapytanie wyszukiwania (minimum 2 znaki) |
-| `allowed_domains` | string[] | Nie | Uwzględnij tylko wyniki z tych domen |
-| `blocked_domains` | string[] | Nie | Wyklucz wyniki z tych domen |
+- `query` (string, wymagany): Zapytanie wyszukiwania. Minimalna długość 2 znaki. Dołącz bieżący rok, gdy pytasz o "najnowsze" lub "ostatnie" informacje, aby wyniki były świeże.
+- `allowed_domains` (tablica stringów, opcjonalny): Ogranicza wyniki tylko do tych domen, na przykład `["nodejs.org", "developer.mozilla.org"]`. Przydatne, gdy ufasz konkretnemu źródłu.
+- `blocked_domains` (tablica stringów, opcjonalny): Wyklucza wyniki z tych domen. Nie przekazuj tej samej domeny do `allowed_domains` i `blocked_domains`.
+
+## Przykłady
+
+### Przykład 1: Wyszukanie wersji z bieżącym rokiem
+
+```
+WebSearch(
+  query="React 19 stable release date 2026",
+  allowed_domains=["react.dev", "github.com"]
+)
+```
+
+Zwraca oficjalne ogłoszenia i unika słabej jakości agregatorów.
+
+### Przykład 2: Wyklucz hałaśliwe źródła
 
-## Scenariusze użycia
+```
+WebSearch(
+  query="kubernetes ingress-nginx CVE April 2026",
+  blocked_domains=["pinterest.com", "medium.com"]
+)
+```
 
-**Odpowiednie zastosowanie:**
-- Uzyskiwanie najnowszych informacji wykraczających poza datę odcięcia wiedzy modelu
-- Wyszukiwanie bieżących wydarzeń i najnowszych danych
-- Wyszukiwanie najnowszej dokumentacji technicznej
+Utrzymuje wyniki skoncentrowane na poradach producentów i trackerach bezpieczeństwa.
 
 ## Uwagi
 
-- Wyniki wyszukiwania są zwracane w formacie hiperłączy markdown
-- Po użyciu należy dołączyć sekcję "Sources:" na końcu odpowiedzi z listą odpowiednich URL
-- Obsługuje filtrowanie domen (uwzględnianie/wykluczanie)
-- W zapytaniach wyszukiwania należy używać bieżącego roku
-- Dostępne tylko w USA
-
-## Tekst oryginalny
-
-<textarea readonly>
-- Allows Claude to search the web and use the results to inform responses
-- Provides up-to-date information for current events and recent data
-- Returns search result information formatted as search result blocks, including links as markdown hyperlinks
-- Use this tool for accessing information beyond Claude's knowledge cutoff
-- Searches are performed automatically within a single API call
-
-CRITICAL REQUIREMENT - You MUST follow this:
-  - After answering the user's question, you MUST include a "Sources:" section at the end of your response
-  - In the Sources section, list all relevant URLs from the search results as markdown hyperlinks: [Title](URL)
-  - This is MANDATORY - never skip including sources in your response
-  - Example format:
-
-    [Your answer here]
-
-    Sources:
-    - [Source Title 1](https://example.com/1)
-    - [Source Title 2](https://example.com/2)
-
-Usage notes:
-  - Domain filtering is supported to include or block specific websites
-  - Web search is only available in the US
-
-IMPORTANT - Use the correct year in search queries:
-  - The current month is March 2026. You MUST use this year when searching for recent information, documentation, or current events.
-  - Example: If the user asks for "latest React docs", search for "React documentation" with the current year, NOT last year
-</textarea>
+- Gdy używasz `WebSearch` w odpowiedzi, musisz dołączyć sekcję `Sources:` na końcu odpowiedzi, wymieniającą każdy cytowany wynik jako hiperłącze Markdown w formie `[Title](URL)`. To wymaganie twarde, nie opcjonalne.
+- `WebSearch` jest dostępny tylko dla użytkowników w Stanach Zjednoczonych. Jeśli narzędzie jest niedostępne w Twoim regionie, użyj `WebFetch` względem znanego URL lub poproś użytkownika, aby wkleił odpowiednią zawartość.
+- Każde wywołanie wykonuje wyszukiwanie w pojedynczym round-tripie — nie możesz strumieniować ani paginować. Popraw zapytanie, jeśli pierwszy zbiór wyników jest nietrafny.
+- Narzędzie zwraca fragmenty i metadane, a nie pełne zawartości stron. Aby przeczytać konkretny wynik dokładnie, kontynuuj z `WebFetch` używając zwróconego URL.
+- Używaj `allowed_domains`, aby wymusić autorytatywne źródła dla pytań wrażliwych na bezpieczeństwo, takich jak CVE lub zgodność, oraz `blocked_domains`, aby odciąć farmy SEO, które kopiują dokumentację.
+- Utrzymuj zapytania krótkie i oparte na słowach kluczowych. Pytania w języku naturalnym działają, ale mają tendencję do zwracania konwersacyjnych odpowiedzi, a nie źródeł pierwotnych.
+- Nie wymyślaj URL-i na podstawie intuicji wyszukiwania — zawsze uruchom wyszukiwanie i cytuj to, co narzędzie faktycznie zwróciło.

package/concepts/pl/Tool-Write.md

@@ -1,39 +1,35 @@
 # Write
 
-## Definicja
+Tworzy nowy plik lub całkowicie zastępuje zawartość istniejącego w lokalnym systemie plików. Ponieważ zastępuje wszystko w ścieżce docelowej, powinno być zarezerwowane dla prawdziwego tworzenia lub celowych pełnych przepisań.
 
-Zapisuje zawartość do lokalnego systemu plików. Jeśli plik już istnieje, nadpisuje go.
+## Kiedy używać
 
-## Parametry
+- Tworzenie całkowicie nowego pliku źródłowego, testu lub konfiguracji, który jeszcze nie istnieje
+- Generowanie świeżej fixtury, snapshotu lub pliku danych od zera
+- Wykonywanie pełnego przepisania, gdy przyrostowy `Edit` byłby bardziej skomplikowany niż zaczęcie od nowa
+- Emitowanie żądanego artefaktu, takiego jak schemat, migracja lub skrypt kompilacji, który użytkownik wyraźnie poprosił o wyprodukowanie
 
-| Parametr | Typ | Wymagany | Opis |
-|------|------|------|------|
-| `file_path` | string | Tak | Bezwzględna ścieżka do pliku (musi być bezwzględna) |
-| `content` | string | Tak | Zawartość do zapisania |
+## Parametry
 
-## Scenariusze użycia
+- `file_path` (string, wymagany): Bezwzględna ścieżka pliku do zapisu. Wszystkie katalogi nadrzędne muszą już istnieć.
+- `content` (string, wymagany): Pełny tekst do zapisania w pliku. Staje się całą treścią pliku.
 
-**Odpowiednie zastosowanie:**
-- Tworzenie nowych plików
-- Gdy wymagane jest całkowite przepisanie zawartości pliku
+## Przykłady
 
-**Nieodpowiednie zastosowanie:**
-- Modyfikacja lokalnej zawartości pliku — należy użyć Edit
-- Nie należy proaktywnie tworzyć plików dokumentacji (*.md) ani README, chyba że użytkownik wyraźnie o to prosi
+### Przykład 1: Utwórz nowy moduł pomocniczy
+Wywołaj `Write` z `file_path: "/Users/me/app/src/utils/slugify.ts"` i podaj implementację jako `content`. Używaj tego tylko po zweryfikowaniu, że plik jeszcze nie istnieje.
 
-## Uwagi
+### Przykład 2: Ponownie wygeneruj pochodny artefakt
+Po zmianie źródła schematu przepisz `/Users/me/app/generated/schema.json` w jednym wywołaniu `Write`, używając świeżo wygenerowanego JSON-a jako `content`.
 
-- Jeśli plik docelowy już istnieje, należy go najpierw odczytać za pomocą Read, w przeciwnym razie operacja się nie powiedzie
-- Nadpisuje całą zawartość istniejącego pliku
-- Preferuj Edit do edycji istniejących plików, Write służy tylko do tworzenia nowych plików lub całkowitego przepisywania
+### Przykład 3: Zastąp mały plik fixtury
+Dla jednorazowej fixtury testowej, gdzie zmienia się każdy wiersz, `Write` może być jaśniejszy niż sekwencja wywołań `Edit`. Najpierw odczytaj plik, potwierdź zakres, a następnie nadpisz.
 
-## Tekst oryginalny
-
-<textarea readonly>Writes a file to the local filesystem.
+## Uwagi
 
-Usage:
-- This tool will overwrite the existing file if there is one at the provided path.
-- If this is an existing file, you MUST use the Read tool first to read the file's contents. This tool will fail if you did not read the file first.
-- Prefer the Edit tool for modifying existing files — it only sends the diff. Only use this tool to create new files or for complete rewrites.
-- NEVER create documentation files (*.md) or README files unless explicitly requested by the User.
-- Only use emojis if the user explicitly requests it. Avoid writing emojis to files unless asked.</textarea>
+- Przed nadpisaniem istniejącego pliku musisz wywołać `Read` na nim w bieżącej sesji. `Write` odmawia nadpisania niewidzianej zawartości.
+- Preferuj `Edit` dla każdej zmiany, która dotyka tylko części pliku. `Edit` wysyła tylko diff, co jest szybsze, bezpieczniejsze i łatwiejsze do przeglądu.
+- Nie twórz proaktywnie dokumentacji Markdown, plików `README.md` ani plików changelog, chyba że użytkownik wyraźnie o to poprosi.
+- Nie dodawaj emoji, tekstów marketingowych ani dekoracyjnych banerów, chyba że użytkownik prosi o taki styl.
+- Najpierw zweryfikuj, czy katalog nadrzędny istnieje, wywołaniem `ls` przez `Bash`; `Write` nie tworzy pośrednich folderów.
+- Dostarczaj zawartość dokładnie tak, jak chcesz, aby została utrwalona; nie ma szablonów ani przetwarzania końcowego.