cc-viewer 1.6.182 → 1.6.183

package/concepts/ar/Tool-Write.md

@@ -1,39 +1,35 @@
 # Write
 
-## التعريف
+يُنشئ ملفاً جديداً أو يستبدل محتويات ملف موجود بالكامل على نظام الملفات المحلي. لأنه يستبدل كل شيء في المسار المستهدف، ينبغي حجزه للإنشاء الحقيقي أو إعادة الكتابة الكاملة المقصودة.
 
-كتابة المحتوى إلى نظام الملفات المحلي. إذا كان الملف موجوداً بالفعل فسيتم الكتابة فوقه.
+## متى يُستخدم
 
-## المعاملات
+- إنشاء ملف مصدر جديد تماماً، أو اختبار، أو إعداد لا يوجد بعد
+- توليد موضع جديد، أو لقطة، أو ملف بيانات من الصفر
+- تنفيذ إعادة كتابة كاملة حيث يكون `Edit` التزايدي أكثر تعقيداً من البدء من جديد
+- إصدار عنصر مطلوب مثل مخطط أو ترحيل أو سكربت بناء طلب المستخدم إنتاجه صراحة
 
-| المعامل | النوع | مطلوب | الوصف |
-|---------|-------|-------|-------|
-| `file_path` | string | نعم | المسار المطلق للملف (يجب أن يكون مسار مطلق) |
-| `content` | string | نعم | المحتوى المراد كتابته |
+## المعاملات
 
-## سيناريوهات الاستخدام
+- `file_path` (سلسلة، مطلوب): المسار المطلق للملف المراد كتابته. يجب أن تكون أي أدلة أبوية موجودة بالفعل.
+- `content` (سلسلة، مطلوب): النص الكامل المراد كتابته في الملف. هذا يصبح متن الملف بأكمله.
 
-**مناسب للاستخدام:**
-- إنشاء ملفات جديدة
-- عند الحاجة لإعادة كتابة محتوى الملف بالكامل
+## أمثلة
 
-**غير مناسب للاستخدام:**
-- تعديل محتوى جزئي في الملف — يجب استخدام Edit
-- لا ينبغي إنشاء ملفات توثيق (*.md) أو README بشكل استباقي، إلا إذا طلب المستخدم ذلك صراحة
+### مثال 1: إنشاء وحدة مساعدة جديدة
+استدعِ `Write` بـ `file_path: "/Users/me/app/src/utils/slugify.ts"` وقدِّم التنفيذ كـ `content`. استخدم هذا فقط بعد التحقق من أن الملف غير موجود بالفعل.
 
-## ملاحظات
+### مثال 2: إعادة توليد عنصر مشتق
+بعد تغيير مصدر المخطط، أعد كتابة `/Users/me/app/generated/schema.json` في استدعاء `Write` واحد باستخدام JSON المُولَّد حديثاً كـ `content`.
 
-- إذا كان الملف الهدف موجوداً بالفعل، يجب قراءته أولاً عبر Read وإلا سيفشل
-- يكتب فوق كامل محتوى الملف الموجود
-- يُفضل استخدام Edit لتحرير الملفات الموجودة، Write فقط لإنشاء ملفات جديدة أو إعادة الكتابة الكاملة
+### مثال 3: استبدال ملف موضع صغير
+لموضع اختبار للاستعمال المؤقت حيث يتغير كل سطر، قد يكون `Write` أوضح من سلسلة استدعاءات `Edit`. اقرأ الملف أولاً، أكد النطاق، ثم اكتب فوقه.
 
-## النص الأصلي
-
-<textarea readonly>Writes a file to the local filesystem.
+## ملاحظات
 
-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>
+- قبل الكتابة فوق ملف موجود، يجب أن تستدعي `Read` عليه في الجلسة الحالية. يرفض `Write` الكتابة فوق محتوى غير مرئي.
+- فضِّل `Edit` لأي تغيير يمس جزءاً من الملف فقط. `Edit` يُرسل الفارق فقط، وهو أسرع وأأمن وأسهل للمراجعة.
+- لا تُنشئ توثيق Markdown استباقياً أو ملفات `README.md` أو سجل تغييرات إلا إذا طلبها المستخدم صراحةً.
+- لا تُضف رموزاً تعبيرية أو نصوصاً تسويقية أو لافتات زخرفية إلا إذا طلب المستخدم هذا الأسلوب.
+- تحقق من وجود الدليل الأبوي أولاً باستدعاء `Bash` `ls`؛ لا يُنشئ `Write` مجلدات وسيطة.
+- زوّد المحتوى بالضبط كما تريد استمراره؛ لا يوجد قولبة أو معالجة لاحقة.

package/concepts/ar/Tool-executeCode.md

@@ -1,41 +1,47 @@
-# executeCode (mcp__ide__executeCode)
+# executeCode
 
-## التعريف
+يُنفِّذ مقتطف شفرة داخل نواة حية أو صندوق رمل يُقدِّمه تكامل IDE (مثل نواة Jupyter المرتبطة بالدفتر المفتوح حالياً). تكون الأداة موجودة فقط عندما يعمل Claude Code جنباً إلى جنب مع جسر IDE متوافق مثل ملحق VS Code مع نواة Jupyter محددة.
 
