Cómo aplicar la estructura Diátaxis con tu IA

Tu agente utiliza la herramienta validate_technical_writing para verificar si tu contenido encaja en las cuatro categorías de Diátaxis: tutoriales, guías prácticas, referencia y explicación. Detecta cuando los tipos de contenido se mezclan para que puedas corregir la estructura. Obtendrás un desglose claro de qué mover y dónde.

1. 01

   Analizar intención

   El agente lee tu texto para determinar si busca enseñar, guiar o describir.

   validate_technical_writing
2. 02

   Verificar cumplimiento Diátaxis

   Compara tu contenido con los cuatro cuadrantes para ver si se están mezclando tipos de contenido.

   validate_technical_writing
3. 03

   Detectar fugas estructurales

   El agente encuentra dónde un tutorial intenta actuar como referencia o viceversa.

   validate_technical_writing
4. 04

   Generar lista de correcciones

   Produce una lista de bloques de contenido específicos que deben moverse o reescribirse.

   validate_technical_writing

Technical Writing Prover Connector

Todo listo. Elige tu cliente MCP y sigue las instrucciones de configuración.

Enlace del conectorhttps://edge.vinkius.com/vk_preview_OWaZOabijYQqiXzNKgOGtWneCoMKT68VO6tDqnNd/mcpCopiar

Claude Desktop

Sigue los pasos siguientes para conectarte en segundos.

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.

Configuración · claude_desktop_config.jsonCopiar

{
  "mcpServers": {
    "technical-writing-prover-mcp": {
      "url": "https://edge.vinkius.com/vk_preview_OWaZOabijYQqiXzNKgOGtWneCoMKT68VO6tDqnNd/mcp"
    }
  }
}

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

Solo tienes que vincular el MCP a tu cliente. Tu inicio de sesión permanece cifrado y puedes empezar a auditar documentos de inmediato.

• 01

  ¿Puede la IA reescribir la documentación por mí?

  No. La IA identifica problemas estructurales y señala qué debe cambiar, pero tú debes realizar la escritura y el movimiento del contenido.

• 02

  ¿Modificará mis archivos actuales?

  No. La IA solo lee y analiza tus archivos para darte feedback. No tiene permiso para escribir ni sobrescribir tus documentos.

• 03

  ¿Funciona con cualquier formato de documentación?

  Funciona con formatos de texto estándar como Markdown que tu cliente de IA pueda leer.

• 04

  ¿Puede corregir mi tono de voz?

  No. Esta herramienta es específicamente para aplicar el marco estructural de Diátaxis, no para edición de estilo o tono.

• 05

  ¿Cómo sabe si una sección es un tutorial?

  Utiliza la herramienta validate_technical_writing para contrastar la intención del contenido con las características de los cuadrantes de Diátaxis.

• ¿Tienes más dudas sobre Technical Writing Prover? La página del Connector tiene las respuestas. Ver todo lo que puede hacer el conector Technical Writing Prover