cc-viewer 1.6.182 → 1.6.183

package/concepts/ru/Tool-CronDelete.md

@@ -0,0 +1,43 @@
+# CronDelete
+
+Отменяет задание cron, ранее запланированное с помощью `CronCreate`. Немедленно удаляет его из сеансового хранилища в памяти. Не оказывает никакого эффекта, если задание уже было автоматически удалено (однократные задания удаляются после срабатывания, повторяющиеся задания истекают через 7 дней).
+
+## Когда использовать
+
+- Пользователь просит остановить повторяющееся запланированное задание до автоматического истечения срока через 7 дней.
+- Однократное задание больше не нужно и должно быть отменено до его срабатывания.
+- Необходимо изменить выражение расписания существующего задания — удалите его с помощью `CronDelete`, затем создайте заново с помощью `CronCreate`, используя новое выражение.
+- Очистка нескольких устаревших заданий для поддержания порядка в сеансовом хранилище.
+
+## Параметры
+
+- `id` (string, обязательный): Идентификатор задания, возвращённый `CronCreate` при первоначальном создании задания. Это значение должно точно совпадать; нечёткий поиск или поиск по имени не поддерживается.
+
+## Примеры
+
+### Пример 1: отмена работающего повторяющегося задания
+
+Повторяющееся задание было ранее создано с идентификатором `"cron_abc123"`. Пользователь просит его остановить.
+
+```
+CronDelete({ id: "cron_abc123" })
+```
+
+Задание удаляется из сеансового хранилища и больше не будет срабатывать.
+
+### Пример 2: удаление устаревшего однократного задания до его срабатывания
+
+Однократное задание с идентификатором `"cron_xyz789"` было запланировано к выполнению через 30 минут, но пользователь решил, что оно больше не нужно.
+
+```
+CronDelete({ id: "cron_xyz789" })
+```
+
+Задание отменяется. Никаких действий не будет выполнено, когда наступит первоначальное время срабатывания.
+
+## Примечания
+
+- `id` должен быть получен из возвращаемого значения `CronCreate`. Нет способа найти задание по описанию или обратному вызову — сохраните идентификатор, если может потребоваться отменить задание позже.
+- Если задание уже было автоматически удалено (сработало как однократное или достигло повторяющегося истечения срока через 7 дней), вызов `CronDelete` с этим идентификатором является холостой операцией и не вызовет ошибки.
+- `CronDelete` влияет только на текущий сеанс в памяти. Если среда выполнения не сохраняет состояние cron между перезапусками, запланированные задания будут потеряны при перезапуске независимо от того, был ли вызван `CronDelete`.
+- Операции массового удаления не существует; отменяйте каждое задание по отдельности, используя его собственный `id`.

package/concepts/ru/Tool-CronList.md

@@ -0,0 +1,30 @@
+# CronList
+
+Выводит список всех задач cron, запланированных с помощью `CronCreate` в текущем сеансе. Возвращает сводку по каждой активной задаче, включая `id`, выражение cron, сокращённый `prompt`, флаг `recurring`, флаг `durable` и время следующего запуска.
+
+## Когда использовать
+
+- Для проверки всех текущих запланированных задач перед внесением изменений или завершением сеанса.
+- Для нахождения корректного `id` задачи перед вызовом `CronDelete` с целью её удаления.
+- Для диагностики причин, по которым ожидаемая задача не была запущена: проверить её существование и время следующего запуска.
+- Для подтверждения того, что одноразовая (неповторяющаяся) задача ещё не была выполнена и по-прежнему ожидает запуска.
+
+## Параметры
+
+Нет.
+
+## Примеры
+
+### Пример 1: просмотр всех запланированных задач
+
+Вызвать `CronList` без аргументов, чтобы получить полный список всех активных задач cron. В ответе для каждой задачи содержится `id`, выражение cron, определяющее расписание, сокращённая версия `prompt`, который будет выполнен, признак `recurring` (повторяющаяся), признак `durable` (сохраняется между перезапусками) и следующее запланированное время запуска.
+
+### Пример 2: поиск id конкретной повторяющейся задачи
+
+Если было создано несколько задач cron и необходимо удалить одну конкретную повторяющуюся задачу, сначала вызвать `CronList`. Просмотреть возвращённый список и найти задачу, сводка `prompt` и выражение cron которой совпадают с целевой задачей. Скопировать её `id` и передать в `CronDelete`.
+
+## Примечания
+
+- В списке отображаются только задачи, созданные в текущем сеансе, если только они не были созданы с `durable: true`, что позволяет им сохраняться между перезапусками сеанса.
+- Поле `prompt` в сводке усечено: отображается только начало полного текста запроса, а не всё его содержимое.
+- Одноразовые задачи (`recurring` равно `false`), которые уже были выполнены, автоматически удаляются и больше не отображаются в списке.