-تنفيذ كود Python في Jupyter kernel الخاص بملف notebook الحالي.
+## متى يُستخدم
+
+- تشغيل حساب سريع أو فحص بيانات أو رسم مقابل الحالة المحمَّلة بالفعل في نواة Jupyter نشطة.
+- التحقق من مقتطف شفرة قبل لصقه في خلية دفتر.
+- استكشاف إطار بيانات في الذاكرة أو متغير أو نموذج موجود في النواة لكن غير مُسلسل على القرص.
+- إنتاج رسم بياني أو نتيجة عددية يريد المستخدم عرضها داخلياً في IDE.
+
+لا تستخدمه لسكربتات مستقلة تكون أفضل بتشغيل `Bash` لـ `python script.py`، أو لشفرة تحتاج إلى الاستمرار عبر نواة جديدة.
 
 ## المعاملات
 
-| المعامل | النوع | مطلوب | الوصف |
-|---------|-------|-------|-------|
-| `code` | string | نعم | كود Python المراد تنفيذه |
+- `code` (سلسلة، مطلوب): الشفرة المراد تنفيذها في النواة الحالية. تعمل كما لو لُصقت في خلية دفتر — المتغيرات المُعرَّفة تستمر في النواة حتى يُعاد تشغيلها.
+- `language` (سلسلة، اختياري): لغة المقتطف عندما يدعم جسر IDE عدة أنوية. غالباً ما يُحذف؛ الافتراضي هو لغة النواة النشطة (Python عادة).
+
+## أمثلة
+
+### مثال 1: فحص إطار بيانات في الذاكرة
+
+```
+executeCode(
+  code="df.head()\nprint(df.shape)\nprint(df.dtypes)"
+)
+```
+
+يُعيد الصفوف الأولى والشكل وأنواع الأعمدة لإطار بيانات مُحمَّل بالفعل في النواة.
 
-## سيناريوهات الاستخدام
+### مثال 2: فحص عددي سريع
 
-**مناسب للاستخدام:**
-- تنفيذ الكود في بيئة Jupyter notebook
-- اختبار مقتطفات الكود
-- تحليل البيانات والحسابات
+```
+executeCode(
+  code="import numpy as np\nnp.mean([1, 2, 3, 4, 5])"
+)
+```
 
-**غير مناسب للاستخدام:**
-- تنفيذ الكود خارج بيئة Jupyter — يجب استخدام Bash
-- تعديل الملفات — يجب استخدام Edit أو Write
+يُشغِّل حساباً لمرة واحدة دون إنشاء خلية دفتر.
 
 ## ملاحظات
 
-- هذه أداة MCP (Model Context Protocol)، مقدمة من تكامل IDE
-- يُنفذ الكود في Jupyter kernel الحالي، والحالة تستمر بين الاستدعاءات
-- ما لم يطلب المستخدم صراحة، يجب تجنب تعريف المتغيرات أو تعديل حالة kernel
-- تُفقد الحالة بعد إعادة تشغيل kernel
-
-## النص الأصلي
-
-<textarea readonly>Execute python code in the Jupyter kernel for the current notebook file.
-    
-    All code will be executed in the current Jupyter kernel.
-    
-    Avoid declaring variables or modifying the state of the kernel unless the user
-    explicitly asks for it.
-    
-    Any code executed will persist across calls to this tool, unless the kernel
-    has been restarted.</textarea>
+- `executeCode` أداة جسر IDE. غير متاحة في جلسات Claude Code العادية في الطرفية؛ تظهر فقط عندما تكون الجلسة متصلة بـ IDE يعرض نواة (مثل ملحق Jupyter لـ VS Code).
+- الحالة تستمر في النواة. المتغيرات المُعرَّفة باستدعاء `executeCode` تبقى مرئية للاستدعاءات اللاحقة ولخلايا الدفتر وللمستخدم — كن مدركاً للآثار الجانبية.
+- ستحجب الشفرة طويلة الأمد أو الحاجبة النواة. أبقِ المقتطفات قصيرة؛ للعمل الذي يستغرق عدة دقائق، اكتب سكربتاً فعلياً وشغِّله عبر `Bash`.
+- تُعاد المخرجات (stdout، القيم المُرجعة، الصور) إلى الجلسة. قد يُقتطع جسر IDE المخرجات الكبيرة جداً.
+- لتعديلات الملفات، فضِّل `Edit` أو `Write` أو `NotebookEdit` — `executeCode` ليس بديلاً لتأليف ملفات المصدر.

package/concepts/ar/Tool-getDiagnostics.md

@@ -1,32 +1,44 @@
-# getDiagnostics (mcp__ide__getDiagnostics)
+# getDiagnostics
 
-## التعريف
+يسترجع تشخيصات خادم اللغة (أخطاء، تحذيرات، تلميحات) من IDE المتصل لملف معين أو لكل ملف يفتحه IDE حالياً. يُستخدم للتحقق من أن تغييرات الشفرة تُصنَّف نظيفاً قبل الإعلان عن إنجاز المهمة.
 
-الحصول على معلومات التشخيص اللغوي من VS Code، بما في ذلك أخطاء الصياغة وأخطاء الأنواع وتحذيرات lint وغيرها.
+## متى يُستخدم
+
+- بعد `Edit` أو `Write` للتأكد من أن التغيير لم يُدخل خطأ نوع أو صياغة أو تحذير lint.
+- قبل إنهاء مهمة لمسح كل ملف مفتوح بحثاً عن مشاكل غير محلولة.
+- عند تشخيص خطأ يُبلِّغ عنه المستخدم — سحب الرسالة الدقيقة من المُصنِّف أو مُفحص النوع من IDE يتجنب التخمين.
+- كبديل خفيف لتشغيل أمر بناء أو اختبار كامل عندما تحتاج فقط إلى فحص الصحة الثابتة.
+
+لا تعتمد على `getDiagnostics` بديلاً لمجموعة الاختبارات. يُبلِّغ عما يراه خادم اللغة، لا عما يعمل في وقت الاختبار أو الإنتاج.
 
 ## المعاملات
 
