specrails-desktop 2.64.2 → 2.65.0

package/docs/guide/es/getting-started/3-try-the-sample-project.md

@@ -0,0 +1,35 @@
+# Prueba el proyecto de ejemplo
+
+¿Quieres ver cómo una spec se convierte en un cambio revisado antes de apuntar specrails a tu propio código? El **proyecto de ejemplo** es un pequeño juego web de tres en raya con tres specs ya escritas. Tarda unos minutos y termina en un **paquete de revisión** real.
+
+## Empezar
+
+En la pantalla de bienvenida, haz clic en **Pruébalo en un proyecto de ejemplo** (junto a **Añadir tu primer proyecto**). El diálogo te explica, antes de que pase nada:
+
+- **Qué se crea**: un pequeño juego web en su propio repositorio git, con tres specs ya en tu tablero.
+- **Dónde**: por defecto `~/Specrails Samples/tic-tac-toe`, dentro de tu carpeta personal. Puedes cambiar la carpeta; una carpeta existente nunca se sobrescribe.
+- **Cuánto costaría una ejecución**: una estimación como «≈ $0,30–$1 · unos 3–5 min». Solo se muestra en dólares cuando tu proveedor factura por uso. Con un plan de suscripción indica que no hay cargo adicional, y con un motor local no hay coste de API.
+
+Crear el ejemplo no cuesta nada y no ejecuta nada. Haz clic en **Crear proyecto de ejemplo** y llegarás al Tablero.
+
+## Los tres pasos
+
+Una pequeña tarjeta guía señala el Tablero real, paso a paso. Puedes cerrarla en cualquier momento; se reduce a una píldora **Proyecto de ejemplo** desde la que **Mostrar guía** la recupera.
+
+1. **La spec.** Las tres specs están escritas para ti. Cada una dice qué construir y cómo saber que está terminada.
+2. **El rail.** Haz clic en **Ejecutar la primera spec**. El ejemplo está preparado para ser barato y acotado: modo rápido, el modelo más barato disponible y un límite suave por ejecución (la ejecución se detiene y pregunta antes de pasar de $1). Si tienes un motor local configurado, puedes elegirlo, sin coste de API.
+3. **La revisión.** Nada se fusiona solo. Al terminar la ejecución, un **paquete de revisión** muestra qué cambió y te deja aceptarlo o descartarlo.
+
+## ¿Ningún proveedor de IA listo?
+
+Antes de ofrecerte la ejecución, specrails comprueba que haya un proveedor instalado y con sesión iniciada. Si no hay ninguno, verás **Ver una ejecución grabada**: una reproducción de una ejecución terminada que acaba en un paquete de revisión. Está claramente marcada como grabación; no se ejecuta nada y no se cobra nada. Instala un proveedor o inicia sesión y elige **Comprobar de nuevo** para pasar a una ejecución real.
+
+## Después, tu propio proyecto
+
+La guía termina con **Ahora añade tu propio proyecto**. Cuando termines con el ejemplo, **Quitar ejemplo** lo da de baja con un clic. La carpeta permanece en el disco salvo que marques **Eliminar también la carpeta del ejemplo**, algo que no se puede deshacer.
+
+## Repetir el tour de la plataforma
+
+El tour ya no está en la pantalla de bienvenida. Abre **Docs** y elige **Repetir el tour**, o abre la paleta de comandos y escribe «Repetir el tour». También está en **Ajustes ▸ Apariencia**.
+
+Siguiente: [Añadir tu primer proyecto](adding-your-first-project).

package/docs/guide/es/getting-started/5-the-dashboard-tour.md

@@ -0,0 +1,52 @@
+# El recorrido por el tablero
+
+Con un proyecto ya añadido, estás viendo el **tablero de tu proyecto**: tu base de operaciones para convertir specs en código publicado. Vamos a ver cómo orientarte.
+
+## El panorama general
+
+La ventana tiene tres zonas:
+
+- **Barra lateral izquierda** — tu lista de proyectos. Haz clic en cualquier proyecto para cambiar a él al instante; todo lo demás en la ventana se actualiza para reflejarlo. El botón **Añadir proyecto** también vive aquí.
+- **Área principal** — el tablero del proyecto activo: tus specs y el pipeline que las ejecuta.
+- **Barra lateral derecha** — la navegación entre las secciones del proyecto actual.
+
+## El tablero principal
+
+Aquí es donde ocurre el trabajo. El tablero muestra:
+
+- **Tus specs** — las specs que has creado, organizadas por estado (de Backlog/Por hacer hasta Hecho). Puedes verlas como lista, como cuadrícula o como tarjetas tipo nota adhesiva, lo que prefieras.
+- **Una forma de añadir una spec** — empieza un nuevo trabajo. Puedes escribir una spec rápida directamente, o abrir un chat guiado de **Explore** que te ayuda a darle forma a través de la conversación y redacta la spec por ti.
+- **Rails** — son los carriles donde se construyen las specs. Suelta una spec en un rail y lánzala para enviarla a través del pipeline Architect → Developer → Reviewer → Ship. Pueden ejecutarse varios rails a la vez, así que puedes trabajar en varias cosas en paralelo.
+
+Cuando una spec está en ejecución, verás el progreso de su pipeline y sus logs en directo: la salida en tiempo real de la IA mientras diseña, programa y revisa tu cambio.
+
+## La barra lateral derecha: las secciones del proyecto
+
+La barra lateral derecha es tu cuadro de mandos para el proyecto actual. Pasa el ratón por encima para expandirla, o ánclala abierta. Las secciones que verás:
+
+- **Tablero** — el tablero de specs y los rails (donde acabas de estar).
+- **Trabajos** — todas las ejecuciones de pipeline de este proyecto, pasadas y presentes, con su estado, su duración y la posibilidad de profundizar en el detalle y los logs de cualquier ejecución.
+- **Integraciones** — complementos opcionales, como conectar tus specs a un tablero de **Jira** o habilitar herramientas adicionales para la IA.
+- **Ajustes** — opciones por proyecto (telemetría, presupuestos, configuración de providers y más).
+
+## La barra de estado
+
+Una fina franja recorre la parte inferior de la ventana. Es pequeña, pero útil:
+
+- **Indicador de conexión** (izquierda) — un punto de color y una etiqueta que muestran que la app está activa: verde para *conectado*, ámbar mientras *reconecta*, azul mientras *sincroniza* justo después de una reconexión. Rara vez lo necesitarás, pero tranquiliza tenerlo.
+- **Gasto total** (derecha) — un total acumulado de lo que has gastado, para que el coste esté siempre a un solo vistazo.
+- **Botón de terminal** (extremo derecho) — abre el panel de terminal integrado. Pulsa **Cmd+J** (macOS) o **Ctrl+J** (Windows/Linux) para alternarlo en cualquier momento. Es una shell completa, abierta directamente en la carpeta de tu proyecto.
+
+## Algunos atajos prácticos {#shortcuts}
+
+- **Cmd/Ctrl+B** — ancla o contrae la barra lateral izquierda; **Option+Cmd+B** (**Ctrl+Alt+B**) hace lo mismo con la derecha.
+- **Cmd/Ctrl+J** — alterna el panel de terminal.
+- **Cmd/Ctrl+K** — la paleta de comandos: busca misiones, proyectos y trabajos, y **ejecuta acciones**. Escribe un verbo («nueva», «lanzar», «mover», «cambiar») o empieza con **>** para listar acciones: Nueva spec (también en Explorar), Lanzar o Mover una spec, Abrir su revisión, Entregar o Pausar un Flow, Nueva misión, Cambiar tema, Cambiar entre modo Misión y Tablero, Abrir los ajustes de la app o del proyecto en una sección, Ejecutar un loop, alternar las barras laterales, Ir atrás o adelante, Deshacer el último cambio y Eliminados recientemente. Las acciones que necesitan una elección (un rail, un estado, un tema, una sección) abren una segunda página; **Retroceso** con la búsqueda vacía vuelve. Cada acción muestra su atajo de teclado, así que la paleta te enseña las teclas. Solo ofrece lo que funciona donde estás y respeta las mismas reglas que los botones (una spec que no se puede lanzar no se ofrece). Con la búsqueda vacía lista tus **Acciones recientes** y **Lugares recientes**.
+- **Cmd+[ / Cmd+]** (**Alt+← / Alt+→** en Windows/Linux), los botones **←  →** de la barra de título o los botones atrás/adelante del ratón — vuelven o avanzan por los lugares donde has estado: specs, misiones, trabajos, proyectos y paneles a pantalla completa. Clic derecho (o pulsación larga) en un botón muestra los últimos lugares.
+- **Cmd+Shift+I** (**Ctrl+Alt+I** en Windows y Linux) o el botón **Pendientes** de la barra de título — la lista **Pendientes**: todo lo que espera por ti en todos tus proyectos, en una sola lista agrupada por proyecto. Reúne revisiones listas para decidir, preguntas que un agente está esperando, ejecuciones que fallaron o quedaron bloqueadas, ejecuciones pausadas por el presupuesto diario y actualizaciones de Jira que no pudieron sincronizarse. Cada fila tiene su acción principal a mano (**Abrir revisión**, **Responder**, **Reanudar**, **Reintentar**) más **Posponer** (1 hora o hasta mañana) y **Hecho**. Un elemento pospuesto o hecho vuelve solo si cambia su estado. El botón muestra cuántos elementos esperan y una notificación de límite del proveedor abre la lista. La lista también es un enlace (`?inbox=1`) y una acción de la paleta de comandos.
+- **M** — con una tarjeta de spec enfocada en el tablero, abre un selector para moverla a un estado o a un rail; es el equivalente de arrastrar y soltar con el teclado. Funciona también con una selección múltiple, y la paleta lo ofrece como **Mover la spec enfocada…**.
+- **?** — la hoja de atajos. Escribe en su cuadro de búsqueda para filtrar los atajos y encontrar páginas y secciones de esta guía, que se abren en la guía sin salir de tu pantalla. Los pequeños iconos **ⓘ** y los enlaces **Más información** junto a los ajustes, los rails, Flow, el control deslizante de contexto y los presupuestos abren la guía en la sección correspondiente del mismo modo.
+
+## A dónde ir después
+
+Ya conoces el terreno. Desde aquí, el primer paso natural es **añadir una spec** y lanzarla en un rail: observa cómo el pipeline se ejecuta de principio a fin y luego revisa las **Analíticas** para ver cuánto costó. Bienvenido a bordo.

