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.

Tu Primera Traducción con DevSpeak

DevSpeak convierte una solicitud informal como «necesitamos que los usuarios inicien sesión con Google» en una especificación técnica formal y específica para una audiencia. Este tutorial recorre una traducción completa y explica qué hace cada control.

Lo que Aprenderás

Configurar los cuatro parámetros de traducción que dan forma a cada salida

Ejecutar una traducción y leer la especificación generada

Refinar el resultado sin empezar de cero (VIBECODER o la prueba de 30 días)

Requisitos Previos

Una cuenta de DevSpeak: el plan GRATIS cubre los Pasos 1–3; el Paso 4 (refinamiento) requiere VIBECODER, que incluye la prueba de 30 días

Una idea de funcionalidad esbozada en lenguaje corriente

Tiempo Estimado

~6 minutos

Paso 1 — Configura los Cuatro Parámetros

Cada traducción se moldea con cuatro controles. No son cosméticos: cada uno cambia lo que contiene el documento generado y cómo se lee.

| Control | Propósito |

| ---------------- | ----------------------------------------------------------------------------------------------------------------------- |

| Público Objetivo | Quién lee la salida: desde Dev Junior hasta Ingeniero de Datos |

| Contexto Técnico | En qué dominio se ubica el trabajo: Backend, Frontend, Móvil, Datos/ML, DevOps |

| Output Format | La forma del documento: Especificación Técnica, Tickets de Jira, Diseño de API, RFC, Modelo de Datos, Prompt, Optimizar |

| Tone | Verbosidad, de 0 a 100, con un corte de comportamiento tajante en 50 |

El deslizador de tono es el que más gente malinterpreta. Por debajo de 50, DevSpeak reescribe y condensa tu entrada. En 50 o por encima, produce un documento técnico completo con secciones que no pediste explícitamente.

Paso 2 — Escribe la Entrada

Mantenla informal. De eso se trata.

``text


Necesitamos que los usuarios puedan entrar con su cuenta de Google
sin tener que crear otra contraseña. Que funcione en el celular también.

`Paso 3 — Traduce`

Selecciona Dev Senior, Backend, Especificación Técnica y un tono de 70. Ejecuta la traducción.

`Punto de Control`

En este punto deberías tener:

[ ] Un documento generado con secciones numeradas


[ ] Criterios de aceptación explícitos que no escribiste tú
[ ] Al menos un caso límite señalado, normalmente la vinculación de cuentas
Si la salida se lee como una versión ligeramente editada de tu entrada, tu deslizador de tono está por debajo de 50. Súbelo y vuelve a ejecutar.
Paso 4 — Refina en Lugar de Reescribir
El refinamiento está incluido desde el plan VIBECODER (la prueba de 30 días cuenta). En el plan GRATIS el panel Iterar y Refinar muestra una insignia PRO y abre el modal de precios en lugar de ejecutarse, así que omite este paso o inicia primero la prueba.
El refinamiento modifica la salida generada, no tu entrada original. Pide un cambio en lenguaje corriente:

`text

Agrega una sección sobre qué pasa cuando un usuario ya tiene una


cuenta con contraseña registrada con el mismo correo electrónico.

Cada refinamiento devuelve un documento de reemplazo completo en lugar de un diff, de modo que el resultado se mantiene coherente internamente.

Solución de Problemas

La salida es más corta que mi entrada

Tu tono está por debajo de 50, lo que pone a DevSpeak en modo de reescritura. Cualquier valor de 50 o superior genera un documento completo.

La especificación apunta a la capa equivocada

Contexto Técnico, y no Público Objetivo, controla el dominio técnico. Una traducción con Dev Senior + Frontend hablará del estado de los componentes, no de esquemas de base de datos.

Resumen

Has aprendido a:

Configurar audiencia, contexto, formato y tono

Generar una especificación formal a partir de una entrada informal

Refinar la salida generada sin perder la estructura

Siguientes Pasos

Explora los otros seis formatos de salida, en especial Tickets de Jira

Lee la [referencia de la API](/docs/api-reference) para automatizar traducciones