-| المعامل | النوع | مطلوب | الوصف |
-|---------|-------|-------|-------|
-| `uri` | string | لا | عنوان URI للملف. إذا لم يُحدد يتم الحصول على معلومات التشخيص لجميع الملفات |
+- `uri` (سلسلة، اختياري): URI الملف (عادة `file:///absolute/path`) لجلب تشخيصات له. عند الحذف، تُعيد الأداة التشخيصات لكل ملف يفتحه IDE حالياً.
 
-## سيناريوهات الاستخدام
+## أمثلة
 
-**مناسب للاستخدام:**
-- فحص مشاكل الصياغة والأنواع وlint وغيرها من المشاكل الدلالية في الكود
-- التحقق بعد تحرير الكود من عدم إدخال أخطاء جديدة
-- بديل لأوامر Bash لفحص جودة الكود
+### مثال 1: فحص ملف واحد بعد التعديل
 
-**غير مناسب للاستخدام:**
-- تشغيل الاختبارات — يجب استخدام Bash
-- فحص أخطاء وقت التشغيل — يجب استخدام Bash لتنفيذ الكود
+```
+getDiagnostics(
+  uri="file:///Users/sky/project/src/auth.ts"
+)
+```
 
-## ملاحظات
+يُعيد أي أخطاء TypeScript أو تحذيرات ESLint أو رسائل خادم اللغة الأخرى لـ `src/auth.ts`.
 
-- هذه أداة MCP (Model Context Protocol)، مقدمة من تكامل IDE
-- متاحة فقط في بيئة VS Code / IDE
-- يُفضل استخدام هذه الأداة بدلاً من أوامر Bash لفحص مشاكل الكود
+### مثال 2: مسح جميع الملفات المفتوحة
 
-## النص الأصلي
+```
+getDiagnostics()
+```
+
+يُعيد التشخيصات عبر كل محرر مفتوح حالياً. مفيد في نهاية إعادة هيكلة متعددة الملفات للتأكد من عدم تراجع أي شيء آخر.
+
+## ملاحظات
 
-<textarea readonly>Get language diagnostics from VS Code</textarea>
+- `getDiagnostics` أداة جسر IDE. متاحة فقط عندما يكون Claude Code متصلاً بتكامل IDE داعم (مثل ملحق VS Code). في جلسة طرفية عادية لن تظهر الأداة.
+- تعكس النتائج أياً من خوادم اللغة التي حمَّلها IDE — TypeScript، Pyright، ESLint، rust-analyzer، إلخ. الجودة والتغطية تعتمدان على إعداد IDE للمستخدم، لا على Claude Code.
+- التشخيصات حية. بعد التعديل، أعطِ خادم اللغة لحظة لإعادة التحليل قبل تفسير نتيجة فارغة نجاحاً — أعد التشغيل إذا كان الملف قد حُفظ للتو.
+- تشمل مستويات الخطورة عادة `error` و`warning` و`information` و`hint`. ركِّز على `error` أولاً؛ قد تكون التحذيرات أسلوب مشروع مقصوداً.
+- للملفات غير المفتوحة حالياً في IDE، قد لا يملك خادم اللغة تشخيصات للإبلاغ عنها حتى لو احتوى الملف على مشاكل حقيقية. افتح الملف أو شغِّل البناء للتغطية الموثوقة.

package/concepts/ar/Tools.md

@@ -8,7 +8,7 @@
 
 | الأداة | الغرض |
 |--------|--------|
-| [Task](Tool-Task.md) | بدء وكيل فرعي (SubAgent) لمعالجة المهام المعقدة متعددة الخطوات |
+| [Agent](Tool-Agent.md) | بدء وكيل فرعي (SubAgent) لمعالجة المهام المعقدة متعددة الخطوات |
 | [TaskOutput](Tool-TaskOutput.md) | الحصول على مخرجات المهام الخلفية |
 | [TaskStop](Tool-TaskStop.md) | إيقاف مهمة خلفية قيد التشغيل |
 | [TaskCreate](Tool-TaskCreate.md) | إنشاء عنصر في قائمة المهام المنظمة |

package/concepts/da/SubAgent-Search.md

@@ -1,20 +1,52 @@
 # SubAgent: Search
 
-## Definition
+## Formål
 
-Search er en sub-agent-type der startes af Claude Codes hovedagent for at udføre kodesøgninger. Den udfører målrettede fil- og indholdssøgninger ved hjælp af værktøjer som Glob, Grep og Read, og returnerer derefter resultaterne til forælderagenten.
+Search-underagenten er en letvægts, skrivebeskyttet udforskningsagent. Udsend den, når du har brug for at forstå en kodebase — finde hvor noget bor, lære hvordan komponenter passer sammen, eller besvare strukturelle spørgsmål — uden at ændre nogen filer. Den er optimeret til mange små læsninger på tværs af mange filer og returnerer en kortfattet opsummering frem for rå søgeoutput.
 
-## Adfærd
+Search er ikke en generel assistent. Den kan ikke redigere kode, køre builds, committe ændringer eller åbne netværksforbindelser ud over skrivebeskyttede hentninger. Dens værdi er, at den kan brænde gennem et stort udforskningsbudget parallelt uden at forbruge hovedagentens kontekst og derefter give et kompakt svar tilbage.
 
