specrails-desktop 2.64.2 → 2.65.0

package/docs/guide/es/specs/1-specs-and-the-backlog.md

@@ -1,19 +1,37 @@
-# Specs y el backlog
+# Specs y el backlog {#specs-backlog}
 
-Una **spec** es la unidad de trabajo que implementa el pipeline de IA. Piénsala como un ticket: un título, una descripción de lo que quieres conseguir, una prioridad y, opcionalmente, etiquetas. Cuando lanzas el pipeline, los agentes de IA leen la spec y actúan en consecuencia, así que una spec clara es la pieza más importante para obtener un buen resultado.
-
-A veces a las specs se las llama **tickets** en la app: las dos palabras significan lo mismo.
+Una **spec** es la unidad de trabajo que implementa el pipeline de IA. Piénsala como un breve encargo: un título, una descripción de lo que quieres conseguir, una prioridad y, opcionalmente, etiquetas. Cuando lanzas el pipeline, los agentes de IA leen la spec y actúan en consecuencia, así que una spec clara es la pieza más importante para obtener un buen resultado.
 
 ## El tablero
 
-Cada proyecto se abre en su **Dashboard**, que muestra el **SpecsBoard**: la lista de todas las specs del proyecto. Este es tu backlog. Desde aquí creas specs nuevas, defines su prioridad, las arrastras a un rail para implementarlas y ves cómo cambia su estado a medida que avanza el trabajo.
+Cada proyecto se abre en su **Tablero**, que muestra el **SpecsBoard**: la lista de todas las specs del proyecto. Este es tu backlog. Desde aquí creas specs nuevas, defines su prioridad, las arrastras a un rail para implementarlas y ves cómo cambia su estado a medida que avanza el trabajo.
 
 El tablero tiene dos modos de vista, que se cambian con un botón de la barra de herramientas y se recuerdan por proyecto:
 
 - **Vista post-it** (la predeterminada): tarjetas con resúmenes breves.
 - **Vista de lista**: filas compactas de una sola línea.
 
-El **selector de estados** de la barra de herramientas muestra cada estado como su propio chip con un contador en vivo — más dos grupos inteligentes: **Activas** (el valor por defecto — todo lo que sigue en movimiento: borradores, por hacer, en curso y en revisión) y **Todos** (todo, con Hecho fijado al final). Tu selección se recuerda por proyecto y se refleja en la URL, así que un refresco o un enlace compartido restaura la vista exacta. En proyectos conectados a Jira aparece además un desplegable de **estado de Jira**, que lista los estados *reales* del flujo de trabajo del tablero (sus nombres tal cual, p. ej. "Code Review", cada uno con su contador en vivo) agrupados bajo el estado al que mapean — se combina con los chips de estado. También puedes filtrar por **etiqueta**, y ordenar por **Por defecto**, **Ticket #** o **Prioridad** (cada uno con un interruptor ascendente/descendente).
+La barra de herramientas de Specs tiene dos filas. La primera reúne un campo de **búsqueda** (pulsa `/` para ir a él; busca por título, `#número`, etiqueta o clave de Jira), un único botón **Filtros**, los controles de orden y vista, y **Nueva spec**. La segunda fila es el **selector de estados**: cada estado como su propio segmento con un contador en vivo, más dos grupos inteligentes, **Activas** (el valor por defecto: todo lo que sigue en movimiento, es decir borradores, por hacer, en curso y en revisión) y **Todos** (todo, con Hecho fijado al final). Cuando la columna es estrecha, los estados menos usados se pliegan en un menú **Más**, y el estado elegido siempre queda visible. Tu selección se recuerda por proyecto y se refleja en la URL, así que un refresco o un enlace compartido restaura la vista exacta. **Filtros** abre un único panel con una sección por dimensión: **etiquetas** (selección múltiple) y, en proyectos conectados a Jira, **épica**, **sprint** y **estado de Jira** (los estados *reales* del flujo del tablero, p. ej. "Code Review", agrupados bajo el estado al que mapean y combinados con el selector de estados). Mientras una búsqueda o un filtro acota el tablero, una tercera fila muestra cada uno como un chip que puedes quitar, indica "x de y" specs y ofrece **Quitar todo** (que conserva el estado elegido). Ordena por **Por defecto**, **Spec #** o **Prioridad**, cada uno con un interruptor ascendente/descendente.
+
+### Seleccionar varias specs
+
+Clasifica en bloque en lugar de una spec cada vez. Pulsa `x` sobre una tarjeta enfocada, haz clic con `Ctrl`/`⌘` sobre una tarjeta, o clic con `Mayús` para seleccionar un rango (un rango se queda dentro de una columna: las specs activas o el grupo Hecho). `Ctrl`/`⌘`+`A` selecciona toda la columna en la que estás y `Esc` quita la selección. Cada tarjeta muestra una casilla al pasar el ratón o enfocarla, y las seleccionadas tienen el borde resaltado. Ninguna de estas teclas actúa mientras escribes en el campo de búsqueda.
+
+En cuanto hay una spec seleccionada, aparece una barra flotante al pie del tablero con el recuento y las acciones:
+
+- **Mover a** cambia el estado. Las specs locales usan los estados locales; las que vienen de Jira usan los estados reales del flujo del tablero de Jira y se mueven por la misma cola de Jira que un movimiento individual.
+- **Etiqueta** añade una etiqueta a la selección, o quita una que las specs ya tengan.
+- **Prioridad** fija una misma prioridad para todas.
+- **Añadir a un rail** coloca la selección en un rail.
+- **Lanzar todo** da a cada spec seleccionada su propio rail libre y las arranca en paralelo, tras la misma confirmación y comprobación del presupuesto diario que *Lanzar todo* de los rails. Las specs que aún no se pueden lanzar (por ejemplo, en revisión sin PR abierta) o que no encuentran un rail libre se omiten y se cuentan en el resumen.
+- **Eliminar** las envía a *Eliminadas recientemente*.
+- **Quitar** (o `Esc`) descarta la selección.
+
+Eliminar y cambiar estado, etiquetas o prioridad se deshacen en un solo paso: un único aviso *Deshacer* (o `⌘Z`) restaura todas las specs que cambió. Si algunas fallan, un solo aviso indica cuántas funcionaron y cuántas no. La selección solo contiene specs que ves: un filtro que oculta una spec seleccionada la saca de la selección.
+
+### Vistas guardadas
+
+El botón **Vistas**, junto a **Filtros**, guarda el tablero tal como lo tienes ahora: el selector de estado, los filtros, el orden y la densidad (no el texto de búsqueda). Elige **Guardar la vista actual…**, ponle nombre («Listas para lanzar», «Sprint 42», «Fallidas esta semana») y selecciónala después desde el mismo menú. **Gestionar vistas…** renombra una vista, la actualiza con el tablero tal como está, copia su enlace o la elimina. Las vistas pertenecen al proyecto. Un enlace copiado (`?view=…`) aplica la vista al abrirlo en esta aplicación, y la paleta de comandos (`⌘K`) puede guardar la vista actual o cambiar a otra.
 
 ## Estados
 
@@ -38,7 +56,7 @@ Los borradores son la única excepción: un borrador puede *no* tener ninguna pr
 
 ## Crear una spec
 
-Para crear una spec, haz clic en **Añadir** (el botón Más de la barra de herramientas del SpecsBoard). Se abre el diálogo **Añadir spec** con varias formas de trabajar:
+Para crear una spec, haz clic en **Nueva spec** (el botón Más de la barra de herramientas del SpecsBoard). Se abre el diálogo **Añadir spec** con varias formas de trabajar:
 
 - **Modo Quick**: describes lo que quieres y la IA escribe la spec completa de una sola vez. Consulta [Añadir spec — Modo Quick](add-spec-quick-mode.md).
 - **Modo Explore**: conversas con la IA y esta te ayuda a dar forma a la spec turno a turno. Consulta [Añadir spec — Modo Explore](add-spec-explore-mode.md).