package/concepts/ru/Tool-Edit.md

@@ -1,46 +1,38 @@
 # Edit
 
-## Определение
+Выполняет точную замену строки внутри существующего файла. Это предпочтительный способ модифицировать файлы, поскольку передаётся только дифф, что делает правки точными и поддающимися аудиту.
 
-Редактирует файл через точную замену строк. Заменяет `old_string` в файле на `new_string`.
+## Когда использовать
 
-## Параметры
+- Исправление ошибки в одной функции без перезаписи окружающего файла
+- Обновление значения конфигурации, строки версии или пути импорта
+- Переименование символа по всему файлу с `replace_all`
+- Вставка блока рядом с якорем (расширьте `old_string`, включив окружающий контекст, затем укажите замену)
+- Применение небольших, чётко очерченных правок в рамках многошагового рефакторинга
 
-| Параметр | Тип | Обязательный | Описание |
-|------|------|------|------|
-| `file_path` | string | Да | Абсолютный путь к файлу для модификации |
-| `old_string` | string | Да | Исходный текст для замены |
-| `new_string` | string | Да | Новый текст после замены (должен отличаться от old_string) |
-| `replace_all` | boolean | Нет | Заменять ли все вхождения, по умолчанию `false` |
+## Параметры
 
-## Сценарии использования
+- `file_path` (string, обязательный): абсолютный путь к изменяемому файлу.
+- `old_string` (string, обязательный): точный текст для поиска. Должен совпадать символ в символ, включая пробелы и отступы.
+- `new_string` (string, обязательный): текст замены. Должен отличаться от `old_string`.
+- `replace_all` (boolean, необязательный): если `true`, заменяет каждое вхождение `old_string`. По умолчанию `false`, что требует уникальности совпадения.
 
-**Подходящее применение:**
-- Модификация определённых фрагментов кода в существующих файлах
-- Исправление ошибок, обновление логики
-- Переименование переменных (в сочетании с `replace_all: true`)
-- Любой сценарий, требующий точной модификации содержимого файла
+## Примеры
 
-**Неподходящее применение:**
-- Создание новых файлов — следует использовать Write
-- Масштабное переписывание — может потребоваться Write для перезаписи всего файла
+### Пример 1: исправление одного места вызова
+Задайте `old_string` в виде точной строки `const port = 3000;`, а `new_string` — `const port = process.env.PORT ?? 3000;`. Совпадение уникально, поэтому `replace_all` можно оставить по умолчанию.
 
-## Примечания
+### Пример 2: переименование символа по всему файлу
+Чтобы переименовать `getUser` в `fetchUser` везде в `api.ts`, задайте `old_string: "getUser"`, `new_string: "fetchUser"` и `replace_all: true`.
 
-- Перед использованием необходимо сначала прочитать файл через Read, иначе возникнет ошибка
-- `old_string` должен быть уникальным в файле, иначе редактирование не удастся. Если не уникален, нужно предоставить больше контекста или использовать `replace_all`
-- При редактировании текста необходимо сохранять оригинальные отступы (tab/пробелы), не включать префиксы номеров строк из вывода Read
-- Предпочтительно редактировать существующие файлы, а не создавать новые
-- `new_string` должен отличаться от `old_string`
+### Пример 3: устранение неоднозначности повторяющегося фрагмента
+Если `return null;` встречается в нескольких ветках, расширьте `old_string`, включив окружающий контекст (например, предшествующую строку `if`), чтобы совпадение стало уникальным. Иначе инструмент выдаст ошибку, а не будет гадать.
 
-## Оригинальный текст
-
-<textarea readonly>Performs exact string replacements in files.
+## Примечания
 