-- Startes automatisk når hovedagenten skal søge i eller udforske kodebasen
-- Kører i en isoleret kontekst med skrivebeskyttet adgang
-- Bruger Glob til filmønster-matchning, Grep til indholdssøgning og Read til filinspection
-- Returnerer søgeresultater til forælderagenten til videre behandling
+## Hvornår skal den bruges
 
-## Hvornår det vises
+- Du har brug for at besvare et spørgsmål, der kræver tre eller flere distinkte søgninger eller læsninger. Eksempel: "Hvordan er autentificering kablet fra login-ruten ned til session-storen?"
+- Målet er ukendt — du ved endnu ikke, hvilken fil, modul eller symbol der skal kigges på.
+- Du har brug for et strukturelt overblik over et ukendt område af repoet, før du foretager ændringer.
+- Du vil krydsreferere flere kandidater (for eksempel hvilken af flere lignende navngivne hjælpefunktioner, der faktisk kaldes i produktion).
+- Du har brug for en litteratur-stil-opsummering: "list hvert sted, der importerer X, og kategorisér efter kaldsstedet."
 
-Search sub-agenter vises typisk når:
+Brug ikke Search, når:
 
-1. Hovedagenten skal finde specifikke filer, funktioner eller kodemønstre
-2. Brugeren anmoder om en bred udforskning af kodebasen
-3. Agenten undersøger afhængigheder, referencer eller anvendelsesmønstre
+- Du allerede kender den nøjagtige fil og linje. Kald `Read` direkte.
+- En enkelt `Grep` eller `Glob` vil besvare spørgsmålet. Kør den direkte; at udsende en underagent tilføjer overhead.
+- Opgaven kræver redigering, kørsel af kommandoer eller enhver sideeffekt. Search er skrivebeskyttet pr. design.
+- Du har brug for nøjagtigt ordret output af et værktøjskald. Underagenter opsummerer; de proxer ikke rå resultater.
+
+## Grundighedsniveauer
+
+Vælg det niveau, der matcher spørgsmålets indsats.
+
+- `quick` — nogle få målrettede søgninger, bedst mulig besvarelse. Brug, når du har brug for en hurtig pegepind (for eksempel "hvor er env-var-parsing-logikken?") og er komfortabel med at iterere, hvis svaret er ufuldstændigt.
+- `medium` — standarden. Flere runder af søgning, krydskontrol af kandidater og læsning af de mest relevante filer fuldt ud. Brug til typiske "hjælp mig med at forstå dette område"-spørgsmål.
+- `very thorough` — udtømmende udforskning. Underagenten vil jage hvert plausibelt spor, læse omgivende kontekst og dobbeltkontrollere fund, før den opsummerer. Brug, når korrekthed betyder noget (for eksempel sikkerhedsgennemgang, migrationsplanlægning), eller når et ufuldstændigt svar vil forårsage omarbejde.
+
+Højere grundighed koster mere tid og tokens inde i underagenten, men disse tokens forbliver inde i underagenten — kun den endelige opsummering returnerer til hovedagenten.
+
+## Tilgængelige værktøjer
+
+Search har adgang til alle skrivebeskyttede værktøjer, hovedagenten bruger, og intet andet:
+
+- `Read` — til at læse specifikke filer, inklusive delvise intervaller.
+- `Grep` — til indholds-søgninger på tværs af træet.
+- `Glob` — til at lokalisere filer efter navnemønster.
+- `Bash` i skrivebeskyttet tilstand — til kommandoer, der inspicerer tilstand uden at mutere den (for eksempel `git log`, `git show`, `ls`, `wc`).
+- `WebFetch` og `WebSearch` — til at læse ekstern dokumentation, når den kontekst er påkrævet.
+
+Redigeringsværktøjer (`Write`, `Edit`, `NotebookEdit`), shell-kommandoer der ændrer tilstand, og task-graph-værktøjer (`TaskCreate`, `TaskUpdate` osv.) er bevidst utilgængelige.
+
+## Noter
+
+- Giv Search-underagenten et specifikt spørgsmål, ikke et emne. "List hver opkalder af `renderMessage`, og notér hvilke der sender et custom tema" returnerer et nyttigt svar; "fortæl mig om rendering" gør ikke.
+- Underagenten returnerer en opsummering. Hvis du har brug for nøjagtige filstier, bed eksplicit om dem i din prompt.
+- Flere uafhængige spørgsmål udsendes bedst som parallelle Search-underagenter frem for én lang prompt, så hver kan fokusere.
+- Fordi Search ikke kan redigere, par den med et opfølgende redigeringstrin i hovedagenten, når du ved, hvad der skal ændres.
+- Behandl Search-output som evidens, ikke som grundsandhed. For alt bærende, åbn de citerede filer selv, før du handler.

package/concepts/da/Tool-Agent.md

@@ -1,125 +1,60 @@
 # Agent
 
-## Definition
+Starter en autonom Claude Code-underagent med sit eget kontekstvindue til at håndtere en fokuseret opgave og returnere et enkelt konsolideret resultat. Dette er den kanoniske mekanisme til at delegere åben research, parallelt arbejde eller teamsamarbejde.
 
-Starter en sub-agent (SubAgent) til selvstændigt at håndtere komplekse flertrinsopgaver. Sub-agenter er uafhængige underprocesser, hver med deres eget dedikerede værktøjssæt og kontekst. Agent er den omdøbte version af Task-værktøjet i nyere Claude Code-versioner.
+## Hvornår skal den bruges
 