package/docs/guide/es/getting-started/6-universal-search.md

@@ -0,0 +1,34 @@
+# Búsqueda universal (⌘K)
+
+Pulsa **⌘K** (**Ctrl+K** en Windows y Linux) para buscar casi todo en Specrails desde un solo sitio: misiones, specs, registros de trabajos, archivos, ajustes y esta guía. Escribe una consulta normal para buscar misiones, proyectos, specs y trabajos recientes como siempre, o empieza con un **prefijo** para buscar solo en una fuente.
+
+## Prefijos
+
+| Escribe | Busca | Intro abre |
+| --- | --- | --- |
+| `#` | Specs: título, resumen, descripción, etiquetas, notas de fuera de alcance, adendas y comentarios. `#12` encuentra la spec 12. | La spec |
+| `@` | Misiones: título y contenido de la conversación. | La misión |
+| `/` | Ajustes (de Desktop y del proyecto) por nombre o por cómo los llamarías. | La ventana de ajustes en ese bloque, visible y con el foco |
+| `f:` | Archivos del proyecto, por nombre o ruta. | El archivo en el explorador de código |
+| `log:` | Registros de trabajos: comandos, nombres de loops, títulos de fases y diagnósticos de fallo. | El trabajo |
+| `?` | Esta guía: títulos de páginas y encabezados. | La guía en ese encabezado |
+
+Al escribir un prefijo se convierte en una **etiqueta** dentro de la caja de búsqueda y la caja conserva solo tu consulta. Pulsa **Retroceso** con la caja vacía (o haz clic en la × de la etiqueta) para quitar el ámbito. Con la caja vacía, la paleta lista los prefijos bajo la caja; haz clic en uno para empezar. `>` sigue listando acciones, como antes.
+
+## Resaltado
+
+Los resultados muestran un fragmento corto alrededor de la primera coincidencia, con el texto coincidente resaltado. La búsqueda ignora mayúsculas y acentos, así que `revision` encuentra «Revisión».
+
+## Ajustes
+
+`/` conoce los bloques principales de ajustes, en tu idioma: tema, idioma, editor, presupuestos, notificaciones, webhooks, actualizaciones, rama, entorno, telemetría, reglas y más. Los ajustes del proyecto se ofrecen cuando hay un proyecto abierto. Elige uno y se abre la ventana correcta en ese bloque. Sin prefijo, una coincidencia fuerte (tres o más caracteres) añade hasta tres ajustes a los resultados normales. `/budget` también encuentra el panel de Presupuesto (límites, proyección, y si…), donde viven los límites semanal y mensual. Un comando con barra como `/implement` aparece bajo los ajustes, en su propio grupo, así que el prefijo `/` nunca lo oculta.
+
+## Registros de trabajos
+
+`log:` busca en un índice compacto, no en la salida cruda de una ejecución: el comando, el nombre del loop, los títulos de las fases y el diagnóstico breve de una ejecución fallida, bloqueada o atascada. Nunca guarda flujos de tokens ni la salida de herramientas, así que se mantiene pequeño y rápido. Se guarda por proyecto y contiene las ejecuciones más recientes.
+
+## Conviene saber
+
+- `#`, `f:` y `log:` buscan en el proyecto activo; abre un proyecto primero.
+- El ámbito de archivos respeta las reglas de exclusión del explorador de código.
+- Cada grupo muestra solo sus mejores resultados; afina la consulta para acotar.

package/docs/guide/es/insights/1-analytics-and-cost-tracking.md

@@ -1,20 +1,22 @@
 # Analíticas y seguimiento de costes
 
-Cada vez que Specrails ejecuta una CLI de IA en tu nombre —un job del pipeline, una spec rápida, una sesión de Explore, un refinado con IA, un resumen de archivo— deja constancia de lo que ocurrió: qué modelo se ejecutó, cuántos tokens entraron y salieron, cuánto tardó y cuánto costó. La sección **Analíticas** convierte todo eso en un único panel para que siempre sepas adónde va tu gasto en IA.
+Cada vez que Specrails ejecuta una CLI de IA en tu nombre —un trabajo del pipeline, una spec rápida, una sesión de Explore, un refinado con IA, un resumen de archivo— deja constancia de lo que ocurrió: qué modelo se ejecutó, cuántos tokens entraron y salieron, cuánto tardó y cuánto costó. La sección **Analíticas** convierte todo eso en un único panel para que siempre sepas adónde va tu gasto en IA.
 
 Ábrela desde la barra lateral derecha (está etiquetada como **Analíticas**). Todo lo que ves está acotado al proyecto en el que estés ahora mismo: cambia de proyecto y los números te siguen.
 
 ## Qué cuenta como gasto
 