-Usage:
-- You must use your `Read` tool at least once in the conversation before editing. This tool will error if you attempt an edit without reading the file. 
-- When editing text from Read tool output, ensure you preserve the exact indentation (tabs/spaces) as it appears AFTER the line number prefix. The line number prefix format is: spaces + line number + tab. Everything after that tab is the actual file content to match. Never include any part of the line number prefix in the old_string or new_string.
-- ALWAYS prefer editing existing files in the codebase. NEVER write new files unless explicitly required.
-- Only use emojis if the user explicitly requests it. Avoid adding emojis to files unless asked.
-- The edit will FAIL if `old_string` is not unique in the file. Either provide a larger string with more surrounding context to make it unique or use `replace_all` to change every instance of `old_string`.
-- Use `replace_all` for replacing and renaming strings across the file. This parameter is useful if you want to rename a variable for instance.</textarea>
+- Перед тем как `Edit` примет изменения, нужно хотя бы раз в текущей сессии вызвать `Read` для этого файла. Префиксы с номерами строк из вывода `Read` не являются частью содержимого файла; не включайте их в `old_string` или `new_string`.
+- Пробельные символы должны совпадать точно. Обращайте внимание на табы против пробелов и хвостовые пробелы, особенно в YAML, Makefile и Python.
+- Если `old_string` не уникален, а `replace_all` равен `false`, правка завершится ошибкой. Либо расширьте контекст, либо включите `replace_all`.
+- Предпочитайте `Edit` перед `Write`, когда файл уже существует; `Write` перезаписывает весь файл и теряет несвязанное содержимое, если не быть аккуратным.
+- Для нескольких несвязанных правок в одном файле делайте несколько последовательных вызовов `Edit` вместо одной громоздкой и хрупкой замены.
+- Избегайте добавления эмодзи, маркетинговых формулировок или незапрошенных блоков документации при правке исходных файлов.

package/concepts/ru/Tool-EnterPlanMode.md

@@ -1,128 +1,35 @@
 # EnterPlanMode
 
-## Определение
+Переключает сессию в режим планирования — фазу исследования только для чтения, в которой ассистент изучает кодовую базу и составляет конкретный план реализации для одобрения пользователем перед любыми изменениями файлов.
 
-Переключает Claude Code в режим планирования для исследования кодовой базы и проектирования плана перед реализацией.
+## Когда использовать
+
+- Пользователь запрашивает нетривиальное изменение, затрагивающее несколько файлов или подсистем.
+- Требования неоднозначны, и ассистенту нужно прочитать код, прежде чем выбирать подход.
+- Предлагается рефакторинг, миграция или обновление зависимости, и радиус воздействия неясен.
+- Пользователь прямо говорит «спланируй это», «давай сначала спланируем» или просит провести разбор проекта.
+- Риск достаточно высок, чтобы переход сразу к правкам мог обесценить работу или повредить состояние.
 
 ## Параметры
 
-Без параметров.
+Нет. `EnterPlanMode` не принимает аргументов — вызывайте с пустым объектом параметров.
 
-## Сценарии использования
+## Примеры
 
-**Подходящее применение:**
-- Реализация новых функций — требуются архитектурные решения
-- Существует несколько возможных решений — требуется выбор пользователя
-- Изменения кода влияют на существующее поведение или структуру
-- Изменения в нескольких файлах — потенциально 2-3 и более файлов
-- Неясные требования — необходимо сначала исследовать, чтобы понять объём
-- Предпочтения пользователя важны — реализация может иметь несколько разумных направлений
+### Пример 1: большой запрос на фичу
 
-**Неподходящее применение:**
-- Исправления одной или нескольких строк (опечатки, очевидные ошибки)
-- Пользователь дал очень конкретные инструкции
-- Чисто исследовательские задачи — следует использовать Task (тип Explore)
+Пользователь просит: «Добавь SSO через Okta в админ-панель». Ассистент вызывает `EnterPlanMode`, затем несколько ходов читает middleware авторизации, хранилище сессий, защитники маршрутов и существующий UI входа. Он пишет план с описанием необходимых изменений, шагов миграции и покрытия тестами, а затем отправляет его на одобрение через `ExitPlanMode`.
 
-## Поведение в режиме планирования
+### Пример 2: рискованный рефакторинг
 