-## Parametre
-
-| Parameter | Type | Påkrævet | Beskrivelse |
-|------|------|------|------|
-| `prompt` | string | Ja | Beskrivelse af opgaven sub-agenten skal udføre |
-| `description` | string | Ja | Kort resumé på 3-5 ord |
-| `subagent_type` | string | Ja | Sub-agent-type, bestemmer det tilgængelige værktøjssæt |
-| `model` | enum | Nej | Angiv model (sonnet / opus / haiku), standard arvet fra forælder |
-| `max_turns` | integer | Nej | Maksimalt antal agentiske ture |
-| `run_in_background` | boolean | Nej | Om den skal køre i baggrunden; baggrundsopgaver returnerer output_file-sti |
-| `resume` | string | Nej | Agent-ID der skal genoptages, fortsætter fra sidste udførelse. Nyttigt til at genoptage en tidligere sub-agent uden at miste kontekst |
-| `isolation` | enum | Nej | Isoleringstilstand, `worktree` opretter et midlertidigt git worktree |
-
-## Sub-agent-typer
-
-| Type | Formål | Tilgængelige værktøjer |
-|------|------|----------|
-| `Bash` | Kommandoudførelse, git-operationer | Bash |
-| `general-purpose` | Generelle flertrinsopgaver | Alle værktøjer |
-| `Explore` | Hurtig udforskning af kodebasen | Alle værktøjer undtagen Agent/Edit/Write/NotebookEdit/ExitPlanMode |
-| `Plan` | Design af implementeringsplan | Alle værktøjer undtagen Agent/Edit/Write/NotebookEdit/ExitPlanMode |
-| `claude-code-guide` | Q&A om Claude Code-brugsvejledning | Glob, Grep, Read, WebFetch, WebSearch |
-| `statusline-setup` | Konfiguration af statuslinje | Read, Edit |
-
-## Brugsscenarier
-
-**Egnet til:**
-- Komplekse opgaver der kræver selvstændig fuldførelse i flere trin
-- Udforskning af kodebasen og dybdegående research (brug Explore-type)
-- Parallelt arbejde der kræver isolerede miljøer
-- Langvarige opgaver der skal køre i baggrunden
-
-**Ikke egnet til:**
-- Læse en specifik filsti — brug direkte Read eller Glob
-- Søge i 2-3 kendte filer — brug direkte Read
-- Søge efter en specifik klassedefinition — brug direkte Glob
-
-## Bemærkninger
-
-- Ved fuldførelse returnerer sub-agenten en enkelt besked; dens resultat er ikke synligt for brugeren og skal videreformidles af hovedagenten
-- Man kan starte flere parallelle Agent-kald i en enkelt besked for at øge effektiviteten
-- Baggrundsopgaver overvåges via TaskOutput-værktøjet
-- Explore-typen er langsommere end direkte Glob/Grep-kald, brug den kun når simpel søgning ikke er tilstrækkelig
-- Brug `run_in_background: true` til langvarige opgaver der ikke kræver øjeblikkeligt resultat; brug forgrundstilstand (standard) når resultatet er nødvendigt før man fortsætter
-- `resume`-parameteren gør det muligt at fortsætte en tidligere startet sub-agent-session og bevare den akkumulerede kontekst
+- Åbne søgninger, hvor du endnu ikke ved, hvilke filer der er relevante, og forventer flere runder af `Glob`, `Grep` og `Read`.
+- Parallelt uafhængigt arbejde — start flere agenter i én besked for samtidigt at undersøge adskilte områder.
+- Isolering af støjende udforskning fra hovedsamtalen, så forældrekonteksten forbliver kompakt.
+- Delegering til en specialiseret underagenttype som `Explore`, `Plan`, `claude-code-guide` eller `statusline-setup`.
+- Indkaldelse af en navngivet holdkammerat til et aktivt team med henblik på koordineret multi-agent-arbejde.
 
-## Originaltekst
+Brug IKKE værktøjet, når målet (fil eller symbol) allerede er kendt — brug `Read`, `Grep` eller `Glob` direkte. Et opslag i et trin gennem `Agent` spilder et helt kontekstvindue og tilføjer latenstid.
 
