# Сценарии работы агента с задачами в Ritodo

> Проверенные последовательности действий для LLM-агента, подключённого к Ritodo по MCP: разбор входящих, декомпозиция, план дня и проверка недели. Во всех сценариях агент сначала предлагает, человек подтверждает, и только потом агент записывает.

## Общие правила

- Начинайте с `tools/list`: сценарий применим, только если у токена есть нужные права.
- Читайте перед записью: `tasks_get` даёт актуальную `version`.
- Любое удаление и любое массовое изменение показывайте человеку списком и ждите явного согласия.
- Не придумывайте сроки, оценки и приоритеты молча. Если данных нет, спросите или пометьте предположение.

## Разобрать входящие

Нужны права: `board:read`, `task:read`, `task:write`. Готовый prompt: `triage_inbox(board_id)`.

1. `boards_list`, затем `tasks_list` по доске входящих.
2. Для каждой задачи предложите статус, проект, оценку и, если нужно, срок. Группируйте похожие задачи.
3. Покажите таблицу «задача → предложение» и попросите подтвердить целиком или по строкам.
4. Примените подтверждённое через `tasks_update` (с `expected_version`) и `tasks_move`.
5. Сообщите, что изменено, и что осталось без решения.

## Декомпозировать задачу

Нужны права: `task:read`, `task:write`. Готовый prompt: `decompose_task(task_id)`.

1. `tasks_get` и `comments_list` — прочитайте контекст.
2. Предложите от 3 до 7 подзадач: каждая — наблюдаемый результат, который помещается в один фокус-блок (около 30 минут) или в один день.
3. После подтверждения создайте подзадачи через `tasks_create` с `parent_id` и `idempotency_key`.
4. Обновите родителя: понизьте непонятность задачи, так как неясность снята.

## План дня

Нужны права: `task:read`, `task:write`.

1. Спросите границы рабочего дня и фиксированные занятия: встречи, перерывы, дорога.
2. Вычтите их и оставьте резерв на входящие: при хаотичном дне больше, при спокойном меньше. Подробнее — [Как всё успевать без перегруза](https://ritodo.com/notes/day-capacity).
3. Выберите одно главное дело: оно должно помещаться в оставшееся время ([приоритеты](https://ritodo.com/notes/task-priorities)). Остальное ранжируйте по цене переноса.
4. Предложите план в блоках по 30 минут. Если плана больше, чем ёмкости, назовите, что снять, а не сжимайте всё.
5. После подтверждения разложите задачи через `tasks_plan`.

## Проверка середины недели

Нужны права: `task:read`, `task:write`.

1. `tasks_list` с фильтром по оставшимся дням недели.
2. Сравните сумму оценок оставшейся работы с оставшейся ёмкостью (рабочие дни × реальные блоки в день).
3. Если работы больше, предложите снять самые крупные задачи без жёсткого срока и перенести их; для задач с обещанными сроками подготовьте текст сообщения человеку, но не отправляйте его сами. Метод описан в [заметке о проверке середины недели](https://ritodo.com/notes/midweek-check).
4. Перенос выполняйте через `tasks_plan` после подтверждения.

## Матрица приоритетов

Нужны права: `task:read`, `task:write`.

Разложите задачи по осям «важно» и «срочно», предложите действие для каждого квадранта (сделать, запланировать, делегировать, удалить) и покажите таблицу. Удаление — только через архивирование и с согласия. Метод: [Матрица Эйзенхауэра](https://ritodo.com/notes/eisenhower-matrix).

## Что агенту не стоит делать

- Читать содержимое вложений: по MCP передаются только метаданные.
- Менять права токена: их можно только пересоздать, и это делает человек.
- Повторять вызов после `429` раньше, чем пройдёт `Retry-After`.
- Продолжать работу после `401`: сообщите, что токен истёк или отозван.