@the-bearded-bear/claude-craft 8.26.0 → 8.27.0

package/Dev/i18n/base/Common/commands/aliases.md

@@ -121,30 +121,30 @@ Add to `~/.bashrc` or `~/.zshrc`:
 
 ```bash
 # Claude Craft Aliases
-alias ci='claude-code -p /common:init'
-alias cr='claude-code -p /gate:check release'
-alias cs='claude-code -p /common:init --context'
-
-alias sc='claude-code -p /symfony:check-compliance'
-alias rc='claude-code -p /react:check-compliance'
-alias fc='claude-code -p /flutter:check-compliance'
-alias pc='claude-code -p /python:check-compliance'
-alias ac='claude-code -p /angular:check-compliance'
-alias vc='claude-code -p /vuejs:check-compliance'
-alias lc='claude-code -p /laravel:check-compliance'
-alias cc='claude-code -p /csharp:check-compliance'
-
-alias ta='claude-code -p /team:audit'
-alias ts='claude-code -p /team:sprint'
-alias td='claude-code -p /team:delivery'
-
-alias wi='claude-code -p /workflow:init'
-alias wp='claude-code -p /workflow:plan'
-
-alias qr='claude-code -p /qa:recette'
-alias qs='claude-code -p /qa:status'
-
-alias rr='claude-code -p /common:ralph-run'
+alias ci='claude -p /common:init'
+alias cr='claude -p /gate:check release'
+alias cs='claude -p /common:init --context'
+
+alias sc='claude -p /symfony:check-compliance'
+alias rc='claude -p /react:check-compliance'
+alias fc='claude -p /flutter:check-compliance'
+alias pc='claude -p /python:check-compliance'
+alias ac='claude -p /angular:check-compliance'
+alias vc='claude -p /vuejs:check-compliance'
+alias lc='claude -p /laravel:check-compliance'
+alias cc='claude -p /csharp:check-compliance'
+
+alias ta='claude -p /team:audit'
+alias ts='claude -p /team:sprint'
+alias td='claude -p /team:delivery'
+
+alias wi='claude -p /workflow:init'
+alias wp='claude -p /workflow:plan'
+
+alias qr='claude -p /qa:recette'
+alias qs='claude -p /qa:status'
+
+alias rr='claude -p /common:ralph-run'
 ```
 
 ### Fish Setup
@@ -153,30 +153,30 @@ Add to `~/.config/fish/config.fish`:
 
 ```fish
 # Claude Craft Aliases
-alias ci 'claude-code -p /common:init'
-alias cr 'claude-code -p /gate:check release'
-alias cs 'claude-code -p /common:init --context'
-
-alias sc 'claude-code -p /symfony:check-compliance'
-alias rc 'claude-code -p /react:check-compliance'
-alias fc 'claude-code -p /flutter:check-compliance'
-alias pc 'claude-code -p /python:check-compliance'
-alias ac 'claude-code -p /angular:check-compliance'
-alias vc 'claude-code -p /vuejs:check-compliance'
-alias lc 'claude-code -p /laravel:check-compliance'
-alias cc 'claude-code -p /csharp:check-compliance'
-
-alias ta 'claude-code -p /team:audit'
-alias ts 'claude-code -p /team:sprint'
-alias td 'claude-code -p /team:delivery'
-
-alias wi 'claude-code -p /workflow:init'
-alias wp 'claude-code -p /workflow:plan'
-
-alias qr 'claude-code -p /qa:recette'
-alias qs 'claude-code -p /qa:status'
-
-alias rr 'claude-code -p /common:ralph-run'
+alias ci 'claude -p /common:init'
+alias cr 'claude -p /gate:check release'
+alias cs 'claude -p /common:init --context'
+
+alias sc 'claude -p /symfony:check-compliance'
+alias rc 'claude -p /react:check-compliance'
+alias fc 'claude -p /flutter:check-compliance'
+alias pc 'claude -p /python:check-compliance'
+alias ac 'claude -p /angular:check-compliance'
+alias vc 'claude -p /vuejs:check-compliance'
+alias lc 'claude -p /laravel:check-compliance'
+alias cc 'claude -p /csharp:check-compliance'
+
+alias ta 'claude -p /team:audit'
+alias ts 'claude -p /team:sprint'
+alias td 'claude -p /team:delivery'
+
+alias wi 'claude -p /workflow:init'
+alias wp 'claude -p /workflow:plan'
+
+alias qr 'claude -p /qa:recette'
+alias qs 'claude -p /qa:status'
+
+alias rr 'claude -p /common:ralph-run'
 ```
 
 ## Mnemonic Logic

