cc-viewer 1.6.182 → 1.6.183

package/concepts/de/Tool-TaskUpdate.md

@@ -1,123 +1,70 @@
 # TaskUpdate
 
-## Definition
+Ändert eine bestehende Aufgabe – ihren Status, Inhalt, Besitz, Metadaten oder Abhängigkeitskanten. So durchlaufen Aufgaben ihren Lebenszyklus und so wird Arbeit zwischen Claude Code, Teammitgliedern und Subagenten übergeben.
 
-Aktualisiert den Status, Inhalt oder die Abhängigkeiten einer Aufgabe in der Aufgabenliste.
+## Wann verwenden
+
+- Eine Aufgabe während der Bearbeitung durch den Status-Workflow führen.
+- Eine Aufgabe beanspruchen, indem Sie sich selbst (oder einen anderen Agenten) als `owner` zuweisen.
+- Das `subject` oder `description` verfeinern, sobald Sie mehr über das Problem erfahren.
+- Neu entdeckte Abhängigkeiten mit `addBlocks` / `addBlockedBy` erfassen.
+- Strukturierte `metadata` anhängen, wie externe Ticket-IDs oder Prioritätshinweise.
 
 ## Parameter
 
-| Parameter | Typ | Erforderlich | Beschreibung |
-|-----------|-----|--------------|--------------|
-| `taskId` | string | Ja | Die zu aktualisierende Aufgaben-ID |
-| `status` | enum | Nein | Neuer Status: `pending` / `in_progress` / `completed` / `deleted` |
-| `subject` | string | Nein | Neuer Titel |
-| `description` | string | Nein | Neue Beschreibung |
-| `activeForm` | string | Nein | Text in Verlaufsform, der während der Bearbeitung angezeigt wird |
-| `owner` | string | Nein | Neuer Aufgabenverantwortlicher (Agent-Name) |
-| `metadata` | object | Nein | Zu mergende Metadaten (auf null setzen zum Löschen eines Schlüssels) |
-| `addBlocks` | string[] | Nein | Liste der Aufgaben-IDs, die von dieser Aufgabe blockiert werden |
-| `addBlockedBy` | string[] | Nein | Liste der Voraussetzungsaufgaben-IDs, die diese Aufgabe blockieren |
+- `taskId` (string, erforderlich): Die zu ändernde Aufgabe. Aus `TaskList` oder `TaskCreate` beziehen.
+- `status` (string, optional): Einer von `pending`, `in_progress`, `completed`, `deleted`.
+- `subject` (string, optional): Ersatz-Imperativ-Titel.
+- `description` (string, optional): Ersatz für die ausführliche Beschreibung.
+- `activeForm` (string, optional): Ersatz-Verlaufsform-Spinnertext.
+- `owner` (string, optional): Agent- oder Teammitglied-Handle, das die Verantwortung für die Aufgabe übernimmt.
+- `metadata` (object, optional): In die Aufgabe einzumischende Metadaten-Schlüssel. Einen Schlüssel auf `null` setzen, um ihn zu löschen.
+- `addBlocks` (array of strings, optional): Aufgaben-IDs, die diese Aufgabe blockiert.
+- `addBlockedBy` (array of strings, optional): Aufgaben-IDs, die vor dieser abgeschlossen sein müssen.
 
 ## Status-Workflow
 
-```
-pending → in_progress → completed
-```
-
-`deleted` kann von jedem Status aus gesetzt werden und entfernt die Aufgabe dauerhaft.
-
-## Anwendungsfälle
-
-**Geeignet für:**
-- Aufgabe bei Arbeitsbeginn als `in_progress` markieren
-- Aufgabe nach Abschluss als `completed` markieren
-- Abhängigkeiten zwischen Aufgaben festlegen
-- Aufgabeninhalt bei Anforderungsänderungen aktualisieren
-
-**Wichtige Regeln:**
-- Nur als `completed` markieren, wenn die Aufgabe vollständig abgeschlossen ist
-- Bei Fehlern oder Blockaden den Status `in_progress` beibehalten
-- Nicht als `completed` markieren bei: fehlgeschlagenen Tests, unvollständiger Implementierung, ungelösten Fehlern
-
-## Hinweise
-
-- Vor der Aktualisierung den aktuellen Status über TaskGet abrufen, um veraltete Daten zu vermeiden
-- Nach Abschluss einer Aufgabe TaskList aufrufen, um die nächste verfügbare Aufgabe zu finden
-
-## Originaltext
-
-<textarea readonly>Use this tool to update a task in the task list.
-
-## When to Use This Tool
+Der Lebenszyklus ist bewusst linear: `pending` → `in_progress` → `completed`. `deleted` ist terminal und wird verwendet, um Aufgaben zurückzuziehen, an denen nie gearbeitet wird.
 