-После входа в режим планирования Claude Code:
-1. Использует инструменты Glob, Grep, Read для глубокого исследования кодовой базы
-2. Понимает существующие паттерны и архитектуру
-3. Проектирует план реализации
-4. Отправляет план на утверждение пользователю
-5. При необходимости уточнения может использовать AskUserQuestion
-6. Когда план готов, выходит через ExitPlanMode
+Пользователь говорит: «Переведи REST-контроллеры на tRPC». Ассистент входит в режим планирования, обходит каждый контроллер, каталогизирует публичный контракт, перечисляет фазы раскатки (шимм, параллельное чтение, переключение) и предлагает последовательный план, прежде чем тронуть какой-либо файл.
 
 ## Примечания
 
-- Этот инструмент требует согласия пользователя для входа в режим планирования
-- Если не уверены, нужно ли планирование, лучше планировать — заблаговременное согласование лучше, чем переделка
-
-## Оригинальный текст
-
-<textarea readonly>Use this tool proactively when you're about to start a non-trivial implementation task. Getting user sign-off on your approach before writing code prevents wasted effort and ensures alignment. This tool transitions you into plan mode where you can explore the codebase and design an implementation approach for user approval.
-
-## When to Use This Tool
-
-**Prefer using EnterPlanMode** for implementation tasks unless they're simple. Use it when ANY of these conditions apply:
-
-1. **New Feature Implementation**: Adding meaningful new functionality
-   - Example: "Add a logout button" - where should it go? What should happen on click?
-   - Example: "Add form validation" - what rules? What error messages?
-
-2. **Multiple Valid Approaches**: The task can be solved in several different ways
-   - Example: "Add caching to the API" - could use Redis, in-memory, file-based, etc.
-   - Example: "Improve performance" - many optimization strategies possible
-
-3. **Code Modifications**: Changes that affect existing behavior or structure
-   - Example: "Update the login flow" - what exactly should change?
-   - Example: "Refactor this component" - what's the target architecture?
-
-4. **Architectural Decisions**: The task requires choosing between patterns or technologies
-   - Example: "Add real-time updates" - WebSockets vs SSE vs polling
-   - Example: "Implement state management" - Redux vs Context vs custom solution
-
-5. **Multi-File Changes**: The task will likely touch more than 2-3 files
-   - Example: "Refactor the authentication system"
-   - Example: "Add a new API endpoint with tests"
-
-6. **Unclear Requirements**: You need to explore before understanding the full scope
-   - Example: "Make the app faster" - need to profile and identify bottlenecks
-   - Example: "Fix the bug in checkout" - need to investigate root cause
-
-7. **User Preferences Matter**: The implementation could reasonably go multiple ways
-   - If you would use AskUserQuestion to clarify the approach, use EnterPlanMode instead
-   - Plan mode lets you explore first, then present options with context
-
-## When NOT to Use This Tool
-
-Only skip EnterPlanMode for simple tasks:
-- Single-line or few-line fixes (typos, obvious bugs, small tweaks)
-- Adding a single function with clear requirements
-- Tasks where the user has given very specific, detailed instructions
-- Pure research/exploration tasks (use the Agent tool with explore agent instead)
-
-## What Happens in Plan Mode
-
-In plan mode, you'll:
-1. Thoroughly explore the codebase using Glob, Grep, and Read tools
-2. Understand existing patterns and architecture
-3. Design an implementation approach
-4. Present your plan to the user for approval
-5. Use AskUserQuestion if you need to clarify approaches
-6. Exit plan mode with ExitPlanMode when ready to implement
-
-## Examples
-
-### GOOD - Use EnterPlanMode:
-User: "Add user authentication to the app"
-- Requires architectural decisions (session vs JWT, where to store tokens, middleware structure)
-
-User: "Optimize the database queries"
-- Multiple approaches possible, need to profile first, significant impact
-
-User: "Implement dark mode"
-- Architectural decision on theme system, affects many components
-
-User: "Add a delete button to the user profile"
-- Seems simple but involves: where to place it, confirmation dialog, API call, error handling, state updates
-
-User: "Update the error handling in the API"
-- Affects multiple files, user should approve the approach
-
-### BAD - Don't use EnterPlanMode:
-User: "Fix the typo in the README"
-- Straightforward, no planning needed
-
-User: "Add a console.log to debug this function"
-- Simple, obvious implementation
-
-User: "What files handle routing?"
-- Research task, not implementation planning
-
-## Important Notes
-
-- This tool REQUIRES user approval - they must consent to entering plan mode
-- If unsure whether to use it, err on the side of planning - it's better to get alignment upfront than to redo work
-- Users appreciate being consulted before significant changes are made to their codebase
-</textarea>
+- Режим планирования по договору работает только на чтение. Находясь в нём, ассистент не должен запускать `Edit`, `Write`, `NotebookEdit` или любые изменяющие shell-команды. Используйте только `Read`, `Grep`, `Glob` и неразрушительные команды `Bash`.
+- Не входите в режим планирования для тривиальных однострочных правок, чисто исследовательских вопросов или задач, где пользователь уже подробно описал изменение. Накладные расходы перевешивают пользу.
+- В режиме Auto план-режим не приветствуется, если пользователь прямо не попросил — Auto предпочитает действие предварительному планированию.
+- Используйте режим планирования, чтобы сократить правки курса на дорогой работе. Пять минут планирования часто экономят час нерелевантных правок.
+- Находясь в режиме планирования, сосредоточьте исследование на тех частях системы, которые действительно изменятся. Избегайте исчерпывающих экскурсий по репозиторию, не связанных с текущей задачей.
+- Сам план должен быть записан на диск по пути, который ожидает каркас, чтобы `ExitPlanMode` мог его отправить. План должен содержать конкретные пути к файлам, имена функций и шаги проверки, а не размытые намерения.
+- Пользователь может отклонить план и попросить правок. Итерируйте внутри режима планирования, пока план не принят; только тогда выходите.