@@ -50,6 +68,24 @@ A cuál recurrir depende de lo clara que tengas ya la idea. ¿Sabes exactamente
 
 Cuando una spec ya tiene trabajo detrás (una PR en revisión, una funcionalidad ya fusionada) y quieres *más*, no reescribas su descripción: eso desvirtúa la spec (y sincroniza la desviación con Jira) y obliga a la siguiente ejecución a replanificarlo todo. Abre la spec y añade un **anexo**: una nota breve con un tipo (petición de cambio, feedback de revisión, aclaración, restricción) y tus palabras. Los anexos abiertos viajan automáticamente con el próximo lanzamiento de esa spec en cualquier loop (Implement, SDD Quick, Freestyle), de modo que la ejecución cambia solo lo que pediste, y el paquete de revisión informa de cada uno como aplicado, aplicado parcialmente o bloqueado. Si la ejecución falla o descartas la entrega, vuelven solos a **Abierto**. El agente de misión puede añadirlos por ti cuando le pides cambiar algo de una spec existente.
 
+## Revisar una entrega: qué mirar primero
+
+Cuando termina una ejecución, su paquete de revisión empieza por **Qué mirar**: el breve resumen del revisor de IA con los puntos más arriesgados primero (alto, luego medio y luego bajo, cada uno con fichero y línea), el comportamiento que cambia, las reglas en las que se apoya el cambio, las rutas de código que ningún test ejercita y las comprobaciones que solo puede hacer una persona. Los mismos riesgos, rutas sin test y comprobaciones aparecen en un bloque corto al principio de la pull request, y la tarjeta de la misión muestra el riesgo principal en una línea. El resumen es una ayuda para revisar, no un resultado de verificación: nunca bloquea Aceptar. Las ejecuciones hechas con un Specrails Core anterior no tienen resumen y su paquete se ve como antes.
+
+## Deshacer y Eliminado recientemente {#recently-deleted}
+
+Eliminar una spec, moverla a otro estado, cambiar sus etiquetas o sacarla de un rail ocurre al instante: no hay un "¿Seguro?" previo. En su lugar, un aviso ofrece **Deshacer** durante unos ocho segundos, y **⌘Z** (**Ctrl+Z** en Windows y Linux) hace lo mismo mientras no estés escribiendo en un campo. Deshacer es por proyecto: al cambiar de proyecto se cierra la ventana.
+
+Una spec eliminada (y una misión eliminada) no desaparece. Pasa a **Ajustes → Eliminado recientemente** en los ajustes del proyecto, donde puedes **Restaurarla** durante 30 días o **Eliminarla definitivamente**, que sí pregunta antes. Pasados 30 días se borra para siempre. Descartar trabajo sin enviar, cerrar a la fuerza una pull request y quitar un proyecto siguen preguntando antes, porque no se pueden revertir. Una spec respaldada por Jira se sigue moviendo con **Mover a** en lugar de eliminarse.
+
+## La cronología de la spec y el traspaso {#spec-timeline}
+
+Abre una spec y pasa a la pestaña **Cronología** para leer toda su historia en un solo sitio: las ediciones y adendas, las misiones que la tocaron, cada ejecución con sus fases y acciones del agente, los eventos de la pull request y el veredicto del revisor con sus hallazgos. Las entradas se agrupan por día, los chips filtran por tipo y cada entrada enlaza a la misión, ejecución o revisión de la que viene. Los grupos largos (fases, acciones del agente, turnos de misión) se pliegan con un contador y se despliegan en el sitio.
+
+El coste aparece junto a la entrada que lo generó, con los dos tipos separados: una cifra informada por el proveedor y otra estimada con la tabla de precios local (marcada «est.»). Si un proveedor se factura mediante un plan, la cronología y las exportaciones muestran turnos, nunca dólares; una ejecución que no informó coste simplemente no lo muestra.
+
+**Exportar traspaso** (el menú junto a las pestañas, o ⌘K → *Exportar traspaso de #N*) genera un archivo Markdown o una página HTML autocontenida con el resumen, las decisiones (adendas, aclaraciones, veredictos del revisor), las estadísticas del diff, el coste y lo que sigue abierto (adendas abiertas y hallazgos de revisión sin resolver). **Copiar como descripción de PR** (también en ⌘K) pone en el portapapeles una versión más corta en Markdown. Los encabezados siguen el idioma de la aplicación. Todo pasa por la misma ocultación de secretos que usa la auditoría de acciones del agente, y el aviso te dice cuándo se ocultó algo.
+
 ## Adónde ir después
 
 - [Añadir spec — Modo Quick](add-spec-quick-mode.md): la forma más rápida de convertir una idea en una spec.

package/docs/guide/es/specs/2-add-spec-quick-mode.md

@@ -6,7 +6,7 @@ El modo Quick es para cuando ya sabes lo que quieres. Escribes tu idea, la IA re
 
 Para crear una spec rápidamente:
 
-1. En el Dashboard, haz clic en **Añadir** (el botón Más de la barra de herramientas del SpecsBoard).
+1. En el Tablero, haz clic en **Nueva spec** (el botón Más de la barra de herramientas del SpecsBoard).
 2. Elige el modo **Quick**.
 3. Escribe tu idea en el campo de texto: una frase o un párrafo, lo que la capture.
 4. Haz clic para generar.

package/docs/guide/es/specs/3-add-spec-explore-mode.md

@@ -8,7 +8,7 @@ Recurre a Explore cuando la idea todavía no está del todo formada, cuando hay
 
 Para dar forma a una spec en modo Explore:
 
-1. En el Dashboard, haz clic en **Añadir** y luego elige **Explore**.
+1. En el Tablero, haz clic en **Añadir** y luego elige **Explore**.
 2. Escribe tu primer mensaje: la idea, una pregunta o un pensamiento a medio formar.
 3. Lee la respuesta de la IA y sigue contestando. En cada turno, refina su comprensión.
 4. Observa cómo se actualiza el **borrador en vivo** junto al chat: esta es la spec tomando forma.
@@ -22,7 +22,7 @@ A medida que conversas, un panel de borrador muestra la spec tal como está en c
 
 Esto es el corazón del modo Explore: nunca estás mirando un formulario en blanco. Siempre tienes delante una spec real y en evolución.
 
-## Cuánto ve la IA: el control deslizante de contexto
+## Cuánto ve la IA: el control deslizante de contexto {#context-scope}
 
 Antes de que la IA responda, decides cuánto de tu proyecto puede ver. Un control deslizante de presets de contexto te permite cambiar velocidad por profundidad:
 
@@ -43,7 +43,7 @@ Si quieres un control más fino, haz clic en **Ajuste fino** para activar las op
 
 - **Crear spec**: promueve el borrador en vivo a una spec real con estado **Por hacer**. (Cuando estás editando una spec existente, este botón pasa a leer **Actualizar spec** y parchea esa spec en su sitio.)
 - **Revisar →**: abre una superposición de revisión que muestra la spec propuesta comparada con la línea base antes de confirmar, para que no haya sorpresas.
-- **Guardar como borrador**: conserva la conversación como un ticket de borrador para que puedas retomarlo más tarde. Disponible en cuanto hayas enviado al menos un mensaje. Ver más abajo.
+- **Guardar como borrador**: conserva la conversación como una spec de borrador para que puedas retomarlo más tarde. Disponible en cuanto hayas enviado al menos un mensaje. Ver más abajo.
 - **Minimizar**: aparca la conversación como un chip en el dock de chats minimizados, abajo a la izquierda. Haz clic en el chip en cualquier momento para volver directamente a la conversación: no se pierde nada.
 - **Descartar**: tira la conversación a la basura (pide confirmación primero).
 

package/docs/guide/fr/agents/1-meet-the-agents.md

@@ -1,4 +1,4 @@
-# Faites connaissance avec les agents
+# Faites connaissance avec les agents {#agents}
 
 Quand vous lancez un rail **Implement**, Specrails ne confie pas votre spec à une seule IA en croisant les doigts. Il fait tourner une petite équipe d'*agents* spécialisés, chacun avec une mission précise, dans un ordre bien pensé. Cette page vous présente qui compose cette équipe et le rôle de chacun.
 

package/docs/guide/fr/getting-started/2-installing-and-first-run.md

@@ -39,3 +39,5 @@ Vous y verrez :
 C'est tout l'onboarding — aucun compte à créer, aucune inscription. Specrails fonctionne entièrement sur votre machine.
 
 Cliquez sur **Ajouter votre premier projet** et passez à [Ajouter votre premier projet](adding-your-first-project).
+
+Ou commencez par le [projet exemple](try-the-sample-project) : un petit jeu et trois specs toutes prêtes, avec le coût indiqué d'avance.

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

@@ -0,0 +1,35 @@
+# Essayer le projet exemple
+
+Vous voulez voir une spec devenir un changement relu avant de pointer specrails vers votre propre code ? Le **projet exemple** est un petit jeu web de morpion avec trois specs toutes prêtes. Il faut quelques minutes et on arrive à un vrai **paquet de revue**.
+
+## Le lancer
+
+Sur l'écran d'accueil, cliquez sur **Essayer sur un projet exemple** (à côté de **Ajouter votre premier projet**). La boîte de dialogue vous dit, avant tout :
+
+- **Ce qui est créé** : un petit jeu web dans son propre dépôt git, avec trois specs déjà sur votre tableau.
+- **Où** : par défaut `~/Specrails Samples/tic-tac-toe`, dans votre dossier personnel. Vous pouvez changer le dossier ; un dossier existant n'est jamais écrasé.
+- **Ce qu'une exécution coûterait** : une estimation du type « ≈ 0,30–1 $ · environ 3–5 min ». Elle n'est donnée en dollars que si votre fournisseur facture à l'usage. Avec un abonnement, elle indique qu'il n'y a pas de frais supplémentaires, et avec un moteur local il n'y a aucun coût d'API.
+
+Créer l'exemple ne coûte rien et n'exécute rien. Cliquez sur **Créer le projet exemple** et vous arrivez sur le Tableau.
+
+## Les trois étapes
+
+Une petite carte de guidage montre le vrai Tableau, étape par étape. Vous pouvez la fermer à tout moment ; elle se réduit à une pastille **Projet exemple** d'où **Afficher le guide** la ramène.
+
+1. **La spec.** Les trois specs sont écrites pour vous. Chacune dit quoi construire et comment savoir que c'est terminé.
+2. **Le rail.** Cliquez sur **Exécuter la première spec**. L'exemple est réglé pour être économique et borné : mode rapide, le modèle le moins cher disponible et un plafond souple par exécution (elle s'arrête et demande avant de dépasser 1 $). Si un moteur local est configuré, vous pouvez le choisir, sans coût d'API.
+3. **La revue.** Rien n'est fusionné tout seul. À la fin de l'exécution, un **paquet de revue** montre ce qui a changé et vous laisse l'accepter ou l'écarter.
+
+## Aucun fournisseur d'IA prêt ?
+
+Avant de proposer l'exécution, specrails vérifie qu'un fournisseur est installé et connecté. Si aucun ne l'est, vous obtenez **Voir une exécution enregistrée** : le rejeu d'une exécution terminée qui s'achève sur un paquet de revue. C'est clairement présenté comme un enregistrement ; rien ne s'exécute et rien n'est facturé. Installez un fournisseur ou connectez-vous, puis choisissez **Vérifier à nouveau** pour passer à une vraie exécution.
+
+## Ensuite, votre propre projet
+
+Le guide se termine par **Ajouter maintenant votre projet**. Quand vous en avez fini avec l'exemple, **Supprimer l'exemple** le retire en un clic. Le dossier reste sur le disque, sauf si vous cochez **Supprimer aussi le dossier de l'exemple**, ce qui est irréversible.
+
+## Revoir la visite de la plateforme
+
+La visite n'est plus sur l'écran d'accueil. Ouvrez **Docs** et choisissez **Revoir la visite**, ou ouvrez la palette de commandes et tapez « Revoir la visite ». Elle est aussi dans **Réglages ▸ Apparence**.
+
+Suite : [Ajouter votre premier projet](adding-your-first-project).