-<textarea readonly>Launch a new agent to handle complex, multi-step tasks autonomously.
-
-The Agent tool launches specialized agents (subprocesses) that autonomously handle complex tasks. Each agent type has specific capabilities and tools available to it.
-
-Available agent types and the tools they have access to:
-- general-purpose: General-purpose agent for researching complex questions, searching for code, and executing multi-step tasks. When you are searching for a keyword or file and are not confident that you will find the right match in the first few tries use this agent to perform the search for you. (Tools: *)
-- statusline-setup: Use this agent to configure the user's Claude Code status line setting. (Tools: Read, Edit)
-- Explore: Fast agent specialized for exploring codebases. Use this when you need to quickly find files by patterns (eg. "src/components/**/*.tsx"), search code for keywords (eg. "API endpoints"), or answer questions about the codebase (eg. "how do API endpoints work?"). When calling this agent, specify the desired thoroughness level: "quick" for basic searches, "medium" for moderate exploration, or "very thorough" for comprehensive analysis across multiple locations and naming conventions. (Tools: All tools except Agent, ExitPlanMode, Edit, Write, NotebookEdit)
-- Plan: Software architect agent for designing implementation plans. Use this when you need to plan the implementation strategy for a task. Returns step-by-step plans, identifies critical files, and considers architectural trade-offs. (Tools: All tools except Agent, ExitPlanMode, Edit, Write, NotebookEdit)
-- claude-code-guide: Use this agent when the user asks questions ("Can Claude...", "Does Claude...", "How do I...") about: (1) Claude Code (the CLI tool) - features, hooks, slash commands, MCP servers, settings, IDE integrations, keyboard shortcuts; (2) Claude Agent SDK - building custom agents; (3) Claude API (formerly Anthropic API) - API usage, tool use, Anthropic SDK usage. **IMPORTANT:** Before spawning a new agent, check if there is already a running or recently completed claude-code-guide agent that you can resume using the "resume" parameter. (Tools: Glob, Grep, Read, WebFetch, WebSearch)
-
-When using the Agent tool, you must specify a subagent_type parameter to select which agent type to use.
-
-When NOT to use the Agent tool:
-- If you want to read a specific file path, use the Read or Glob tool instead of the Agent tool, to find the match more quickly
-- If you are searching for a specific class definition like "class Foo", use the Glob tool instead, to find the match more quickly
-- If you are searching for code within a specific file or set of 2-3 files, use the Read tool instead of the Agent tool, to find the match more quickly
-- Other tasks that are not related to the agent descriptions above
-
-Usage notes:
-- Always include a short description (3-5 words) summarizing what the agent will do
-- Launch multiple agents concurrently whenever possible, to maximize performance; to do that, use a single message with multiple tool uses
-- When the agent is done, it will return a single message back to you. The result returned by the agent is not visible to the user. To show the user the result, you should send a text message back to the user with a concise summary of the result.
-- You can optionally run agents in the background using the run_in_background parameter. When an agent runs in the background, you will be automatically notified when it completes — do NOT sleep, poll, or proactively check on its progress. Continue with other work or respond to the user instead.
-- **Foreground vs background**: Use foreground (default) when you need the agent's results before you can proceed — e.g., research agents whose findings inform your next steps. Use background when you have genuinely independent work to do in parallel.
-- Agents can be resumed using the `resume` parameter by passing the agent ID from a previous invocation. When resumed, the agent continues with its full previous context preserved. When NOT resuming, each invocation starts fresh and you should provide a detailed task description with all necessary context.
-- When the agent is done, it will return a single message back to you along with its agent ID. You can use this ID to resume the agent later if needed for follow-up work.
-- Provide clear, detailed prompts so the agent can work autonomously and return exactly the information you need.
-- Agents with "access to current context" can see the full conversation history before the tool call. When using these agents, you can write concise prompts that reference earlier context (e.g., "investigate the error discussed above") instead of repeating information. The agent will receive all prior messages and understand the context.
-- The agent's outputs should generally be trusted
-- Clearly tell the agent whether you expect it to write code or just to do research (search, file reads, web fetches, etc.), since it is not aware of the user's intent
-- If the agent description mentions that it should be used proactively, then you should try your best to use it without the user having to ask for it first. Use your judgement.
-- If the user specifies that they want you to run agents "in parallel", you MUST send a single message with multiple Agent tool use content blocks. For example, if you need to launch both a build-validator agent and a test-runner agent in parallel, send a single message with both tool calls.
-- You can optionally set `isolation: "worktree"` to run the agent in a temporary git worktree, giving it an isolated copy of the repository. The worktree is automatically cleaned up if the agent makes no changes; if changes are made, the worktree path and branch are returned in the result.
-
-Example usage:
-
-<example_agent_descriptions>
-"test-runner": use this agent after you are done writing code to run tests
-"greeting-responder": use this agent to respond to user greetings with a friendly joke
-</example_agent_descriptions>
-
-<example>
-user: "Please write a function that checks if a number is prime"
-assistant: Sure let me write a function that checks if a number is prime
-assistant: First let me use the Write tool to write a function that checks if a number is prime
-assistant: I'm going to use the Write tool to write the following code:
-<code>
-function isPrime(n) {
-  if (n <= 1) return false
-  for (let i = 2; i * i <= n; i++) {
-    if (n % i === 0) return false
-  }
-  return true
-}
-</code>
-<commentary>
-Since a significant piece of code was written and the task was completed, now use the test-runner agent to run the tests
-</commentary>
-assistant: Now let me use the test-runner agent to run the tests
-assistant: Uses the Agent tool to launch the test-runner agent
-</example>
+## Parametre
 