-**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
+- Setzen Sie `in_progress` genau in dem Moment, in dem Sie tatsächlich mit der Arbeit beginnen, nicht vorher. Es sollte immer nur eine Aufgabe pro Besitzer `in_progress` sein.
+- Setzen Sie `completed` nur, wenn die Arbeit vollständig erledigt ist – Akzeptanzkriterien erfüllt, Tests bestehen, Ausgabe geschrieben. Tritt ein Blocker auf, lassen Sie die Aufgabe `in_progress` und legen Sie eine neue Aufgabe an, die beschreibt, was gelöst werden muss.
+- Markieren Sie eine Aufgabe niemals als `completed`, wenn Tests fehlschlagen, die Implementierung unvollständig ist oder Sie auf ungelöste Fehler stoßen.
+- Verwenden Sie `deleted` für Aufgaben, die storniert werden oder Duplikate sind; nutzen Sie eine Aufgabe nicht für unbeteiligte Arbeit um.
 
-- 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
+## Beispiele
 
-**Delete tasks:**
-- When a task is no longer relevant or was created in error
-- Setting status to `deleted` permanently removes the task
+### Beispiel 1
 
-**Update task details:**
-- When requirements change or become clearer
-- When establishing dependencies between tasks
+Eine Aufgabe beanspruchen und starten.
 
-## 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
+### Beispiel 2
 
-Mark task as in progress when starting work:
-```json
-{"taskId": "1", "status": "in_progress"}
-```
+Die Arbeit abschließen und eine Folgeabhängigkeit erfassen.
 