-Specrails registra cinco tipos de actividad de IA, llamados *superficies*. Cada uno tiene un color asignado de forma consistente en todas las gráficas, para que lo identifiques de un vistazo:
+Specrails etiqueta cada ejecución de IA con una *superficie*: la parte de la app que generó el gasto. Las superficies principales tienen un color fijo y su propio chip de filtro, para que las identifiques de un vistazo:
 
-- **Job** — un rail del pipeline ejecutando Architect → Developer → Reviewer → Ship.
+- **Trabajo** — un trabajo del pipeline en cola (Architect → Developer → Reviewer → Ship), incluidas las ejecuciones Freestyle.
+- **Loop** — cada paso de IA de una ejecución de loop. Los rails se ejecutan como loops por defecto, así que la mayor parte del gasto de los rails aparece aquí.
 - **Quick spec** — una spec generada por la vía rápida de Add Spec.
 - **Explore spec** — una conversación de Explore en la que das forma a una spec charlando.
 - **AI edit** — un refinado asistido por IA sobre un agente o un archivo.
-- **File summary** — los resúmenes en lenguaje sencillo que alimentan el Code explorer.
+- **SMASH** — dividir una spec épica en specs más pequeñas.
+- **File summary** — los resúmenes en lenguaje sencillo y las historias de archivo que alimentan el Code explorer.
 
-Hay un par de cosas que, a propósito, *no* se registran: el panel de chat lateral y el asistente de configuración también lanzan CLIs de IA, pero nunca aparecen en tu gasto. Así el panel refleja trabajo real y repetible, en lugar de conversaciones puntuales.
+También se registran superficies menores, sin chip propio: el panel de chat lateral, el lanzador de specs de OpenSpec, las propuestas de specs, Agent Studio y el chat de configuración heredado. Las misiones fijadas al proyecto también cuentan en su gasto. No se deja fuera nada que ejecute una CLI de IA, así que los totales reflejan toda la actividad de IA del proyecto.
 
 ## Cómo leer el panel
 
@@ -40,9 +42,9 @@ Tus modelos con más gasto (hasta diez). Haz clic en cualquier modelo para filtr
 
 Cada punto es una invocación, situando el coste frente al número de turnos. Los valores atípicos —las ejecuciones caras y con muchos turnos— saltan a la vista enseguida. (La dispersión muestra tus 500 puntos más recientes para seguir siendo ágil.)
 
-### Tickets principales
+### Specs principales
 
-Tus diez tickets más caros sumando *todas* las superficies a la vez, de modo que un ticket que costó poco en Explore y mucho en un job muestra su total real. Los tickets eliminados y las ejecuciones sin atribuir tienen su propio grupo, así que nada desaparece en silencio de los totales.
+Tus diez specs más caras sumando *todas* las superficies a la vez, de modo que una spec que costó poco en Explore y mucho en un trabajo muestra su total real. Las specs eliminadas y las ejecuciones sin atribuir tienen su propio grupo, así que nada desaparece en silencio de los totales.
 
 ### Tabla de invocaciones en bruto
 
@@ -50,23 +52,23 @@ La verdad sobre el terreno: una fila por invocación. Este bloque tiene sus prop
 
 ## Filtrado
 
-La cabecera fija de la parte superior lleva los dos filtros principales —**periodo** y **superficie**— y ambos se guardan en la URL de la página. Eso significa que puedes marcar como favorita o compartir una vista filtrada ("últimos 30 días, solo jobs") y se reabrirá exactamente como la dejaste. Los filtros de la tabla en bruto son aparte y se mantienen locales a ese bloque.
+La cabecera fija de la parte superior lleva los dos filtros principales —**periodo** y **superficie**— y ambos se guardan en la URL de la página. Eso significa que puedes marcar como favorita o compartir una vista filtrada ("últimos 30 días, solo trabajos") y se reabrirá exactamente como la dejaste. Los filtros de la tabla en bruto son aparte y se mantienen locales a ese bloque.
 
 Una nota sobre la precisión: las ejecuciones fallidas y abortadas se dejan fuera de las *medias de coste* (distorsionarían los números por ejecución), pero siguen contando para tu número total de ejecuciones y tu tasa de fallos. Así las medias se mantienen limpias mientras la imagen de fiabilidad queda completa.
 
-## Coste por ticket
+## Coste por spec
 
-No hace falta ir a la página de Analíticas para ver cuánto costó una spec. Abre cualquier ticket y, si tiene gasto asociado, verás un resumen de una línea justo debajo del título:
+No hace falta ir a la página de Analíticas para ver cuánto costó una spec. Abre cualquier spec y, si tiene gasto asociado, verás un resumen de una línea justo debajo del título:
 
 > $0.42 · 6 turns · 1m 12s active · breakdown
 
-Haz clic y aterrizas en la página de Analíticas ya filtrada por ese ticket. Es el camino más rápido entre "¿cuánto me costó esta funcionalidad?" y el desglose completo.
+Haz clic y aterrizas en la página de Analíticas ya filtrada por esa spec. Es el camino más rápido entre "¿cuánto me costó esta funcionalidad?" y el desglose completo.
 
 ## Exportar tus datos
 
 Cuando necesites los números fuera de la aplicación —una hoja de cálculo, un informe de finanzas, tu propio análisis— usa el desplegable **Exportar**. Ofrece cuatro formatos:
 
-- **CSV resumen** — un archivo con varias secciones que incluye totales, la cronología diaria, por superficie, por modelo y tickets principales.
+- **CSV resumen** — un archivo con varias secciones que incluye totales, la cronología diaria, por superficie, por modelo y specs principales.
 - **JSON resumen** — el mismo resumen, estructurado.
 - **CSV en bruto** — cada fila de invocación (hasta 10 000; indica si tuvo que truncar).
 - **JSON en bruto** — las mismas filas en bruto, estructuradas.
@@ -76,3 +78,15 @@ Las exportaciones respetan los filtros de periodo y superficie que tengas aplica
 ## Siempre al día
 
 No necesitas refrescar. Cuando se registra una nueva invocación en cualquier parte del proyecto, el panel abierto se vuelve a cargar discretamente un instante después, de modo que el medidor de consumo va al ritmo del trabajo a medida que termina.
+
+## Presupuestos diarios {#daily-budget}
+
+Define un presupuesto diario para limitar lo que puede costar un día. Todos los límites (diario, semanal, mensual y por ejecución) se editan en un único sitio: **Analíticas → Presupuesto**. **Ajustes → Avanzado** y **Ajustes del proyecto → Presupuesto** solo muestran el límite diario actual, con un botón **Abrir Presupuesto** que te lleva allí.
+
+Cuando el gasto registrado del día alcanza un límite, la cola se pausa sola, los rails y las ejecuciones de loops se niegan a lanzarse con *Límite diario alcanzado*, y una ejecución de loop en curso se detiene entre pasos, en pausa por el límite. Sube o quita el límite, o espera al reinicio diario, y luego reanuda.
+
+El límite del proyecto cuenta tu día local; el de toda la app cuenta el día UTC. La alerta de coste por trabajo es un ajuste aparte.
+
+**Límites semanales, mensuales y por ejecución.** Los límites más largos funcionan igual. Abre **Analíticas → Presupuesto** para fijar un límite **semanal** y uno **mensual**, por proyecto y para toda la app, y un **límite blando por ejecución** (*pausar y preguntar a $X*). Las semanas empiezan el lunes y los meses el día 1, en tu hora local. Un límite semanal o mensual pausa las colas, rechaza lanzamientos y deja en pausa los loops en curso igual que el límite diario; súbelo o bórralo ahí, o espera al reinicio. Cuando el coste reportado de una ejecución alcanza el límite por ejecución, se pausa, y **Reanudar** pregunta si continuar sin el límite o subirlo. Alcanzar cualquier límite añade además un elemento **Subir límite** a la bandeja.
+
+El panel de Presupuesto muestra hoy, esta semana y este mes frente a cada límite. Su **proyección** a fin de mes es una estimación (la media de los últimos 14 días completos por los días que quedan, más lo que ya has gastado) y nunca se suma al gasto facturado. **Y si** vuelve a calcular los últimos 30 días de uso de tokens registrado con otro modelo usando la lista de precios de la app, y dice *Sin precio* si no tiene precio para un modelo. Con un plan de suscripción no hay coste en dólares por uso, así que el panel muestra turnos y límites del plan en lugar de dólares.

