DEV Community

Renato Marinho
Renato Marinho

Posted on

Stop letting your AI agents write terrible DevRel

I've seen this happen dozens of times. An engineering team finally ships a massive, much-needed fix—something that solves a long-standing headache described in three different GitHub issues—and the resulting announcement sounds like it was written by a mid-level PR agency intern trapped in a basement.

"We are thrilled to announce our innovative solution!"

If I see that sentence in a changelog, I am closing the tab. Immediately.

The problem isn't just bad writing; it's a fundamental breakdown in how we communicate technical value. And now, as we move toward agentic workflows where LLMs handle more of our documentation, social posts, and release notes, this problem is scaling at an alarming rate. Without guardrails, your AI agents will become the ultimate generators of corporate fluff.

They love buzzwords. They adore terms like 'seamless,' 'robust,' and 'leveraging.' They excel at listing features while completely ignoring the context of why those features were even requested.

This is exactly why I wanted to look at the DevRel Voice Prover.

The Gap Between Content and Communication

You probably think you have a content problem. You don't. You have a validation problem. Most people assume if an AI generates text that follows proper grammar and includes the right keywords, the job is done. But DevRel (Developer Relations) isn't about following templates; it's about maintaining trust through authenticity.

A senior engineer doesn't talk to another senior engineer using adjectives like 'game-changing.' They talk about implementation details, trade-offs, and specific fixes.

When I looked into how this MCP operates, I realized it isn't actually a writer. If you ask an agent to 'write a post about v2.0,' it might still fail spectacularly because its primary objective remains generation rather than scrutiny.

The DevRel Voice Prover acts as a specialized validator—a gatekeeper that sits between the generative process and the final output. It enforces five specific decision pivots that separate professional DevRel from useless marketing noise:

  1. Developer Voice: Eliminating the "corporate speak" that makes devs tune out.
  2. Community Awareness: Forcing the inclusion of specific signals like GitHub issue numbers or Discord threads instead of vague phrases like "people asked for this."
  3. Value Articulation: Moving from "we added X" (feature dumping) to "X removes this specific pain point" (value delivery).
  4. Actionable Paths: Ensuring there is always runnable code or migration commands included so the reader knows exactly what to do next.
  5. Authentic Engagement: Checking if the content has enough soul that swapping the brand name wouldn't make it identical to a competitor’s template.

The Failure Modes in Practice

The most interesting part of this tool isn't what it allows, but what it rejects. Let's look at how it handles common failures found in typical AI outputs.

A classic "Feature Dump" looks fine on paper: "We added GraphQL subscriptions and improved error messages."
To an untrained eye, that's informative news. To this MCP, it's garbage because it lacks the why. Why does GraphQL matter here? Did polling cause latency spikes? Were errors previously opaque? If you don't explain how the daily workflow changes for the developer, you haven't communicated anything useful; you've just updated a list.

The tool identifies these gaps during evaluation. In one example provided in its documentation, an attempt to announce a highly anticipated v3.0 release was flagged as CORPORATE_SPEAK because every adjective used was hollow marketing jargon ($innovative$, $best-in-class$, $seamless$). Instead of passing, it demanded a rewrite focused on resolving specific auth token race conditions mentioned in earlier issues.

Integrating Validation into Agentic Pipelines\ launched recently, many teams are building custom internal tools to automate their comms pipelines via MCP servers running in local environments or cloud containers.\ud83d\udccd Rather than trying to prompt-engineer perfection—which is basically playing whack-a-mole with hallucinations—you simply plug this prover into your loop.

You provide your draft or your raw structured data (like a JSON log of closed issues), and the agent uses the validate_devrel_voice tool to cross-reference its own output against these strict authenticity standards.

You can find the full suite for this at https://vinkius.com/ai-agent-connect/devrel-voice-prover. It belongs alongside other precision tools designed for engineers who need accuracy over volume—things like my colleagues working on API design verification or commit diff reviews under similar frameworks built on MCPFusion.

A question often comes up when discussing such specialized servers: Does this thing actually write things for me?<br>
The answer is no, and that’s intentional. Writing requires intent; validating requires rigor. By separating these roles, you ensure that the human or high-level orchestrator maintains control over intent, while the MCP ensures execution quality meets professional standards.\ize technically accurate communication precisely when automation usually drifts towards mediocrity.


MCPs are the music of AI Agents. We built the catalog. Discover Vinkius MCP Catalog.

Top comments (0)