package/docs/guide/fr/getting-started/{4-the-dashboard-tour.md → 5-the-dashboard-tour.md}

@@ -37,11 +37,15 @@ Un fin bandeau court tout en bas de la fenêtre. Discret mais bien pratique :
 - **Dépense totale** (à droite) — un cumul en temps réel de ce que vous avez dépensé, pour que le coût soit toujours à portée de regard.
 - **Bascule du terminal** (tout à droite) — ouvre le panneau de terminal intégré. Appuyez sur **Cmd+J** (macOS) ou **Ctrl+J** (Windows/Linux) pour l'afficher ou le masquer à tout moment. C'est un vrai shell, ouvert directement dans le dossier de votre projet.
 
-## Quelques raccourcis bien pratiques
+## Quelques raccourcis bien pratiques {#shortcuts}
 
-- **Cmd/Ctrl+B** — épingler ou replier les barres latérales.
+- **Cmd/Ctrl+B** — épingler ou replier la barre latérale gauche ; **Option+Cmd+B** (**Ctrl+Alt+B**) fait de même pour la droite.
 - **Cmd/Ctrl+J** — afficher ou masquer le panneau de terminal.
-- **Cmd/Ctrl+K** — ouvrir la recherche.
+- **Cmd/Ctrl+K** — la palette de commandes : recherchez missions, projets et jobs, et **lancez des actions**. Tapez un verbe (« nouvelle », « lancer », « déplacer », « changer ») ou commencez par **>** pour lister les actions : Nouvelle spec (aussi en Explorer), Lancer ou Déplacer une spec, Ouvrir sa revue, Transmettre ou mettre en pause un Flow, Nouvelle mission, Changer de thème, Passer du mode Mission au mode Tableau, Ouvrir les réglages de l'app ou du projet sur une section, Exécuter un loop, afficher/masquer les barres latérales, Revenir ou avancer, Annuler le dernier changement et Supprimés récemment. Les actions qui demandent un choix (un rail, un statut, un thème, une section) ouvrent une seconde page ; **Retour arrière** sur une recherche vide revient en arrière. Chaque action affiche son raccourci clavier : la palette vous apprend les touches. Elle ne propose que ce qui fonctionne là où vous êtes et respecte les mêmes règles que les boutons (une spec qui ne peut pas être lancée n'est pas proposée). Avec une recherche vide, elle liste vos **Actions récentes** et **Lieux récents**.
+- **Cmd+[ / Cmd+]** (**Alt+← / Alt+→** sous Windows/Linux), les boutons **←  →** de la barre de titre ou les boutons précédent/suivant de la souris — reculent ou avancent parmi les lieux visités : specs, missions, tâches, projets et panneaux plein écran. Un clic droit (ou un appui long) sur un bouton affiche les derniers lieux.
+- **Cmd+Maj+I** (**Ctrl+Alt+I** sous Windows et Linux) ou le bouton **À traiter** de la barre de titre — la liste **À traiter** : tout ce qui vous attend dans tous vos projets, dans une seule liste groupée par projet. Elle réunit les revues prêtes à décider, les questions qu'un agent attend, les exécutions en échec ou bloquées, les exécutions en pause à cause du budget quotidien et les mises à jour Jira qui n'ont pas pu se synchroniser. Chaque ligne porte son action principale (**Ouvrir la revue**, **Répondre**, **Reprendre**, **Réessayer**) ainsi que **Reporter** (1 heure ou jusqu'à demain) et **Terminé**. Un élément reporté ou terminé revient tout seul si son état change. Le bouton indique combien d'éléments attendent, et une notification de limite du fournisseur ouvre la liste. La liste est aussi un lien (`?inbox=1`) et une action de la palette de commandes.
+- **M** — avec une carte de spec ciblée dans le tableau, ouvre un sélecteur pour la déplacer vers un statut ou un rail, l'équivalent clavier du glisser-déposer. Cela fonctionne aussi sur une sélection multiple, et la palette le propose sous **Déplacer la spec ciblée…**.
+- **?** — l’aide-mémoire des raccourcis. Saisissez dans son champ de recherche pour filtrer les raccourcis et trouver les pages et sections de ce guide, qui s’ouvrent dans le guide sans quitter votre écran. Les petites icônes **ⓘ** et les liens **En savoir plus** à côté des réglages, des rails, de Flow, du curseur de contexte et des budgets ouvrent le guide à la section correspondante de la même façon.
 
 ## Et maintenant ?
 

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

@@ -0,0 +1,34 @@
+# Recherche universelle (⌘K)
+
+Appuyez sur **⌘K** (**Ctrl+K** sous Windows et Linux) pour chercher presque tout dans Specrails depuis un seul endroit : missions, specs, journaux de jobs, fichiers, réglages et ce guide. Saisissez une requête simple pour chercher parmi les missions, projets, specs et jobs récents comme avant, ou commencez par un **préfixe** pour ne chercher que dans une source.
+
+## Préfixes
+
+| Saisie | Cherche | Entrée ouvre |
+| --- | --- | --- |
+| `#` | Specs : titre, résumé, description, étiquettes, notes hors périmètre, addendums et commentaires. `#12` trouve la spec 12. | La spec |
+| `@` | Missions : titre et contenu de la conversation. | La mission |
+| `/` | Réglages (Desktop et projet) par nom ou par la façon dont vous les appelleriez. | La fenêtre de réglages sur ce bloc, visible et activé |
+| `f:` | Fichiers du projet, par nom ou chemin. | Le fichier dans l’explorateur de code |
+| `log:` | Journaux de jobs : commandes, noms de loops, titres de phases et diagnostics d’échec. | Le job |
+| `?` | Ce guide : titres de pages et intertitres. | Le guide à cet intertitre |
+
+Quand vous saisissez un préfixe, il devient une **pastille** dans la zone de recherche, qui ne garde que votre requête. Appuyez sur **Retour arrière** dans une zone vide (ou cliquez sur le × de la pastille) pour retirer le périmètre. Zone vide, la palette liste les préfixes sous la zone ; cliquez sur l’un d’eux pour commencer. `>` liste toujours les actions, comme avant.
+
+## Surlignage
+
+Les résultats montrent un court extrait autour de la première correspondance, avec le texte trouvé surligné. La recherche ignore la casse et les accents : `revision` trouve « Révision ».
+
+## Réglages
+
+`/` connaît les principaux blocs de réglages, dans votre langue : thème, langue, éditeur, budgets, notifications, webhooks, mises à jour, branche, environnement, télémétrie, règles et plus. Les réglages du projet sont proposés quand un projet est ouvert. Choisissez-en un : la bonne fenêtre s’ouvre sur ce bloc. Sans préfixe, une correspondance forte (trois caractères ou plus) ajoute jusqu’à trois réglages aux résultats habituels. `/budget` trouve aussi le panneau Budget (plafonds, projection, et si…), où se trouvent les plafonds hebdomadaire et mensuel. Une commande à barre comme `/implement` est listée sous les réglages, dans son propre groupe : le préfixe `/` ne la masque jamais.
+
+## Journaux de jobs
+
+`log:` interroge un index compact, pas la sortie brute d’une exécution : la commande, le nom du loop, les titres des phases et le diagnostic court d’une exécution échouée, bloquée ou à l’arrêt. Il ne stocke jamais de flux de tokens ni de sortie d’outils, il reste donc petit et rapide. Il est conservé par projet et contient les exécutions les plus récentes.
+
+## Bon à savoir
+
+- `#`, `f:` et `log:` cherchent dans le projet actif ; ouvrez d’abord un projet.
+- Le périmètre des fichiers respecte les règles d’exclusion de l’explorateur de code.
+- Chaque groupe n’affiche que ses meilleurs résultats ; affinez la requête pour restreindre.

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

@@ -6,15 +6,17 @@ Ouvrez-la depuis la barre latérale droite (elle est intitulée **Analytics**).
 
 ## Ce qui compte comme dépense
 
-Specrails suit cinq types d'activité IA, appelés *surfaces*. Chacune dispose d'un code couleur cohérent sur tous les graphiques, pour que vous puissiez la repérer d'un coup d'œil :
+Specrails associe chaque exécution IA à une *surface* : la partie de l'app qui a engagé la dépense. Les surfaces principales ont chacune une couleur fixe et leur propre puce de filtre, pour que vous les repériez d'un coup d'œil :
 
-- **Job** — un rail de pipeline qui enchaîne Architect → Developer → Reviewer → Ship.
+- **Job** — un job de pipeline mis en file (Architect → Developer → Reviewer → Ship), y compris les exécutions Freestyle.
+- **Loop** — chaque étape IA d'une exécution de loop. Les rails s'exécutent en loops par défaut, donc l'essentiel de la dépense des rails apparaît ici.
 - **Quick spec** — une spec générée par la voie rapide d'Add Spec.
 - **Explore spec** — une conversation Explore où vous façonnez une spec en discutant.
 - **AI edit** — un affinage assisté par l'IA sur un agent ou un fichier.
-- **File summary** — les résumés en langage clair qui alimentent le Code explorer.
+- **SMASH** — le découpage d'une spec épique en specs plus petites.
+- **File summary** — les résumés en langage clair et les histoires de fichiers qui alimentent le Code explorer.
 
-Deux activités ne sont délibérément *pas* suivies : le panneau de chat latéral et l'assistant de configuration lancent tous deux des CLI IA, mais ils n'apparaissent jamais dans vos dépenses. Le tableau de bord reflète ainsi un travail réel et reproductible plutôt que des échanges anecdotiques.
+Des surfaces secondaires sont également suivies, sans puce dédiée : le panneau de chat latéral, le lanceur de specs OpenSpec, les propositions de specs, Agent Studio et l'ancien chat de configuration. Les missions épinglées au projet comptent aussi dans sa dépense. Rien de ce qui exécute une CLI IA n'est laissé de côté : les totaux reflètent toute l'activité IA du projet.
 
 ## Lire le tableau de bord
 
@@ -76,3 +78,15 @@ Les exports respectent les filtres de période et de surface actuellement appliq
 ## Toujours à jour
 
 Pas besoin d'actualiser. Quand une nouvelle invocation est enregistrée n'importe où dans le projet, le tableau de bord ouvert se recharge discrètement un instant plus tard, pour que la jauge de consommation suive le rythme du travail à mesure qu'il se termine.
+
+## Budgets quotidiens {#daily-budget}
+
+Définissez un budget quotidien pour plafonner ce qu’une journée peut coûter. Tous les plafonds (quotidien, hebdomadaire, mensuel et par exécution) se modifient au même endroit : **Analyses → Budget**. **Réglages → Avancé** et **Réglages du projet → Budget** n’affichent que le plafond quotidien actuel, avec un bouton **Ouvrir Budget** qui y mène.
+
+Quand la dépense enregistrée du jour atteint un budget, la file se met en pause d’elle-même, les rails et les exécutions de loops refusent de démarrer avec *Budget quotidien atteint*, et une exécution de loop en cours s’arrête entre deux étapes, en pause à cause du budget. Augmentez ou supprimez le budget, ou attendez la réinitialisation quotidienne, puis reprenez.
+
+Le budget du projet compte votre journée locale ; celui de toute l’app compte la journée UTC. L’alerte de coût par job est un réglage distinct.
+
+**Plafonds hebdomadaires, mensuels et par exécution.** Les plafonds plus longs fonctionnent de la même façon. Ouvrez **Analyses → Budget** pour définir un plafond **hebdomadaire** et un plafond **mensuel**, par projet et pour toute l’app, ainsi qu’un **plafond souple par exécution** (*mettre en pause et demander à X $*). Les semaines commencent le lundi et les mois le 1er, à l’heure locale. Un plafond hebdomadaire ou mensuel met les files en pause, refuse les lancements et suspend les loops en cours exactement comme le budget quotidien ; relevez-le ou supprimez-le là, ou attendez la réinitialisation. Quand le coût communiqué d’une exécution atteint le plafond par exécution, elle se met en pause et **Reprendre** demande s’il faut continuer sans le plafond ou le relever. Atteindre un plafond ajoute aussi un élément **Relever le plafond** à la boîte de réception.
+
+Le panneau Budget montre aujourd’hui, cette semaine et ce mois face à chaque plafond. Sa **projection** de fin de mois est une estimation (la moyenne des 14 derniers jours complets multipliée par les jours restants, plus ce que vous avez déjà dépensé), jamais ajoutée à la dépense facturée. **Et si** recalcule les 30 derniers jours d’usage de tokens enregistré avec un autre modèle, d’après la grille de prix de l’app, et indique *Pas de tarif* pour un modèle sans prix. Avec un forfait d’abonnement, il n’y a pas de coût en dollars par usage : le panneau affiche alors les tours et les limites du forfait.

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

@@ -1,4 +1,4 @@
-# Le terminal intégré
+# Le terminal intégré {#integrated-terminal}
 
 Specrails embarque un véritable terminal — le panneau qui remonte depuis le bas de la fenêtre, exactement comme celui de VS Code ou Cursor. Il fait tourner votre shell réel, dans le répertoire réel de votre projet, pour que vous puissiez lancer `git`, `npm`, vos tests, ou tout autre commande sans quitter l'application.
 

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

@@ -1,4 +1,4 @@
-# Code explorer
+# Code explorer {#code-explorer}
 
 La section **Code** vous offre une fenêtre conviviale et en lecture seule sur votre dépôt — pensée tout particulièrement pour celles et ceux qui veulent comprendre ce que l'IA construit sans devoir vivre dans un éditeur. Vous disposez d'une arborescence de fichiers à gauche, d'un afficheur de code à droite, et, au-dessus du code, d'un résumé en langage clair de ce que fait réellement chaque fichier.
 

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

@@ -1,4 +1,4 @@
-# Fournisseurs d'IA (Claude, Codex)
+# Fournisseurs d'IA (Claude, Codex) {#ai-providers}
 
 ## Les deux fournisseurs
 

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

@@ -1,4 +1,4 @@
-# Plugins (Intégrations)
+# Plugins (Intégrations) {#plugins}
 
 La section **Intégrations** est une place de marché par projet de modules optionnels qui étendent les capacités de l'IA. Chaque projet décide indépendamment des plugins qu'il souhaite — installer un plugin dans un projet ne touche jamais à un autre.
 

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

@@ -15,7 +15,7 @@ Toutes les écritures vers Jira passent par une file d'attente durable et résis
 
 ## Connecter un tableau
 
-La connexion se fait depuis la page **Réglages** d'un projet (il existe aussi une étape facultative « Configurer Jira » à la fin de l'assistant d'ajout de projet). L'assistant de connexion vous guide :
+La connexion se fait depuis la page **Plugins** de la barre latérale gauche : cliquez sur **Installer** sur la carte Jira et choisissez le projet. L'assistant de connexion vous guide :
 
 1. **Tester** — saisissez l'URL et les identifiants de votre Jira, et Specrails vérifie la connexion.
 2. **Choisir un projet** — sélectionnez le projet Jira avec lequel synchroniser.
@@ -52,7 +52,7 @@ Vous pouvez donc expérimenter librement — activez, lancez quelques rails, dé
 
 ## Au quotidien
 
-Une fois connecté, la page Réglages du projet affiche une **carte de connexion** où vous pouvez :
+Une fois connecté, la carte Jira de la page **Plugins** passe à **Gérer**. Choisissez-y le projet pour ouvrir sa **carte de connexion**, où vous pouvez :
 
 - **Synchroniser maintenant** — forcer une interrogation immédiate au lieu d'attendre le minuteur.
 - **Réessayer les lettres mortes** — relancer les écritures vers Jira restées bloquées.
@@ -69,4 +69,4 @@ Les specs adossées à Jira affichent un **badge de clé Jira** (comme `PROJ-123
 
 ## Désactiver l'intégration
 
-Si vous souhaitez tout arrêter, il suffit de cliquer sur **Se déconnecter** depuis les Réglages. Vos specs retrouvent leur comportement purement local, et les métadonnées Jira restent simplement inutilisées — rien n'est détruit.
+Si vous souhaitez tout arrêter, il suffit de cliquer sur **Se déconnecter** depuis la carte de connexion. Vos specs retrouvent leur comportement purement local, et les métadonnées Jira restent simplement inutilisées — rien n'est détruit.

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

@@ -1,4 +1,4 @@
-# L'application compagnon mobile
+# L'application compagnon mobile {#mobile-companion}
 
 Specrails dispose d'une application compagnon pour téléphone afin de garder un œil sur vos rails quand vous êtes loin de votre bureau — regardez les jobs s'exécuter, voyez-les se terminer et restez dans la boucle sans rester assis devant le tableau de bord.
 

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

@@ -1,4 +1,4 @@
-# Piloter Specrails depuis n'importe quelle IA (serveur MCP)
+# Piloter Specrails depuis n'importe quelle IA (serveur MCP) {#mcp-server}
 
 > **For agents (English):** use the [current connection runbook](../../../agents/mcp.md) for Claude and Codex. It includes verified bridge discovery, registration and read-only checks.
 

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

@@ -33,6 +33,8 @@ L'agent peut toucher à toute l'application, c'est donc à vous de décider quel
 
 Commencez sur **Observer** et n'élevez le niveau que lorsque vous voulez que l'agent agisse. S'il tente quelque chose au-dessus du niveau actuel, il s'arrête et vous indique exactement quel niveau activer — il ne contourne jamais la limite. C'est distinct des niveaux de Réglages ▸ MCP, qui régissent les assistants *externes* ; le niveau ici ne concerne que cet agent intégré à l'application.
 
+Passer **en Autonome** ne se fait jamais sur une simple touche : Shift+Tab depuis Opérer affiche un avis avec **Passer en Autonome**, et un nouveau Shift+Tab revient plutôt à Observer. Baisser le niveau est toujours immédiat.
+
 ## Quelques exemples de demandes
 
 Une fois sur **Opérer**, essayez :
@@ -47,16 +49,21 @@ Une fois sur **Opérer**, essayez :
 
 Les réponses arrivent en flux fluide et s'affichent déjà mises en forme (titres, tableaux, listes), chacune avec un petit bouton **copier**. Une étiquette d'état en bas montre ce que fait l'agent en ce moment — *Réflexion…*, *MCP · jobs*, *Terminal* — pour que vous connaissiez toujours son état.
 
+Les blocs de code affichent leur langage et ont leur propre bouton **copier**. Si vous remontez pendant que l'agent écrit encore, une pastille **Nouveaux messages** apparaît au-dessus de la zone : cliquez-la pour revenir à la dernière réponse.
+
 ## Petits plus pratiques
 
 - **Des super specs depuis une conversation.** Demandez à l’agent de *façonner* une spec avec vous au lieu de la générer d’un coup : il lit d’abord le vrai code, vous pose quelques questions et affiche le brouillon qui évolue sous forme de carte en direct dans la conversation. Quand vous dites oui, il crée la spec et — par défaut — l’enrichit en arrière-plan d’une **Contract Layer** (chemins de fichiers exacts, formes de données, invariants) pour que les agents qui implémentent n’improvisent pas. Dites « sans contract layer » pour sauter l’enrichissement.
 - **Cliquez sur ce qu'il mentionne.** Dans une mission épinglée à un projet, les numéros de spec (`#12`) et les ids de job/run dans les réponses de l'agent sont des puces cliquables : une spec ouvre la fenêtre de détail du tableau, un id de job ouvre la vue du job en direct. Si la référence n'existe plus, une discrète note « introuvable » s'affiche.
-- **La carte d'implémentation reste sous les yeux.** Quand l'agent implémente des specs, une carte en direct suit le travail — et tant qu'elle attend quelque chose de vous (créer la PR, la publier, réessayer, abandonner) elle reste **épinglée juste au-dessus de la zone de message**, aussi loin que défile la conversation ; sa place dans l'historique affiche à la place un discret marqueur « épinglée ci-dessus ». Plusieurs cartes actives s'empilent en petites puces (cliquez-en une pour la mettre en avant), et un chevron réduit la carte en une barre fine. Une fois la PR publiée — ou le travail fusionné ou abandonné — la carte reprend sa place dans l'historique de la conversation.
+- **Un bandeau pour vos exécutions.** Quand l'agent lance du travail, un seul bandeau juste au-dessus de la zone de message le suit : ce que fait l'exécution, en mots simples (« Rédaction de la spec à partir de vos modifications »), combien d'exécutions sont terminées, le temps et le coût réel jusqu'ici (`—` tant que le fournisseur n'a rien facturé). Quand une exécution a besoin de vous (créer la PR, réessayer, revenir dans Flow), le bandeau le dit avec une icône et des mots et propose cette seule action ; cliquez sur le bandeau pour ouvrir la carte complète de l'exécution juste au-dessus (Échap la ferme). Avec plusieurs exécutions, le bandeau montre d'abord celle qui a besoin de vous et un petit sélecteur (« Rail 1 · Rail 2 · +1 »). La conversation ne garde que ce qui s'est passé (« Lancé sur Rail 1 », « Rail 1 a échoué : … », « Livré : PR #812 ») et chaque ligne ouvre son exécution. Les missions qui attendent votre décision affichent un point dans la liste des missions. Les actions qui lancent une nouvelle exécution payante (**Relancer**, **Récupérer et réessayer**) ou que d'autres voient (Créer la PR, Publier) ne partent jamais du bandeau : il ouvre la carte avec le focus sur ce bouton, pour que vous confirmiez depuis la carte.
+- **Le bandeau au clavier.** **⌥R** (**Alt+R** sous Windows/Linux) passe de la zone de message au bandeau de la mission où vous êtes ; appuyez à nouveau pour afficher ou masquer les détails de l’exécution, et **Échap** vous ramène où vous étiez. Hors d’un champ de texte, **⌥[** et **⌥]** passent d’une exécution à l’autre. Quand le bandeau a le focus, **P** suspend ou reprend un Flow et **H** le remet ; ces lettres n’agissent nulle part ailleurs. Appuyez sur **?** pour la liste complète.
 - **Historique des prompts.** Avec la zone vide, appuyez sur **↑**/**↓** pour parcourir ce que vous avez demandé auparavant (affiché en grisé pendant que vous défilez) ; commencez à taper pour le modifier, ou appuyez sur Entrée pour l'envoyer.
 - **Modifiez la file.** Vous en avez envoyé d'autres pendant que l'agent travaillait ? Tant que des messages sont en file, **↑**/**↓** parcourt *ceux-ci* : la zone affiche le message sélectionné, vous le modifiez sur place, et **Entrée l'enregistre dans la file** (Échap annule ; votre brouillon non envoyé revient tel quel).
+- **Répondez au clavier.** Quand l'agent propose des choix, chaque puce porte un numéro : appuyez sur **⌥1**…**⌥9** (**Alt+1**…**Alt+9** sous Windows/Linux), zone vide, pour en choisir un.
+- **Annulez la suppression d'un message en file.** Supprimer un message en file affiche **Annuler** quelques secondes ; il revient dans la file.
 - **Réduire sans rien perdre.** Cliquez sur la ✕ pour renvoyer le panneau dans la bulle — la conversation continue de tourner. Rouvrez-le et vous atterrissez sur le dernier message ; rien n'est à retaper.
 - **Nouvelle conversation.** Le bouton **+** démarre un fil vierge ; l'historique vit au niveau de l'application, au-dessus de tout projet individuel.
-- **Changez de mission.** Le sélecteur de missions, à côté du sélecteur de projet, liste vos conversations de la plus récente à la plus ancienne — un point clignotant signale celles où l'agent travaille encore, et un petit badge compte les messages en file. La recherche apparaît dès que la liste dépasse huit entrées, et l'icône corbeille de chaque ligne supprime une mission après une confirmation rapide en ligne — même une mission en cours (elle prévient d'abord, puis arrête l'agent).
+- **Changez de mission.** Le sélecteur de missions, à côté du sélecteur de projet, liste vos conversations de la plus récente à la plus ancienne — un point clignotant signale celles où l'agent travaille encore, et un petit badge compte les messages en file. La recherche apparaît dès que la liste dépasse huit entrées, et l'icône corbeille de chaque ligne supprime une mission aussitôt et affiche **Annuler** (ou appuyez sur **⌘Z**) quelques secondes ; la mission attend ensuite 30 jours dans **Supprimés récemment**, dans les paramètres du projet. Une mission où l'agent travaille encore demande d'abord confirmation, car arrêter l'agent est irréversible.
 - **Retrouvez une mission de n'importe où.** Appuyez sur **⌘K** (ou le bouton **Rechercher** de la barre latérale en mode Agent) et tapez n'importe quel fragment dont vous vous souvenez — un mot du titre *ou* de ce qui a été dit dedans. Les missions correspondent instantanément par titre depuis la mémoire, puis un instant plus tard arrivent les correspondances par contenu avec le passage surligné, le projet épinglé et la date de dernière activité. En mode Agent, les missions forment le premier groupe ; sur le tableau, elles suivent les Projets. Entrée ouvre la mission.
 
 ## Cartes de lancement et cartes d'exécution
@@ -69,9 +76,9 @@ Les réponses arrivent en flux fluide et s'affichent déjà mises en forme (titr
 
 ## Sous-agents
 
-Certains fournisseurs peuvent confier des parties d'une tâche à des **sous-agents** : des assistants qui travaillent en parallèle et continuent après la réponse de l'agent. Les sous-agents sont **désactivés par défaut** car ils multiplient le coût d'une demande.
+Certains fournisseurs peuvent confier des parties d'une tâche à des **sous-agents** : des assistants qui travaillent en parallèle et continuent après la réponse de l'agent. Les sous-agents sont **activés par défaut** ; désactivez-les par projet pour contenir les coûts, car ils multiplient le coût d'une demande.
 
-- **Activez-les par projet.** Ouvrez **Réglages → Sous-agents** du projet et activez **Autoriser les sous-agents dans ce projet**. Cela couvre les missions, l'exploration et les affinages du projet ; les pipelines Implement ne sont jamais concernés. Les missions sans projet suivent **Réglages de l'app → Fournisseurs d'IA → Autoriser les sous-agents dans les missions sans projet**.
+- **Désactivez-les par projet.** Ouvrez **Réglages → Sous-agents** du projet et désactivez **Autoriser les sous-agents dans ce projet**. Cela couvre les missions, l'exploration et les affinages du projet ; les pipelines Implement ne sont jamais concernés. Les missions sans projet suivent **Réglages de l'app → Fournisseurs d'IA → Autoriser les sous-agents dans les missions sans projet**.
 - **Choisissez qui les exécute.** Sous **Exécuter les sous-agents avec**, l'option par défaut **Comme l'agent de la mission** laisse le CLI de la mission les lancer nativement : c'est le plus rapide, et ils partagent son cache de prompt. Choisissez plutôt un fournisseur, un modèle et un effort pour mélanger les fournisseurs — par exemple une mission Codex avec des sous-agents Claude. Les missions déjà sur ce fournisseur restent natives avec ce modèle ; sur un autre fournisseur, Specrails lance lui-même chaque sous-agent, qui démarre à froid et peut coûter plus, mais vous donne plus de contrôle et affiche le coût réel de chacun. Specrails demande une confirmation avant le changement, et ces sous-agents portent un badge de fournisseur dans la mission.
 - **Suivez leur travail.** Les agents lancés par une réponse apparaissent sur une ligne compacte sous cette réponse. Elle reste ouverte pendant qu'ils travaillent et se replie en un résumé avec la durée et les jetons totaux une fois qu'ils ont tous fini. Dépliez une ligne pour lire son résultat et son coût, ou suivre son activité en direct. Chaque lancement reste à sa place dans la conversation : les suivants ne se mélangent jamais aux précédents. Arrêtez un agent en cours depuis sa ligne, ou tous depuis la ligne de résumé.
 - **L'agent reprend tout seul.** Quand les agents en arrière-plan ont fini, l'agent continue et publie ce qu'ils ont trouvé, marqué *Suite après les agents en arrière-plan*.

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

@@ -0,0 +1,69 @@
+# Flow : construire d’abord, la spec ensuite {#flow-mode}
+
+Flow est une façon de construire avec un agent quand vous ne savez pas encore exactement ce que vous voulez. Vous parlez à l’agent dans votre mission, il écrit et exécute du vrai code sur sa propre branche de Flow (une copie séparée de votre projet), et quand le résultat est le bon, vous appuyez sur **Remettre** : un rail reprend vos modifications, dérive la spec et lance la vérification, la revue et la livraison habituelles.
+
+Implement sert à déléguer un travail que vous savez déjà décrire. Flow sert à le découvrir.
+
+## Comment démarre un Flow
+
+Vous n’avez jamais à demander Flow par son nom. Quand vous décrivez quelque chose d’exploratoire ou de visuel (« je veux essayer… », « je ne sais pas à quoi ça doit ressembler »), la mission affiche une carte avec deux chemins :
+
+- **Flow** : le construire ensemble maintenant ; la spec vient à la fin.
+- **Spec + Implement** : s’accorder d’abord sur une spec, puis la déléguer à un rail.
+
+Les deux chemins ont le même poids et apparaissent toujours dans le même ordre : aucun n’est recommandé, c’est vous qui choisissez. Sous **Pourquoi l’agent pose la question**, l’agent dit en une phrase ce qui l’a fait demander, et il n’insistera pas quel que soit votre choix ou si vous appuyez sur **Pas maintenant**.
+
+Choisir Flow ouvre une confirmation : Specrails crée une copie séparée du projet sur sa propre branche de Flow, où l’agent peut écrire du code, et votre branche principale n’est pas touchée. Appuyez sur **Démarrer le Flow**. Une spec provisoire apparaît sur le board avec le libellé **En Flow** (cliquez dessus pour revenir à la mission).
+
+Si votre Specrails Core ne peut pas encore exécuter Flow, Démarrer est désactivé et la carte liste ce qui manque. En général, une mise à jour de Specrails Core suffit.
+
+## Démarrer un Flow depuis une spec existante
+
+Toute spec peut être construite en Flow, pas seulement une nouvelle idée. Flow et Implement restent deux façons égales d’y travailler :
+
+- sur le tableau, faites un clic droit sur une spec et choisissez **Démarrer en Flow** (à côté du glisser vers un rail) ; dans le détail de la spec, **Démarrer en Flow** se trouve à côté de **Déplacer vers un rail** ;
+- dans une mission, quand vous demandez d’implémenter une spec sans nommer de rail, l’agent affiche la même carte à deux chemins pour cette spec : **Flow** y travaille avec vous, **Spec + Implement** la lance sur un rail ;
+- une carte de lancement sur rail pour une seule spec propose aussi **Démarrer en Flow** à côté de son lancement.
+
+La spec elle-même passe **En Flow** : aucune spec provisoire n’est créée et le premier tour de l’agent reçoit la spec (critères d’acceptation, Contract Layer, hors-périmètre et addenda ouverts). Démarré depuis le tableau, le Flow s’ouvre dans la mission de la spec, ou dans une nouvelle mission portant son nom. Dans un projet à plusieurs dépôts Git, quand la spec n’en désigne pas exactement un, une petite boîte de dialogue demande d’abord où le Flow s’exécute : seuls les dépôts Git sont listés, le dépôt de la spec (sinon le principal) est présélectionné et les flèches changent le choix. **Démarrer en Flow** est désactivé, avec la raison au survol, quand la spec est déjà en Flow, terminée ou annulée, sur un rail, ou que Flow n’est pas disponible.
+
+**Abandonner** rend la spec exactement comme elle était, avec son statut précédent : votre spec n’est jamais supprimée. À la livraison du Flow, la spec est réécrite à partir de ce qui a été construit, et son texte d’origine est d’abord conservé en commentaire, **Original spec before Flow**, pour que rien ne se perde. Une spec déjà liée à Jira met à jour ce même ticket et le passe au statut associé à la revue ; aucun second ticket n’est créé.
+
+## Pendant le Flow
+
+Le mode Flow est nommé là où vous regardez, dans sa propre couleur de Flow : le compositeur affiche une puce **Flow** à côté de celle d’autonomie et l’indication *Dites à l’agent quoi modifier dans ce Flow…* ; le titre de la mission indique **En Flow**, tout comme sa ligne dans la liste des missions. La conversation marque où vous êtes entré dans Flow et où vous en êtes sorti, et les réponses de l’agent écrites en Flow portent une petite marque **Flow** à côté de leur heure.
+
+Le bandeau juste au-dessus du compositeur montre le Flow sur une ligne courte : son état, **Flow · 7 fichiers**, **Suspendre le Flow** et l’action principale, **Remettre**. Quand une action est indisponible (le Flow enregistre encore, une autre action est en cours), le survol dit pourquoi. Ouvrez la ligne avec son chevron, comme n’importe quelle exécution, pour voir le reste :
+
+- la **branche** (cliquez pour copier son nom), les **modifications** avec les lignes ajoutées et supprimées (cliquez pour lister chaque fichier modifié avec son état et ses +/−), et le **coût jusqu’ici** tel que facturé par le fournisseur. Il affiche `—` tant qu’aucun tour n’a de coût déclaré, jamais une estimation ; un `*` signale un total qui exclut des tours sans prix, avec une note indiquant combien ;
+- **Aperçu** tant que l’app du Flow tourne (voir plus bas) ;
+- **Abandonner**, à l’écart, supprime les modifications du Flow, sa branche et la spec provisoire. La confirmation liste ce que vous perdez : les fichiers modifiés avec leurs +/−, la branche et la spec.
+
+**Suspendre le Flow** arrête l’agent et conserve vos modifications et la spec. La ligne affiche alors **Reprendre le Flow**.
+
+Vous pouvez écrire pendant que l’agent travaille : en Flow, votre message **interrompt** l’étape en cours (le bouton d’envoi devient un éclair) et l’agent continue aussitôt avec vos nouvelles informations. Tant que le Flow est ouvert, la bande git sous le compositeur s’efface : le panneau du Flow montre déjà sa branche.
+
+## Essayer l’app
+
+L’agent Flow lance lui-même le typecheck et les tests pour vérifier son travail. Quand il y a quelque chose à essayer, il demande avec trois choix : **Start the app**, **Start and expose on the local network** ou **Not now**. L’exposer vous permet d’ouvrir l’app depuis un téléphone sur le même Wi-Fi ou VPN, et toute personne sur ce réseau peut y accéder.
+
+Une fois l’app à l’écoute, l’agent vous donne ses adresses en liens et le panneau du Flow affiche **Aperçu** avec un point vert : il ouvre l’app dans votre navigateur. Son menu propose l’adresse réseau et **Arrêter l’app**. L’app tourne depuis la copie du Flow, jamais depuis votre checkout principal, et Specrails l’arrête quand vous mettez en pause, abandonnez ou remettez le Flow.
+
+## Remettre {#flow-hand-off}
+
+Quand le résultat vous convient, appuyez sur **Remettre**. La ligne indique **Prêt à devenir une PR** et ouvre une seule ligne au-dessus : *Rail 2 transformera vos 7 fichiers modifiés en PR relue. En cas d’échec, votre travail est en sécurité.* Appuyez sur **Lancer**, ou sur **Pas encore** pour revenir au Flow ; **Échap** revient à **Pas encore** ; un clic ailleurs replie seulement la ligne, et le bandeau garde **Prêt à devenir une PR** avec **Lancer**. Si le moteur de votre conversation ne peut pas exécuter la remise sur cette machine, une note juste sous la ligne le dit et le moteur par défaut du rail est utilisé.
+
+Le rail, le moteur, le modèle et l’effort sont déjà choisis pour vous (un rail libre et le moteur de votre conversation). Pour les changer, ouvrez **Changer la méthode** ; vous y voyez aussi ce qui a changé. Le coût jusqu’ici figure sur la ligne principale. Vos choix sont conservés si vous appuyez sur **Pas encore** et remettez plus tard. Pendant le démarrage, le bandeau montre le lancement sans interruption, puis suit l’exécution étape par étape. Si la limite de revue ou un budget est atteint, la ligne le dit et rien n’est lancé. Si l’exécution n’apparaît pas au bout de 45 secondes, le bandeau cesse de tourner et indique **Remise à Rail 2 toujours en cours…** avec **Actualiser**, qui vérifie à nouveau et continue d’attendre jusqu’à ce que l’exécution apparaisse.
+
+Le rail dérive la spec et son changement de spec à partir de ce que vous avez construit, la vérifie et la relit, et la carte de livraison apparaît dans la mission comme pour toute exécution.
+
+Si l’exécution échoue pour une raison technique, le travail revient de lui-même dans ce Flow, intact : la carte dit en mots simples ce qui a échoué (les codes restent sous **Détails techniques**) et l’agent reçoit l’erreur et l’explique. Si la revue demande des modifications, la carte propose **Revenir dans Flow** ou **Relancer**. Quand la livraison est réglée, la mission clôt le Flow par un résumé : la pull request, la spec réécrite à partir de ce que vous avez construit, le changement de spec archivé et le ticket Jira s’il y en a un.
+
+## Bon à savoir
+
+- Flow n’écrit que sur sa propre branche. Hors de Flow, les missions restent en lecture seule.
+- Un seul Flow par mission à la fois. Une pause survit au redémarrage de l’app.
+- Si la copie du projet du Flow disparaît, le Flow est marqué **doit être vérifié** (pour information, rien à décider) et rien n’est supprimé.
+- Le bandeau ne change jamais l’exécution que vous regardez. Si une autre se met à vous attendre entre-temps, son nom dans le sélecteur du bandeau indique **vous attend**.
+- Jira ne reçoit rien tant que vous êtes en Flow ni si vous l’abandonnez.
+- Le coût de Flow apparaît dans Analytics comme surface à part, **Flow**, et dans le bloc des missions d’agent.

package/docs/guide/fr/pipeline/1-rails-and-jobs.md

@@ -37,13 +37,14 @@ Voilà. Le rail démarre un processus AI CLI dans le bon contexte d'exécution e
 | **Sélecteur de Loop** | Le Loop que ce rail exécute — un intégré (`Implement` / `Freestyle` / `SDD Quick (OpenSpec)`) ou un loop personnalisé. Voir le tableau ci-dessous. Persisté par rail. |
 | **▶ Play / ■ Stop** | Démarrer ou annuler. |
 
-### Ce qu'un rail exécute : les Loops
+### Ce qu'un rail exécute : les Loops {#rail-loops}
 
 Un rail exécute un **Loop** — la recette du travail. Deux loops sont **intégrés** et couvrent les cas courants :
 
 | Loop intégré | Commande | Ce qu'il fait |
 |------|---------|--------------|
 | **Implement** | `/specrails:implement` | Un seul job couvrant tous les specs du rail. Exécute tout le pipeline Architect → Developer → Reviewer → Ship. Le choix par défaut au quotidien. |
+| **Freestyle** | Freestyle | Le fournisseur du rail implémente chaque spec de façon autonome, **sans** le pipeline ; la vérification et le Loop Decider affinent ensuite le résultat jusqu'au vert. Une exécution indépendante par spec. Fonctionne avec Claude, Codex, Gemini, Kimi et les moteurs locaux ; le chat interactif dans le job est réservé à Claude. |
 
 Pour exécuter plusieurs specs, placez les specs liées (jusqu'à 3) sur un même rail — `Implement` les exécute en un seul job commun — ou répartissez les specs indépendantes sur plusieurs rails : chaque rail adossé à git s'exécute en parallèle dans son propre worktree isolé.
 
@@ -85,6 +86,25 @@ Si quelque chose semble anormal :
 - **Auto-suspension sur budget** — définissez un budget quotidien et la file se suspend d'elle-même quand la dépense du jour atteint le plafond.
 - **Tout** — quittez l'application desktop, ou lancez `specrails-desktop stop`.
 
+## Intégrer en local avec des modifications non commitées
+
+**Intégrer en local** fusionne une livraison approuvée dans votre branche d'intégration (par exemple `main`) sur cet ordinateur, sans PR. Pas besoin d'un checkout propre :
+
+- Les modifications non commitées qui ne touchent pas les fichiers livrés restent en place.
+- Si vos modifications touchent les mêmes fichiers, Specrails les met de côté dans un git stash nommé `specrails: before integrating #N (…)`, intègre, puis les réapplique. La notification indique que vos modifications ont été mises de côté, #N intégré, puis restaurées.
+- Si la réapplication entre en conflit avec le code intégré, Specrails laisse la branche exactement telle qu'intégrée et **conserve le stash** : rien n'est perdu. La carte affiche *Vos modifications locales sont enregistrées dans un stash* avec les fichiers en conflit, **Restaurer mes modifications** (nouvel essai, par exemple après avoir modifié le code) et le nom du stash à copier. Specrails les restaure ensuite lui-même sur une nouvelle branche `specrails/restore-local-<id>` dans un worktree séparé : si elles s'y appliquent sans conflit, il les commite ; sinon un résolveur de conflits IA travaille uniquement dans ce worktree, en gardant votre intention et le code intégré, et Specrails commite le résultat. La carte liste les fichiers restaurés ; **Les ramener sur <branche>** les place sur votre branche (le stash n'est supprimé qu'à ce moment) et **Supprimer la branche restaurée** retire la branche et conserve le stash. Une mission est seulement informée ; elle n'a jamais rien à exécuter. Les skills et commandes OpenSpec générées par Specrails (par exemple `.claude/skills/openspec-*/SKILL.md`) ne comptent pas comme vos modifications : en cas de conflit, elles gardent la version intégrée.
+- Les fichiers ignorés ne sont jamais mis dans le stash : si l'un d'eux entre en collision avec la livraison, Specrails vous demande de le déplacer d'abord.
+- Si l'application s'arrête entre la mise de côté et la restauration, elle restaure vos modifications à la prochaine ouverture du projet (uniquement si la même branche est extraite).
+
+## Prévision de durée et de coût {#launch-forecast}
+
+Avant d’appuyer sur Lancer, un rail peut afficher la durée habituelle des exécutions de ce type et, quand c’est pertinent, leur coût habituel, par exemple *En général 6–9 min · 2–4 $ pour ce type d’exécution*.
+
+La fourchette correspond à la moitié centrale de votre propre historique : du 25e au 75e centile des exécutions terminées de ce projet avec le même loop ou la même commande et le même moteur. Il faut au moins 5 exécutions comparables. D’ici là, la ligne indique *Pas encore assez d’historique* plutôt que de deviner. Seuls les coûts communiqués par le fournisseur sont utilisés ; les coûts estimés sont exclus. C’est une estimation, jamais une facture.
+
+Le montant en dollars n’apparaît que lorsque le moteur est connu pour facturer à l’usage (par exemple une clé d’API). Avec un abonnement, ou tant que le mode de facturation n’est pas connu, seule la durée s’affiche. Quand le rail contient plusieurs specs, la fourchette vaut pour une spec et l’indique par *(par spec)*. Si la dépense du jour plus le haut de la fourchette pouvait atteindre votre budget quotidien, la ligne ajoute *Peut se mettre en pause au budget* avec un lien vers les réglages du budget. Si le budget du jour est déjà épuisé, Lancer demande d’abord une confirmation, car l’exécution se mettrait en pause jusqu’à la réinitialisation.
+
+
 ## Où aller ensuite
 
 - [Le Loop Builder](the-loop-builder) — ce qu'un rail exécute, et comment construire vos propres loops.

package/docs/guide/fr/pipeline/2-the-job-detail-view.md

@@ -107,6 +107,18 @@ Si la [télémétrie](../settings/customizing) était activée pour le job, un b
 
 Pratique pour partager une exécution avec un coéquipier, ou pour déposer un rapport de bug précis.
 
+## Quand une exécution échoue
+
+Quand un job échoue, se bloque ou s'arrête, l'état final commence par une **carte de diagnostic** qui dit en langage clair ce qui s'est passé, par exemple *Les tests ont échoué en phase Reviewer après 4 tours de correction*, et pourquoi quand l'app le sait :
+
+- **Tests échoués** : les vérifications échouent encore après les tours de correction.
+- **Limite du fournisseur** : la limite d'utilisation du fournisseur d'IA est atteinte. La carte cite le moment de la réinitialisation, avec les mots du fournisseur.
+- **Environnement** : la machine ne peut pas exécuter les vérifications (identifiants, outil manquant, commande de préparation en échec). *Réparer l'environnement* montre précisément quoi exécuter ou changer.
+- **Bloquée**, **à court de temps**, **silencieuse** et **arrêtée de façon inattendue** désignent la limite ou le processus qui a arrêté l'exécution.
+- **Cause inconnue** : l'app ne devine pas. Elle affiche la fin du journal pour que vous le lisiez vous-même.
+
+Sous le diagnostic, jusqu'à trois remèdes classés, et seulement ceux qui peuvent fonctionner ici : **Reprendre depuis** la phase arrêtée, **Relancer**, **Modifier la spec et relancer** (les addenda de la spec portent votre changement à l'exécution suivante), **Réparer l'environnement** et **Ouvrir le journal à l'échec**. La même cause apparaît en une ligne dans la [liste À traiter](../getting-started/the-dashboard-tour), et la carte d'exécution de la mission montre la même carte.
+
 ## Où aller ensuite
 
 - [Rails et jobs](rails-and-jobs) — lancement et mise en file.