package/docs/guide/es/insights/2-the-integrated-terminal.md

@@ -1,4 +1,4 @@
-# El terminal integrado
+# El terminal integrado {#integrated-terminal}
 
 Specrails tiene un terminal de verdad integrado: el panel que sube desde la parte inferior de la ventana, igual que el de VS Code o Cursor. Ejecuta tu shell real, en el directorio real de tu proyecto, así que puedes usar `git`, `npm`, tests o cualquier otra cosa sin salir de la aplicación.
 

package/docs/guide/es/insights/3-code-explorer.md

@@ -1,4 +1,4 @@
-# Code explorer
+# Code explorer {#code-explorer}
 
 La sección **Code** te da una ventana amigable y de solo lectura a tu repositorio, pensada especialmente para quienes quieren entender lo que la IA ha estado construyendo sin vivir dentro de un editor. Tienes un árbol de archivos a la izquierda, un visor de código a la derecha y, encima del código, un resumen en lenguaje sencillo de lo que hace realmente cada archivo.
 
@@ -10,7 +10,7 @@ En esta versión es estrictamente de solo lectura: nada de lo que hagas aquí ca
 
 El panel izquierdo es un árbol virtualizado de los archivos de tu proyecto: rápido incluso en repositorios grandes. Respeta tu `.gitignore` y una lista de exclusión integrada, así que ves los archivos que importan, no un mar de artefactos de compilación y `node_modules`.
 
-Junto a los archivos verás **chips de procedencia**: pequeñas marcas que te indican que un archivo fue *tocado por IA*. Esto es el corazón del Code explorer: Specrails registra qué archivos creó o modificó cada job del pipeline y los vincula al ticket que originó el trabajo. Así puedes responder, de un vistazo, "¿esto lo escribió la IA o lo escribí yo?".
+Junto a los archivos verás **chips de procedencia**: pequeñas marcas que te indican que un archivo fue *tocado por IA*. Esto es el corazón del Code explorer: Specrails registra qué archivos creó o modificó cada trabajo del pipeline y los vincula a la spec que originó el trabajo. Así puedes responder, de un vistazo, "¿esto lo escribió la IA o lo escribí yo?".
 
 En la parte superior del árbol hay un filtro:
 
@@ -33,7 +33,7 @@ Encima del código verás un **resumen en lenguaje sencillo** del archivo —par
 
 Los resúmenes son listos a la hora de mantenerse al día: están vinculados al contenido del archivo, de modo que cuando un archivo cambia de verdad el resumen se regenera, pero los archivos sin cambios no se vuelven a resumir sin necesidad. Si editas un archivo tú mismo, su resumen se marca como obsoleto en vez de regenerarse en silencio: tú mantienes el control de cuándo se refresca. Hay una acción de **regenerar** para cuando quieras una versión fresca al momento.
 
-Un par de salvaguardas mantienen los costes a raya: la generación de resúmenes se ejecuta dentro de un **presupuesto mensual** (unos pocos dólares por defecto, configurable en Ajustes), y hay topes de cuántos resúmenes lanzará un mismo job. Si se omite un resumen, la aplicación te dice por qué: presupuesto alcanzado, un tope por job, o que el archivo simplemente no se encuentra.
+Un par de salvaguardas mantienen los costes a raya: la generación de resúmenes se ejecuta dentro de un **presupuesto mensual** (unos pocos dólares por defecto, configurable en Ajustes), y hay topes de cuántos resúmenes lanzará un mismo trabajo. Si se omite un resumen, la aplicación te dice por qué: presupuesto alcanzado, un tope por trabajo, o que el archivo simplemente no se encuentra.
 
 También puedes elegir el **idioma del resumen** (inglés o español) en los ajustes globales, dentro del área *Code section*.
 
@@ -45,11 +45,11 @@ Para cualquier capítulo puedes pedir una explicación en lenguaje llano: pulsa
 
 ## Conectar el código con las specs
 
-El vínculo de procedencia funciona en ambos sentidos. Dentro del Code explorer, hacer clic en el chip de un ticket sobre un archivo abre el detalle de ese ticket. Y en sentido inverso, la vista de **detalle del ticket** tiene una sección *Archivos tocados por este ticket*: haz clic en un archivo ahí y saltas directo al Code explorer con él abierto. Cierra el círculo entre "esta es la spec que escribimos" y "este es el código que salió de ella".
+El vínculo de procedencia funciona en ambos sentidos. Dentro del Code explorer, hacer clic en el chip de una spec sobre un archivo abre el detalle de esa spec. Y en sentido inverso, la vista de **detalle de la spec** tiene una sección *Archivos tocados por esta spec*: haz clic en un archivo ahí y saltas directo al Code explorer con él abierto. Cierra el círculo entre "esta es la spec que escribimos" y "este es el código que salió de ella".
 
 ## Lo que (todavía) no hace
 
-Para dejar las expectativas claras, esta primera versión deja fuera a propósito algunas cosas: la edición dentro de la aplicación, los resúmenes por símbolo o por directorio, una vista de diff narrativa y el "pregúntale a la IA sobre este archivo" conversacional. La procedencia atribuye un archivo solo a su ticket principal. Son el tipo de cosas que podrían crecer con el tiempo.
+Para dejar las expectativas claras, esta primera versión deja fuera a propósito algunas cosas: la edición dentro de la aplicación, los resúmenes por símbolo o por directorio, una vista de diff narrativa y el "pregúntale a la IA sobre este archivo" conversacional. La procedencia atribuye un archivo solo a su spec principal. Son el tipo de cosas que podrían crecer con el tiempo.
 
 ## Desactivarlo
 

package/docs/guide/es/integrations/1-ai-providers.md

@@ -1,6 +1,6 @@
 <!-- guide-revision: mission-first-v1 -->
 
-# Conecta un proveedor de IA
+# Conecta un proveedor de IA {#ai-providers}
 
 Specrails coordina tus CLI autenticadas de Claude o Codex. Su instalación, la cuenta y la facturación del modelo son independientes de la aplicación.
 

package/docs/guide/es/integrations/2-plugins.md

@@ -1,4 +1,4 @@
-# Plugins (Integraciones)
+# Plugins (Integraciones) {#plugins}
 
 La sección **Integraciones** es un marketplace por proyecto de complementos opcionales que amplían lo que la IA puede hacer. Cada proyecto decide de forma independiente qué plugins quiere: instalar un plugin en un proyecto nunca afecta a otro.
 

package/docs/guide/es/integrations/3-jira-integration.md