package/concepts/ru/Tool-EnterWorktree.md

@@ -1,56 +1,44 @@
 # EnterWorktree
 
-## Определение
+Создаёт изолированный Git worktree в новой ветке или переключает сессию в существующий worktree текущего репозитория, чтобы параллельная или экспериментальная работа велась без влияния на основной чекаут.
 
-Creates an isolated git worktree and switches the current session into it. Only used when the user explicitly asks to work in a worktree.
+## Когда использовать
 
-## Параметры
-
-| Name | Type | Required | Description |
-|---|---|---|---|
-| name | string | No | A name for the worktree. If not provided, a random name is generated. |
-
-## Сценарии использования
+- Пользователь явно говорит «worktree» — например, «создай worktree», «начни worktree» или «работай в worktree».
+- Инструкции проекта в `CLAUDE.md` или постоянная память предписывают использовать worktree для текущей задачи.
+- Вы хотите продолжить задачу, ранее настроенную как worktree (передайте `path`, чтобы вернуться в неё).
+- Несколько экспериментальных веток должны сосуществовать на диске без постоянных переключений checkout.
+- Долгую задачу нужно изолировать от несвязанных правок в основном рабочем дереве.
 
-**Подходит для:**
-- The user explicitly says "worktree" (e.g., "start a worktree", "work in a worktree", "create a worktree")
-
-**Не подходит для:**
-- The user asks to create/switch branches — use git commands instead
-- The user asks to fix a bug or work on a feature — use normal git workflow unless they specifically mention worktrees
-
-## Примечания
-
-- Must be in a git repository, or have WorktreeCreate/WorktreeRemove hooks configured
-- Must not already be in a worktree
-
-## Оригинальный текст
-
-<textarea readonly>Use this tool ONLY when the user explicitly asks to work in a worktree. This tool creates an isolated git worktree and switches the current session into it.
+## Параметры
 
-## When to Use
+- `name` (string, необязательный): имя для каталога нового worktree. Каждый разделённый `/` сегмент может содержать только буквы, цифры, точки, подчёркивания и дефисы; вся строка ограничена 64 символами. Если не указан и `path` тоже отсутствует, имя генерируется случайно. Взаимоисключающий с `path`.
+- `path` (string, необязательный): путь в файловой системе к существующему worktree текущего репозитория, в который нужно переключиться. Должен отображаться в `git worktree list` для этого репо; пути, не зарегистрированные как worktree текущего репо, отклоняются. Взаимоисключающий с `name`.
 
-- The user explicitly says "worktree" (e.g., "start a worktree", "work in a worktree", "create a worktree", "use a worktree")
+## Примеры
 
-## When NOT to Use
+### Пример 1: создание нового worktree с описательным именем
 
