Writing & Content Workflows

Use whenever a task touches the RichDocument system at matrx-frontend — rendering markdown/interactive content WITH an action toolkit (copy, save to notes/scratch/task/code, save as file, HTML preview, copy HTML page, email, print, edit, open in full-screen editor, fork, delete, TTS, analyze/debug, convert to broker, add to docs) on any surface that is NOT the live chat AssistantActionBar. Triggers on features/rich-document/, any or usage, the richDocumentActionSurfaces Redux slice, registerAction, ContentSource, ContentSourceAdapter, the enableContextMenu prop, or anything mentioning "rich document", "action bar on markdown", "save to task/notes from ", "remote action surface", "action surface id", "context menu on content", "add an action to the menu", "multi-layer overflow menu", or "put actions on a markdown preview". Read this BEFORE adding an action, adding a content source, wiring a remote surface, or swapping a MarkdownStream / BasicMarkdownContent consumer to gain actions. NOT for the live chat message bar (that is AssistantActionBar + messageActionRegistry.ts — see the overlay-system skill's "Message actions (chat)" section).

Consume scoped short-lived credentials from the aidream token broker in matrx-frontend. Use whenever a task needs temporary privileged reach from the browser — a provider realtime session (OpenAI realtime voice), direct provider API calls (Anthropic messages), or ANY capability that would otherwise require a provider API key client-side. Triggers on "API key in the browser", "realtime session token", "ephemeral token", "call directly", "broker", "brokered credential", "mint a token", lib/api/broker/, or any temptation to put a provider secret in NEXTPUBLIC env. Read BEFORE wiring any provider connection from client code.