Guías prácticas para convertir requisitos informales en especificaciones técnicas listas para producción.
Tutorial sobre el paquete npm @devspeak/cli: instalación global, autenticación con clave de API mediante devspeak login, traducción de texto desde argumentos o stdin, adjuntar contexto local en PDF y Markdown con --file, y cómo integrar la CLI en un pipeline de CI usando la variable de entorno DEVSPEAK_API_KEY.
Tutorial paso a paso de DevSpeak que convierte una solicitud informal de una parte interesada en una especificación técnica formal. Cubre los cuatro parámetros de traducción (audiencia objetivo, contexto técnico, formato de salida y tono de verbosidad), cómo ejecutar una traducción y verificar la salida generada con un punto de control, y cómo refinar esa salida en lenguaje corriente desde el panel Iterar y Refinar, incluido desde el plan VIBECODER.
Tutorial de configuración del servidor MCP @devspeak/mcp: generar una clave de API (en cualquier plan), agregar el bloque stdio en settings.json de Claude Code, claude_desktop_config.json de Claude Desktop, .cursor/mcp.json de Cursor y mcp_config.json de Windsurf, verificar con auth_confirm, leer tier y cuotas con get_account_info, y resolver fallos: sin herramientas de DevSpeak (JSON inválido o sin reiniciar), Cannot reach the DevSpeak API (proxy o VPN), HTTP 401 (clave incorrecta, revocada o sin sustituir) y HTTP 403 (tier sin acceso a la API).
Tutorial para fundamentar traducciones MCP de DevSpeak con Context Projects. Explica por qué las herramientas MCP difieren del registro fijo de conectores, cómo crear un proyecto con activos de documento, enlace e imagen, cómo los conectores context7, github y web_search aportan documentación, contexto de repositorio y resultados web, y cómo pasar contextProjectId a translate_text y refine_translation. Documenta el grounding fail-open —un proyecto desconocido o un conector fallido deja la solicitud sin grounding en vez de dar error— y los estados de ingesta pending, processing, ready y failed.
Referencia avanzada de manejo de errores y control de generación en el servidor MCP de DevSpeak. Cubre el envelope con success, data y error, el significado de HTTP 400, 401, 403, 429 y 5xx, cómo respetar Retry-After ante límites de tasa, cómo manejar timeouts en generaciones largas, cómo fijar un modelo con managedModel, y cómo solicitar XML con responseFormat.
Tutorial del pipeline de tres etapas del servidor MCP de DevSpeak dentro de un IDE con IA: optimize_text para la limpieza léxica de Etapa 1, translate_text para generar un API Design en Etapa 2 con audience, context, format y tone, y refine_translation para la revisión iterativa de Etapa 3 con previousOutput y feedback. Explica por qué la Etapa 1 actúa sobre el texto original y la Etapa 3 sobre la salida generada, y cómo summarize_input maneja texto sobre el límite de 10.000 caracteres.
Referencia completa para principiantes del Editor de Traducción de DevSpeak. Documenta cada control: la barra de funciones con Búsqueda Web, Salida (Prosa/XML), Modelo y Proyecto; los parámetros Público Objetivo, Contexto Técnico, Formato de Salida y Tono; las acciones Optimizar, Traducir Texto, IA Rápida y Detener Generación; el cajón de adjuntos (PNG, JPG, WEBP, PDF, TXT, MD, con límites de tamaño por archivo y por petición); los modos de salida Vista previa, Dividido y Código; el panel Iterar y Refinar; y la paleta de comandos, con valores por defecto y niveles de suscripción.