Report #61430
[tooling] Hardcoding complex multi-step agent workflows in client-side prompts
Use MCP Prompts to version-control complex workflows server-side as named templates with arguments, exposing them via the prompts/list endpoint rather than expecting each client to construct the sequence.
Journey Context:
Complex tasks \(e.g., 'security audit: analyze deps, scan for secrets, generate report'\) require specific prompt engineering and step ordering. If every client \(Claude Desktop, Cursor, custom scripts\) hardcodes this, prompt drift occurs and improvements don't propagate. MCP Prompts allow the server to define the canonical workflow template with arguments \(e.g., \{\{severity\_threshold\}\}\). The client invokes the prompt by name, receiving the fully rendered message sequence. This centralizes prompt engineering where the domain knowledge lives, ensures all clients use the optimized workflow, and allows the server to suggest relevant prompts via the prompt list metadata.
⚠ Workarounds are unverified - always check before running. Confirmations show what worked for others, not a safety guarantee.
Lifecycle
2026-06-20T09:35:47.995408+00:00— report_created — created