-<example>
-user: "Hello"
-<commentary>
-Since the user is greeting, use the greeting-responder agent to respond with a friendly joke
-</commentary>
-assistant: "I'm going to use the Agent tool to launch the greeting-responder agent"
-</example>
-</textarea>
+- `description` (string, påkrævet): Kort 3-5 ords etiket, der beskriver opgaven; vises i UI og logs.
+- `prompt` (string, påkrævet): Den fuldstændige, selvstændige briefing, agenten skal udføre. Skal indeholde al nødvendig kontekst, begrænsninger og det forventede returformat.
+- `subagent_type` (string, valgfri): Forudindstillet persona som `general-purpose`, `Explore`, `Plan`, `claude-code-guide` eller `statusline-setup`. Standard er `general-purpose`.
+- `run_in_background` (boolean, valgfri): Hvis true, kører agenten asynkront, og forælderen kan fortsætte arbejdet; resultaterne hentes senere.
+- `model` (string, valgfri): Tilsidesæt modellen for denne agent — `opus`, `sonnet` eller `haiku`. Standard er forældrens sessionmodel.
+- `isolation` (string, valgfri): Sæt til `worktree` for at køre agenten i et isoleret git-worktree, så dens filsystemskriverier ikke kolliderer med forælderen.
+- `team_name` (string, valgfri): Ved indkaldelse til et eksisterende team er dette team-identifikatoren, agenten slutter sig til.
+- `name` (string, valgfri): Adresserbart holdkammeratsnavn inden for teamet, brugt som `to`-mål for `SendMessage`.
+
+## Eksempler
+
+### Eksempel 1: Åben kodesøgning
+
+```
+Agent(
+  description="Find auth middleware",
+  subagent_type="Explore",
+  prompt="Locate every place in this repo where JWT verification is performed. Return a bulleted list of absolute file paths with a one-line note about each site's role. Do not modify any files."
+)
+```
+
+### Eksempel 2: Parallelle uafhængige undersøgelser
+
+Start to agenter i samme besked — én der inspicerer build-pipelinen, én der gennemgår testrammen. Hver får sit eget kontekstvindue og returnerer en opsummering. Batchning i en enkelt værktøjskaldsblok kører dem samtidigt.
+
+### Eksempel 3: Indkald en holdkammerat til et kørende team
+
+```
+Agent(
+  description="Data layer specialist",
+  team_name="refactor-crew",
+  name="db-lead",
+  prompt="You are db-lead on team refactor-crew. Audit all Prisma schema files and propose a migration plan. Use SendMessage to report findings to the team leader."
+)
+```
+
+## Noter
+
+- Agenter har ingen hukommelse af tidligere kørsler. Hver invokering starter fra nul, så `prompt` skal være fuldstændig selvstændig — medtag filstier, konventioner, spørgsmålet og den eksakte form på det svar, du vil have tilbage.
+- Agenten returnerer præcis én sidste besked. Den kan ikke stille afklarende spørgsmål midt i kørslen, så tvetydighed i prompten bliver til gætværk i resultatet.
+- At køre flere agenter parallelt er markant hurtigere end sekventielle kald, når deludgaverne er uafhængige. Batch dem i en enkelt værktøjskaldsblok.
+- Brug `isolation: "worktree"` når en agent skriver filer, og du vil gennemgå ændringerne, før de flettes ind i det primære arbejdstræ.
+- Foretræk `subagent_type: "Explore"` til skrivebeskyttet rekognoscering og `Plan` til designarbejde; `general-purpose` er standarden for blandede læse-/skriveopgaver.
+- Baggrundsagenter (`run_in_background: true`) egner sig til langtkørende jobs; undgå polling i en sleep-løkke — forælderen får besked ved afslutning.

package/concepts/da/Tool-AskUserQuestion.md

@@ -1,75 +1,60 @@
 # AskUserQuestion
 
-## Definition
+Præsenterer brugeren for et eller flere strukturerede multiple choice-spørgsmål i chat-grænsefladen, indsamler deres valg og returnerer dem til assistenten — nyttigt til at afklare intentioner uden frit formuleret frem og tilbage.
 
-Stiller spørgsmål til brugeren under udførelsen for at få afklaring, verificere antagelser eller anmode om beslutninger.
+## Hvornår skal den bruges
 
-## Parametre
-
-| Parameter | Type | Påkrævet | Beskrivelse |
-|------|------|------|------|
-| `questions` | array | Ja | Liste af spørgsmål (1-4 spørgsmål) |
-| `answers` | object | Nej | Svar indsamlet fra brugeren |
-| `annotations` | object | Nej | Annotationer for hvert spørgsmål (f.eks. noter til forhåndsvisning af valg) |
-| `metadata` | object | Nej | Metadata til sporing og analyse |
-
-Hvert `question`-objekt:
-
-| Felt | Type | Påkrævet | Beskrivelse |
-|------|------|------|------|
-| `question` | string | Ja | Komplet spørgsmålstekst, skal slutte med spørgsmålstegn |
-| `header` | string | Ja | Kort label (maks. 12 tegn), vises som label-chip |
-| `options` | array | Ja | 2-4 valgmuligheder |
-| `multiSelect` | boolean | Ja | Om flervalg er tilladt |
-
-Hvert `option`-objekt:
-
-| Felt | Type | Påkrævet | Beskrivelse |
-|------|------|------|------|
-| `label` | string | Ja | Visningstekst for valgmuligheden (1-5 ord) |
-| `description` | string | Ja | Beskrivelse af valgmuligheden |
-| `markdown` | string | Nej | Forhåndsvisningsindhold (til visuel sammenligning af ASCII-layout, kodestykker osv.) |
-
-## Brugsscenarier
-
-**Egnet til:**
-- Indsamling af brugerpræferencer eller krav
-- Afklaring af tvetydige instruktioner
-- Indhentning af beslutninger under implementering
-- Give brugeren retningsvalg
+- En anmodning har flere rimelige fortolkninger, og assistenten skal have brugeren til at vælge en, før der fortsættes.
+- Brugeren skal vælge mellem konkrete muligheder (framework, bibliotek, filsti, strategi), hvor fritekstsvar ville være fejlbehæftede.
+- Du vil sammenligne alternativer side om side ved hjælp af forhåndsvisningsruden.
+- Flere relaterede beslutninger kan batches til en enkelt forespørgsel for at reducere frem og tilbage.
+- En plan eller et værktøjskald afhænger af konfiguration, som brugeren endnu ikke har angivet.
 