-- The user asks to create a branch, switch branches, or work on a different branch — use git commands instead
-- The user asks to fix a bug or work on a feature — use normal git workflow unless they specifically mention worktrees
-- Never use this tool unless the user explicitly mentions "worktree"
+```
+EnterWorktree(name="feat/okta-sso")
+```
 
-## Requirements
+Создаёт `.claude/worktrees/feat/okta-sso` в новой ветке на основе `HEAD`, затем переключает рабочий каталог сессии в него. Все последующие правки файлов и shell-команды выполняются внутри этого worktree до выхода.
 
-- Must be in a git repository, OR have WorktreeCreate/WorktreeRemove hooks configured in settings.json
-- Must not already be in a worktree
+### Пример 2: возврат в существующий worktree
 
-## Behavior
+```
+EnterWorktree(path="/Users/me/repo/.claude/worktrees/feat/okta-sso")
+```
 
-- In a git repository: creates a new git worktree inside `.claude/worktrees/` with a new branch based on HEAD
-- Outside a git repository: delegates to WorktreeCreate/WorktreeRemove hooks for VCS-agnostic isolation
-- Switches the session's working directory to the new worktree
-- On session exit, the user will be prompted to keep or remove the worktree
+Возобновляет работу в ранее созданном worktree. Поскольку вы зашли в него через `path`, `ExitWorktree` не удалит его автоматически — выход с `action: "keep"` просто возвращает вас в исходный каталог.
 
-## Parameters
+## Примечания
 
-- `name` (optional): A name for the worktree. If not provided, a random name is generated.
-</textarea>
+- Не вызывайте `EnterWorktree`, пока пользователь не попросил явно или инструкции проекта не требуют. Обычные переключения веток или исправления багов должны использовать обычные Git-команды, а не worktrees.
+- Когда вызывается внутри Git-репозитория, инструмент создаёт worktree в `.claude/worktrees/` и регистрирует новую ветку на основе `HEAD`. Вне Git-репозитория делегирует настроенным хукам `WorktreeCreate` / `WorktreeRemove` в `settings.json` для VCS-независимой изоляции.
+- Одновременно активна только одна сессия worktree. Инструмент отказывается работать, если вы уже внутри сессии worktree; сначала выйдите через `ExitWorktree`.
+- Используйте `ExitWorktree`, чтобы покинуть середину сессии. Если сессия завершится, пока вы всё ещё внутри только что созданного worktree, пользователю будет предложено сохранить или удалить его.
+- Worktrees, в которые вы вошли через `path`, считаются внешними — `ExitWorktree` с `action: "remove"` не удалит их. Это защитная мера для worktrees, которыми пользователь управляет вручную.
+- Новый worktree наследует содержимое текущей ветки, но имеет независимый рабочий каталог и индекс. Застейдженные и незастейдженные изменения в основном чекауте не видны внутри worktree.
+- Совет по именованию: префиксируйте типом работы (`feat/`, `fix/`, `spike/`), чтобы несколько параллельных worktrees было легко различить в `git worktree list`.

package/concepts/ru/Tool-ExitPlanMode.md

@@ -1,62 +1,42 @@
 # ExitPlanMode
 
-## Определение
+Отправляет план реализации, составленный в режиме планирования, на одобрение пользователя, и — если одобрен — выводит сессию из режима планирования, позволяя приступить к правкам.
 
-Выходит из режима планирования и отправляет план на утверждение пользователю. Содержимое плана считывается из ранее записанного файла плана.
+## Когда использовать
 
-## Параметры
-
-| Параметр | Тип | Обязательный | Описание |
-|------|------|------|------|
-| `allowedPrompts` | array | Нет | Список описаний разрешений, необходимых для реализации плана |
-
-Каждый элемент массива `allowedPrompts`:
-
-| Поле | Тип | Обязательный | Описание |
-|------|------|------|------|
-| `tool` | enum | Да | Применимый инструмент, в настоящее время поддерживается только `Bash` |
-| `prompt` | string | Да | Семантическое описание операции (например, "run tests", "install dependencies") |
-
-## Сценарии использования
+- План, написанный во время `EnterPlanMode`, завершён и готов к ревью.
+- Задача ориентирована на реализацию (изменения кода или конфигурации), а не на чистое исследование, поэтому явный план уместен.
+- Всё предварительное чтение и анализ сделано; перед решением пользователя дальнейших исследований не требуется.
+- Ассистент перечислил конкретные пути файлов, функции и шаги — а не только цели.
+- Пользователь попросил показать план, или рабочий процесс план-режима вот-вот передаст эстафету инструментам правки.
 
