¿Qué hace Visualizador de Flujos de Trabajo?
Cuando alguien quiere entender un flujo de trabajo en detalle, el texto corrido rara vez es suficiente. Un proceso tiene un orden, transferencias, decisiones y tiempos de espera. Un gráfico adecuado lo hace legible de inmediato. Reemplaza la respuesta larga de texto en lugar de añadirse a ella.
La forma se elige libremente. Ninguna forma tiene prioridad, ni la línea de tiempo ni ninguna otra. La estructura del flujo de trabajo decide.
Cuándo aplica esta habilidad
Dos condiciones juntas:
- El contexto es un flujo de trabajo, proceso o procedimiento (el propio del usuario, uno que se haya discutido, o uno que necesite explicarse desde cero).
- El usuario quiere más profundidad: "en detalle", "más precisamente", "paso a paso", "explica de nuevo", "cómo funciona".
Si la palabra "flujo de trabajo" solo surge de paso y la pregunta se responde rápidamente, responde brevemente en el chat. Un gráfico para cada mención pasajera lo devalúa.
Procedimiento
- Clarifica el proceso. Toma el proceso de la conversación, de los archivos o de las fuentes que nombre el usuario. Si falta algo esencial, pregunta una vez, brevemente. No inventes pasos, duraciones ni herramientas. Cualquier cosa no verificada se marca como "Abierto".
- Lee la estructura, luego elige la forma. Consulta la siguiente sección. Di en una frase en el chat qué forma elegiste y por qué. El usuario puede anular tu decisión con una palabra.
- Esquema. De 4 a 10 pasos en total, agrupados en 2 a 4 fases o carriles. Más pasos diluye el gráfico; en su lugar, resume subprocesos.
- Completa cada paso.
- Marcador de tiempo o posición: una duración real, punto en el tiempo u orden ("Paso 3"). Sin horas de reloj supuestas.
- Un símbolo de la leyenda.
- Un título (sustantivo, corto) y una o dos frases sobre qué ocurre y por qué.
- Opcional: cuadro Importante: solo cuando una información puede determinar el éxito o fracaso del proceso (prerrequisito, fuente de error, aprobación).
- Opcional: cuadro Concreto: una imagen tangible, ejemplo o analogía que haga comprensible un paso abstracto. La imagen explica algo; no decora.
- Construye la leyenda. Solo los símbolos que aparecen en el gráfico, más los elementos de la forma elegida. La leyenda va en la parte superior.
- Entrega como página. Constrúyela a partir de
assets/base-template.html(tokens, encabezado, leyenda, cuadros) y añade la estructura de la forma elegida siguiendoreferences/shapes.md. Para el diagrama de flujo hay un ejemplo terminado enassets/flowchart-example.html: reutiliza su CSS y reemplaza el contenido. Titula la página con el nombre del flujo de trabajo, por ejemplo "Flujo de aprobación de documentos". Si tu entorno puede publicar páginas o artefactos, publícalo allí; de lo contrario, entrega un archivo HTML autónomo. - Responde en el chat. Una o dos frases: la forma elegida con la razón, y cualquier punto abierto. No repitas el contenido del gráfico.
Elección de la forma
Lee primero la estructura del flujo de trabajo, luego decide. Estas preguntas ayudan:
- ¿Hay decisiones cuyo resultado lleva de vuelta (un bucle), o cuyos caminos se reencuentran, y debería el lector poder seguir la ruta con el dedo? → Diagrama de flujo
- ¿Los caminos se dividen en decisiones y terminan en lugares diferentes sin volver? → Ramificación
- ¿Varias personas, herramientas o roles llevan partes del proceso, la dificultad está en las transferencias, y no hay bucle? → Carriles
- ¿El proceso comienza de nuevo sin cambios después del último paso, o el resultado alimenta la siguiente ejecución, sin decisiones intermedias? → Ciclo
- ¿Las ramas ocurren al mismo tiempo y deben reunirse en algún punto? → Pistas paralelas
- ¿El proceso es en esencia una secuencia de pasos a lo largo del tiempo, con tiempos de espera, plazos o duraciones que importan? → Línea de tiempo
- ¿El flujo de trabajo mezcla varias propiedades? Elige aquella donde el lector tenga más probabilidades de equivocarse. La propiedad secundaria se convierte en un cuadro informativo o una etiqueta de ubicación: un diagrama de flujo puede mostrar dónde tiene lugar un paso sin necesidad de carriles.
Un bucle es la razón más común para cambiar de forma. Ocultarlo en un cuadro informativo lo entierra, y es justo donde los lectores tropiezan. Si hay uno, el diagrama de flujo suele ser la forma más honesta, incluso si los carriles o la línea de tiempo parecen adecuados a primera vista.
No elijas por apariencia o por costumbre. Una forma que no coincida con la estructura falsea el proceso: un eje oculta alternativas, los carriles sin transferencias reales son decoración.
Las reglas exactas de construcción para cada forma están en references/shapes.md. Lee solo la sección de la forma elegida.
Símbolos
Todos angulares, sin círculos. Las formas se dibujan con CSS en lugar de caracteres para que se vean igual en todas partes.
| Símbolo | Forma | Significado |
|---|---|---|
| Acción | cuadrado relleno | se hace o produce algo |
| Decisión | cuadrado vacío | el flujo se bifurca aquí |
| Punto de control | diamante | verificación, aprobación, visto bueno |
| Transferencia | triángulo | el resultado pasa a una persona, herramienta o fase |
| Espera | barra horizontal | no ocurre nada activamente, el tiempo pasa |
| Abierto | cuadrado discontinuo | falta información o no está verificada |
Añade más símbolos solo cuando el flujo de trabajo realmente los necesite, y explícalos en la leyenda.
Estilo
La plantilla trae un valor predeterminado neutro: un fondo de papel cálido, tinta casi negra, un acento pálido usado solo como superficie, y la fuente del sistema. Todos los colores son tokens en :root. Si el usuario tiene una marca o sistema de diseño, cambia solo esos tokens; no rediseñes la estructura.
- Fondo de papel, tinta para títulos, grafito para texto corriente, un tono tranquilo para superficies silenciosas, líneas finas para reglas.
- El acento se usa solo como superficie, nunca como color de texto o línea. El texto sobre él es siempre tinta. Como máximo una banda de acento grande por página; las pequeñas barras marcadoras (10px) bajo los títulos de fases y carriles pueden repetirse.
- Una familia tipográfica. Jerarquía mediante peso y espaciado entre letras; espaciado solo en mayúsculas.
- Sin sombras, gradientes, esquinas redondeadas, emojis ni signos de exclamación. Las listas usan cuadrados de tinta. Las conexiones son líneas rectas con ángulos rectos, de 2px de tinta.
- La página se mantiene en un solo tema sobre papel. Todos los colores se establecen explícitamente para que se lea igual en interfaces claras y oscuras.
- Prioridad móvil, sin desplazamiento horizontal de la página. Cualquier cosa que deba ser más ancha (carriles) se desplaza en su propio contenedor.
No inventes nuevos colores, fuentes o formas. Si al sistema le falta algo, nombra la carencia y resuélvelo dentro de los tokens.
Idioma
Escribe el gráfico en el idioma que el usuario está usando. Mantenlo factual, basado en sustantivos y corto. Sin relleno, sin jerga de moda. Las explicaciones pueden ser vívidas pero precisas: una imagen fuerte en lugar de tres débiles.
Lista de verificación antes de entregar
- La forma sigue la estructura del flujo de trabajo, y la frase en el chat nombra la razón.
- Todo bucle está dibujado como un camino y no solo mencionado en texto.
- Cada declaración de tiempo está documentada o marcada solo como orden.
- Cualquier cosa no verificada lleva el símbolo "Abierto".
- Todos los símbolos en el gráfico aparecen en la leyenda, y no otros.
- El acento se usa solo como superficie, nunca como texto o línea.
- Ningún texto se sale del borde, ni siquiera a 400px de ancho.
- El texto del chat no repite el contenido del gráfico.