cc-viewer 1.6.182 → 1.6.183

package/concepts/uk/Tool-ScheduleWakeup.md

@@ -0,0 +1,56 @@
+# ScheduleWakeup
+
+Планує, коли відновити роботу в динамічному режимі `/loop`. Інструмент дозволяє Claude самостійно керувати темпом ітерацій завдання, засинаючи на вибраний інтервал, а потім знову запускаючись з тим самим промптом циклу.
+
+## Коли використовувати
+
+- При самостійному управлінні темпом динамічного завдання `/loop`, де інтервал ітерацій залежить від стану роботи, а не від фіксованого таймера
+- При очікуванні завершення тривалої збірки, розгортання або запуску тестів перед перевіркою результатів
+- При вставці холостих тіків між ітераціями, коли немає конкретного сигналу для моніторингу в даний момент
+- При запуску автономного циклу без промпту користувача — передати буквальний sentinel `<<autonomous-loop-dynamic>>` як `prompt`
+- При опитуванні процесу, стан якого ось-ось зміниться (використовувати короткий затримку для підтримання кешу в теплому стані)
+
+## Параметри
+
+- `delaySeconds` (число, обов'язкове): Секунди до відновлення. Середовище виконання автоматично обмежує значення до `[60, 3600]`, тому ручне обмеження не потрібне.
+- `reason` (рядок, обов'язковий): Одне коротке речення, що пояснює вибрану затримку. Відображається користувачеві і записується в телеметрію. Будьте конкретні — «перевіряю тривалу збірку bun» корисніше, ніж «очікування».
+- `prompt` (рядок, обов'язковий): Вхідні дані `/loop` для запуску при пробудженні. Передавати той самий рядок у кожному ході, щоб наступний запуск повторив завдання. Для автономного циклу без промпту користувача передати буквальний sentinel `<<autonomous-loop-dynamic>>`.
+
+## Приклади
+
+### Приклад 1: коротка затримка для повторної перевірки сигналу, що швидко змінюється (підтримання кешу в теплому стані)
+
+Збірка щойно запущена і зазвичай завершується за дві-три хвилини.
+
+```json
+{
+  "delaySeconds": 120,
+  "reason": "перевіряю збірку bun, очікуване завершення через ~2 хв",
+  "prompt": "перевірити статус збірки та повідомити про помилки"
+}
+```
+
+120 секунд зберігає контекст розмови в кеші промптів Anthropic (TTL 5 хв), тому наступне пробудження відбувається швидше і дешевше.
+
+### Приклад 2: тривалий холостий тік (прийняти промах кешу, амортизувати на тривалішому очікуванні)
+
+Міграція бази даних виконується і зазвичай займає 20–40 хвилин.
+
+```json
+{
+  "delaySeconds": 1200,
+  "reason": "міграція зазвичай займає 20–40 хв; перевіряю через 20 хв",
+  "prompt": "перевірити статус міграції та продовжити якщо завершена"
+}
+```
+
+При пробудженні кеш буде холодним, але 20-хвилинне очікування з надлишком амортизує вартість одного промаху. Опитування кожні 5 хвилин платитиме ту саму ціну промаху 4 рази без будь-якої вигоди.
+
+## Примітки
+
+- **TTL кешу 5 хвилин**: Кеш промптів Anthropic закінчується через 300 секунд. Затримки менше 300 с зберігають контекст теплим; затримки більше 300 с призводять до промаху кешу при наступному пробудженні.
+- **Уникайте рівно 300 с**: Це найгірший варіант з обох світів — ви платите за промах кешу, не отримуючи при цьому суттєво тривалішого очікування. Або знизьте до 270 с (зберегти теплий кеш), або зафіксуйте 1200 с або більше (один промах забезпечує значно триваліше очікування).
+- **Значення за замовчуванням для холостих тіків**: Коли немає конкретного сигналу для моніторингу, використовуйте **1200–1800 с** (20–30 хв). Це дозволяє циклу перевіряти періодично, не спалюючи кеш 12 разів на годину без причини.
+- **Автоматичне обмеження**: Середовище виконання обмежує `delaySeconds` до `[60, 3600]`. Значення нижче 60 стають 60; значення вище 3600 стають 3600. Не потрібно самостійно обробляти ці межі.
+- **Пропустити виклик для завершення циклу**: Якщо ви маєте намір зупинити ітерації, не викликайте ScheduleWakeup. Просте пропущення виклику завершує цикл.
+- **Передавати той самий `prompt` у кожному ході**: Поле `prompt` повинно містити оригінальну інструкцію `/loop` при кожному виклику, щоб наступне пробудження знало, яке завдання відновити.

package/concepts/uk/Tool-SendMessage.md

@@ -1,41 +1,68 @@
 # SendMessage
 
-## Визначення
+Доставляє повідомлення від одного члена команди іншому в активній команді або транслює його всім членам одразу. Це єдиний канал, який члени команди чують — усе, записане у звичайний текстовий вивід, невидиме для них.
 
-Надсилає повідомлення між агентами всередині команди. Використовується для прямого спілкування, широкомовного розсилання та протокольних повідомлень (запити/відповіді на завершення, затвердження планів).
+## Коли використовувати
+
+- Призначення завдання чи передача підзадачі іменованому члену команди під час командної співпраці.
+- Запит статусу, проміжних висновків чи огляду коду від іншого агента.
+- Трансляція рішення, спільного обмеження чи оголошення завершення всій команді через `*`.
+- Відповідь на протокольний запит, такий як запит на завершення роботи чи запит на затвердження плану від лідера команди.
+- Замикання циклу наприкінці делегованого завдання, щоб лідер міг позначити пункт як виконаний.
 
 ## Параметри
 
-| Параметр | Тип | Обов'язковий | Опис |
-|----------|-----|--------------|------|
-| `to` | string | Так | Одержувач: ім'я учасника або `"*"` для розсилання всім |
-| `message` | string / object | Так | Текстове повідомлення або структурований протокольний об'єкт |
-| `summary` | string | Ні | Попередній перегляд з 5-10 слів, що відображається в інтерфейсі |
+- `to` (string, обовʼязковий): `name` цільового члена команди, як зареєстровано в команді, або `*` для трансляції всім членам команди одразу.
+- `message` (string або object, обовʼязковий): Простий текст для звичайної комунікації або структурований обʼєкт для протокольних відповідей, таких як `shutdown_response` та `plan_approval_response`.
+- `summary` (string, необовʼязковий): Превʼю з 5–10 слів, показане в журналі активності команди для текстових повідомлень. Обовʼязковий для довгих рядкових повідомлень; ігнорується, коли `message` є протокольним обʼєктом.
+
+## Приклади
+
+### Приклад 1: Пряма передача завдання
+
+```
+SendMessage(
+  to="db-lead",
+  message="Please audit prisma/schema.prisma and list any model missing createdAt/updatedAt timestamps. Reply when done.",
+  summary="Audit schema for missing timestamps"
+)
+```
 
-## Типи повідомлень
+### Приклад 2: Трансляція спільного обмеження
 
-### Текст
-Прямі повідомлення між учасниками команди для координації, оновлення статусу та обговорення завдань.
+```
+SendMessage(
+  to="*",
+  message="Reminder: do not touch files under legacy/ — that subtree is frozen until the migration PR lands.",
+  summary="Freeze legacy/ during migration"
+)
+```
 
-### Запит на завершення
-Просить учасника коректно завершити роботу: `{ type: "shutdown_request", reason: "..." }`
+### Приклад 3: Протокольна відповідь
 
-### Відповідь на завершення
-Учасник схвалює або відхиляє завершення: `{ type: "shutdown_response", approve: true/false }`
+Відповідайте на запит завершення роботи від лідера, використовуючи структуроване повідомлення:
 
-### Відповідь на затвердження плану
-Схвалює або відхиляє план учасника: `{ type: "plan_approval_response", approve: true/false }`
+```
+SendMessage(
+  to="leader",
+  message={ "type": "shutdown_response", "ready": true, "final_report": "All assigned diff chunks committed on branch refactor-crew/db-lead." }
+)
+```
 
-## Широкомовне vs. пряме
+### Приклад 4: Відповідь на затвердження плану
 
-- **Пряме** (`to: "ім'я-учасника"`): Надіслати конкретному учаснику — бажано для більшості комунікацій
-- **Широкомовне** (`to: "*"`): Надіслати всім учасникам — використовувати обережно, лише для критичних командних оголошень
+```
+SendMessage(
+  to="leader",
+  message={ "type": "plan_approval_response", "approved": true, "notes": "LGTM, but please split step 4 into migration + backfill." }
+)
+```
 
-## Пов'язані інструменти
+## Примітки
 
-| Інструмент | Призначення |
-|------------|-------------|
-| `TeamCreate` | Створити нову команду |
-| `TeamDelete` | Видалити команду після завершення |
-| `Agent` | Запустити учасників, які приєднуються до команди |
-| `TaskCreate` / `TaskUpdate` / `TaskList` | Управління спільним списком завдань |
+- Ваш звичайний текстовий вивід асистента НЕ передається членам команди. Якщо ви хочете, щоб інший агент щось побачив, це має пройти через `SendMessage`. Це найпоширеніша помилка в командних робочих процесах.
+- Трансляція (`to: "*"`) дорога — вона будить кожного члена команди та споживає їхній контекст. Резервуйте її для оголошень, які справді стосуються всіх. Віддавайте перевагу цілеспрямованим надсиланням.
+- Тримайте повідомлення лаконічними та орієнтованими на дії. Включайте шляхи файлів, обмеження та очікуваний формат відповіді, які потрібні отримувачу; памʼятайте, вони не мають спільної памʼяті з вами.
+- Обʼєкти протокольних повідомлень (`shutdown_response`, `plan_approval_response`) мають фіксовані форми. Не змішуйте протокольні поля з текстовими повідомленнями чи навпаки.
+- Повідомлення асинхронні. Отримувач отримає ваше на своєму наступному кроці; не припускайте, що він прочитав чи діяв на нього, доки він не відповість.
+- Добре написаний `summary` робить журнал активності команди придатним для швидкого перегляду лідером — ставтеся до нього як до рядка теми коміту.

package/concepts/uk/Tool-Skill.md

@@ -1,56 +1,47 @@
 # Skill
 
-## Визначення
+Викликає іменовану навичку (skill) всередині поточної розмови. Навички — це попередньо спаковані пакети можливостей — доменні знання, робочі процеси та іноді доступ до інструментів — які оболонка надає асистенту через системні нагадування.
 
-Виконує навичку (skill) в основній розмові. Навички — це спеціалізовані можливості, які користувач може викликати через slash command (наприклад, `/commit`, `/review-pr`).
+## Коли використовувати
 
-## Параметри
+- Користувач вводить слеш-команду, таку як `/review` чи `/init` — слеш-команди є навичками і повинні виконуватися через цей інструмент.
+- Користувач описує завдання, що відповідає умовам активації оголошеної навички (наприклад, запит сканувати транскрипти на повторювані запити дозволу відповідає `fewer-permission-prompts`).
+- Заявлена мета навички є прямим збігом з поточним файлом, запитом чи контекстом розмови.
+- Доступні спеціалізовані, повторювані робочі процеси у вигляді навичок, і канонічна процедура є кращою за ad-hoc підхід.
+- Користувач запитує "які навички доступні" — перелічіть оголошені імена та викликайте лише після підтвердження.
 
-| Параметр | Тип | Обов'язковий | Опис |
-|----------|-----|--------------|------|
-| `skill` | string | Так | Назва навички (наприклад, "commit", "review-pr", "pdf") |
-| `args` | string | Ні | Параметри навички |
+## Параметри
 
-## Сценарії використання
+- `skill` (string, обовʼязковий): Точне імʼя навички, перелічене в поточному системному нагадуванні доступних навичок. Для навичок з простору імен плагіна використовуйте повністю кваліфіковану форму `plugin:skill` (наприклад, `skill-creator:skill-creator`). Не включайте провідну косу риску.
+- `args` (string, необовʼязковий): Довільні аргументи, передані навичці. Формат і семантика визначаються документацією кожної навички.
 
-**Підходить для:**
-- Користувач ввів slash command у форматі `/<skill-name>`
-- Запит користувача відповідає функціональності зареєстрованої навички
+## Приклади
 
-**Не підходить для:**
-- Вбудовані CLI-команди (наприклад, `/help`, `/clear`)
-- Навичка, що вже виконується
-- Назви навичок, яких немає у списку доступних
+### Приклад 1: Запуск навички огляду на поточній гілці
 
-## Примітки
+```
+Skill(skill="review")
+```
 
-- Після виклику навичка розгортається у повний prompt
-- Підтримуються повні кваліфіковані назви (наприклад, `ms-office-suite:pdf`)
-- Список доступних навичок надається в повідомленнях system-reminder
-- Коли видно тег `<command-name>`, навичка вже завантажена — слід виконувати безпосередньо, а не викликати цей інструмент знову
-- Не згадуйте навичку, не викликавши інструмент фактично
+Навичка `review` пакує кроки для огляду pull request відносно поточної базової гілки. Її виклик завантажує визначену оболонкою процедуру огляду в поточний крок.
 
-## Оригінальний текст
+### Приклад 2: Виклик навички з простору імен плагіна з аргументами
 
-<textarea readonly>Execute a skill within the main conversation
+```
+Skill(
+  skill="skill-creator:skill-creator",
+  args="create a skill that summarizes git log for a given date range"
+)
+```
 
-When users ask you to perform tasks, check if any of the available skills match. Skills provide specialized capabilities and domain knowledge.
+Маршрутизує запит через точку входу плагіна `skill-creator`, щоб запустився робочий процес створення.
 
-When users reference a "slash command" or "/<something>" (e.g., "/commit", "/review-pr"), they are referring to a skill. Use this tool to invoke it.
-
-How to invoke:
-- Use this tool with the skill name and optional arguments
-- Examples:
-  - `skill: "pdf"` - invoke the pdf skill
-  - `skill: "commit", args: "-m 'Fix bug'"` - invoke with arguments
-  - `skill: "review-pr", args: "123"` - invoke with arguments
-  - `skill: "ms-office-suite:pdf"` - invoke using fully qualified name
+## Примітки
 
-Important:
-- Available skills are listed in system-reminder messages in the conversation
-- When a skill matches the user's request, this is a BLOCKING REQUIREMENT: invoke the relevant Skill tool BEFORE generating any other response about the task
-- NEVER mention a skill without actually calling this tool
-- Do not invoke a skill that is already running
-- Do not use this tool for built-in CLI commands (like /help, /clear, etc.)
-- If you see a <command-name> tag in the current conversation turn, the skill has ALREADY been loaded - follow the instructions directly instead of calling this tool again
-</textarea>
+- Викликайте лише навички, імена яких зʼявляються буквально в системному нагадуванні доступних навичок, або навички, які користувач ввів безпосередньо як `/name` у своєму повідомленні. Ніколи не вгадуйте та не вигадуйте імена навичок з памʼяті чи даних навчання — якщо навичка не оголошена, не викликайте цей інструмент.
+- Коли запит користувача відповідає оголошеній навичці, виклик `Skill` є блокуючою передумовою: викликайте її перед генерацією будь-якої іншої відповіді про завдання. Не описуйте, що робитиме навичка — запускайте її.
+- Ніколи не згадуйте навичку за імʼям, не викликаючи її насправді. Оголошення навички без виклику інструмента вводить в оману.
+- Не використовуйте `Skill` для вбудованих команд CLI, таких як `/help`, `/clear`, `/model` чи `/exit`. Вони обробляються оболонкою безпосередньо.
+- Не викликайте повторно навичку, яка вже виконується в поточному кроці. Якщо ви бачите тег `<command-name>` у поточному кроці, навичка вже завантажена — виконуйте її інструкції на місці замість повторного виклику інструмента.
+- Якщо кілька навичок могли б застосуватися, оберіть найспецифічнішу. Для змін конфігурації, таких як додавання дозволів чи хуків, віддавайте перевагу `update-config` над загальним підходом до налаштувань.
+- Виконання навички може вводити нові системні нагадування, інструменти чи обмеження до кінця кроку. Перечитайте стан розмови після завершення навички перед продовженням.

package/concepts/uk/Tool-TaskCreate.md

@@ -1,78 +1,56 @@
 # TaskCreate
 
-## Визначення
+Створює нове завдання в списку завдань поточної команди (або в списку завдань сесії, коли команда не активна). Використовуйте для захоплення робочих пунктів, які слід відстежувати, делегувати чи повертатися до них пізніше.
 
-Створює запис структурованого списку завдань для відстеження прогресу, організації складних завдань та демонстрації ходу роботи користувачу.
+## Коли використовувати
 
-## Параметри
-
-| Параметр | Тип | Обов'язковий | Опис |
-|----------|-----|--------------|------|
-| `subject` | string | Так | Короткий заголовок завдання, використовується наказовий спосіб (наприклад, "Fix authentication bug") |
-| `description` | string | Так | Детальний опис, включаючи контекст та критерії прийняття |
-| `activeForm` | string | Ні | Текст у теперішньому тривалому часі, що відображається під час виконання (наприклад, "Fixing authentication bug") |
-| `metadata` | object | Ні | Довільні метадані, прикріплені до завдання |
-
-## Сценарії використання
-
-**Підходить для:**
-- Складні багатокрокові завдання (більше 3 кроків)
-- Користувач надав кілька справ для виконання
-- Відстеження роботи в режимі планування
-- Користувач явно просить використовувати список todo
-
-**Не підходить для:**
-- Одне просте завдання
-- Прості операції менш ніж за 3 кроки
-- Суто розмова або інформаційний запит
+- Користувач описує багатоетапну роботу, що виграє від явного відстеження.
+- Ви розбиваєте великий запит на менші, окремо завершувані одиниці.
+- Продовження виявлено посеред завдання і його не слід забути.
+- Вам потрібен стійкий запис наміру перед передачею роботи члену команди чи підагенту.
+- Ви працюєте в режимі плану і хочете, щоб кожен крок плану був представлений як конкретне завдання.
 
-## Примітки
-
-- Усі нові завдання мають початковий статус `pending`
-- `subject` використовує наказовий спосіб ("Run tests"), `activeForm` — теперішній тривалий час ("Running tests")
-- Після створення можна встановити залежності (blocks/blockedBy) через TaskUpdate
-- Перед створенням слід перевірити наявність дублікатів через TaskList
-
-## Оригінальний текст
+Пропустіть `TaskCreate` для тривіальних одноразових дій, чистої розмови чи будь-чого, що можна виконати за два-три прямі виклики інструментів.
 
-<textarea readonly>Use this tool to create a structured task list for your current coding session. This helps you track progress, organize complex tasks, and demonstrate thoroughness to the user.
-It also helps the user understand the progress of the task and overall progress of their requests.
+## Параметри
 
-## When to Use This Tool
+- `subject` (string, обовʼязковий): Короткий імперативний заголовок, наприклад `Fix login redirect on Safari`. Тримайте його приблизно до восьмидесяти символів.
+- `description` (string, обовʼязковий): Детальний контекст — проблема, обмеження, критерії прийому та будь-які файли чи посилання, які знадобляться майбутньому читачеві. Пишіть так, наче член команди візьметься за це з нуля.
+- `activeForm` (string, необовʼязковий): Текст індикатора в теперішньому тривалому часі, показаний, поки завдання має статус `in_progress`, наприклад `Fixing login redirect on Safari`. Повторіть `subject`, але у формі на -ing.
+- `metadata` (object, необовʼязковий): Довільні структуровані дані, прикріплені до завдання. Типові застосування: мітки, підказки пріоритету, ID зовнішніх тикетів чи специфічна для агента конфігурація.
 
-Use this tool proactively in these scenarios:
+Новостворені завдання завжди починаються зі статусом `pending` без власника. Залежності (`blocks`, `blockedBy`) не встановлюються під час створення — застосовуйте їх пізніше через `TaskUpdate`.
 
-- Complex multi-step tasks - When a task requires 3 or more distinct steps or actions
-- Non-trivial and complex tasks - Tasks that require careful planning or multiple operations
-- Plan mode - When using plan mode, create a task list to track the work
-- User explicitly requests todo list - When the user directly asks you to use the todo list
-- User provides multiple tasks - When users provide a list of things to be done (numbered or comma-separated)
-- After receiving new instructions - Immediately capture user requirements as tasks
-- When you start working on a task - Mark it as in_progress BEFORE beginning work
-- After completing a task - Mark it as completed and add any new follow-up tasks discovered during implementation
+## Приклади
 
-## When NOT to Use This Tool
+### Приклад 1
 
-Skip using this tool when:
-- There is only a single, straightforward task
-- The task is trivial and tracking it provides no organizational benefit
-- The task can be completed in less than 3 trivial steps
-- The task is purely conversational or informational
+Захоплення повідомлення про помилку, щойно поданого користувачем.
 
-NOTE that you should not use this tool if there is only one trivial task to do. In this case you are better off just doing the task directly.
+```
+TaskCreate(
+  subject: "Repair broken PDF export on Windows",
+  description: "Users on Windows 11 report the export button produces a 0-byte file. Reproduce with sample doc in test/fixtures/export/, then fix the code path in src/export/pdf.ts. Acceptance: export writes a valid PDF and the existing export test suite passes.",
+  activeForm: "Repairing broken PDF export on Windows"
+)
+```
 
-## Task Fields
+### Приклад 2
 
-- **subject**: A brief, actionable title in imperative form (e.g., "Fix authentication bug in login flow")
-- **description**: Detailed description of what needs to be done, including context and acceptance criteria
-- **activeForm**: Present continuous form shown in spinner when task is in_progress (e.g., "Fixing authentication bug"). This is displayed to the user while you work on the task.
+Розділіть епік на відстежувані одиниці на початку сесії.
 
-**IMPORTANT**: Always provide activeForm when creating tasks. The subject should be imperative ("Run tests") while activeForm should be present continuous ("Running tests"). All tasks are created with status `pending`.
+```
+TaskCreate(
+  subject: "Draft migration plan for auth service",
+  description: "Produce a written plan covering rollout stages, rollback strategy, and monitoring. Output: docs/auth-migration.md.",
+  activeForm: "Drafting migration plan for auth service",
+  metadata: { "priority": "P1", "linearId": "AUTH-214" }
+)
+```
 
-## Tips
+## Примітки
 
-- Create tasks with clear, specific subjects that describe the outcome
-- Include enough detail in the description for another agent to understand and complete the task
-- After creating tasks, use TaskUpdate to set up dependencies (blocks/blockedBy) if needed
-- Check TaskList first to avoid creating duplicate tasks
-</textarea>
+- Пишіть `subject` в імперативному стилі, а `activeForm` у теперішньому тривалому, щоб UI читався природно, коли завдання переходить у `in_progress`.
+- Викликайте `TaskList` перед створенням, щоб уникнути дублікатів — список команди спільний з членами команди та підагентами.
+- Не включайте секрети чи облікові дані в `description` чи `metadata`; записи завдань видимі кожному, хто має доступ до команди.
+- Після створення перемещуйте завдання через його життєвий цикл через `TaskUpdate`. Не залишайте роботу мовчки покинутою в `in_progress`.

package/concepts/uk/Tool-TaskGet.md

@@ -1,56 +1,47 @@
 # TaskGet
 
-## Визначення
+Отримує повний запис одного завдання за ID, включно з його описом, поточним статусом, власником, метаданими та ребрами залежностей. Використовуйте, коли підсумок, повернутий `TaskList`, недостатній для дії із завданням.
 
-Отримує повні деталі завдання за його ID.
+## Коли використовувати
 
-## Параметри
-
-| Параметр | Тип | Обов'язковий | Опис |
-|----------|-----|--------------|------|
-| `taskId` | string | Так | ID завдання для отримання |
-
-## Вміст відповіді
+- Ви вибрали завдання з `TaskList` і потребуєте повного опису перед початком роботи.
+- Ви збираєтеся позначити завдання як `completed` і хочете перевірити критерії прийому ще раз.
+- Вам потрібно перевірити, які завдання це блокує (`blocks`) або ким воно заблоковане (`blockedBy`), щоб вирішити наступний крок.
+- Ви досліджуєте історію — хто ним володіє, які метадані були прикріплені, коли воно змінювало стан.
+- Член команди чи попередня сесія посилалися на ID завдання, і вам потрібен контекст.
 
-- `subject` — Заголовок завдання
-- `description` — Детальні вимоги та контекст
-- `status` — Статус: `pending`, `in_progress` або `completed`
-- `blocks` — Список завдань, заблокованих цим завданням
-- `blockedBy` — Список попередніх завдань, що блокують це завдання
+Віддавайте перевагу `TaskList`, коли вам потрібен лише високорівневий огляд; резервуйте `TaskGet` для конкретного запису, який ви маєте намір уважно прочитати чи модифікувати.
 
-## Сценарії використання
+## Параметри
 
-**Підходить для:**
-- Отримання повного опису та контексту завдання перед початком роботи
-- Розуміння залежностей завдання
-- Отримання повних вимог після призначення завдання
+- `taskId` (string, обовʼязковий): Ідентифікатор завдання, повернутий `TaskCreate` чи `TaskList`. ID стабільні протягом усього життя завдання.
 
-## Примітки
+## Приклади
 
-- Після отримання завдання слід перевірити, чи порожній список `blockedBy`, перш ніж починати роботу
-- Використовуйте TaskList для перегляду зведеної інформації про всі завдання
+### Приклад 1
 
-## Оригінальний текст
+Перегляд завдання, яке ви щойно побачили в списку.
 
-<textarea readonly>Use this tool to retrieve a task by its ID from the task list.
+```
+TaskGet(taskId: "t_01HXYZ...")
+```
 
-## When to Use This Tool
+Типові поля відповіді: `id`, `subject`, `description`, `activeForm`, `status`, `owner`, `blocks`, `blockedBy`, `metadata`, `createdAt`, `updatedAt`.
 
-- When you need the full description and context before starting work on a task
-- To understand task dependencies (what it blocks, what blocks it)
-- After being assigned a task, to get complete requirements
+### Приклад 2
 
-## Output
+Розвʼяжіть залежності перед початком.
 
-Returns full task details:
-- **subject**: Task title
-- **description**: Detailed requirements and context
-- **status**: 'pending', 'in_progress', or 'completed'
-- **blocks**: Tasks waiting on this one to complete
-- **blockedBy**: Tasks that must complete before this one can start
+```
+TaskGet(taskId: "t_01HXYZ...")
+# Перевірте blockedBy — якщо будь-яке посилане завдання все ще pending
+# або in_progress, спочатку працюйте над блокатором.
+```
 
-## Tips
+## Примітки
 
-- After fetching a task, verify its blockedBy list is empty before beginning work.
-- Use TaskList to see all tasks in summary form.
-</textarea>
+- `TaskGet` лише для читання і безпечний для багаторазового виклику; він не змінює статус чи власника.
+- Якщо `blockedBy` не порожній і містить завдання, які не `completed`, не починайте це завдання — спочатку розвʼяжіть блокатори (або скоординуйтеся з їхнім власником).
+- Поле `description` може бути довгим. Прочитайте його повністю перед діями; перегляд по діагоналі призводить до пропущених критеріїв прийому.
+- Невідомий чи видалений `taskId` повертає помилку. Перезапустіть `TaskList`, щоб вибрати поточний ID.
+- Якщо ви збираєтеся редагувати завдання, спочатку викличте `TaskGet`, щоб уникнути перезапису полів, які член команди щойно змінив.

package/concepts/uk/Tool-TaskList.md

@@ -1,56 +1,62 @@
 # TaskList
 
-## Визначення
+Повертає кожне завдання в поточній команді (або сесії) у підсумковій формі. Використовуйте для огляду невиконаної роботи, вирішення, що взяти далі, та уникнення дублікатів.
 
-Перелічує всі завдання у списку завдань, переглядає загальний прогрес та доступну роботу.
+## Коли використовувати
+
+- На початку сесії, щоб побачити, що вже відстежується.
+- Перед викликом `TaskCreate`, щоб підтвердити, що робота ще не захоплена.
+- Коли вирішуєте, яке завдання взяти наступним як член команди чи підагент.
+- Щоб одним поглядом перевірити відносини залежностей по команді.
+- Періодично під час довгих сесій, щоб ресинхронізуватися з членами команди, які могли взяти, завершити чи додати завдання.
+
+`TaskList` лише для читання і дешевий; викликайте його вільно щоразу, коли вам потрібен огляд.
 
 ## Параметри
 
-Без параметрів.
+`TaskList` не приймає параметрів. Він завжди повертає повний набір завдань для активного контексту.
 
-## Вміст відповіді
+## Форма відповіді
 
-Зведена інформація по кожному завданню:
-- `id` — Ідентифікатор завдання
-- `subject` — Короткий опис
-- `status` — Статус: `pending`, `in_progress` або `completed`
-- `owner` — Відповідальний (agent ID), порожнє означає не призначено
-- `blockedBy` — Список ID незавершених завдань, що блокують це завдання
+Кожне завдання в списку — підсумок, а не повний запис. Очікуйте приблизно:
 
-## Сценарії використання
+- `id` — стабільний ідентифікатор для використання з `TaskGet` / `TaskUpdate`.
+- `subject` — короткий імперативний заголовок.
+- `status` — один з `pending`, `in_progress`, `completed`, `deleted`.
+- `owner` — дескриптор агента чи члена команди або порожній, коли не захоплено.
+- `blockedBy` — масив ID завдань, які мають завершитися першими.
 
-**Підходить для:**
-- Перегляд доступних завдань (статус pending, без owner, не заблоковані)
-- Перевірка загального прогресу проєкту
-- Пошук заблокованих завдань
-- Пошук наступного завдання після завершення поточного
+Для повного опису, критеріїв прийому чи метаданих конкретного завдання продовжте `TaskGet`.
 
-## Примітки
+## Приклади
 
-- Надавайте перевагу обробці завдань у порядку ID (найменший ID першим), оскільки ранні завдання зазвичай надають контекст для наступних
-- Завдання з `blockedBy` не можна брати до зняття залежності
-- Використовуйте TaskGet для отримання повних деталей конкретного завдання
+### Приклад 1
 
-## Оригінальний текст
+Швидка перевірка статусу.
 
-<textarea readonly>Use this tool to list all tasks in the task list.
+```
+TaskList()
+```
 
-## When to Use This Tool
+Проскануйте вивід на будь-що `in_progress` без `owner` (застаріла робота) і будь-що `pending` з порожнім `blockedBy` (готове для взяття).
 
-- To see what tasks are available to work on (status: 'pending', no owner, not blocked)
-- To check overall progress on the project
-- To find tasks that are blocked and need dependencies resolved
-- After completing a task, to check for newly unblocked work or claim the next available task
-- **Prefer working on tasks in ID order** (lowest ID first) when multiple tasks are available, as earlier tasks often set up context for later ones
+### Приклад 2
 
-## Output
+Член команди вибирає наступне завдання.
 
-Returns a summary of each task:
-- **id**: Task identifier (use with TaskGet, TaskUpdate)
-- **subject**: Brief description of the task
-- **status**: 'pending', 'in_progress', or 'completed'
-- **owner**: Agent ID if assigned, empty if available
-- **blockedBy**: List of open task IDs that must be resolved first (tasks with blockedBy cannot be claimed until dependencies resolve)
+```
+TaskList()
+# Фільтруйте до: status == pending AND blockedBy порожній AND owner порожній.
+# Серед них віддавайте перевагу меншому ID (завдання зазвичай нумеруються
+# у порядку створення, тож менші ID старіші і зазвичай вищого пріоритету).
+TaskGet(taskId: "<chosen id>")
+TaskUpdate(taskId: "<chosen id>", status: "in_progress", owner: "<your handle>")
+```
+
+## Примітки
 
-Use TaskGet with a specific task ID to view full details including description and comments.
-</textarea>
+- Евристика члена команди: коли кілька `pending` завдань розблоковані й не захоплені, вибирайте найменший ID. Це зберігає роботу FIFO і уникає того, щоб два агенти хапали одне й те саме гучне завдання.
+- Поважайте `blockedBy`: не починайте завдання, блокатори якого все ще `pending` чи `in_progress`. Спочатку працюйте над блокатором або скоординуйтеся з його власником.
+- `TaskList` — єдиний механізм виявлення завдань. Немає пошуку; якщо список довгий, скануйте структурно (за статусом, потім за власником).
+- Видалені завдання можуть все ще зʼявлятися в списку зі статусом `deleted` для простеження. Ігноруйте їх для цілей планування.
+- Список відображає живий стан команди, тому члени команди можуть додавати чи захоплювати завдання між викликами. Перелічіть знову перед захопленням, якщо минув час.