feat: add MCP prompt templates with YAML override support

[disintegrator]

• Add MCP prompt registration to the docs server via templates discovered in docs folders and exposed through prompts/list and prompts/get.
• Support two authoring formats: *.template.md (single user text message shorthand) and *.template.yaml (multi-message structured prompts), with mustache rendering for text content.
• Exclude prompt templates from indexing, persist normalized prompts in metadata.json.
• Prefer YAML when both formats share a derived prompt name (with warnings in build and validate). Example: if /example.template.md and /example.template.yaml are found then the latter is used.

Codex

Not supported

Cursor

Supported via slash commands

Claude Code

Claude Desktop

VS Code

[changeset-bot]

🦋 Changeset detected

Latest commit: 5becccc

The changes in this PR will be included in the next version bump.

This PR includes changesets to release 5 packages

Name	Type
@speakeasy-api/docs-mcp-server	Minor
@speakeasy-api/docs-mcp-core	Minor
@speakeasy-api/docs-mcp-cli	Minor
@speakeasy-api/docs-mcp-eval	Minor
@speakeasy-api/docs-mcp-playground	Minor

Not sure what this means? Click here to learn what changesets are.

Click here if you're a maintainer who wants to add another changeset to this PR