-**Подходящее применение:**
-- План в режиме планирования завершён, готов к отправке на утверждение пользователю
-- Только для задач реализации, требующих написания кода
-
-**Неподходящее применение:**
-- Чисто исследовательские задачи — не требуют выхода из режима планирования
-- Хотите спросить пользователя «план подходит?» — это именно функция данного инструмента, не используйте AskUserQuestion для этого
-
-## Примечания
+## Параметры
 
-- Этот инструмент не принимает содержимое плана в качестве параметра — он считывает его из ранее записанного файла плана
-- Пользователь увидит содержимое файла плана для утверждения
-- Не спрашивайте через AskUserQuestion «подходит ли план» перед вызовом этого инструмента — это дублирование
-- Не упоминайте «план» в вопросах, так как пользователь не видит содержимое плана до ExitPlanMode
+- `allowedPrompts` (array, необязательный): промпты, которые пользователь может ввести на экране одобрения, чтобы авто-одобрить или изменить план. Каждый элемент задаёт разрешение с областью (например, имя операции и инструмент, к которому оно применяется). Оставьте пустым, чтобы использовать поток одобрения по умолчанию.
 
-## Оригинальный текст
+## Примеры
 
-<textarea readonly>Use this tool when you are in plan mode and have finished writing your plan to the plan file and are ready for user approval.
+### Пример 1: стандартная отправка
 
-## How This Tool Works
-- You should have already written your plan to the plan file specified in the plan mode system message
-- This tool does NOT take the plan content as a parameter - it will read the plan from the file you wrote
-- This tool simply signals that you're done planning and ready for the user to review and approve
-- The user will see the contents of your plan file when they review it
+После исследования рефакторинга авторизации в режиме планирования и записи файла плана на диск ассистент вызывает `ExitPlanMode` без аргументов. Каркас читает план из его канонического места, показывает пользователю и ждёт одобрения или отклонения.
 
-## When to Use This Tool
-IMPORTANT: Only use this tool when the task requires planning the implementation steps of a task that requires writing code. For research tasks where you're gathering information, searching files, reading files or in general trying to understand the codebase - do NOT use this tool.
+### Пример 2: предварительно одобренные быстрые действия
 
-## Before Using This Tool
-Ensure your plan is complete and unambiguous:
-- If you have unresolved questions about requirements or approach, use AskUserQuestion first (in earlier phases)
-- Once your plan is finalized, use THIS tool to request approval
+```
+ExitPlanMode(allowedPrompts=[
+  {"tool": "Bash", "prompt": "run tests"},
+  {"tool": "Bash", "prompt": "install dependencies"}
+])
+```
 
-**Important:** Do NOT use AskUserQuestion to ask "Is this plan okay?" or "Should I proceed?" - that's exactly what THIS tool does. ExitPlanMode inherently requests user approval of your plan.
+Позволяет пользователю заранее выдать разрешение на обычные последующие команды, чтобы ассистенту не приходилось останавливаться для каждого запроса на разрешение во время реализации.
 
-## Examples
+## Примечания
 
-1. Initial task: "Search for and understand the implementation of vim mode in the codebase" - Do not use the exit plan mode tool because you are not planning the implementation steps of a task.
-2. Initial task: "Help me implement yank mode for vim" - Use the exit plan mode tool after you have finished planning the implementation steps of the task.
-3. Initial task: "Add a new feature to handle user authentication" - If unsure about auth method (OAuth, JWT, etc.), use AskUserQuestion first, then use exit plan mode tool after clarifying the approach.
-</textarea>
+- `ExitPlanMode` имеет смысл только для работ типа реализации. Если запрос пользователя — это исследование или объяснение без изменений файлов, отвечайте напрямую, не маршрутизируйте через режим планирования только ради выхода из него.
+- План должен быть уже записан на диск перед вызовом этого инструмента. `ExitPlanMode` не принимает тело плана как параметр; он читает по пути, который ожидает каркас.
+- Если пользователь отклоняет план, вы возвращаетесь в режим планирования. Исправьте на основе обратной связи и отправьте снова; не начинайте править файлы, пока план не одобрен.
+- Одобрение даёт разрешение выйти из режима планирования и использовать изменяющие инструменты (`Edit`, `Write`, `Bash` и т. д.) в рамках описанной в плане области. Расширение области после этого требует нового плана или явного согласия пользователя.
+- Не используйте `AskUserQuestion` со словами «нравится ли вам этот план?» перед вызовом этого инструмента — запрос одобрения плана — это именно то, что делает `ExitPlanMode`, и пользователь не видит план, пока тот не отправлен.
+- Сохраняйте план минимальным и реализуемым. Ревьюер должен суметь просмотреть его меньше чем за минуту и точно понять, что изменится.
+- Если в середине реализации вы осознали, что план был неверен, остановитесь и сообщите пользователю, а не молча отклоняйтесь. Повторный вход в режим планирования — валидный следующий шаг.

