• TUTORIAL
  • HOW-TO
  • REFERENCE
  • HUMAN

How to enforce Diátaxis structure with your AI

Connect this MCP to your agent to stop it from mixing up tutorials and references. It forces your documentation into the four distinct Diátaxis quadrants.

Ask AI about this page

Short answer

How can I make my AI follow Diátaxis?

Your agent uses the validate_technical_writing tool to check if your content fits the four Diátaxis categories: tutorials, how-to guides, reference, and explanation. It flags content that bleeds between these types so you can fix the structure. You'll get a clear breakdown of what needs to move where.

Where every issue lands.

The structural outcomes

The AI categorizes your content based on its intent and purpose.

TUTORIAL

Learning-oriented paths

The AI identifies content meant for hands-on learning. It ensures these sections focus on a successful outcome for a beginner.

HOW-TO

Task-oriented guides

The agent flags content that should be a step-by-step guide. It checks that these sections solve specific user problems.

REFERENCE

Information-oriented facts

The AI pulls out technical specifications and descriptions. It ensures these stay dry and factual without instructional fluff.

HUMAN

Manual structural edits

The AI flags content that violates Diátaxis rules. You'll receive these specific warnings to perform the final reorganization.

The workflow

What your AI does when the documentation arrives.

The agent acts as a structural auditor for your technical docs.

  1. Analyze intent

    The agent reads your raw text to determine if it's teaching, guiding, or describing.

    validate_technical_writing

  2. Check Diátaxis compliance

    It compares your content against the four quadrants to see if types are being mixed.

    validate_technical_writing

  3. Identify structural leaks

    The agent finds where a tutorial is trying to be a reference or vice versa.

    validate_technical_writing

  4. Generate correction list

    It produces a list of specific content blocks that need to be moved or rewritten.

    validate_technical_writing

Try it

Copy these to start.

Use these prompts to begin the structural audit.

Starting points

Swap the file names or repository paths for your actual documentation files.

Technical Writing Prover Connector

You're all set. Choose your MCP client and follow the setup instructions.

Connector linkhttps://edge.vinkius.com/vk_preview_OWaZOabijYQqiXzNKgOGtWneCoMKT68VO6tDqnNd/mcp

Claude Desktop

Follow the steps below to connect in seconds.

  1. 1In Claude Desktop, open Settings → Connectors.
  2. 2Click “Add custom connector” and paste the connector link above as the remote MCP server URL.
  3. 3Click Add and start a new chat — Technical Writing Prover capabilities are ready to use.
Configuration · claude_desktop_config.jsonCopy
{
  "mcpServers": {
    "technical-writing-prover-mcp": {
      "url": "https://edge.vinkius.com/vk_preview_OWaZOabijYQqiXzNKgOGtWneCoMKT68VO6tDqnNd/mcp"
    }
  }
}
Copy into chat04

  • Check this markdown file in my repo for Diátaxis compliance.

  • Does this tutorial in my docs folder contain too much reference material?

  • Audit the documentation in this GitHub repository and flag any mixed-intent sections.

  • Review this technical guide and tell me if it follows the how-to quadrant rules.

  • Claude
  • ChatGPT
  • Cursor
  • VS Code
  • Windsurf
  • Claude Code
  • JetBrains
  • Cline

Start here

Connect Technical Writing Prover once, then ask.

Just link the MCP to your client. Your login stays encrypted, and you can start auditing docs immediately.

Connect Technical Writing Prover to your AI

FAQ

How this task behaves

  • 01

    Can the AI rewrite the documentation for me?

    No. The AI identifies structural issues and flags what needs to change, but you must perform the actual writing and moving of content.

  • 02

    Will it change my existing files?

    No. The AI only reads and analyzes your files to provide feedback. It does not have permission to write or overwrite your documents.

  • 03

    Does it work with any documentation format?

    It works with standard text-based formats like Markdown that your AI client can read.

  • 04

    Can it fix my tone of voice?

    No. This tool is specifically for enforcing the Diátaxis structural framework, not for stylistic or tonal editing.

  • 05

    How does it know if a section is a tutorial?

    It uses the validate_technical_writing tool to check the content's intent against the specific characteristics of the Diátaxis quadrants.

  • More questions about Technical Writing Prover? The Connector page answers them. See everything the Technical Writing Prover Connector can do

Connect Technical Writing Prover to Claude, Cursor, ChatGPT & more