-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"}
-```
+## Hinweise
 
-Set up task dependencies:
-```json
-{"taskId": "2", "addBlockedBy": ["1"]}
-```
-</textarea>
+- `metadata` wird schlüsselweise zusammengeführt; die Übergabe von `null` für einen Schlüssel entfernt ihn. Rufen Sie zuerst `TaskGet` auf, wenn Sie sich über den aktuellen Inhalt unsicher sind.
+- `addBlocks` und `addBlockedBy` hängen Kanten an; sie entfernen keine bestehenden. Ein destruktives Bearbeiten des Graphen erfordert einen eigenen Workflow – konsultieren Sie den Team-Besitzer, bevor Sie Abhängigkeiten umschreiben.
+- Halten Sie `activeForm` synchron, wenn Sie `subject` ändern, damit der Spinner-Text weiterhin natürlich liest.
+- Markieren Sie eine Aufgabe nicht als `completed`, um sie zum Schweigen zu bringen. Hat der Benutzer die Arbeit storniert, verwenden Sie `deleted` mit einer kurzen Begründung in `description`.
+- Lesen Sie vor dem Aktualisieren den neuesten Zustand einer Aufgabe mit `TaskGet` – Teammitglieder könnten sie zwischen Ihrem letzten Lesen und Schreiben geändert haben.

package/concepts/de/Tool-TeamCreate.md

@@ -1,38 +1,53 @@
 # TeamCreate
 
-## Definition
+Etabliert ein neues Kollaborationsteam mit einer gemeinsamen Aufgabenliste und einem Messaging-Kanal zwischen Agenten. Ein Team ist das Koordinationsprimitive für Multi-Agenten-Arbeit – die Hauptsitzung fungiert als Leiter und startet namentlich benannte Teammitglieder über das `Agent`-Tool.
 
-Erstellt ein neues Team zur Koordination mehrerer Agenten, die an einem Projekt arbeiten. Teams ermöglichen parallele Aufgabenausführung über eine gemeinsame Aufgabenliste und agentenübergreifende Kommunikation.
+## Wann verwenden
+
+- Der Benutzer fordert ausdrücklich ein Team, einen Schwarm, eine Crew oder eine Multi-Agenten-Zusammenarbeit an.
+- Ein Projekt hat mehrere klar unabhängige Arbeitsstränge, die von dedizierten Spezialisten profitieren (z. B. Frontend, Backend, Tests, Docs).
+- Sie benötigen eine persistente gemeinsame Aufgabenliste, die mehrere Agenten im Laufe der Arbeit aktualisieren.
+- Sie möchten benannte, adressierbare Teammitglieder, die Nachrichten über `SendMessage` austauschen können, statt einmaliger Subagenten-Aufrufe.
+
+NICHT verwenden für eine einzelne delegierte Suche oder ein einmaliges paralleles Fan-out – einfache `Agent`-Aufrufe sind leichter und ausreichend.
 
 ## Parameter
 
-| Parameter | Typ | Erforderlich | Beschreibung |
-|-----------|-----|--------------|--------------|
-| `team_name` | string | Ja | Name des neuen Teams |
-| `description` | string | Nein | Team-Beschreibung / Zweck |
-| `agent_type` | string | Nein | Typ / Rolle des Team-Leiters |
+- `team_name` (string, erforderlich): Eindeutige Kennung für das Team. Verwendet als Verzeichnisname unter `~/.claude/teams/` und als `team_name`-Argument beim Starten von Teammitgliedern.
+- `description` (string, erforderlich): Kurze Beschreibung des Teamziels. Wird jedem Teammitglied beim Start gezeigt und in die Team-Konfiguration geschrieben.
+- `agent_type` (string, optional): Standard-Subagenten-Persona, angewendet auf Teammitglieder, die sie nicht überschreiben. Typische Werte sind `general-purpose`, `Explore` oder `Plan`.
+
+## Beispiele
+
+### Beispiel 1: Ein Refactor-Team erstellen
 
-## Was erstellt wird
+```
+TeamCreate(
+  team_name="refactor-crew",
+  description="Refactor the data access layer from raw SQL to Prisma, including migrations and tests.",
+  agent_type="general-purpose"
+)
+```
 
-- **Team-Konfigurationsdatei**: `~/.claude/teams/{team-name}/config.json` — speichert Mitgliederliste und Metadaten
-- **Aufgabenlisten-Verzeichnis**: `~/.claude/tasks/{team-name}/` — gemeinsame Aufgabenliste für alle Teammitglieder
+Nach der Erstellung Teammitglieder mit `Agent` unter Verwendung von `team_name: "refactor-crew"` und verschiedenen `name`-Werten wie `db-lead`, `migrations` und `tests` starten.
 
-Teams stehen in einem 1:1-Verhältnis zu Aufgabenlisten.
+### Beispiel 2: Ein Ermittlungsteam erstellen
 
-## Team-Workflow
+```
+TeamCreate(
+  team_name="perf-investigation",
+  description="Identify and rank the top three performance regressions introduced in the last release.",
+  agent_type="Explore"
+)
+```
 
-1. **TeamCreate** — Team und zugehörige Aufgabenliste erstellen
-2. **TaskCreate** — Aufgaben für das Team definieren
-3. **Agent** (mit `team_name` + `name`) — Teammitglieder starten, die dem Team beitreten
-4. **TaskUpdate** — Aufgaben über `owner` an Teammitglieder zuweisen
-5. Teammitglieder bearbeiten Aufgaben und kommunizieren über **SendMessage**
-6. Teammitglieder beenden, dann **TeamDelete** zur Bereinigung
+Jedes gestartete Teammitglied erbt `Explore` als Standard-Persona, was zum schreibgeschützten ermittelnden Charakter der Arbeit passt.
 
-## Verwandte Tools
+## Hinweise
 
-| Tool | Zweck |
-|------|-------|
-| `TeamDelete` | Team und Aufgabenverzeichnisse entfernen |
-| `SendMessage` | Kommunikation zwischen Agenten innerhalb des Teams |
-| `TaskCreate` / `TaskUpdate` / `TaskList` / `TaskGet` | Gemeinsame Aufgabenliste verwalten |
-| `Agent` | Teammitglieder starten, die dem Team beitreten |
+- Aus einer gegebenen Sitzung kann jeweils nur ein Team geführt werden. Beenden oder löschen Sie das aktuelle Team, bevor Sie ein weiteres erstellen.
+- Ein Team ist 1:1 mit einer gemeinsamen Aufgabenliste. Der Leiter besitzt das Erstellen, Zuweisen und Abschließen von Aufgaben; Teammitglieder aktualisieren den Status der Aufgaben, an denen sie arbeiten.
+- Team-Konfiguration wird unter `~/.claude/teams/{team_name}/config.json` persistiert, und das Aufgabenverzeichnis liegt daneben. Diese Dateien überleben Sitzungen, bis sie ausdrücklich mit `TeamDelete` entfernt werden.
+- Teammitglieder werden mit dem `Agent`-Tool unter passendem `team_name` plus distinktem `name` gestartet. Der `name` wird zur Adresse, die von `SendMessage` verwendet wird.
+- Wählen Sie einen `team_name`, der dateisystemsicher ist (Buchstaben, Ziffern, Bindestriche, Unterstriche). Vermeiden Sie Leerzeichen oder Schrägstriche.
+- Schreiben Sie die `description` so, dass ein brandneues Teammitglied, das sie kalt liest, das Ziel des Teams ohne weiteren Kontext verstehen würde. Sie wird Teil des Startup-Prompts jedes Teammitglieds.

package/concepts/de/Tool-TeamDelete.md

@@ -1,30 +1,44 @@
 # TeamDelete
 
-## Definition
+Baut das derzeit aktive Team ab und entfernt sein Konfigurationsverzeichnis und gemeinsames Aufgabenverzeichnis. Dies ist das Aufräum-Gegenstück zu `TeamCreate` und wird typischerweise aufgerufen, nachdem das Ziel des Teams erreicht wurde und alle Teammitglieder heruntergefahren sind.
 
-Entfernt ein Team und die zugehörigen Aufgabenverzeichnisse, wenn die Multi-Agent-Kollaborationsarbeit abgeschlossen ist. Dies ist das Bereinigungs-Gegenstück zu TeamCreate.
+## Wann verwenden
 
-## Verhalten
+- Das Team hat seine Arbeit abgeschlossen und der Schlussbericht wurde an den Benutzer geliefert.
+- Das Team wurde fälschlicherweise erstellt oder sein Umfang hat sich so drastisch geändert, dass ein Neustart sauberer ist als fortzufahren.
+- Sie müssen ein neues Team erstellen, aber eines ist bereits aktiv – löschen Sie zuerst das alte, da immer nur ein Team geführt werden kann.
+- Ein Team ist über Sitzungen hinweg veraltet und sein persistierter Zustand unter `~/.claude/teams/` wird nicht mehr benötigt.
 
-- Entfernt das Team-Verzeichnis: `~/.claude/teams/{team-name}/`
-- Entfernt das Aufgabenverzeichnis: `~/.claude/tasks/{team-name}/`
-- Löscht den Team-Kontext aus der aktuellen Sitzung
+NICHT aufrufen, solange Teammitglieder noch laufen – fahren Sie diese zuerst über `SendMessage` mit einem `shutdown_request` herunter, warten Sie auf jedes `shutdown_response` und löschen Sie dann.
 
-**Wichtig**: TeamDelete schlägt fehl, wenn das Team noch aktive Mitglieder hat. Teammitglieder müssen zuvor über SendMessage-Shutdown-Anfragen ordnungsgemäß beendet werden.
+## Parameter
 
-## Typische Verwendung
+`TeamDelete` nimmt in seiner typischen Invocation keine Parameter entgegen. Es operiert auf dem derzeit aktiven Team, das von der aufrufenden Sitzung besessen wird.
 
-TeamDelete wird am Ende eines Team-Workflows aufgerufen:
+## Beispiele
 
-1. Alle Aufgaben sind abgeschlossen
-2. Teammitglieder werden über `SendMessage` mit `shutdown_request` beendet
-3. **TeamDelete** entfernt Team- und Aufgabenverzeichnisse
+### Beispiel 1: Routine-Shutdown nach Erfolg
 
-## Verwandte Tools
+1. Eine Shutdown-Anfrage an das Team rundsenden:
+   ```
+   SendMessage(to="*", message={ "type": "shutdown_request" })
+   ```
+2. Warten, bis jedes Teammitglied mit einem `shutdown_response` antwortet.
+3. `TeamDelete()` aufrufen, um das Team-Verzeichnis und das Aufgabenverzeichnis zu entfernen.
 
-| Tool | Zweck |
-|------|-------|
-| `TeamCreate` | Neues Team und zugehörige Aufgabenliste erstellen |
-| `SendMessage` | Kommunikation mit Teammitgliedern / Shutdown-Anfragen senden |
-| `TaskCreate` / `TaskUpdate` / `TaskList` / `TaskGet` | Gemeinsame Aufgabenliste verwalten |
-| `Agent` | Teammitglieder starten, die dem Team beitreten |
+### Beispiel 2: Ein fehlkonfiguriertes Team ersetzen
+
+Wenn `TeamCreate` mit falschem `agent_type` oder `description` aufgerufen wurde, zuerst sicherstellen, dass noch keine Teammitglieder gestartet wurden (oder diese herunterfahren), dann:
+
+```
+TeamDelete()
+TeamCreate(team_name="...", description="...", agent_type="...")
+```
+
+## Hinweise
+
+- `TeamDelete` schlägt fehl, wenn noch Teammitglieder aktiv sind. Die Fehlerantwort listet die lebenden Teammitglieder auf – senden Sie jedem einen `shutdown_request` über `SendMessage`, warten Sie auf deren `shutdown_response` und versuchen Sie es erneut.
+- Das Löschen ist aus Sicht des Tools unumkehrbar. Die Team-Konfiguration unter `~/.claude/teams/{team_name}/config.json` und deren Aufgabenverzeichnis werden von der Festplatte entfernt. Wenn Sie die Aufgabenliste bewahren möchten, exportieren oder kopieren Sie das Verzeichnis vor dem Löschen.
+- Nur die Leiter-Sitzung, die das Team erstellt hat, kann es löschen. Ein gestartetes Teammitglied kann `TeamDelete` nicht auf sein eigenes Team anwenden.
+- Das Löschen des Teams macht keine Dateisystemänderungen rückgängig, die Teammitglieder im Repository vorgenommen haben. Dies sind gewöhnliche git-verfolgte Edits und müssen separat zurückgesetzt werden, falls unerwünscht.
+- Nach erfolgreichem Rückkehren von `TeamDelete` steht der Sitzung frei, `TeamCreate` erneut für ein neues Team aufzurufen.

package/concepts/de/Tool-WebFetch.md

@@ -1,55 +1,50 @@
 # WebFetch
 
-## Definition
+Ruft den Inhalt einer öffentlichen Webseite ab, konvertiert das HTML in Markdown und führt ein kleines Hilfsmodell mit einer Natürlichsprachlichen Aufforderung über das Ergebnis laufen, um die gewünschten Informationen zu extrahieren.
 
-Ruft den Inhalt einer angegebenen URL ab, konvertiert HTML in Markdown und verarbeitet den Inhalt mit einem KI-Modell basierend auf dem Prompt.
+## Wann verwenden
+
+- Lesen einer öffentlichen Dokumentationsseite, eines Blogposts oder eines RFCs, der in der Unterhaltung referenziert wird.
+- Extrahieren einer bestimmten Tatsache, eines Code-Snippets oder einer Tabelle aus einer bekannten URL, ohne die gesamte Seite in den Kontext zu laden.
+- Zusammenfassen von Release Notes oder Changelogs aus einer offenen Webressource.
+- Prüfen der öffentlichen API-Referenz einer Bibliothek, wenn die Quelle nicht im lokalen Repository vorhanden ist.
+- Einem vom Benutzer im Chat eingefügten Link folgen, um eine Folgefrage zu beantworten.
 
 ## Parameter
 
-| Parameter | Typ | Erforderlich | Beschreibung |
-|-----------|-----|--------------|--------------|
-| `url` | string (URI) | Ja | Die vollständige abzurufende URL |
-| `prompt` | string | Ja | Beschreibt, welche Informationen von der Seite extrahiert werden sollen |
+- `url` (string, erforderlich): Eine voll ausgeformte absolute URL. Einfaches `http://` wird automatisch auf `https://` aktualisiert.
+- `prompt` (string, erforderlich): Die Anweisung, die an das kleine Extraktionsmodell übergeben wird. Beschreiben Sie genau, was aus der Seite herausgezogen werden soll, z. B. "list all exported functions" oder "return the minimum supported Node version".
+
+## Beispiele
+
+### Beispiel 1: Einen Konfigurations-Standardwert extrahieren
+
+```
+WebFetch(
+  url="https://vitejs.dev/config/server-options.html",
+  prompt="What is the default value of server.port and can it be a string?"
+)
+```
+
+Das Tool holt die Vite-Dokumentationsseite, wandelt sie in Markdown um und gibt eine kurze Antwort zurück wie "Default is `5173`; accepts a number only."
 
