ClipManual← Volver al inicio
Guía práctica

Guía paso a paso: escribe instrucciones que se puedan ejecutar

Cómo convertir una tarea en acciones observables, colocar capturas donde aportan contexto y explicar decisiones y excepciones sin esconderlas en párrafos.

Un paso debe permitir actuar sin preguntar

Una guía paso a paso no resume el proceso: acompaña su ejecución. Cada instrucción debe decir qué hacer, dónde hacerlo y qué resultado observar antes de continuar.

La prueba es práctica. Entrega el borrador a una persona con el conocimiento básico necesario y observa dónde se detiene, interpreta dos cosas distintas o pide una explicación. Esos puntos necesitan una acción, una condición o una referencia visual más precisa.

La anatomía de un paso claro

Redacta una acción por paso y añade solo el contexto necesario para ejecutarla.

  1. Verbo en imperativo
  2. Objeto y ubicación
  3. Dato o condición
  4. Resultado esperado
  5. Captura útil

  1. Verbo en imperativo

    Empieza con una instrucción directa: «Abre», «Selecciona», «Escribe», «Confirma». Evita títulos nominales como «Configuración de acceso» si no indican una acción.

  2. Objeto y ubicación

    Nombra el control, el campo o el documento y dónde se encuentra: «Selecciona Estado en la ficha del pedido».

  3. Dato o condición

    Indica qué valor usar o qué debe cumplirse, sin depender de una explicación oral.

  4. Resultado esperado

    Cierra con una señal observable cuando haga falta comprobar el avance: un estado, un número de registro, un mensaje o un archivo creado.

  5. Captura útil

    Coloca la imagen junto al paso donde se usa. La captura debe ayudar a localizar o verificar; no sustituye la instrucción escrita.

De una intención vaga a instrucciones observables

Antes
«Gestiona correctamente la aprobación del pedido en el sistema». La frase nombra una intención, pero no permite ejecutar el trabajo.

Después

  1. Abre el pedido pendiente desde la bandeja Aprobaciones.La captura muestra la bandeja y resalta el identificador del pedido que debe coincidir con la solicitud.
  2. Selecciona Aprobar en el menú Estado.Añade una nota si el menú contiene opciones parecidas o si la acción requiere un permiso específico.
  3. Confirma que el pedido aparece con estado Aprobado.La captura de resultado ayuda a comparar la pantalla esperada con la que recibe quien sigue la guía.

Dónde poner una captura y cuándo omitirla

Usa imágenes para resolver una duda visual concreta. Si no puedes decir qué debe mirar la persona, la captura probablemente añade ruido.

Ubicación

Inclúyela cuando el control es difícil de encontrar, está dentro de un menú o puede confundirse con otro.

Selección

Inclúyela cuando hay varias opciones y la decisión depende de una etiqueta, estado o dato visible.

Resultado

Inclúyela cuando la persona necesita comparar la pantalla final con una señal esperada.

Omisión

Omítela si solo repite un botón que la instrucción ya identifica sin ambigüedad o si expone datos que no hacen falta para aprender el paso.

Antes de compartir, oculta datos personales, credenciales, importes o identificadores que no sean necesarios para ejecutar la tarea.

Cómo marcar decisiones y excepciones

No escondas una bifurcación dentro de una oración larga. Escribe la condición antes de las rutas posibles y deja claro dónde continúa cada una.

  1. Nombra la condición

    Escribe qué dato debe observarse: «Si el estado es Pendiente de revisión…».

  2. Separa cada ruta

    Indica una acción para el caso que cumple la condición y otra para el que no la cumple. Evita «según corresponda» sin criterio.

  3. Define el reencuentro

    Señala en qué paso continúa cada ruta o si el proceso termina. Así se evita repetir o saltar acciones después de una excepción.

  4. Escala lo que no debe decidir quien ejecuta

    Si falta autorización o aparece un caso fuera del alcance, indica a quién avisar, qué información enviar y qué registro conservar.

Lista de revisión antes de compartir

La EPA recomienda redactar en voz activa, en presente y paso a paso, y probar el borrador con una persona distinta de quien lo escribió.

  1. Cada paso empieza con una acción concreta en imperativo.
  2. Cada paso contiene una acción principal; las comprobaciones independientes tienen su propio paso.
  3. Los nombres de botones, campos y estados coinciden con la interfaz vigente.
  4. Las decisiones muestran la condición y las rutas posibles.
  5. Las excepciones indican cuándo detenerse o escalar.
  6. Cada captura está junto al paso que explica y tiene una razón para estar ahí.
  7. El último paso permite comprobar el resultado esperado.
  8. Una persona distinta siguió el borrador y las preguntas encontradas se resolvieron en el texto.

Preguntas frecuentes

¿Cada paso debe llevar una captura?

No. Añádela cuando resuelva una duda de ubicación, selección o resultado. Si la instrucción ya identifica la acción sin ambigüedad, una imagen puede repetir información sin ayudar.

¿Se puede escribir más de una acción en el mismo paso?

Agrupa solo acciones inseparables que no necesiten una comprobación entre ellas. Si alguien puede terminar una acción y detenerse antes de la siguiente, sepáralas para que el avance sea observable.

¿Imperativo significa usar un tono brusco?

No. El imperativo elimina rodeos: «Selecciona Guardar» indica la acción con claridad. El tono depende del resto de la frase y puede mantenerse neutral y respetuoso.

¿Cómo se documenta una excepción poco frecuente?

Escribe la señal que permite reconocerla, la acción segura y el punto de escalamiento. Si requiere otro flujo completo, enlaza a una guía separada en lugar de insertar una rama extensa.

Fuente

Cuando los pasos ocurren en una pantalla

Empieza el borrador desde capturas con ClipManual

Recorre la tarea en pantalla y conserva cada paso en capturas o en un video corto; ClipManual genera un borrador con título, objetivo y pasos numerados en español, listo para editar.

Sin cuentas. Las capturas se procesan en tu navegador; al generar se envían al servidor de ClipManual y a Anthropic, y el servidor de ClipManual no las conserva.

Crear una guía

Guías relacionadas