Propose brief edit

propose_brief_edit

Schreiben

Was es tut

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.

Parameter

Name	Typ	Pflicht	Beschreibung
`tier`	`string`	Pflicht	Which brief: the project's, or one task's own Erlaubte Werte`projecttask`
`target_id`	`string`	Pflicht	The project id (tier project) or task id (tier task)
`text`	`string \| null`	Pflicht	The full proposed brief. null or empty proposes clearing it.
`reason`	`string`	Pflicht	Why — what was rejected and how this wording stops it happening again.
`source_task_id`	`string`	Optional	The rejected task that prompted this, if any
`agent`	`string`	Optional	Your name, for the record (a scoped token's own name wins)

Annotationen

Die Hinweise, die der Server mit diesem Tool mitschickt. Ein Client liest sie, um zu entscheiden, ob er dich vor einem Aufruf fragt.

Nur lesenreadOnlyHint: false: Ändert Daten in deinem Done-Konto.
DestruktivdestructiveHint: false: Fügt nur hinzu oder liest; nichts Bestehendes wird entfernt oder überschrieben.
IdempotentidempotentHint: false: Jeder Aufruf kann etwas Neues hinzufügen, etwa einen Kommentar, einen Lauf oder eine Aufgabe.
Offene WeltopenWorldHint: false: Berührt nur dein eigenes Done-Konto.

Welche Tokens es aufrufen dürfen

Eine per OAuth hergestellte Verbindung hat vollen Zugriff. Ein Token aus Einstellungen → Agentenzugriff → Weitere MCP-Tokens lässt sich einschränken, und ein eingeschränktes Token sieht nie über sein Projekt oder seinen Workspace hinaus.

Voller ZugriffErlaubt
Token nur zum LesenAbgelehnt
Token für ein ProjektErlaubt
Token für einen WorkspaceErlaubt

Probier es aus

Sobald Done verbunden ist, sag deinem Assistenten zum Beispiel:

“Diese Ablehnung hätte die Projektanweisung abdecken sollen. Schlag eine neue Formulierung vor.”

Verbinde Done mit deinem Assistenten

Ein MCP-Endpunkt pro Konto, per OAuth oder Token. Die Einrichtung Schritt für Schritt für jeden Client:

Überblick über die MCP-Einrichtung →