Deja una automatización que otra persona pueda entender.

Ejemplo ficticio: un flujo recibe una solicitud, comprueba sus campos y prepara un borrador para el equipo de soporte. No envía la respuesta al cliente. Esa última frase delimita una acción que alguien podría dar por supuesta.

En la ficha, completa objetivo, evento de inicio, entrada mínima, resultado esperado y acciones excluidas. Añade quién usa el resultado y quién mantiene el flujo. Si son personas diferentes, registra ambas funciones.

Guarda una solicitud ficticia válida y describe lo que debe ocurrir en cada paso: recibirla, validar campos, asignar categoría y crear borrador. Anota dónde se consulta el estado y qué identificador conecta la entrada con el resultado.

Incluye las reglas de clasificación y sus excepciones. Si hay instrucciones para un modelo, indica dónde está la versión activa. Para las conexiones, documenta qué acceso necesita cada paso y quién puede renovarlo, sin copiar contraseñas ni claves en la ficha.

Ensaya una entrada incompleta, una conexión que no responde y un resultado que necesita revisión. Para cada caso, escribe cómo se detecta, dónde queda el trabajo y qué persona decide el siguiente paso.

No uses «volver a ejecutar» como respuesta universal. Primero comprueba si ya se creó el borrador o se modificó algún registro. Documenta qué pasos se pueden repetir y cómo reconocer un resultado previo para no duplicarlo.

Ficha: nombre del flujo; propósito; responsable; fecha de la última revisión real; evento de inicio; entrada de ejemplo; reglas; salida esperada; ubicación del estado; conexiones necesarias; errores conocidos; cómo detenerlo; cómo continuar manualmente; comprobación antes de reintentar.

Completa cada campo con una instrucción localizable. «Mirar el error» no indica dónde; «abrir el historial del flujo y buscar el identificador de la solicitud» ya describe un recorrido. Sustituye los nombres genéricos por los de tu entorno.

Pide a otra persona que use la ficha con una entrada ficticia correcta y otra incompleta. Observa si localiza el resultado, identifica qué falta y sabe a quién acudir. Anota las preguntas que la obligan a buscarte y mejora la documentación con ellas.

Repite ese ensayo después de cambiar una conexión, regla o salida. Conserva un registro breve de qué cambió y por qué. Una ficha pequeña que refleja el proceso actual resulta más útil para este ejercicio que un manual extenso que nadie ha comprobado.