package/Dev/i18n/base/Common/skills/sub-agents-patterns/SKILL.md

@@ -1,6 +1,7 @@
 ---
 name: sub-agents-patterns
 description: Sub-agent patterns for parallel and complex tasks. Use when splitting work across Explore/Plan/general-purpose sub-agents or running independent investigations in parallel.
+context: fork
 allowed-tools:
   - Read
   - Glob

package/Dev/i18n/de/Common/agents/devops-engineer.md

@@ -7,20 +7,6 @@ maxTurns: 8
 tools: [Read, Glob, Grep, Edit, Write, Bash, WebFetch, WebSearch]
 permissionMode: default
 skills: [security, git-workflow]
-disallowedTools:
-  - "Bash(rm -rf:*)"
-  - "Bash(dd:*)"
-  - "Bash(mkfs:*)"
-  - "Bash(kubectl delete:*)"
-  - "Bash(helm uninstall:*)"
-  - "Bash(terraform destroy:*)"
-  - "Bash(tofu destroy:*)"
-  - "Bash(docker system prune -a*)"
-  - "Bash(docker volume rm:*)"
-  - "Bash(curl * | sh*)"
-  - "Bash(wget * | sh*)"
-  - "Bash(git push --force*)"
-  - "Bash(git push -f*)"
 ---
 
 # DevOps Engineer Agent
@@ -232,3 +218,22 @@ strategy:
 3. Health Checks konfigurieren
 4. Rollback vorbereiten
 5. Deployment überwachen
+
+## Schutz vor destruktiven Befehlen
+
+Ein Agent kann keinen einzelnen Befehl sperren: `disallowedTools: Bash(...)` entfernt Bash vollständig. Diese Befehle laufen daher über den Berechtigungs-Prompt — vor der Ausführung immer eine ausdrückliche Bestätigung einholen. Um sie in einem Projekt zu sperren, in dessen `.claude/settings.json` ergänzen (die Regeln gelten auch für Sub-Agenten):
+
+```json
+{
+  "permissions": {
+    "deny": [
+      "Bash(kubectl delete:*)",
+      "Bash(helm uninstall:*)",
+      "Bash(terraform destroy:*)",
+      "Bash(tofu destroy:*)",
+      "Bash(docker volume rm:*)",
+      "Bash(docker system prune -a*)"
+    ]
+  }
+}
+```

package/Dev/i18n/de/Common/agents/migration-specialist.md

@@ -6,22 +6,13 @@ maxTurns: 6
 effort: xhigh
 memory: user
 tools: [Read, Glob, Grep, Bash, WebFetch, WebSearch]
-# Audit 2026-05-18 QW-15 — migrations touch shared/prod databases. Block
-# destructive shell verbs and database drop/truncate. Investigate-then-output
-# is fine; actual destructive execution must require an explicit user opt-in.
-disallowedTools:
-  - "Bash(rm -rf:*)"
-  - "Bash(dd:*)"
-  - "Bash(mkfs:*)"
-  - "Bash(:(){:|:&};:*)"
-  - "Bash(DROP DATABASE:*)"
-  - "Bash(DROP TABLE:*)"
-  - "Bash(TRUNCATE:*)"
-  - "Bash(pg_dump:*)"
-  - "Bash(mysqldump:*)"
-  - "Bash(curl * | sh*)"
-  - "Bash(wget * | sh*)"
 permissionMode: default
