Propose brief edit

propose_brief_edit

Escritura

Qué hace

Propose new wording for a project's or a task's agent brief (notes_for_agent) WITHOUT writing it. Briefs are the human's standing instructions to you, one-way, so you can never write one — but when a task has been sent back for a reason the brief should have covered, you are the one who knows the line that is missing. Give tier ("project" or "task"), target_id (the project or task id), text (the WHOLE brief as you propose it — a full replacement, not a patch; include what should stay), a reason (what went wrong and how this wording prevents it — this is what the human decides on), and source_task_id for the rejected task that prompted it. Nothing changes until a person applies it on the Needs you screen, where they see current vs proposed. It records the brief as you saw it: if someone edits that brief before yours is read, applying is refused rather than overwriting them. One open proposal per brief. The workspace brief can't be proposed here — it reaches every project, a teammate's agents included; use ask_decision for that.

Parámetros

Nombre	Tipo	Obligatorio	Descripción
`tier`	`string`	Obligatorio	Which brief: the project's, or one task's own Valores permitidos`projecttask`
`target_id`	`string`	Obligatorio	The project id (tier project) or task id (tier task)
`text`	`string \| null`	Obligatorio	The full proposed brief. null or empty proposes clearing it.
`reason`	`string`	Obligatorio	Why — what was rejected and how this wording stops it happening again.
`source_task_id`	`string`	Opcional	The rejected task that prompted this, if any
`agent`	`string`	Opcional	Your name, for the record (a scoped token's own name wins)

Anotaciones

Las pistas que el servidor envía con esta herramienta. Un cliente las lee para decidir si te pregunta antes de llamarla.

Solo lecturareadOnlyHint: false: Cambia datos de tu cuenta de Done.
DestructivadestructiveHint: false: Solo agrega o lee; no quita ni sobrescribe nada de lo que ya existe.
IdempotenteidempotentHint: false: Cada llamada puede agregar algo nuevo, como un comentario, una ejecución o una tarea.
Mundo abiertoopenWorldHint: 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 proyectoPermitido
Token de un espacio de trabajoPermitido

Pruébala

Con Done conectado, pídele a tu asistente algo como:

“Ese rechazo es algo que las instrucciones del proyecto debieron cubrir. Propón una nueva redacción.”

Conecta Done a tu asistente

Un endpoint MCP por cuenta, con OAuth o con un token. Configuración paso a paso para cada cliente:

Resumen de la configuración de MCP →