Qué hace
Propose *how* you intend to tackle a task before doing the work, and wait for a human to approve it. Posts your plan (markdown) as a comment and sets status to plan_proposed, which drops the task out of your ready queue (list_my_tasks) until a human approves (→ back to in_progress, with plan_approved_at stamped as your go-ahead) or rejects (→ back to not_started, with feedback to re-plan) it in the app. Use this for substantial or ambiguous work where the human should sign off on the approach before you spend effort — the pre-execution counterpart to propose_completion. Pass steps to materialize the plan as real subtasks right away (same mechanism as decompose_task) instead of leaving it as prose only a human has to manually turn into tasks later — render_plan and the app both read these subtasks, so this is what makes the checklist/progress view work. A step's assignee defaults to unset (nobody's queue) even if you write "I'll do this" in the plan text — set assignee:"claude" explicitly on the steps you intend to execute yourself, otherwise get_task/list_my_tasks won't know they're yours.
Parámetros
| Nombre | Tipo | Obligatorio | Descripción |
|---|---|---|---|
id | string | Obligatorio | |
plan | string | Obligatorio | The plan (markdown) — the approach, steps, and anything you need the human to confirm |
steps | object[] | Opcional | Optional concrete action steps — created as real subtasks under this task immediately, so the human can review the actual breakdown (not just prose) before approving.
|
steps[].title | string | Obligatorio |
|
steps[].assignee | string | Opcional | Set to claude if you'll execute this step yourself; omit for a step that's on the human. Valores permitidos claude |
Anotaciones
Las pistas que el servidor envía con esta herramienta. Un cliente las lee para decidir si te pregunta antes de llamarla.
- Solo lectura
readOnlyHint: false - Cambia datos de tu cuenta de Done.
- Destructiva
destructiveHint: false - Solo agrega o lee; no quita ni sobrescribe nada de lo que ya existe.
- Idempotente
idempotentHint: false - Cada llamada puede agregar algo nuevo, como un comentario, una ejecución o una tarea.
- Mundo abierto
openWorldHint: false - Solo toca tu propia cuenta de Done.
Qué tokens pueden llamarla
Una conexión hecha con OAuth tiene acceso completo. Un token de Ajustes → Acceso de agentes → Tokens de MCP adicionales se puede acotar, y un token acotado nunca ve más allá de su proyecto o espacio de trabajo.
- Acceso completoPermitido
- Token de solo lecturaRechazado
- Token de un proyectoRechazado
- Token de un espacio de trabajoPermitido
Pruébala
Con Done conectado, pídele a tu asistente algo como:
“Antes de empezar la migración, propón un plan y espera mi visto bueno.”
Conecta Done a tu asistente
Un endpoint MCP por cuenta, con OAuth o con un token. Configuración paso a paso para cada cliente: