Propose brief edit

propose_brief_edit

Escrita

O que faz

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

Nome	Tipo	Obrigatório	Descrição
`tier`	`string`	Obrigatório	Which brief: the project's, or one task's own Valores permitidos`projecttask`
`target_id`	`string`	Obrigatório	The project id (tier project) or task id (tier task)
`text`	`string \| null`	Obrigatório	The full proposed brief. null or empty proposes clearing it.
`reason`	`string`	Obrigatório	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)

Anotações

As indicações que o servidor envia com esta ferramenta. Um cliente as lê para decidir se pergunta a você antes de uma chamada.

Somente leiturareadOnlyHint: false: Altera dados da sua conta do Done.
DestrutivadestructiveHint: false: Só adiciona ou lê; nada do que já existe é removido ou sobrescrito.
IdempotenteidempotentHint: false: Cada chamada pode adicionar algo novo, como um comentário, uma execução ou uma tarefa.
Mundo abertoopenWorldHint: false: Só mexe na sua própria conta do Done.

Quais tokens podem chamá-la

Uma conexão feita com OAuth tem acesso total. Um token de Configurações → Acesso de agentes → Tokens MCP adicionais pode ser restringido, e um token restrito nunca enxerga além do seu projeto ou espaço de trabalho.

Acesso totalPermitido
Token somente leituraRecusado
Token de um projetoPermitido
Token de um espaço de trabalhoPermitido

Experimente

Com o Done conectado, peça ao seu assistente algo como:

“Essa recusa é algo que as instruções do projeto deveriam ter coberto. Proponha um novo texto.”

Conecte o Done ao seu assistente

Um endpoint MCP por conta, com OAuth ou com um token. A configuração passo a passo para cada cliente:

Visão geral da configuração do MCP →