@@ -8,14 +8,14 @@ Specrails actúa como **capa de sincronización** entre Jira y tu proyecto. La i
 
 - Cuando lanzas un rail, Specrails mueve el issue de Jira vinculado a **En progreso**.
 - Cuando un trabajo termina, Specrails transiciona el issue: si tuvo éxito, lo mueve a tu estado de **revisión** mapeado y solo llega a **Hecho** cuando se mergea la PR de entrega o aceptas el resultado local; si falló, vuelve a **Por hacer** con un comentario de finalización que incluye resultado, id de ejecución, coste, duración y el cambio de estado en Jira.
-- Si pides cambios de seguimiento cuando el issue de Jira ya está en revisión, Specrails intenta continuar la rama de la PR abierta existente para ese ticket en lugar de crear una rama nueva. Si tu estado de revisión de Jira no está mapeado explícitamente y todavía aparece localmente como **En progreso**, Specrails puede continuar igualmente la PR cuando la clave de Jira coincide con la pull request abierta.
+- Si pides cambios de seguimiento cuando el issue de Jira ya está en revisión, Specrails intenta continuar la rama de la PR abierta existente para esa spec en lugar de crear una rama nueva. Si tu estado de revisión de Jira no está mapeado explícitamente y todavía aparece localmente como **En progreso**, Specrails puede continuar igualmente la PR cuando la clave de Jira coincide con la pull request abierta.
 - Periódicamente, Specrails **sondea** Jira en busca de cambios que cualquiera haya hecho en el tablero y los refleja de vuelta en tus specs.
 
 Todas las escrituras pasan por un outbox duradero y a prueba de fallos, así que un tropiezo puntual de Jira nunca rompe un trabajo: la actualización simplemente se reintenta.
 
 ## Conectar un tablero
 
-Te conectas desde la página de **Ajustes** de un proyecto (también hay un paso opcional «Configurar Jira» al final del asistente de Añadir proyecto). El asistente de conexión te guía paso a paso:
+Te conectas desde la página **Plugins** de la barra lateral izquierda: pulsa **Instalar** en la tarjeta de Jira y elige el proyecto. El asistente de conexión te guía paso a paso:
 
 1. **Probar** — introduce la URL de tu Jira y tus credenciales, y Specrails verifica la conexión.
 2. **Elegir un proyecto** — elige con qué proyecto de Jira sincronizar.
@@ -52,7 +52,7 @@ Así que puedes experimentar con libertad —actívalo, ejecuta unos cuantos rai
 
 ## El día a día
 
-Una vez conectado, la página de Ajustes del proyecto muestra una **tarjeta de conexión** donde puedes:
+Una vez conectado, la tarjeta de Jira de la página **Plugins** pasa a **Gestionar**. Elige ahí el proyecto para abrir su **tarjeta de conexión**, donde puedes:
 
 - **Sincronizar ahora** — fuerza un sondeo inmediato en lugar de esperar al temporizador.
 - **Reintentar cartas muertas** — vuelve a ejecutar cualquier escritura que se haya quedado atascada.