+hooks:
+  PreToolUse:
+    - matcher: "Bash"
+      hooks:
+        - type: command
+          command: "grep -qiE '(^|[^A-Za-z_])(DROP[[:space:]]+(DATABASE|SCHEMA|TABLE)|TRUNCATE)([^A-Za-z_]|$)' && { echo \"BLOCKIERT: destruktives SQL (DROP DATABASE/SCHEMA/TABLE, TRUNCATE). Den Befehl dem Benutzer zur eigenen Ausführung vorschlagen.\" >&2; exit 2; } || exit 0"
 ---
 
 # Migration Specialist Agent
@@ -140,3 +131,7 @@ Du bist ein **Senior Migration Specialist** mit über 12 Jahren Erfahrung in kri
 - [Stripe - Online migrations at scale](https://stripe.com/blog/online-migrations)
 - [Shopify - Sharding playbook](https://shopify.engineering/learnings-from-shopifys-largest-database-sharding-project)
 - [Strangler Fig - Martin Fowler](https://martinfowler.com/bliki/StranglerFigApplication.html)
+
+## Schutz vor destruktivem SQL
+
+Ein im Frontmatter deklarierter `PreToolUse`-Hook blockiert, solange dieser Agent läuft, jeden Bash-Befehl mit `DROP DATABASE`, `DROP SCHEMA`, `DROP TABLE` oder `TRUNCATE` (zum Beispiel `psql -c "DROP TABLE …"`): den Befehl dann dem Benutzer vorschlagen. Mit Edit/Write geschriebene Migrationsdateien sind nicht betroffen. Grenzen: Der Hook läuft erst, nachdem dem Ordner vertraut wurde (Workspace Trust), und wird ignoriert, wenn der Agent aus einem Plugin geladen wird.

package/Dev/i18n/de/Common/agents/mlops-engineer.md

@@ -6,21 +6,6 @@ maxTurns: 6
 effort: medium
 memory: user
 tools: [Read, Glob, Grep, Edit, Write, Bash, WebFetch, WebSearch]
-# Audit 2026-05-18 QW-15 — MLOps touches feature stores, model registries
-# and inference endpoints (often production). Block destructive verbs on
-# data/model artefacts and on the underlying infra.
-disallowedTools:
-  - "Bash(rm -rf:*)"
-  - "Bash(dd:*)"
-  - "Bash(mkfs:*)"
-  - "Bash(kubectl delete:*)"
-  - "Bash(helm uninstall:*)"
-  - "Bash(mlflow models delete:*)"
-  - "Bash(mlflow registered-models delete:*)"
-  - "Bash(aws s3 rm:*)"
-  - "Bash(gsutil rm:*)"
-  - "Bash(curl * | sh*)"
-  - "Bash(wget * | sh*)"
 permissionMode: default
 ---
 
@@ -262,3 +247,22 @@ if report.as_dict()["metrics"][0]["result"]["dataset_drift"]:
 - [Google MLOps Guide](https://cloud.google.com/architecture/mlops-continuous-delivery-and-automation-pipelines-in-machine-learning)
 - [Book: Introducing MLOps](https://www.oreilly.com/library/view/introducing-mlops/9781492083283/)
 - [ML Model Governance](https://learn.microsoft.com/en-us/azure/machine-learning/concept-model-management-and-deployment)
+
+## Schutz vor destruktiven Befehlen
+
+Ein Agent kann keinen einzelnen Befehl sperren: `disallowedTools: Bash(...)` entfernt Bash vollständig. Diese Befehle laufen daher über den Berechtigungs-Prompt — vor der Ausführung immer eine ausdrückliche Bestätigung einholen. Um sie in einem Projekt zu sperren, in dessen `.claude/settings.json` ergänzen (die Regeln gelten auch für Sub-Agenten):
+
+```json
+{
+  "permissions": {
+    "deny": [
+      "Bash(kubectl delete:*)",
+      "Bash(helm uninstall:*)",
+      "Bash(mlflow models delete:*)",
+      "Bash(mlflow registered-models delete:*)",
+      "Bash(aws s3 rm:*)",
+      "Bash(gsutil rm:*)"
+    ]
+  }
+}
+```

package/Dev/i18n/de/Common/agents/ralph-conductor.md

@@ -7,17 +7,6 @@ maxTurns: 10
 memory: user
 tools: [Read, Glob, Grep, Edit, Write, Bash, Agent, WebFetch, WebSearch]
 permissionMode: default
-disallowedTools:
-  - "Bash(rm -rf:*)"
-  - "Bash(dd:*)"
-  - "Bash(mkfs:*)"
-  - "Bash(:(){:|:&};:*)"
-  - "Bash(sudo:*)"
-  - "Bash(chmod 777:*)"
-  - "Bash(curl * | sh*)"
-  - "Bash(wget * | sh*)"
-  - "Bash(git push --force*)"
-  - "Bash(git push -f*)"
 ---
 
 # Ralph Conductor Agent v2.0
@@ -188,11 +177,11 @@ Zusammenfassung:
 
 ## Agent Teams Koordinationsmodus
 
-Bei der Ausführung im Agent Teams Modus (aktiviert über `--ralph-mode` bei `/team:sprint`) übernimmt der Conductor die Rolle des **Team Leads** und koordiniert einen Dev-Kollegen über die Claude Code Agent Teams API anstelle von Bash-Prozessmanagement.
+Bei der Ausführung im Agent Teams Modus (aktiviert über `--ralph-mode` bei `/team:sprint --engine=teams`) übernimmt der Conductor die Rolle des **Team Leads** und koordiniert einen Dev-Kollegen über die Claude Code Agent Teams API anstelle von Bash-Prozessmanagement.
 
 ### Voraussetzungen
 
-- Umgebungsvariable `CLAUDE_CODE_EXPERIMENTAL_AGENT_TEAMS=1`
+- Umgebungsvariable `CLAUDE_CODE_EXPERIMENTAL_AGENT_TEAMS=1` (nur für `/team:sprint --engine=teams` erforderlich)
 - Claude Code v2.1.32+
 - Adapter-Bibliothek: `Tools/AgentTeams/lib/ralph-teams-adapter.sh`
 
@@ -229,8 +218,8 @@ Der Conductor führt periodische Gesundheitsprüfungen über den `teams_watchdog
 ### Bash-Modus erhalten
 
 Die gesamte bestehende Bash-Modus-Orchestrierung bleibt unverändert. Der Agent Teams Modus wird nur aktiviert, wenn:
-1. Das `--ralph-mode`-Flag an `/team:sprint` übergeben wird
-2. Die Umgebungsvariable `CLAUDE_CODE_EXPERIMENTAL_AGENT_TEAMS=1` gesetzt ist
+1. Das `--ralph-mode`-Flag an `/team:sprint --engine=teams` übergeben wird
+2. Die Umgebungsvariable `CLAUDE_CODE_EXPERIMENTAL_AGENT_TEAMS=1` gesetzt ist (nur für `/team:sprint --engine=teams` erforderlich)
 3. Die Adapter-Bibliothek verfügbar ist
 
 Ohne diese Bedingungen arbeitet der Conductor genau wie bisher.

package/Dev/i18n/de/Common/agents/refactoring-specialist.md

@@ -17,15 +17,6 @@ skills:
   - solid-principles
   - kiss-dry-yagni
   - testing
-disallowedTools:
-  - "Bash(rm -rf:*)"
-  - "Bash(dd:*)"
-  - "Bash(mkfs:*)"
-  - "Bash(:(){:|:&};:*)"
-  - "Bash(sudo:*)"
-  - "Bash(chmod 777:*)"
-  - "Bash(curl * | sh*)"
-  - "Bash(wget * | sh*)"
 ---
 
 # Refactoring-Spezialist-Agent

package/Dev/i18n/de/Common/agents/tdd-coach.md

@@ -7,15 +7,6 @@ maxTurns: 8
 tools: [Read, Glob, Grep, Edit, Write, Bash, WebFetch, WebSearch]
 permissionMode: default
 skills: [testing, solid-principles]
-disallowedTools:
-  - "Bash(rm -rf:*)"
-  - "Bash(dd:*)"
-  - "Bash(mkfs:*)"
-  - "Bash(:(){:|:&};:*)"
-  - "Bash(sudo:*)"
-  - "Bash(chmod 777:*)"
-  - "Bash(curl * | sh*)"
-  - "Bash(wget * | sh*)"
 ---
 
 # TDD/BDD Coach Agent

package/Dev/i18n/de/Common/agents/uiux-orchestrator.md

@@ -6,15 +6,6 @@ effort: medium
 maxTurns: 10
 tools: [Read, Glob, Grep, Edit, Write, Bash, Agent, WebFetch, WebSearch]
 permissionMode: default
-disallowedTools:
-  - "Bash(rm -rf:*)"
-  - "Bash(dd:*)"
-  - "Bash(mkfs:*)"
-  - "Bash(:(){:|:&};:*)"
-  - "Bash(sudo:*)"
-  - "Bash(chmod 777:*)"
-  - "Bash(curl * | sh*)"
-  - "Bash(wget * | sh*)"
 ---
 
 # UI/UX Orchestrator Agent

package/Dev/i18n/de/Common/commands/ralph-run.md

@@ -51,6 +51,12 @@ Führt Claude in einer kontinuierlichen Schleife aus, bis die Aufgabe abgeschlos
    - Maximale Iterationen, Timeouts, DoD-Kriterien festlegen
    - Hooks initialisieren, falls aktiviert
 
+#### Isolierung von Sessions und parallelen Workern
+
+- **Explizite Claude-Session**: Jede Ralph-Session legt ihre eigene Claude-Konversations-ID fest — `claude --session-id <uuid>` in der ersten Iteration, danach `claude --resume <uuid>`. Die UUID wird in `.ralph/sessions/<session>/claude_session_id` gespeichert, sodass `--continue=<session>` die richtige Konversation fortsetzt. Ralph verwendet `claude --continue` nicht mehr, das „die neueste Konversation im Verzeichnis“ fortsetzte (geteilt zwischen Workern oder sogar mit der interaktiven Session des Benutzers).
+- **Ein Git-Worktree pro Worker** (paralleler Modus, `lib/parallel-manager.sh`): Jede Story läuft in einem eigenen Worktree `.ralph/parallel/worktrees/<session>` auf dem Branch `ralph/<session>`, mit ihrem Ralph-Zustand unter `.ralph/parallel/sessions/<session>/ralph/`. Am Ende des Laufs werden verbleibende Änderungen als `wip(ralph): <story>` auf diesem Branch committet, danach wird der Worktree entfernt (`git worktree remove`). Schlägt dieser Commit fehl, bleibt der Worktree erhalten (kein Datenverlust) und wird in `output.log` gemeldet. Die Arbeit wird durch Mergen der `ralph/*`-Branches übernommen.
+- **Außerhalb eines Git-Repositorys**: kein Worktree; der Worker läuft im aktuellen Verzeichnis (eine Warnung wird ausgegeben), die Isolierung der Claude-Sessions bleibt bestehen.
+
 ### 2. Hauptschleife mit Dashboard
 
 ```
@@ -76,6 +82,35 @@ Das DoD-System validiert den Abschluss über mehrere Kriterien:
 | `hook` | Bestehenden Claude-Hook ausführen |
 | `human` | Interaktive menschliche Validierung |
 
+#### Grenze des `command`-Validators → `type: hook` verwenden
+
+`type: command` führt nur Befehle aus, die die Allowlist in `Tools/Ralph/lib/dod-validator.sh` bestehen: Buchstaben, Ziffern, Leerzeichen und `_ . / " ' -`. Jeder Befehl mit `=`, `|`, `&` oder `:` (sowie `;`, `>`, `$` usw.) wird mit `ERROR: Invalid command` abgelehnt: Das Kriterium wird dann **nie** erfüllt und die Schleife läuft, bis der Circuit Breaker auslöst.
+
+| Abgelehnter Befehl | Problematisches Zeichen |
+|--------------------|-------------------------|
+| `dotnet build /p:TreatWarningsAsErrors=true` | `:` und `=` |
+| `npm test && npm run lint` | `&` |
+| `pytest \| tee out.log` | `\|` |
+
+In diesen Fällen den Befehl in ein Skript auslagern und als `type: hook` deklarieren:
+
+```yaml
+definition_of_done:
+  checklist:
+    - id: build
+      type: hook
+      script: ".ralph/dod/build.sh"
+      required: true
+```
+
+```bash
+#!/usr/bin/env bash
+# .ralph/dod/build.sh — erhält {"cwd": ..., "output": ...} als JSON über stdin
+dotnet build /p:TreatWarningsAsErrors=true || exit 2
+```
+
+Das Skript gibt `0` (Kriterium erfüllt) oder `2` (Kriterium fehlgeschlagen) zurück. Gelesene Schlüssel je Typ: `command` → `command:`, `output_contains` und `file_changed` → `pattern:`, `hook` → `script:`, `human` → `prompt:`.
+
 ### 4. Adaptiver Circuit Breaker (v2.0)
 
 Wählt automatisch das Profil basierend auf Aufgaben-Schlüsselwörtern:
@@ -100,6 +135,23 @@ Claude arbeitet...
 Stop → stop-dod-gate.sh → Blockieren, wenn DoD nicht erfüllt (exit 2)
 ```
 
+## /goal (interaktiv) oder Ralph (autonom/CI)?
+
+`/goal` ist ein nativer Claude-Code-Befehl, der in einer Sitzung eingegeben wird: Er ist keine Option von `ralph.sh` — `ralph.sh` bietet dafür keine an und erzeugt nie ein `/goal`. Beide Werkzeuge ergänzen sich:
+
+| Kriterium | `/goal` (nativ) | Ralph (`ralph.sh`) |
+|-----------|-----------------|--------------------|
+| Abschlussprüfung | LLM-Urteil: Ein kleines, schnelles Modell bewertet nach jedem Zug, was in der Konversation sichtbar ist — es führt keinen Befehl aus und liest keine Datei | Deterministisch: Befehle, Muster und Hooks, ausgeführt von `dod-validator.sh` |
+| Iterationsobergrenze | Keine feste Grenze: Ende, wenn die Bedingung erfüllt oder als unmöglich bewertet ist, bei `/goal clear` oder wenn Claude mehrere Züge in Folge ohne Werkzeug antwortet; eine Grenze kann in die Bedingung geschrieben werden | `max_iterations` + adaptiver Circuit Breaker |
+| Headless / CI | `claude -p "/goal ..."` läuft in einem einzigen Aufruf bis zum Ende; CI-Nutzung nicht dokumentiert | Dafür gebaut: autonome Läufe (`--autonomous`, `--overnight`), `headless`-Dashboard |
+| `disableAllHooks: true` | Nicht verfügbar: `/goal` umhüllt einen sitzungsbezogenen Stop-Hook (ebenso mit `allowManagedHooksOnly`) | Schleife und DoD laufen in `ralph.sh`; nur die Hooks-Integration (`stop-dod-gate.sh`) ist deaktiviert |
+| Konfiguration | Keine; ein Goal pro Sitzung, durch `/clear` gelöscht | `ralph.yml` |
+
+- **`/goal` wählen** für eine interaktive Aufgabe, deren Abschluss in der Konversation sichtbar wird (Testausgabe anzeigen: Der Evaluator führt die Tests nicht aus).
+- **Ralph wählen**, wenn der Abschluss durch Befehle belegt werden muss, mit Iterationsobergrenze, unbeaufsichtigt oder in CI.
+
+Referenz: [`/goal`-Dokumentation](https://code.claude.com/docs/en/goal).
+
 ## Schnellstart-Beispiele
 
 ```bash

package/Dev/i18n/de/Common/commands/research-context7.md

@@ -1,257 +1,9 @@
 ---
-description: Recherche mit Context7 und Web
-argument-hint: [arguments]
+description: "Veraltet (Entfernung in 9.0): context7-MCP oder /deep-research verwenden"
+deprecated: true
+replaced-by: mcp:context7
 ---
 
-# Recherche mit Context7 und Web
+> ⚠️ `/common:research-context7` ist veraltet und wird in 9.0 entfernt. Verwenden Sie den context7-MCP oder `/deep-research`.
 
-Sie sind ein erfahrener Recherche-Assistent. Sie müssen MCP Context7 verwenden, um auf Bibliotheksdokumentation zuzugreifen, und Websuche, um aktuelle Informationen zu einem technischen Thema zu finden.
-
-## Argumente
-$ARGUMENTS
-
-Argumente:
-- Recherche-Thema oder technische Frage
-- (Optional) Spezifische zu konsultierende Bibliotheken
-
-Beispiel: `/common:research-context7 "Wie OAuth2-Authentifizierung mit NextAuth.js implementieren"` oder `/common:research-context7 "React 19 Best Practices" react,nextjs`
-
-## Plan-Modus
-
-> Der Plan-Modus wird automatisch aktiviert, wenn der Umfang mehrere Module umfasst oder eine modulübergreifende Untersuchung erfordert.
-
-## MISSION
-
-### Schritt 1: Anfrage analysieren
-
-Identifizieren:
-- Hauptrecherche-Thema
-- Betroffene Technologien/Bibliotheken
-- Erforderliches Detailniveau
-- Zu beantwortende spezifische Fragen
-
-### Schritt 2: Context7 (MCP) verwenden
-
-**Context7 bietet Zugriff auf aktuelle Bibliotheksdokumentation.**
-
-#### Dokumentation durchsuchen
-
-```
-MCP Context7 Tool verwenden für:
-1. Offizielle Bibliotheksdokumentation durchsuchen
-2. Aktuelle Code-Beispiele erhalten
-3. Offizielle Anleitungen und Tutorials konsultieren
-4. Verfügbare APIs prüfen
-```
-
-#### Von Context7 unterstützte Bibliotheken
-
-Context7 indiziert Dokumentation vieler populärer Bibliotheken:
-- React, Next.js, Vue, Nuxt, Svelte
-- Node.js, Express, Fastify, NestJS
-- Python (Django, FastAPI, Flask)
-- TypeScript, Tailwind CSS
-- Und viele andere...
-
-#### Context7-Abfrageformat
-
-Um Context7 zu verwenden, muss ich:
-1. Die exakte Bibliothek identifizieren
-2. Eine präzise Abfrage formulieren
-3. Code-Beispiele anfordern falls relevant
-
-### Schritt 3: Ergänzende Websuche
-
-**Websuche verwenden für:**
-
-1. **Aktuelle Informationen** (nach Context7s Stichtag)
-   - Neue Versionen
-   - Breaking Changes
-   - Offizielle Ankündigungen
-
-2. **Community-Diskussionen**
-   - GitHub Issues
-   - Stack Overflow Diskussionen
-   - Experten-Blog-Artikel
-
-3. **Vergleiche und Alternativen**
-   - Benchmarks
-   - Lösungsvergleiche
-   - Erfahrungs-Feedback
-
-4. **Spezifische Anwendungsfälle**
-   - Produktionsbeispiele
-   - Fortgeschrittene Patterns
-   - Lösungen für häufige Probleme
-
-### Schritt 4: Ergebnisse zusammenfassen
-
-#### Antwortformat
-
-```
-══════════════════════════════════════════════════════════════
-🔍 RECHERCHE: [Thema]
-══════════════════════════════════════════════════════════════
-
-──────────────────────────────────────────────────────────────
-📚 OFFIZIELLE DOKUMENTATION (Context7)
-──────────────────────────────────────────────────────────────
-
-### [Bibliothek 1]
-
-**Aktuelle Version**: X.Y.Z
-
-**Zusammenfassung**:
-[Zusammenfassung gefundener Informationen]
-
-**Code-Beispiel**:
-```[sprache]
-// Beispiel-Code aus Dokumentation
-```
-
-**Nützliche Links**:
-- [Link 1]
-- [Link 2]
-
-### [Bibliothek 2]
-...
-
-──────────────────────────────────────────────────────────────
-🌐 WEBSUCHE
-──────────────────────────────────────────────────────────────
-
-### Aktuelle Informationen
-
-- [Datum]: [Gefundene Information]
-- [Datum]: [Gefundene Information]
-
-### Relevante Artikel
-
-1. **[Artikeltitel]**
-   - Quelle: [URL]
-   - Zusammenfassung: [Kernpunkte]
-
-2. **[Artikeltitel]**
-   ...
-
-### Community-Diskussionen
-
-- **GitHub Issue**: [Link] - [Zusammenfassung]
-- **Stack Overflow**: [Link] - [Zusammenfassung]
-
-──────────────────────────────────────────────────────────────
-💡 SYNTHESE UND EMPFEHLUNGEN
-──────────────────────────────────────────────────────────────
-
-### Antwort auf Frage
-
-[Synthetische Antwort basierend auf Recherche]
-
-### Empfohlene Vorgehensweise
-
-1. [Schritt 1]
-2. [Schritt 2]
-3. [Schritt 3]
-
-### Aufmerksamkeitspunkte
-
-- ⚠️ [Aufmerksamkeitspunkt 1]
-- ⚠️ [Aufmerksamkeitspunkt 2]
-
-### Vollständiges Code-Beispiel
-
-```[sprache]
-// Beispiel-Code, der gefundene Best Practices kompiliert
-```
-
-──────────────────────────────────────────────────────────────
-📋 QUELLEN
-──────────────────────────────────────────────────────────────
-
-Dokumentation:
-- [Quelle 1]
-- [Quelle 2]
-
-Web:
-- [Quelle 1]
-- [Quelle 2]
-```
-
-### Schritt 5: Validierung
-
-#### Quellenqualität überprüfen
-
-- [ ] Offizielle Quellen priorisiert
-- [ ] Aktuelle Informationen (< 1 Jahr idealerweise)
-- [ ] Konsistenz zwischen Quellen
-- [ ] Testbare Code-Beispiele
-
-#### Relevanz überprüfen
-
-- [ ] Beantwortet ursprüngliche Frage
-- [ ] Angemessenes Detailniveau
-- [ ] Praktische Beispiele bereitgestellt
-- [ ] Alternativen erwähnt falls relevant
-
-### Typische Anwendungsfälle
-
-#### 1. Neue Bibliothek
-
-```
-Frage: "Wie [neue Bibliothek] verwenden?"
-
-→ Context7: Dokumentation, API, Basisbeispiele
-→ Web: Tutorials, Feedback, Fallstricke
-```
-
-#### 2. Technisches Problem
-
-```
-Frage: "Warum [Fehler] mit [Bibliothek]?"
-
-→ Context7: Fehler-Dokumentation, Troubleshooting
-→ Web: GitHub Issues, Stack Overflow, Foren
-```
-
-#### 3. Vergleich
-
-```
-Frage: "[Lib A] vs [Lib B] für [Anwendungsfall]?"
-
-→ Context7: Features jeder Lib
-→ Web: Benchmarks, Vergleiche, Experten-Meinungen
-```
-
-#### 4. Best Practices
-
-```
-Frage: "Best Practices für [Thema]?"
-
-→ Context7: Offizielle Richtlinien
-→ Web: Experten-Artikel, populäre Patterns
-```
-
-#### 5. Migration
-
-```
-Frage: "Von [v1] zu [v2] migrieren?"
-
-→ Context7: Offizielle Migrationsanleitung
-→ Web: Erfahrungs-Feedback, echte Breaking Changes
-```
-
-### Wichtige Richtlinien
-
-1. **Quellen immer zitieren** - Niemals Informationen erfinden
-2. **Offizielle Dokumentation priorisieren** - Context7 zuerst
-3. **Informationsdatum prüfen** - Web kann veraltete Inhalte haben
-4. **Testbaren Code bereitstellen** - Beispiele müssen funktionieren
-5. **Ehrlich über Einschränkungen sein** - Falls Information nicht gefunden, sagen
-
-### Bei Zweifel
-
-Falls ich die Information nicht finde:
-- Klar angeben, was nicht gefunden wurde
-- Alternative Wege vorschlagen
-- Vorschlagen, wo manuell gesucht werden kann
-- NIEMALS Informationen erfinden oder halluzinieren
+Für „$ARGUMENTS": Doku über den context7-MCP (`resolve-library-id`, dann `query-docs`), Webrecherche über `/deep-research`; außerhalb von claude.ai WebSearch/WebFetch oder der Agent `@research-assistant`.