docs: consolidate voice/writing-style guidance into the brand MCP#19777
docs: consolidate voice/writing-style guidance into the brand MCP#19777cnunciato wants to merge 4 commits into
Conversation
Make the Pulumi brand guide (served by the public pulumi-brand MCP server) the source of truth for voice and writing-style, and have the docs STYLE-GUIDE and content skills consult it instead of restating it. - STYLE-GUIDE.md: trim to Hugo/repo mechanics + a pointer to the brand guide's voice/writing-style sections; add a precedence rule (the brand guide wins on any overlap, including social/SEO/AEO). - AGENTS.md: point content rules at the brand guide; standardize headings on sentence case at every level; precedence rule. - glow-up: require the pulumi-brand MCP (fail loud if unreachable) and defer voice/prose/terminology to it. - prose-patterns: source-of-truth note pointing at brand writing-style. - new-doc / new-blog-post: suggest sentence-case titles; point at the guide. - .vale.ini: put punctuation outside quotes; note the sentence-case standard. - claude-code-review.yml / content-review-article.yml: wire the public brand MCP (mcp_config + get_guidelines/search_guidelines) so CI review can consult voice/writing-style. SEO and social guidance intentionally stay in this repo's skills for now. Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
Pre-merge Review — Last updated 2026-06-20T00:27:11ZTip Summary: <TODO: one paragraph — (1) what this PR is (content type + subject; for a new page, which existing pages it parallels), (2) what specific kind of wrongness would block a reader's success, (3) which investigative passes ran>. Review confidence:
Investigation log
🔍 Verification trail28 claims extracted · 12 verified · 6 unverifiable · 2 contradicted
🚨 Outstanding in this PRThese must be resolved or refuted before merging.
|
… input) The pinned anthropics/claude-code-action@v1 rejects a top-level mcp_config input (logged 'Unexpected input(s) mcp_config' and ignored it). v1 expects custom MCP servers in claude_args via --mcp-config; the config merges with the action's built-in GitHub MCP server. Move the pulumi-brand HTTP server there and keep its tools in --allowed-tools. Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
|
Your site preview for commit 3a75f8c is ready! 🎉 http://www-testing-pulumi-docs-origin-pr-19777-3a75f8c1.s3-website.us-west-2.amazonaws.com |
The 'Upload Claude execution log' step pointed at a hardcoded temp path (/home/runner/work/_temp/claude-execution-output.json) that claude-code-action@v1 no longer writes, so with if-no-files-found:ignore it silently uploaded nothing — losing per-tool spend telemetry and any visibility into MCP usage. Point it at the action's `execution_file` output instead. The stream-JSON log's system/init message lists mcp_servers + connection status, which also lets us confirm the brand MCP connects. Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
The execution_file output renders empty under the pinned claude-code-action@v1, and an empty upload-artifact path fails the step. Restore the original harmless no-op path; execution-log observability is a separate follow-up. Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
Draft — opened primarily to verify the brand MCP server connection in CI.
What this does
Makes the Pulumi brand guide (public
pulumi-brandMCP server athttps://brand.pulumi.com/mcp) the source of truth for general voice + writing-style, and has the docsSTYLE-GUIDE.mdand content skills consult it rather than restating it. Adds a precedence rule: wherever the brand guide overlaps anything in this repo, the brand guide wins.Verifying the MCP connection
The brand MCP is wired into
claude-code-review.ymlandcontent-review-article.ymlviamcp_config, pointing at the already-live public server (no auth). Note: the auto-review fires viaworkflow_run, which uses master's copy of the workflow — so this PR's newmcp_configis exercised by manually dispatching the review on this branch, not by the auto-trigger.Out of scope
SEO/AEO and social-copy skills stay in this repo untouched for now; they'll be handled in the brand guide separately. The brand-side changes (voice/writing-style enrichments) are a separate
pulumi/marketing-webPR.🤖 Generated with Claude Code