package/concepts/ru/Tool-ExitWorktree.md

@@ -0,0 +1,41 @@
+# ExitWorktree
+
+Завершает сеанс worktree, ранее созданный с помощью `EnterWorktree`, и возвращает сеанс в исходный рабочий каталог. Этот инструмент действует исключительно на worktree, созданные `EnterWorktree` в текущем сеансе; если такой сеанс не активен, вызов не производит никакого эффекта.
+
+## Когда использовать
+
+- Работа в изолированном worktree завершена и требуется вернуться в основной рабочий каталог.
+- Задача в worktree ветки функциональности выполнена и после слияния необходимо удалить ветку и каталог.
+- Требуется сохранить worktree для последующего использования и просто вернуться в исходный каталог, не удаляя ничего.
+- Требуется отказаться от экспериментальной или временной ветки, не оставляя на диске никаких артефактов.
+- Перед запуском нового сеанса `EnterWorktree` необходимо сначала завершить текущий.
+
+## Параметры
+
+- `action` (строка, обязательный): `"keep"` сохраняет каталог worktree и ветку на диске, чтобы можно было вернуться к ним позже; `"remove"` удаляет и каталог, и ветку, выполняя чистое завершение.
+- `discard_changes` (логическое значение, необязательный, по умолчанию `false`): Имеет значение только при `action: "remove"`. Если worktree содержит незафиксированные файлы или коммиты, отсутствующие в исходной ветке, инструмент откажет в удалении, если `discard_changes` не установлен в `true`. В ответе об ошибке перечислены конкретные изменения, чтобы вы могли подтвердить их с пользователем перед повторным вызовом.
+
+## Примеры
+
+### Пример 1: чистое завершение после слияния изменений
+
+После завершения работы в worktree и слияния ветки в main вызовите `ExitWorktree` с `action: "remove"`, чтобы удалить каталог worktree и ветку и вернуться в исходный рабочий каталог.
+
+```
+ExitWorktree(action: "remove")
+```
+
+### Пример 2: отказ от временного worktree с незафиксированным экспериментальным кодом
+
+Если worktree содержит экспериментальные незафиксированные изменения, которые необходимо полностью отбросить, сначала попробуйте `action: "remove"`. Инструмент откажет и перечислит незафиксированные изменения. После подтверждения пользователем того, что изменения можно отбросить, повторно вызовите с `discard_changes: true`.
+
+```
+ExitWorktree(action: "remove", discard_changes: true)
+```
+
+## Примечания
+
+- Этот инструмент действует исключительно на worktree, созданные `EnterWorktree` в текущем сеансе. Он не затронет worktree, созданные с помощью `git worktree add`, worktree из предыдущих сеансов или обычный рабочий каталог, если `EnterWorktree` никогда не вызывался — в этих случаях вызов не производит эффекта.
+- `action: "remove"` будет отклонён, если worktree содержит незафиксированные изменения или коммиты, отсутствующие в исходной ветке, если только `discard_changes: true` не задан явно. Всегда подтверждайте с пользователем перед установкой `discard_changes: true`, поскольку данные не подлежат восстановлению.
+- Если к worktree был присоединён сеанс tmux: при `remove` он завершается; при `keep` продолжает работу, а его имя возвращается, чтобы пользователь мог переподключиться позже.
+- После завершения `ExitWorktree` можно снова вызвать `EnterWorktree` для запуска нового сеанса worktree.