-## Anwendungsfälle
+### Beispiel 2: Einen Changelog-Abschnitt zusammenfassen
 
-**Geeignet für:**
-- Inhalte öffentlicher Webseiten abrufen
-- Online-Dokumentation nachschlagen
-- Bestimmte Informationen aus Webseiten extrahieren
+```
+WebFetch(
+  url="https://nodejs.org/en/blog/release/v20.11.0",
+  prompt="List the security fixes included in this release as bullet points."
+)
+```
 
-**Nicht geeignet für:**
-- URLs, die Authentifizierung erfordern (Google Docs, Confluence, Jira, GitHub usw.) – zuerst nach einem dedizierten MCP-Tool suchen
-- GitHub-URLs – bevorzugt `gh` CLI verwenden
+Nützlich, wenn der Benutzer fragt "was hat sich in Node 20.11 geändert" und die Release-Seite lang ist.
 
 ## Hinweise
 
-- Die URL muss eine vollständige gültige URL sein
-- HTTP wird automatisch auf HTTPS hochgestuft
-- Bei sehr großen Inhalten können die Ergebnisse zusammengefasst werden
-- Enthält einen sich selbst bereinigenden 15-Minuten-Cache
-- Wenn die URL zu einem anderen Host weiterleitet, gibt das Tool die Weiterleitungs-URL zurück; eine erneute Anfrage mit der neuen URL ist erforderlich
-- Wenn ein MCP-bereitgestelltes Web-Fetch-Tool verfügbar ist, dieses bevorzugt verwenden
-
-## Originaltext
-
-<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` schlägt bei jeder URL fehl, die Authentifizierung, Cookies oder ein VPN erfordert. Für Google Docs, Confluence, Jira, private GitHub-Ressourcen oder interne Wikis verwenden Sie stattdessen einen dedizierten MCP-Server, der authentifizierten Zugriff bereitstellt.
+- Für alles, was auf GitHub gehostet wird (PRs, Issues, Datei-Blobs, API-Antworten), bevorzugen Sie die `gh`-CLI über `Bash` statt die Web-UI zu scrapen. `gh pr view`, `gh issue view` und `gh api` geben strukturierte Daten zurück und funktionieren gegen private Repositories.
+- Ergebnisse können zusammengefasst werden, wenn die abgerufene Seite sehr groß ist. Wenn Sie exakten Text benötigen, formulieren Sie den `prompt` enger, um einen wörtlichen Auszug anzufordern.
+- Ein selbstbereinigender 15-Minuten-Cache wird pro URL angewendet. Wiederholte Aufrufe derselben Seite innerhalb einer Sitzung sind nahezu sofort, können aber leicht veralteten Inhalt zurückgeben. Wenn Aktualität wichtig ist, erwähnen Sie das im Prompt oder warten Sie den Cache ab.
+- Gibt der Ziel-Host eine Cross-Host-Umleitung aus, gibt das Tool die neue URL in einem speziellen Antwortblock zurück und folgt ihr nicht automatisch. Rufen Sie `WebFetch` mit dem Umleitungsziel erneut auf, wenn Sie den Inhalt dennoch möchten.
+- Der Prompt wird von einem kleineren, schnelleren Modell als dem Hauptassistenten ausgeführt. Halten Sie ihn eng und konkret; komplexes mehrstufiges Reasoning wird besser erledigt, indem Sie das rohe Markdown nach dem Abruf selbst lesen.
+- Übergeben Sie niemals Geheimnisse, Tokens oder in der URL eingebettete Session-Bezeichner – Seiteninhalte und in der Ausgabe widergespiegelte Query-Strings können von vorgelagerten Diensten protokolliert werden.

package/concepts/de/Tool-WebSearch.md

@@ -1,58 +1,51 @@
 # WebSearch
 
-## Definition
+Führt eine Live-Websuche durch und gibt gerankte Ergebnisse zurück, mit denen der Assistent seine Antwort auf aktuelle Informationen jenseits des Trainings-Cutoffs des Modells stützt.
 
-Führt eine Suchmaschinenabfrage durch und gibt Suchergebnisse zurück, um aktuelle Informationen zu erhalten.
+## Wann verwenden
+
+- Beantworten von Fragen zu aktuellen Ereignissen, jüngsten Releases oder Breaking News.
+- Nachschlagen der neuesten Version einer Bibliothek, eines Frameworks oder CLI-Tools.
+- Finden von Dokumentation oder Blogposts, wenn die genaue URL unbekannt ist.
+- Verifizieren einer Tatsache, die sich seit dem Training des Modells geändert haben könnte.
+- Entdecken mehrerer Perspektiven zu einem Thema, bevor eine einzelne Seite mit `WebFetch` abgerufen wird.
 
 ## Parameter
 
-| Parameter | Typ | Erforderlich | Beschreibung |
-|-----------|-----|--------------|--------------|
-| `query` | string | Ja | Suchanfrage (mindestens 2 Zeichen) |
-| `allowed_domains` | string[] | Nein | Nur Ergebnisse von diesen Domains einschließen |
-| `blocked_domains` | string[] | Nein | Ergebnisse von diesen Domains ausschließen |
+- `query` (string, erforderlich): Die Suchanfrage. Mindestlänge 2 Zeichen. Fügen Sie das aktuelle Jahr hinzu, wenn Sie nach "aktuellen" oder "jüngsten" Informationen fragen, damit die Ergebnisse frisch sind.
+- `allowed_domains` (array of strings, optional): Beschränkt Ergebnisse auf nur diese Domains, zum Beispiel `["nodejs.org", "developer.mozilla.org"]`. Nützlich, wenn Sie einer bestimmten Quelle vertrauen.
+- `blocked_domains` (array of strings, optional): Schließt Ergebnisse von diesen Domains aus. Übergeben Sie dieselbe Domain nicht sowohl an `allowed_domains` als auch an `blocked_domains`.
+
+## Beispiele
+
+### Beispiel 1: Versions-Nachschlagen mit aktuellem Jahr
+
+```
+WebSearch(
+  query="React 19 stable release date 2026",
+  allowed_domains=["react.dev", "github.com"]
+)
+```
+
+Liefert offizielle Ankündigungen und vermeidet Low-Quality-Aggregator-Seiten.
+
+### Beispiel 2: Rauschige Quellen ausschließen
 
-## Anwendungsfälle
+```
+WebSearch(
+  query="kubernetes ingress-nginx CVE April 2026",
+  blocked_domains=["pinterest.com", "medium.com"]
+)
+```
 
-**Geeignet für:**
-- Aktuelle Informationen abrufen, die über den Wissensstand des Modells hinausgehen
-- Aktuelle Ereignisse und neueste Daten finden
-- Neueste technische Dokumentation suchen
+Hält die Ergebnisse auf Herstellerhinweise und Security-Tracker fokussiert.
 
 ## Hinweise
 
-- Suchergebnisse werden im Markdown-Hyperlink-Format zurückgegeben
-- Nach der Verwendung muss am Ende der Antwort ein "Sources:"-Abschnitt mit den relevanten URLs angefügt werden
-- Unterstützt Domain-Filterung (einschließen/ausschließen)
-- In Suchanfragen sollte das aktuelle Jahr verwendet werden
-- Nur in den USA verfügbar
-
-## Originaltext
-
-<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>
+- Wenn Sie `WebSearch` in einer Antwort verwenden, müssen Sie am Ende Ihrer Antwort einen `Sources:`-Abschnitt anhängen, der jedes zitierte Ergebnis als Markdown-Hyperlink der Form `[Title](URL)` auflistet. Das ist eine harte Voraussetzung, keine Option.
+- `WebSearch` ist nur für Benutzer in den Vereinigten Staaten verfügbar. Wenn das Tool in Ihrer Region nicht verfügbar ist, weichen Sie auf `WebFetch` gegen eine bekannte URL aus oder bitten Sie den Benutzer, relevanten Inhalt einzufügen.
+- Jeder Aufruf führt die Suche in einem einzigen Roundtrip aus – Sie können nicht streamen oder paginieren. Verfeinern Sie die Anfrage, wenn das erste Ergebnisset unpassend ist.
+- Das Tool gibt Snippets und Metadaten zurück, keine vollständigen Seiteninhalte. Um einen bestimmten Treffer tiefgehend zu lesen, folgen Sie mit `WebFetch` unter Verwendung der zurückgegebenen URL.
+- Verwenden Sie `allowed_domains`, um autoritative Quellen für sicherheitsrelevante Fragen wie CVEs oder Compliance durchzusetzen, und `blocked_domains`, um SEO-Farmen auszuschließen, die Dokumentation spiegeln.
+- Halten Sie Anfragen kurz und schlagwortgetrieben. Natürlichsprachliche Fragen funktionieren, neigen aber dazu, Konversationsantworten statt Primärquellen zurückzuliefern.
+- Erfinden Sie keine URLs aufgrund Suchintuition – führen Sie die Suche stets aus und zitieren Sie, was das Tool tatsächlich zurückgegeben hat.

package/concepts/de/Tool-Write.md

@@ -1,39 +1,35 @@
 # Write
 
-## Definition
+Erstellt eine neue Datei oder ersetzt den Inhalt einer bestehenden Datei im lokalen Dateisystem vollständig. Da es alles am Zielpfad ersetzt, sollte es für echte Neuerstellungen oder beabsichtigte vollständige Umschreibungen reserviert sein.
 
-Schreibt Inhalte in das lokale Dateisystem. Überschreibt die Datei, falls sie bereits existiert.
+## Wann verwenden
 
-## Parameter
+- Erstellen einer brandneuen Quelldatei, eines Tests oder einer Konfiguration, die noch nicht existiert
+- Erzeugen einer frischen Fixture, eines Snapshots oder einer Datendatei von Grund auf
+- Durchführen einer vollständigen Umschreibung, bei der ein inkrementelles `Edit` komplexer wäre als ein Neustart
+- Ausgeben eines angeforderten Artefakts wie eines Schemas, einer Migration oder eines Build-Skripts, das der Benutzer ausdrücklich zu erstellen angefordert hat
 
-| Parameter | Typ | Erforderlich | Beschreibung |
-|-----------|-----|--------------|--------------|
-| `file_path` | string | Ja | Absoluter Pfad der Datei (muss ein absoluter Pfad sein) |
-| `content` | string | Ja | Der zu schreibende Inhalt |
+## Parameter
 
-## Anwendungsfälle
+- `file_path` (string, erforderlich): Absoluter Pfad der zu schreibenden Datei. Alle übergeordneten Verzeichnisse müssen bereits existieren.
+- `content` (string, erforderlich): Der vollständige in die Datei zu schreibende Text. Dies wird der gesamte Dateiinhalt.
 
-**Geeignet für:**
-- Neue Dateien erstellen
-- Wenn der Dateiinhalt vollständig neu geschrieben werden muss
+## Beispiele
 
-**Nicht geeignet für:**
-- Teilinhalte einer Datei ändern – dafür Edit verwenden
-- Nicht proaktiv Dokumentationsdateien (*.md) oder READMEs erstellen, es sei denn, der Benutzer fordert es ausdrücklich an
+### Beispiel 1: Ein neues Hilfsmodul erstellen
+`Write` mit `file_path: "/Users/me/app/src/utils/slugify.ts"` aufrufen und die Implementierung als `content` übergeben. Dies nur nach Überprüfung verwenden, dass die Datei nicht bereits existiert.
 
-## Hinweise
+### Beispiel 2: Ein abgeleitetes Artefakt neu generieren
+Nachdem sich die Schema-Quelle ändert, `/Users/me/app/generated/schema.json` in einem einzigen `Write`-Aufruf mit dem frisch generierten JSON als `content` neu schreiben.
 
-- Wenn die Zieldatei bereits existiert, muss sie zuerst über Read gelesen werden, sonst schlägt der Vorgang fehl
-- Überschreibt den gesamten Inhalt einer vorhandenen Datei
-- Edit zum Bearbeiten vorhandener Dateien bevorzugen; Write nur für neue Dateien oder vollständige Neuschreibungen verwenden
+### Beispiel 3: Eine kleine Fixture-Datei ersetzen
+Für eine Wegwerf-Testfixture, bei der sich jede Zeile ändert, kann `Write` klarer sein als eine Folge von `Edit`-Aufrufen. Lesen Sie die Datei zuerst, bestätigen Sie den Umfang, und überschreiben Sie dann.
 
-## Originaltext
-
-<textarea readonly>Writes a file to the local filesystem.
+## Hinweise
 
-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>
+- Bevor Sie eine bestehende Datei überschreiben, müssen Sie `Read` auf sie in der aktuellen Sitzung aufrufen. `Write` verweigert das Überschreiben ungesehener Inhalte.
+- Bevorzugen Sie `Edit` für jede Änderung, die nur einen Teil einer Datei berührt. `Edit` sendet nur das Diff, was schneller, sicherer und leichter zu reviewen ist.
+- Erstellen Sie nicht proaktiv Markdown-Dokumentation, `README.md` oder Changelog-Dateien, sofern der Benutzer sie nicht ausdrücklich anfordert.
+- Fügen Sie keine Emojis, Marketing-Texte oder dekorativen Banner hinzu, sofern der Benutzer diesen Stil nicht anfordert.
+- Überprüfen Sie zuerst mit einem `Bash`-`ls`-Aufruf, dass das übergeordnete Verzeichnis existiert; `Write` erstellt keine Zwischenordner.
+- Liefern Sie den Inhalt genau so, wie Sie ihn persistiert haben möchten; es gibt kein Templating oder Post-Processing.