@@ -69,4 +69,4 @@ Las specs respaldadas por Jira muestran una **insignia con la clave de Jira** (c
 
 ## Desactivarlo
 
-Si en algún momento quieres dar marcha atrás del todo, simplemente **Desconecta** desde Ajustes. Tus specs vuelven al comportamiento solo-local y los metadatos de Jira simplemente quedan sin uso: no se destruye nada.
+Si en algún momento quieres dar marcha atrás del todo, simplemente **Desconecta** desde la tarjeta de conexión. Tus specs vuelven al comportamiento solo-local y los metadatos de Jira simplemente quedan sin uso: no se destruye nada.

package/docs/guide/es/integrations/4-mobile-companion.md

@@ -1,4 +1,4 @@
-# La app complementaria para el móvil
+# La app complementaria para el móvil {#mobile-companion}
 
 Specrails tiene una app complementaria para el teléfono para que puedas vigilar tus rails mientras estás lejos del escritorio: ver los trabajos en marcha, verlos terminar y mantenerte al tanto sin estar sentado frente al panel.
 

package/docs/guide/es/integrations/5-mcp-server.md

@@ -1,4 +1,4 @@
-# Controla Specrails desde cualquier IA (servidor MCP)
+# Controla Specrails desde cualquier IA (servidor MCP) {#mcp-server}
 
 Specrails puede exponerse **a sí mismo** a cualquier asistente de IA que hable el [Model Context Protocol](https://modelcontextprotocol.io) — Claude Desktop, Claude Code, Cursor, Cline o tu propio agente. Actívalo, apunta tu asistente a Specrails y podrás manejar toda la app conversando: *"lista mis proyectos", "crea una spec para login social en el proyecto de la API", "lanza el rail 0 y avísame cuando termine", "¿cuánto he gastado esta semana?"*. Tu asistente llama por debajo a las herramientas de Specrails en lugar de que tú andes haciendo clics.
 
@@ -47,16 +47,16 @@ Desmarca **Destructivo** y podrá trabajar toda la noche sin borrar nada nunca.
 > *"Revisa todos mis proyectos. Dime cuáles tienen specs en el backlog y ningún rail en marcha, y arranca el de mayor prioridad en cada uno."*
 
 **Sin manos mientras programas.** Maneja Specrails desde tu editor o por voz, sin cambiar de ventana:
-> *"Lanza el rail 0 en modo Freestyle con Opus para el ticket #42 y avísame cuando termine."*
+> *"Lanza el rail 0 en modo Freestyle con Opus para la spec #42 y avísame cuando termine."*
 
 **Pregunta por el coste y el historial.** Tus analíticas, en lenguaje natural:
-> *"¿Dónde he gastado más en IA esta semana, por proyecto y por modelo? Enséñame los cinco tickets más caros."*
+> *"¿Dónde he gastado más en IA esta semana, por proyecto y por modelo? Enséñame los cinco specs más caras."*
 
 **Tu standup diario.**
 > *"Escribe mi standup: qué rails se ejecutaron ayer, qué se completó, qué falló y el coste total — en viñetas listas para pegar en Slack."*
 
 **Entiende el código.** Sin necesidad de editor:
-> *"¿Qué archivos tocó el ticket #38? Resume en una línea qué cambió en cada uno."*
+> *"¿Qué archivos tocó la spec #38? Resume en una línea qué cambió en cada uno."*
 
 Como tu asistente lee primero la guía incorporada, rara vez necesitas nombrar herramientas ni specs — describe el resultado que quieres y él se encarga de las llamadas.
 

package/docs/guide/es/integrations/6-agent-chat.md

@@ -1,6 +1,6 @@
 # Maneja Specrails conversando (Agent Chat)
 
-El **Agent Chat** es un copiloto que vive *dentro* de Specrails y puede manejar toda la app por ti. En lugar de ir haciendo clic por proyectos, specs, raíles y analítica, basta con que preguntes: *«¿cuántos trabajos salieron bien esta semana?»*, *«crea una spec para el inicio de sesión social en el proyecto de la API»*, *«lanza los tres tickets de mayor prioridad y avísame cuando terminen»*. Lleva a cabo el trabajo llamando a las propias herramientas de Specrails —las mismas que expone el [servidor MCP](./5-mcp-server.md)— mientras ves el panel actualizarse en directo detrás de él.
+El **Agent Chat** es un copiloto que vive *dentro* de Specrails y puede manejar toda la app por ti. En lugar de ir haciendo clic por proyectos, specs, raíles y analítica, basta con que preguntes: *«¿cuántos trabajos salieron bien esta semana?»*, *«crea una spec para el inicio de sesión social en el proyecto de la API»*, *«lanza las tres specs de mayor prioridad y avísame cuando terminen»*. Lleva a cabo el trabajo llamando a las propias herramientas de Specrails —las mismas que expone el [servidor MCP](./5-mcp-server.md)— mientras ves el panel actualizarse en directo detrás de él.
 
 > **No lo confundas con los agentes del pipeline.** La sección *Agentes* (Architect → Developer → Reviewer) trata de *cómo un raíl implementa una spec*. El **Agent Chat** es un único asistente que *maneja la propia app*. Cosas distintas, misma palabra.
 
@@ -33,6 +33,8 @@ El agente puede tocar toda la app, así que tú decides cuánta libertad tiene c
 
 Empieza en **Observa** y sube el nivel solo cuando quieras que el agente actúe. Si intenta algo por encima del nivel actual, se detiene y te dice exactamente qué nivel activar; nunca sortea el límite. Esto es independiente de los niveles de Ajustes ▸ MCP, que rigen a los asistentes *externos*; el nivel de aquí es solo para este agente interno de la app.
 
+Subir el nivel **a Autónomo** nunca ocurre solo con una tecla: Shift+Tab desde Opera muestra un aviso con **Cambiar a Autónomo**, y si vuelves a pulsar Shift+Tab, se salta y regresa a Observa. Bajar el nivel siempre es inmediato.
+
 ## Algunas cosas que puedes pedir
 
 Cuando estés en **Opera**, prueba con:
@@ -45,18 +47,23 @@ Cuando estés en **Opera**, prueba con:
 >
 > *«Algo ha fallado en el último lote: encuentra los trabajos fallidos y resume por qué.»*
 
-Las respuestas llegan fluidas y ya formateadas (encabezados, tablas, listas), cada una con un pequeño botón de **copiar**. Una etiqueta de estado abajo muestra lo que el agente está haciendo ahora mismo —*Pensando…*, *MCP · jobs*, *Terminal*— para que siempre sepas en qué estado está.
+Las respuestas llegan fluidas y ya formateadas (encabezados, tablas, listas), cada una con un pequeño botón de **copiar**. Una etiqueta de estado abajo muestra lo que el agente está haciendo ahora mismo —*Pensando…*, *MCP · trabajos*, *Terminal*— para que siempre sepas en qué estado está.
+
+Los bloques de código muestran su lenguaje y tienen su propio botón de **copiar**. Si te desplazas hacia arriba mientras el agente sigue escribiendo, aparece la píldora **Mensajes nuevos** sobre el cuadro: púlsala para volver a la última respuesta.
 
 ## Detalles prácticos
 
 - **Súper specs desde una conversación.** Pide al agente *dar forma* a una spec contigo en vez de generarla de una sola vez: primero lee el código real, te entrevista brevemente y muestra el borrador en evolución como una tarjeta en vivo dentro de la conversación. Cuando dices que sí, crea la spec y — por defecto — la enriquece en segundo plano con una **Contract Layer** (rutas de archivo exactas, formas de datos, invariantes) para que los agentes que implementan no improvisen. Di «sin contract layer» para omitir el enriquecimiento.
-- **Haz clic en lo que menciona.** En una misión fijada a un proyecto, los números de spec (`#12`) y los ids de job/ejecución en las respuestas del agente son chips clicables: una spec abre el modal de detalle del tablero y un id de job abre la vista del job en directo. Si la referencia ya no existe, verás un aviso discreto de «no encontrado».
-- **La tarjeta de implementación, siempre a la vista.** Cuando el agente implementa specs, una tarjeta en vivo sigue el trabajo — y mientras necesite algo de ti (crear la PR, publicarla, reintentar, descartar) permanece **fijada justo encima del cuadro de mensaje**, por mucho que se desplace la conversación; en su lugar del historial aparece un marcador discreto de «fijada arriba». Varias tarjetas activas se apilan como pequeños chips (haz clic en uno para traerla al frente), y un chevrón minimiza la tarjeta a una barra fina. Una vez publicada la PR — o cuando el trabajo se fusiona o se descarta — la tarjeta vuelve a su sitio en el historial de la conversación.
+- **Haz clic en lo que menciona.** En una misión fijada a un proyecto, los números de spec (`#12`) y los ids de trabajo/ejecución en las respuestas del agente son chips clicables: una spec abre el modal de detalle del tablero y un id de trabajo abre la vista del trabajo en directo. Si la referencia ya no existe, verás un aviso discreto de «no encontrado».
+- **Una franja para tus ejecuciones.** Cuando el agente lanza trabajo, una única franja justo encima del cuadro de mensaje lo sigue: qué está haciendo la ejecución en palabras claras («Escribiendo la spec a partir de tus cambios»), cuántas ejecuciones han terminado, el tiempo y el gasto real hasta ahora (`—` hasta que el proveedor lo factura). Cuando una ejecución te necesita — crear la PR, reintentar, volver a Flow — la franja lo dice con un icono y palabras y te ofrece esa única acción; pulsa la franja para abrir la tarjeta completa de la ejecución justo encima (Esc la cierra). Con varias ejecuciones, la franja muestra primero la que te necesita y un pequeño selector («Rail 1 · Rail 2 · +1»). La conversación solo guarda lo que pasó — «Lanzado en Rail 1», «Rail 1 falló: …», «Entregado: PR #812» — y cada línea abre su ejecución. Las misiones que esperan tu decisión muestran un punto en la lista de misiones. Las acciones que inician una nueva ejecución de pago (**Relanzar**, **Recuperar y reintentar**) o que otras personas ven (Crear PR, Publicar) nunca se disparan desde la franja: abre la tarjeta con el foco en ese botón, así que confirmas allí.
+- **La franja desde el teclado.** **⌥R** (**Alt+R** en Windows/Linux) salta del cuadro de mensaje a la franja de la misión en la que estás; vuelve a pulsarlo para ver u ocultar los detalles de la ejecución, y **Esc** te devuelve a donde estabas. Fuera de un campo de texto, **⌥[** y **⌥]** cambian de ejecución. Con la franja enfocada, **P** pausa o reanuda un Flow y **H** lo pasa a un rail; estas letras no hacen nada desde ningún otro sitio. Pulsa **?** para ver la lista completa.
 - **Historial de prompts.** Con el cuadro vacío, pulsa **↑**/**↓** para recorrer lo que preguntaste antes (se muestra atenuado mientras te desplazas); empieza a escribir para editarlo, o pulsa Intro para enviarlo.
 - **Edita la cola.** ¿Enviaste más mientras el agente estaba ocupado? Mientras haya mensajes en cola, **↑**/**↓** recorre *esos* mensajes: el cuadro muestra el seleccionado, lo editas en el sitio y **Intro lo guarda de vuelta en la cola** (Esc cancela; tu borrador sin enviar vuelve tal cual).
+- **Responde con una tecla.** Cuando el agente ofrece opciones, cada chip lleva un número: pulsa **⌥1**…**⌥9** (**Alt+1**…**Alt+9** en Windows/Linux) con el cuadro vacío para elegir una.
+- **Deshaz un mensaje en cola borrado.** Al borrar un mensaje en cola aparece **Deshacer** unos segundos; lo devuelve a la cola.
 - **Minimiza sin perder nada.** Haz clic en la ✕ para devolver el panel a la burbuja: la conversación sigue en marcha. Vuelve a abrirlo y aterrizas en el último mensaje; no hay que reescribir nada.
 - **Nueva conversación.** El botón **+** inicia un hilo limpio; el historial vive a nivel de app, por encima de cualquier proyecto concreto.
-- **Cambia de misión.** El selector de misiones junto al selector de proyecto lista tus conversaciones de más reciente a más antigua — un punto pulsante marca aquellas donde el agente sigue trabajando, y una pequeña insignia cuenta los mensajes en cola. La búsqueda aparece cuando la lista supera las ocho, y el icono de papelera de cada fila elimina una misión tras una confirmación rápida en línea — incluso una en marcha (avisa primero y luego detiene al agente).
+- **Cambia de misión.** El selector de misiones junto al selector de proyecto lista tus conversaciones de más reciente a más antigua — un punto pulsante marca aquellas donde el agente sigue trabajando, y una pequeña insignia cuenta los mensajes en cola. La búsqueda aparece cuando la lista supera las ocho, y el icono de papelera de cada fila elimina una misión al instante y muestra **Deshacer** (o pulsa **⌘Z**) durante unos segundos; después la misión espera 30 días en **Eliminado recientemente**, en los ajustes del proyecto. Una misión donde el agente sigue trabajando pregunta primero, porque detener al agente no se puede deshacer.
 - **Encuentra una misión desde cualquier sitio.** Pulsa **⌘K** (o el botón **Buscar** del sidebar en modo Agente) y escribe cualquier fragmento que recuerdes: una palabra del título *o* de lo que se dijo dentro. Las misiones coinciden al instante por título desde memoria y, un latido después, llegan las coincidencias por contenido con el pasaje resaltado, más el proyecto anclado y cuándo tuvo actividad por última vez. En modo Agente las misiones son el primer grupo; en el tablero van justo después de Proyectos. Enter abre la misión.
 
 ## Cards de lanzamiento y cards de ejecución
@@ -69,9 +76,9 @@ Las respuestas llegan fluidas y ya formateadas (encabezados, tablas, listas), ca
 
 ## Sub-agentes
 
-Algunos proveedores pueden repartir partes de una tarea entre **sub-agentes**: ayudantes que trabajan en paralelo y siguen después de que el agente responda. Los sub-agentes vienen **desactivados por defecto** porque multiplican lo que cuesta una petición.
+Algunos proveedores pueden repartir partes de una tarea entre **sub-agentes**: ayudantes que trabajan en paralelo y siguen después de que el agente responda. Los sub-agentes vienen **activados por defecto**; desactívalos por proyecto si quieres contener el coste, porque multiplican lo que cuesta una petición.
 
-- **Actívalos por proyecto.** Abre **Configuración → Sub-agentes** del proyecto y activa **Permitir sub-agentes en este proyecto**. Cubre las misiones, la exploración y los refinamientos de ese proyecto; los pipelines de Implement nunca se ven afectados. Las misiones sin proyecto siguen **Ajustes de la app → Proveedores de IA → Permitir sub-agentes en misiones sin proyecto**.
+- **Desactívalos por proyecto.** Abre **Configuración → Sub-agentes** del proyecto y desactiva **Permitir sub-agentes en este proyecto**. Cubre las misiones, la exploración y los refinamientos de ese proyecto; los pipelines de Implement nunca se ven afectados. Las misiones sin proyecto siguen **Ajustes de la app → Proveedores de IA → Permitir sub-agentes en misiones sin proyecto**.
 - **Elige quién los ejecuta.** En **Ejecutar sub-agentes con**, la opción por defecto **Igual que el agente de la misión** deja que el propio CLI de la misión los lance de forma nativa: es lo más rápido y comparten su caché de prompt. Elige en su lugar un proveedor, modelo y esfuerzo para combinar proveedores — por ejemplo, una misión en Codex con sub-agentes en Claude. Las misiones que ya usan ese proveedor siguen siendo nativas con ese modelo; con otro proveedor, Specrails lanza cada sub-agente por su cuenta, que arranca en frío y puede costar más, pero te da más control y muestra el coste real de cada uno. Specrails te pide confirmación antes del cambio, y esos sub-agentes llevan una etiqueta con su proveedor en la misión.
 - **Míralos trabajar.** Los agentes que lanza una respuesta aparecen como una línea compacta bajo esa respuesta. Se mantiene abierta mientras trabajan y, cuando terminan todos, se pliega en un resumen con el tiempo y los tokens totales. Despliega una fila para leer su resultado y lo que costó, o para seguir su actividad en directo. Cada lanzamiento se queda en su punto de la conversación, así que los siguientes nunca se mezclan con los anteriores. Detén un agente en marcha desde su fila, o todos desde la línea.
 - **El agente retoma solo.** Cuando terminan los agentes en segundo plano, el agente continúa y publica lo que encontraron, marcado como *Continuó tras los agentes en segundo plano*.

package/docs/guide/es/integrations/7-local-engines.md

@@ -17,7 +17,7 @@ Cada conexión tiene además un ajuste **Bucle del agente**. **Compacto** (por d
 
 - Rails (implement, freestyle, loops personalizados), Explore y specs Quick, chat y misiones se ejecutan con el modelo local.
 - Las misiones conservan sus herramientas Specrails y tus servidores MCP externos.
-- Las sesiones se reanudan entre turnos; los jobs interactivos funcionan.
+- Las sesiones se reanudan entre turnos; los trabajos interactivos funcionan.
 - El coste es honesto: se registran los tokens, el coste queda *desconocido* salvo que indiques tarifas (entonces se marca *estimado*).
 
 No disponible en motores locales: perfiles de agente y roles personalizados, enriquecimiento SMASH / Contract Layer, adjuntos y telemetría del pipeline. El Project Builder funciona en modo solo-salida (sin herramientas); su contrato de blueprint es estricto, así que usa un modelo capaz.

package/docs/guide/es/integrations/8-flow-mode.md

@@ -0,0 +1,69 @@
+# Flow: construir primero, spec después {#flow-mode}
+
+Flow es una forma de construir con un agente cuando todavía no sabes exactamente qué quieres. Hablas con el agente en tu misión, escribe y ejecuta código real en su propia rama de Flow (una copia aparte de tu proyecto) y, cuando el resultado es el bueno, pulsas **Pasar a un rail**: un rail toma tus cambios, deriva la spec y ejecuta la verificación, la revisión y la entrega de siempre.
+
+Implement sirve para delegar trabajo que ya sabes describir. Flow, para descubrirlo.
+
+## Cómo empieza un Flow
+
+No tienes que pedir Flow por su nombre. Cuando describes algo exploratorio o visual («quiero probar…», «no sé cómo debería quedar»), la misión muestra una tarjeta con dos caminos:
+
+- **Flow**: construirlo juntos ahora; la spec llega al final.
+- **Spec + Implement**: acordar primero una spec y luego delegarla a un rail.
+
+Los dos caminos tienen el mismo peso y aparecen siempre en el mismo orden: ninguno se recomienda, eliges tú. En **Por qué pregunta el agente**, el agente explica en una frase qué le hizo preguntar, y no insistirá elijas el camino que elijas o si pulsas **Ahora no**.
+
+Al elegir Flow se abre una confirmación: Specrails crea una copia aparte del proyecto en su propia rama de Flow, donde el agente puede escribir código, y tu rama principal no se toca. Pulsa **Empezar Flow**. En el board aparece una spec provisional con la etiqueta **En Flow** (haz clic en ella para volver a la misión).
+
+Si tu Specrails Core todavía no puede ejecutar Flow, el botón está desactivado y la tarjeta lista lo que falta. Normalmente se arregla actualizando Specrails Core.
+
+## Empezar un Flow desde una spec que ya tienes
+
+Cualquier spec se puede construir en Flow, no solo una idea nueva. Flow e Implement siguen siendo dos formas iguales de trabajarla:
+
+- en el tablero, haz clic derecho en una spec y elige **Empezar en Flow** (junto a arrastrarla a un rail); en el detalle de la spec, **Empezar en Flow** está junto a **Mover a rail**;
+- en una misión, cuando pides implementar una spec sin nombrar un rail, el agente muestra la misma tarjeta de dos caminos para esa spec: **Flow** la trabaja contigo y **Spec + Implement** la lanza en un rail;
+- una tarjeta de lanzamiento en rail de una sola spec también ofrece **Empezar en Flow** junto a su lanzamiento.
+
+La propia spec pasa a **En Flow**: no se crea ninguna spec provisional y el primer turno del agente recibe la spec (sus criterios de aceptación, la Contract Layer, lo que queda fuera de alcance y los addenda abiertos). Si la empiezas desde el tablero, el Flow se abre en la misión de la propia spec o en una misión nueva con el nombre de la spec. En un proyecto con varios repositorios Git, cuando la spec no indica exactamente uno de ellos, un pequeño diálogo pregunta antes dónde se ejecuta el Flow: solo aparecen los repositorios Git, viene preseleccionado el repositorio de la spec (o, si no, el principal) y las flechas cambian la elección. **Empezar en Flow** aparece desactivado, con el motivo al pasar el ratón, cuando la spec ya está en Flow, está hecha o cancelada, está en un rail o Flow no está disponible.
+
+**Descartar** devuelve la spec tal como estaba, con su estado anterior: tu spec nunca se borra. Cuando el Flow se entrega, la spec se reescribe a partir de lo construido y antes se guarda su texto original como comentario, **Original spec before Flow**, para que no se pierda nada. Una spec ya enlazada con Jira actualiza esa misma incidencia y la mueve al estado asignado a revisión; no se crea una segunda.
+
+## Mientras estás en Flow
+
+El modo Flow se nombra allí donde miras, con su propio color de Flow: el compositor muestra un chip **Flow** junto al de autonomía y la pista *Dile al agente qué cambiar en este Flow…*; el título de la misión indica **En Flow**, igual que su fila en la lista de misiones. La conversación marca dónde entraste y saliste de Flow, y las respuestas del agente escritas en Flow llevan una pequeña marca **Flow** junto a su hora.
+
+La franja justo encima del compositor muestra el Flow en una fila corta: su estado, **Flow · 7 archivos**, **Pausar Flow** y la acción principal, **Pasar a un rail**. Cuando una acción no está disponible (el Flow aún está guardando, hay otra acción en curso), al pasar el ratón dice por qué. Abre la fila con su flecha, como cualquier otra ejecución, para ver el resto:
+
+- la **rama** (pulsa para copiar su nombre), los **cambios** con líneas añadidas y eliminadas (pulsa para ver cada archivo con su estado y +/−) y el **coste hasta ahora** según factura el proveedor. Muestra `—` hasta que un turno tiene coste informado, y nunca una estimación; un `*` marca un total que deja fuera turnos sin precio, con una nota que dice cuántos;
+- **Vista previa** mientras la app del Flow está en marcha (ver más abajo);
+- **Descartar**, aparte, borra los cambios del Flow, su rama y la spec provisional. La confirmación enumera lo que pierdes: los archivos cambiados con sus +/−, la rama y la spec.
+
+**Pausar Flow** detiene al agente y conserva tus cambios y la spec. La fila muestra entonces **Reanudar Flow**.
+
+Puedes escribir mientras el agente trabaja: en Flow tu mensaje **interrumpe** el paso actual (el botón de enviar se convierte en un rayo) y el agente sigue al momento con tu nueva información. Mientras el Flow está abierto, la franja de git bajo el compositor se aparta: el panel del Flow ya muestra su rama.
+
+## Prueba la app
+
+El agente de Flow ejecuta él mismo el typecheck y los tests para comprobar su trabajo. Cuando hay algo que probar, te pregunta con tres opciones: **Start the app**, **Start and expose on the local network** o **Not now**. Exponerla te permite abrir la app desde un móvil en la misma Wi-Fi o VPN, y cualquiera en esa red puede acceder a ella.
+
+Cuando la app escucha, el agente te da sus direcciones como enlaces y el panel del Flow muestra **Vista previa** con un punto verde: abre la app en tu navegador. Su menú tiene la dirección de red y **Detener app**. La app se ejecuta desde la copia del Flow, nunca desde tu checkout principal, y Specrails la detiene cuando pausas, descartas o entregas el Flow.
+
+## Pasar a un rail {#flow-hand-off}
+
+Cuando el resultado te convenza, pulsa **Pasar a un rail**. La fila pasa a **Listo para convertirse en un PR** y abre una sola línea encima: *Rail 2 convertirá tus 7 archivos cambiados en un PR revisado. Si falla, tu trabajo está a salvo.* Pulsa **Lanzar**, o **Todavía no** para volver al Flow; **Esc** equivale a **Todavía no**; un clic fuera solo pliega la línea, y la fila sigue en **Listo para convertirse en un PR** con **Lanzar**. Si el motor de tu conversación no puede pasar el Flow a un rail en este equipo, una nota justo debajo de la línea lo dice y se usa el motor por defecto del rail.
+
+El rail, el motor, el modelo y el esfuerzo ya están elegidos (un rail libre y el motor de tu conversación). Para cambiarlos, abre **Cambiar cómo**; ahí también ves qué cambió. El coste hasta ahora aparece en la línea principal. Tus elecciones se conservan si pulsas **Todavía no** y vuelves a pasarlo más tarde. Mientras arranca, la franja lo muestra lanzándose, sin huecos, y después sigue la ejecución paso a paso. Si se alcanza el límite de revisión o un presupuesto, la línea lo dice y no se lanza nada. Si la ejecución no aparece en 45 segundos, la franja deja de girar y dice **Aún pasando a Rail 2…** con **Actualizar**, que vuelve a comprobar y sigue esperando hasta que aparezca la ejecución.
+
+El rail deriva la spec y su cambio de spec a partir de lo que construiste, lo verifica y lo revisa, y la tarjeta de entrega aparece en la misión como en cualquier ejecución.
+
+Si la ejecución falla por un motivo técnico, el trabajo vuelve solo a este Flow, intacto: la tarjeta dice en palabras sencillas qué falló (los códigos quedan en **Detalles técnicos**) y el agente recibe el error y lo explica. Si la revisión pide cambios, la tarjeta ofrece **Volver a Flow** o **Relanzar**. Cuando la entrega se asienta, la misión cierra el Flow con un resumen: el pull request, la spec reescrita a partir de lo que construiste, el cambio de spec archivado y la incidencia de Jira si la hay.
+
+## Conviene saber
+
+- Flow solo escribe en su propia rama. Fuera de Flow las misiones siguen siendo de solo lectura.
+- Un Flow por misión a la vez. La pausa sobrevive a un reinicio de la app.
+- Si la copia del proyecto del Flow desaparece, el Flow queda marcado como **necesita revisión** (para tu información, no hay nada que decidir) y no se borra nada.
+- La franja nunca cambia la ejecución que estás mirando. Si otra empieza a necesitarte mientras tanto, su nombre en el selector de la franja dice **te necesita**.
+- Jira no recibe nada mientras estás en Flow ni si lo descartas.
+- El gasto de Flow aparece en Analítica como superficie propia, **Flow**, y dentro del bloque de misiones del agente.