-**Ikke egnet til:**
-- At spørge "er planen OK?" — brug ExitPlanMode
-
-## Bemærkninger
-
-- Brugeren kan altid vælge "Other" for at give brugerdefineret input
-- Den anbefalede valgmulighed placeres først med "(Recommended)" i slutningen af label
-- `markdown`-forhåndsvisning understøttes kun for enkeltvalgs-spørgsmål
-- Valgmuligheder med `markdown` skifter til side-om-side-layout
-- I planlægningstilstand bruges det til at afklare krav, før planen fastlægges
-
-## Originaltekst
-
-<textarea readonly>Use this tool when you need to ask the user questions during execution. This allows you to:
-1. Gather user preferences or requirements
-2. Clarify ambiguous instructions
-3. Get decisions on implementation choices as you work
-4. Offer choices to the user about what direction to take.
-
-Usage notes:
-- Users will always be able to select "Other" to provide custom text input
-- Use multiSelect: true to allow multiple answers to be selected for a question
-- If you recommend a specific option, make that the first option in the list and add "(Recommended)" at the end of the label
-
-Plan mode note: In plan mode, use this tool to clarify requirements or choose between approaches BEFORE finalizing your plan. Do NOT use this tool to ask "Is my plan ready?" or "Should I proceed?" - use ExitPlanMode for plan approval. IMPORTANT: Do not reference "the plan" in your questions (e.g., "Do you have feedback about the plan?", "Does the plan look good?") because the user cannot see the plan in the UI until you call ExitPlanMode. If you need plan approval, use ExitPlanMode instead.
-
-Preview feature:
-Use the optional `markdown` field on options when presenting concrete artifacts that users need to visually compare:
-- ASCII mockups of UI layouts or components
-- Code snippets showing different implementations
-- Diagram variations
-- Configuration examples
+## Parametre
 
-When any option has a markdown, the UI switches to a side-by-side layout with a vertical option list on the left and preview on the right. Do not use previews for simple preference questions where labels and descriptions suffice. Note: previews are only supported for single-select questions (not multiSelect).
-</textarea>
+- `questions` (array, påkrævet): Et til fire spørgsmål vist sammen i en enkelt forespørgsel. Hvert spørgsmålsobjekt indeholder:
+  - `question` (string, påkrævet): Den fulde spørgsmålstekst, der slutter med et spørgsmålstegn.
+  - `header` (string, påkrævet): En kort label (højst 12 tegn), der vises som et mærke over spørgsmålet.
+  - `options` (array, påkrævet): To til fire mulighedsobjekter. Hver mulighed har en `label` (1-5 ord), en `description` og en valgfri `markdown`-forhåndsvisning.
+  - `multiSelect` (boolean, påkrævet): Når `true`, kan brugeren vælge mere end én mulighed.
+
+## Eksempler
+
+### Eksempel 1: Vælg et enkelt framework
+
+```
+AskUserQuestion(questions=[{
+  "header": "Test runner",
+  "question": "Which test runner should I configure?",
+  "multiSelect": false,
+  "options": [
+    {"label": "Vitest (Recommended)", "description": "Fast, Vite-native, Jest-compatible API"},
+    {"label": "Jest",                  "description": "Mature, broadest plugin ecosystem"},
+    {"label": "Node --test",           "description": "Zero dependencies, built in"}
+  ]
+}])
+```
+
+### Eksempel 2: Side om side-forhåndsvisning af to layouts
+
+```
+AskUserQuestion(questions=[{
+  "header": "Layout",
+  "question": "Which dashboard layout do you prefer?",
+  "multiSelect": false,
+  "options": [
+    {"label": "Sidebar",  "description": "Nav on the left", "markdown": "```\n+------+---------+\n| NAV  | CONTENT |\n+------+---------+\n```"},
+    {"label": "Top bar",  "description": "Nav across top",  "markdown": "```\n+-----------------+\n|       NAV       |\n+-----------------+\n|     CONTENT     |\n+-----------------+\n```"}
+  ]
+}])
+```
+
+## Noter
+
+- UI tilføjer automatisk en "Other"-fritekstindstilling til hvert spørgsmål. Tilføj ikke din egen "Other", "None" eller "Custom"-post — det vil duplikere den indbyggede nødudgang.
+- Begræns hvert kald til mellem et og fire spørgsmål og hvert spørgsmål til mellem to og fire muligheder. Overskridelse af disse grænser afvises af rammen.
+- Hvis du anbefaler en specifik mulighed, sæt den først og tilføj "(Recommended)" til dens label, så UI fremhæver den foretrukne sti.
+- Forhåndsvisninger via `markdown`-feltet understøttes kun på single-select-spørgsmål. Brug dem til visuelle artefakter som ASCII-layouts, kodestumper eller konfigurationsdiffs — ikke til simple præferencespørgsmål, hvor en label plus beskrivelse er tilstrækkelig.
+- Når en vilkårlig mulighed i et spørgsmål har en `markdown`-værdi, skifter UI til et side om side-layout med mulighedslisten til venstre og forhåndsvisningen til højre.
+- Brug ikke `AskUserQuestion` til at spørge "ser denne plan god ud?" — kald i stedet `ExitPlanMode`, som netop findes til plangodkendelse. I plantilstand bør du også undgå at nævne "planen" i spørgsmålsteksten, fordi planen ikke er synlig for brugeren, før `ExitPlanMode` kører.
+- Brug ikke dette værktøj til at anmode om følsomt eller fritformuleret input som API-nøgler eller adgangskoder. Spørg i stedet i chatten.