specrails-desktop 2.64.2 → 2.65.0

package/docs/guide/fr/pipeline/3-reviewing-a-delivery.md

@@ -0,0 +1,43 @@
+<!-- guide-revision: mission-first-v1 -->
+
+# Relire une livraison dans l'app {#review-a-delivery}
+
+Une livraison prête à être relue a deux vues : **Aperçu** (le verdict, les preuves et les boutons de décision) et **Modifications** (ce que la livraison a réellement changé). Ouvrez la revue avec le bouton **Relire** de la livraison, puis choisissez **Modifications**.
+
+## Lire les modifications
+
+La liste de fichiers à gauche montre chaque fichier modifié avec son statut (ajouté, modifié, supprimé, renommé), ses compteurs de lignes `+` et `−` et une coche une fois que vous le marquez comme vu. Le diff à droite charge un fichier à la fois : une grosse modification reste fluide. Passez de la disposition **Unifié** à **Côte à côte** ; Specrails retient votre choix. Un fichier très volumineux affiche ses premières lignes avec **Charger le diff complet du fichier** ; un fichier binaire est indiqué comme tel.
+
+Les modifications sont mesurées depuis le point où la livraison s'est détachée de sa branche de base : ce qui a été ajouté à la base ensuite n'apparaît pas. Tant qu'une livraison n'a pas de branche combinée, vous pouvez choisir la branche de quelle spec lire.
+
+## Notes du relecteur sur le code
+
+Les constats du relecteur, les risques signalés et les commentaires de revue que l'exécution devait résoudre apparaissent sous la ligne concernée. Les notes qui ne désignent ni fichier ni ligne sont listées au-dessus de la liste de fichiers : rien n'est caché. Les anciennes livraisons, et les relecteurs qui n'ont pas indiqué d'endroit, affichent leurs constats dans cette liste.
+
+## Demander à l'agent de modifier quelque chose
+
+Sélectionnez des lignes en cliquant sur leurs numéros (Maj-clic étend la plage), choisissez **Demander une modification à l'agent** et décrivez la modification. Specrails l'enregistre comme retour de revue sur la spec, avec le fichier, la plage de lignes et le code sélectionné, et affiche un message avec un lien vers la spec. La prochaine exécution sur cette spec en tiendra compte. Pour la lancer tout de suite, utilisez **Demander des modifications** dans l'Aperçu. Il n'y a pas de fils de commentaires entre personnes ici ; discutez avec votre équipe sur GitHub.
+
+## Ouvrir dans votre éditeur
+
+**Ouvrir dans l'éditeur** ouvre le fichier, à la ligne sélectionnée, dans VS Code, Cursor ou un IDE JetBrains. Choisissez l'éditeur dans **Réglages → Code → Éditeur**. Le fichier s'ouvre depuis votre propre copie du projet, où la branche de la revue n'est peut-être pas extraite.
+
+## Choisir ce qu'il advient d'une livraison {#pr-decision}
+
+Une exécution terminée ne vous demande qu'une chose : que faire de son résultat. La carte affiche un bouton principal pour l'étape suivante (créer la PR, la publier ou la vérifier) et, à côté, **Relire**, qui ouvre le dossier de relecture en langage clair. Tout le reste se trouve sous **Plus d'actions** :
+
+- **Changer de branche** place la branche dans le dossier de votre projet pour que vous l'essayiez.
+- **Intégrer en local** fusionne le résultat dans votre branche de base sur cet ordinateur. Pas besoin de GitHub, et vous confirmez d'abord.
+- **Abandonner** supprime le résultat et sa branche. Vous confirmez d'abord.
+
+Si une action échoue, la notification dit ce qui n'a pas pu être fait et propose **Réessayer**.
+
+## Clavier
+
+| Touche | Action |
+| --- | --- |
+| `j` / `k` | Fichier modifié suivant / précédent |
+| `n` / `p` | Note du relecteur suivante / précédente |
+| `v` | Marquer le fichier comme vu |
+
+Les touches sont ignorées pendant que vous saisissez dans un champ. Marquer un fichier comme vu reste privé : si le fichier change dans une révision ultérieure, il affiche **Modifié depuis votre lecture** et redevient non vu.

package/docs/guide/fr/pipeline/4-picking-an-engine-per-rail.md

@@ -1,4 +1,4 @@
-# Choisir un moteur par rail
+# Choisir un moteur par rail {#provider-capabilities}
 
 ## Quand le sélecteur apparaît
 
@@ -19,7 +19,7 @@ Les quatre exécutent **Implement** :
 | Moteur | À privilégier quand… | Notes |
 |--------|--------------------|-------|
 | **Claude** | Vous avez besoin du coût natif, de l'interaction persistante ou de politiques d'outils strictes. | Profils, Freestyle et transforms structurés. |
-| **Codex** | Vous préférez la CLI Codex d'OpenAI ou vous voulez comparer les implémentations entre fournisseurs. | `codex` ≥ 0.128.0. Pas de rapport de coût natif — l'application complète le coût à partir de sa table de tarifs. Les profils ne s'appliquent pas. |
+| **Codex** | Vous préférez la CLI Codex d'OpenAI ou vous voulez comparer les implémentations entre fournisseurs. | `codex` ≥ 0.128.0. Pas de rapport de coût natif — l'application complète le coût à partir de sa table de tarifs. Les profils ne s'appliquent pas. Freestyle fonctionne, sans chat interactif. |
 
 ## Un flux de travail pratique
 

package/docs/guide/fr/pipeline/5-the-loop-builder.md

@@ -1,4 +1,4 @@
-# Le Loop Builder
+# Le Loop Builder {#loop-builder}
 
 ## Workflows Core
 

package/docs/guide/fr/settings/1-themes.md

@@ -1,4 +1,4 @@
-# Thèmes
+# Thèmes {#themes}
 
 Donnez à Specrails l'allure qui vous plaît. L'application est livrée avec cinq thèmes peaufinés à la main que vous pouvez changer instantanément — sans redémarrage, sans recompilation, sans rien à configurer.
 

package/docs/guide/fr/settings/3-pipeline-telemetry-and-diagnostics.md

@@ -1,4 +1,4 @@
-# Télémétrie & diagnostics du pipeline
+# Télémétrie & diagnostics du pipeline {#telemetry}
 
 La télémétrie enregistre les diagnostics du pipeline localement. Elle est **activée par défaut** pour les projets sans préférence enregistrée. Vous pouvez la désactiver par projet ; les choix explicitement enregistrés sont conservés.
 
@@ -20,7 +20,7 @@ La télémétrie se configure **par projet** :
 
 ### Ce qui est couvert
 
-La télémétrie s'applique aux **jobs de pipeline** (les exécutions de rail en file Architect → Developer → Reviewer → Ship). Les sessions interactives comme le chat et l'assistant de configuration en sont volontairement exclues — la télémétrie est conçue pour les exécutions de pipeline répétables et inspectables, pas pour les conversations ponctuelles.
+La télémétrie s'applique aux jobs qui passent par la **file de jobs** du projet : les exécutions de pipeline de la CLI (les rails quand les Loops sont désactivés, et les commandes `implement` envoyées depuis la CLI `specrails-desktop`). Les exécutions de loop — le mode d'exécution par défaut des rails — et les sessions interactives comme le chat, Explore et les missions ne sont pas instrumentées.
 
 ## Où vivent les données
 

package/docs/guide/fr/settings/5-project-environment.md

@@ -1,4 +1,4 @@
-# Environnement du projet
+# Environnement du projet {#project-environment}
 
 Certains projets ont besoin d'un identifiant à l'exécution, comme `NODE_AUTH_TOKEN` pour des paquets npm privés. Dans **Paramètres du projet → Environnement**, ajoutez les **noms** des variables dont vos rails et vos loops ont besoin. Specrails enregistre uniquement les noms, jamais les valeurs.
 

package/docs/guide/fr/settings/6-updates.md

@@ -0,0 +1,24 @@
+# Mises à jour {#updates}
+
+Specrails tient à jour deux choses : l'application **Specrails Desktop** elle-même et le framework **specrails-core** utilisé par vos projets. Les deux se trouvent dans **Paramètres ▸ Mises à jour**.
+
+## Canal de mise à jour
+
+Choisissez à quel rythme vous recevez les nouvelles versions :
+
+- **Dernière** (par défaut) : chaque version dès sa sortie. Vous obtenez les nouveautés et les correctifs en premier.
+- **Stable** : uniquement les versions restées au moins une semaine sur Dernière avec une CI verte, puis promues par les mainteneurs. À choisir si votre équipe préfère des mises à jour moins nombreuses et bien testées.
+
+Le canal s'applique à l'application et à specrails-core. Si specrails-core n'a pas encore de version stable, Core suit Dernière et la carte Core vous l'indique.
+
+Sur Stable, si aucune version n'a encore été promue, **Rechercher des mises à jour** vous le signale au lieu de proposer une version de Dernière.
+
+## Comment arrivent les mises à jour
+
+- **Specrails Desktop** vérifie au lancement puis toutes les 6 heures. Quand une mise à jour est disponible, une carte apparaît pour télécharger, installer et redémarrer. Vous pouvez aussi cliquer sur **Rechercher des mises à jour**.
+- **specrails-core** ne se met jamais à jour tout seul. Cliquez sur **Rechercher des mises à jour** dans la carte Core, puis sur **Mettre à jour**. Vos projets passent au nouveau framework sans redémarrer l'application.
+
+## Bon à savoir
+
+- Passer de Dernière à Stable ne vous fait jamais revenir en arrière. Vous restez sur votre version jusqu'à ce que Stable la rattrape.
+- Chaque mise à jour est signée et vérifiée avant installation, sur les deux canaux.

package/docs/guide/fr/settings/7-existing-projects.md

@@ -0,0 +1,33 @@
+# Travailler dans un projet existant {#existing-projects}
+
+Ces fonctions aident les runs à respecter un projet qui existe déjà : ce qu'une spec laisse de côté, les questions de l'architecte avant de planifier, les exigences qu'un test prouve vraiment, la façon de décrire l'ancien code avant de le modifier et les règles que votre équipe a déjà écrites. Chacune nécessite une version de specrails-core qui la prend en charge ; en attendant, son interrupteur est grisé avec une note pour mettre Core à jour.
+
+## Hors périmètre
+
+Chaque spec peut lister ce qu'elle ne change volontairement **pas**. Quick et Explore le remplissent pour vous ; dans la fenêtre de la spec il apparaît comme **Hors périmètre** sous la description, un élément par ligne, et se modifie comme n'importe quel champ. Les agents le reçoivent avec la spec à chaque lancement.
+
+## Questions de l'architecte dans Jira
+
+Dans **Réglages ▸ Ancrage dans les projets existants**, activez **Publier les clarifications de l'architecte dans Jira**. Quand un run s'arrête parce que l'architecte a besoin d'une réponse, ou continue sur des hypothèses, Specrails les publie en un commentaire sur le ticket Jira lié. Répondez à ce commentaire dans Jira : la réponse est ajoutée à la spec comme clarification et le prochain run de la spec la lit. Vous pouvez toujours répondre à un run en pause depuis l'application.
+
+## Exigences démontrées
+
+Quand un test nomme l'exigence qu'il prouve (`[spec:<capacité>/<exigence>]` dans son titre), la page de revue affiche **Exigences démontrées X/Y** : les exigences prouvées par un test réussi, celles qui n'en ont pas encore et celles que le changement a touchées. Les analyses montrent la même chose par loop. Pour faire échouer la CI quand une exigence modifiée n'a pas de test, ajoutez `specrails-core pipeline trace --check --tests-passed` après vos tests.
+
+La bibliothèque de loops propose aussi **Balayage de dérive**, un loop en lecture seule qui compare ce que dit chaque spec avec ce que fait le code et liste chaque contradiction. Il ne modifie rien.
+
+## Baseline au contact
+
+Activez **Baseline au contact** pour qu'un changement qui atteint du code qu'aucune spec ne décrit commence par le décrire : des tests du comportement actuel, prouvés sur le code inchangé, et une courte spec de l'existant. La page de revue affiche **Spec créée là où le travail est passé** avec le module, les exigences et les tests, et son coût est affiché à part. Si ces tests échouent sur le code inchangé, le run s'arrête avant de modifier le module et le signale.
+
+## Règles du projet {#project-rules}
+
+**Réglages ▸ Règles du projet** liste les contrôles que votre projet exécute déjà (lint, types, tests, CI) et chaque règle écrite dans des fichiers comme `CLAUDE.md` ou `AGENTS.md`, classées en :
+
+- **Appliquée** : un contrôle la garantit déjà.
+- **Automatisable** : un contrôle le pourrait. **Créer la spec** la transforme en spec en un clic.
+- **Humaine uniquement** : quelqu'un doit regarder. Elles apparaissent sur chaque page de revue sous **Regard humain requis**.
+
+Les règles que Core n'a pas encore pu classer (par exemple juste après l'ajout du projet, quand l'inventaire tourne hors ligne) apparaissent comme **Non classée** ; **Relancer l'inventaire** avec un fournisseur configuré les classe.
+
+**Relancer l'inventaire** actualise la liste. Quand un projet n'a pas encore de commandes de vérification, les réglages de l'agent runtime proposent d'abord ces contrôles.

package/docs/guide/fr/settings/8-accessibility.md

@@ -0,0 +1,23 @@
+# Accessibilité et personnalisation {#accessibility}
+
+Specrails s'adapte à votre façon de travailler. Tout se trouve dans **Réglages ▸ Apparence**, s'applique immédiatement et est enregistré sur cet ordinateur.
+
+## Densité {#density}
+
+**Confortable** garde cartes et lignes aérées. **Compacte** en affiche davantage : le tableau des specs démarre en lignes compactes, la liste des jobs resserre ses lignes et le récit du job resserre sa chronologie. Une vue enregistrée du tableau garde sa propre disposition : une vue enregistrée en cartes post-it s'ouvre toujours en cartes post-it. Si le tableau de ce projet a déjà sa propre disposition, **L’appliquer aussi au tableau**, sous le choix, lui fait suivre à nouveau la densité.
+
+## Réduire les animations {#reduce-motion}
+
+**Suivre le système** respecte votre système d'exploitation. **Réduire** désactive animations et transitions dans Specrails quoi que dise le système : la pastille du rail reste à sa position, les points d'activité cessent de pulser et le halo du Builder ainsi que les effets de thème restent immobiles. **Animations complètes** anime même quand le système en demande moins.
+
+## Déplacer une spec au clavier {#keyboard-moves}
+
+Placez le focus sur une carte de spec dans le tableau (Tab ou flèches) et appuyez sur **M**. Un petit sélecteur liste les statuts et les rails ; choisissez avec les flèches et **Entrée**. Cela revient à y glisser la carte, y compris pour les specs liées à Jira, qui suivent votre workflow Jira. Si la carte fait partie d'une sélection multiple (**X** sélectionne la carte ciblée), le déplacement s'applique à toutes les specs sélectionnées. La palette de commandes propose la même chose sous **Déplacer la spec ciblée…**. **M** ne fait rien pendant que vous saisissez dans un champ.
+
+## Annonces d'exécution pour lecteurs d'écran {#live-status}
+
+Specrails annonce les changements des runs via une région live polie, pour le projet que vous regardez : un run démarré, en pause, qui a besoin de vous, échoué, terminé ou dont la revue est prête. Les rafales sont regroupées et les répétitions ignorées : un rail très actif ne submerge jamais le lecteur. Les notifications d'annulation s'annoncent déjà d'elles-mêmes.
+
+## Focus clavier {#focus}
+
+Chaque bouton, lien, élément de menu, carte et ligne d'arbre affiche un anneau de focus visible quand vous l'atteignez au clavier. Les informations qui n'existaient que dans une infobulle, comme la référence de spec sur la bande d'un rail, sont aussi accessibles au clavier et aux lecteurs d'écran.

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

@@ -1,4 +1,4 @@
-# Les specs et le backlog
+# Les specs et le backlog {#specs-backlog}
 
 Une **spec** est l'unité de travail que le pipeline IA met en œuvre. Voyez-la comme un ticket : un titre, une description de ce que vous voulez réaliser, une priorité et, en option, des labels. Quand vous lancez le pipeline, les agents IA lisent la spec et agissent à partir d'elle — une spec claire est donc l'élément le plus important pour obtenir un bon résultat.
 
@@ -13,7 +13,27 @@ Le tableau propose deux modes d'affichage, basculables depuis un bouton de la ba
 - **Vue post-it** (par défaut) — des tuiles façon cartes avec de courts résumés.
 - **Vue liste** — des lignes compactes sur une seule ligne.
 
-Le **sélecteur de statuts** de la barre d'outils affiche chaque statut sous forme de puce avec un compteur en direct — plus deux groupes intelligents : **Actives** (le défaut — tout ce qui bouge encore : brouillons, à faire, en cours et en révision) et **Tous** (tout, avec Terminé épinglé en bas). Votre choix est mémorisé par projet et reflété dans l'URL : un rafraîchissement ou un lien partagé restaure la vue exacte. Sur les projets connectés à Jira, un menu déroulant **statut Jira** supplémentaire apparaît, listant les *vrais* statuts du workflow du board (leurs noms bruts, p. ex. « Code Review », chacun avec son compteur en direct) regroupés sous l'état auquel ils correspondent — il se combine avec les puces de statut. Vous pouvez aussi filtrer par **label**, et trier par **Par défaut**, **Ticket #** ou **Priorité** (chacun avec un sens croissant/décroissant).
+La barre d'outils des Specs a deux rangées. La première réunit un champ de **recherche** (appuyez sur `/` pour y aller ; il cherche dans le titre, le `#numéro`, les étiquettes ou la clé Jira), un unique bouton **Filtres**, les contrôles de tri et d'affichage, et **Nouvelle spec**. La seconde rangée est le **sélecteur de statuts** : chaque statut sous forme de segment avec un compteur en direct, plus deux groupes intelligents, **Actives** (le défaut : tout ce qui bouge encore, soit brouillons, à faire, en cours et en révision) et **Tous** (tout, avec Terminé épinglé en bas). Quand la colonne est étroite, les statuts les moins utilisés se replient dans un menu **Plus**, et le statut choisi reste toujours visible. Votre choix est mémorisé par projet et reflété dans l'URL : un rafraîchissement ou un lien partagé restaure la vue exacte. **Filtres** ouvre un seul panneau avec une section par dimension : **étiquettes** (sélection multiple) et, sur les projets connectés à Jira, **epic**, **sprint** et **statut Jira** (les *vrais* statuts du workflow du board, p. ex. « Code Review », regroupés sous l'état auquel ils correspondent et combinés avec le sélecteur de statuts). Tant qu'une recherche ou un filtre restreint le board, une troisième rangée affiche chacun sous forme de puce amovible, indique « x sur y » specs et propose **Tout effacer** (qui conserve le statut choisi). Triez par **Par défaut**, **Ticket #** ou **Priorité**, chacun avec un sens croissant/décroissant.
+
+### Sélectionner plusieurs specs
+
+Triez en lot plutôt qu'une spec à la fois. Appuyez sur `x` sur une carte ciblée, cliquez sur une carte avec `Ctrl`/`⌘`, ou cliquez avec `Maj` pour sélectionner une plage (une plage reste dans une colonne : les specs actives ou le groupe Terminé). `Ctrl`/`⌘`+`A` sélectionne toute la colonne où vous êtes, et `Échap` efface la sélection. Chaque carte affiche une case au survol ou au focus, et les cartes sélectionnées ont une bordure mise en évidence. Aucune de ces touches n'agit pendant que vous saisissez du texte dans la recherche.
+
+Dès qu'une spec est sélectionnée, une barre flottante apparaît en bas du tableau avec le nombre et les actions :
+
+- **Déplacer vers** change le statut. Les specs locales reçoivent les statuts locaux ; celles qui viennent de Jira reçoivent les vrais statuts du workflow du tableau Jira et passent par la même file Jira qu'un déplacement individuel.
+- **Libellé** ajoute un libellé à la sélection, ou retire un libellé que les specs portent.
+- **Priorité** définit une même priorité pour toutes.
+- **Ajouter à un rail** place la sélection sur un rail.
+- **Tout lancer** donne à chaque spec sélectionnée son propre rail libre et les démarre en parallèle, après la même confirmation et le même contrôle du budget quotidien que *Tout lancer* des rails. Les specs qui ne peuvent pas encore être lancées (par exemple en revue sans PR ouverte) ou qui ne trouvent pas de rail libre sont ignorées et comptées dans le récapitulatif.
+- **Supprimer** les envoie dans *Récemment supprimées*.
+- **Effacer** (ou `Échap`) abandonne la sélection.
+
+La suppression et les changements de statut, de libellés ou de priorité s'annulent en une seule étape : un seul message *Annuler* (ou `⌘Z`) restaure toutes les specs modifiées. Si certaines échouent, un seul message indique combien ont réussi et combien ont échoué. La sélection ne contient que des specs visibles : un filtre qui masque une spec sélectionnée la retire de la sélection.
+
+### Vues enregistrées
+
+Le bouton **Vues**, à côté de **Filtres**, enregistre le tableau tel qu'il est : le sélecteur de statut, les filtres, le tri et la densité (pas le texte de recherche). Choisissez **Enregistrer la vue actuelle…**, nommez-la (« Prêtes à lancer », « Sprint 42 », « En échec cette semaine ») et retrouvez-la ensuite dans le même menu. **Gérer les vues…** renomme une vue, la met à jour avec le tableau actuel, copie son lien ou la supprime. Les vues appartiennent au projet. Un lien copié (`?view=…`) applique la vue lorsqu'il est ouvert dans cette application, et la palette de commandes (`⌘K`) peut enregistrer la vue actuelle ou passer à une autre.
 
 ## Les statuts
 
@@ -38,7 +58,7 @@ Les brouillons sont la seule exception : un brouillon peut n'avoir *aucune* prio
 
 ## Créer une spec
 
-Pour créer une spec, cliquez sur **Ajouter** (le bouton Plus de la barre d'outils du SpecsBoard). La fenêtre **Ajouter une spec** s'ouvre, avec plusieurs façons de travailler :
+Pour créer une spec, cliquez sur **Nouvelle spec** (le bouton Plus de la barre d'outils du SpecsBoard). La fenêtre **Ajouter une spec** s'ouvre, avec plusieurs façons de travailler :
 
 - **Mode Quick** — vous décrivez ce que vous voulez et l'IA écrit la spec complète en un seul coup. Voir [Ajouter une spec — mode Quick](add-spec-quick-mode.md).
 - **Mode Explore** — vous échangez avec l'IA, qui vous aide à façonner la spec tour après tour. Voir [Ajouter une spec — mode Explore](add-spec-explore-mode.md).
@@ -50,6 +70,24 @@ Le choix dépend du degré de clarté de votre idée. Vous savez exactement ce q
 
 Quand une spec a déjà du travail derrière elle — une PR en revue, une fonctionnalité fusionnée — et que vous en voulez *plus*, ne réécrivez pas sa description : cela fait dériver la spec (et synchronise la dérive vers Jira) et force la prochaine exécution à tout replanifier. Ouvrez la spec et ajoutez plutôt un **addendum** : une courte note avec un type (demande de changement, retour de revue, clarification, contrainte) et vos mots. Les addenda ouverts accompagnent automatiquement le prochain lancement de cette spec sur n'importe quelle boucle — Implement, SDD Quick, Freestyle — de sorte que l'exécution ne change que ce que vous avez demandé, et le paquet de revue signale chacun comme appliqué, partiellement appliqué ou bloqué. Si l'exécution échoue ou si vous écartez la livraison, ils reviennent d'eux-mêmes à **Ouvert**. L'agent de mission peut les ajouter pour vous quand vous lui demandez de modifier une spec existante.
 
+## Relire une livraison : par où commencer
+
+À la fin d'une exécution, son dossier de revue s'ouvre sur **Points à examiner** : la courte note du relecteur IA qui liste d'abord les endroits les plus risqués (élevé, puis moyen, puis faible, chacun avec un fichier et une ligne), le comportement qui change, les règles sur lesquelles le changement s'appuie, les chemins de code qu'aucun test n'exerce et les vérifications que seul un humain peut faire. Les mêmes risques, chemins non testés et vérifications figurent dans un court bloc en haut de la pull request, et la carte de mission affiche le risque principal sur une ligne. La note guide votre relecture, ce n'est pas un résultat de vérification : elle ne bloque jamais Accepter. Les exécutions faites avec un Specrails Core plus ancien n'ont pas de note et leur dossier reste identique.
+
+## Annuler, et Supprimés récemment {#recently-deleted}
+
+Supprimer une spec, la déplacer vers un autre statut, modifier ses étiquettes ou la retirer d'un rail se fait aussitôt : pas de « Êtes-vous sûr ? » au préalable. À la place, une notification propose **Annuler** pendant environ huit secondes, et **⌘Z** (**Ctrl+Z** sous Windows et Linux) fait de même tant que vous ne tapez pas dans un champ. L'annulation est propre à chaque projet : changer de projet ferme la fenêtre.
+
+Une spec supprimée (comme une mission supprimée) n'est pas perdue. Elle passe dans **Réglages → Supprimés récemment**, dans les paramètres du projet, où vous pouvez la **Restaurer** pendant 30 jours ou la **Supprimer définitivement**, ce qui demande confirmation. Après 30 jours, elle est supprimée pour de bon. Abandonner un travail non poussé, fermer de force une pull request et retirer un projet demandent toujours confirmation, car ils sont irréversibles. Une spec liée à Jira se déplace toujours avec **Déplacer vers** au lieu d'être supprimée.
+
+## La chronologie de la spec et la passation {#spec-timeline}
+
+Ouvrez une spec et passez à l’onglet **Chronologie** pour lire toute son histoire au même endroit : les modifications et addenda, les missions qui l’ont touchée, chaque exécution avec ses phases et les actions de l’agent, les événements de la pull request et le verdict du relecteur avec ses constats. Les entrées sont regroupées par jour, les pastilles filtrent par type et chaque entrée renvoie à la mission, à l’exécution ou à la relecture dont elle provient. Les longs groupes (phases, actions de l’agent, tours de mission) sont repliés avec un compteur et se déplient sur place.
+
+Le coût apparaît à côté de l’entrée qui l’a engendré, les deux sortes restant séparées : un montant communiqué par le fournisseur et un montant estimé d’après la grille tarifaire locale (marqué « est. »). Si un fournisseur est facturé via un forfait, la chronologie et les exports affichent des tours, jamais des dollars ; une exécution sans coût communiqué n’en affiche simplement pas.
+
+**Exporter la passation** (le menu à côté des onglets, ou ⌘K → *Exporter la passation de #N*) produit un fichier Markdown ou une page HTML autonome avec le résumé, les décisions (addenda, clarifications, verdicts du relecteur), les statistiques du diff, le coût et ce qui reste ouvert (addenda ouverts et constats de relecture non résolus). **Copier comme description de PR** (aussi dans ⌘K) place une version plus courte en Markdown dans le presse-papiers. Les titres suivent la langue de l’application. Tout passe par le même masquage des secrets que l’audit des actions de l’agent, et la notification indique quand quelque chose a été masqué.
+
 ## Pour aller plus loin
 
 - [Ajouter une spec — mode Quick](add-spec-quick-mode.md) — la façon la plus rapide de transformer une idée en spec.

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

@@ -6,7 +6,7 @@ Le mode Quick, c'est pour quand vous savez déjà ce que vous voulez. Vous tapez
 
 Pour créer une spec rapidement :
 
-1. Sur le Dashboard, cliquez sur **Ajouter** (le bouton Plus de la barre d'outils du SpecsBoard).
+1. Sur le Dashboard, cliquez sur **Nouvelle spec** (le bouton Plus de la barre d'outils du SpecsBoard).
 2. Choisissez le mode **Quick**.
 3. Tapez votre idée dans le champ de texte — une phrase ou un paragraphe, ce qui la capture le mieux.
 4. Cliquez pour générer.

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

@@ -22,7 +22,7 @@ Au fil de l'échange, un volet de brouillon affiche la spec dans son état actue
 
 C'est tout le cœur du mode Explore : vous n'êtes jamais face à un formulaire vide. Vous regardez toujours une spec réelle, qui évolue.
 
-## Ce que l'IA voit : le curseur de contexte
+## Ce que l'IA voit : le curseur de contexte {#context-scope}
 
 Avant que l'IA ne réponde, vous décidez quelle part de votre projet elle peut voir. Un curseur de préréglages de contexte vous laisse arbitrer entre vitesse et profondeur :
 

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

@@ -1,4 +1,4 @@
-# Conosci gli agenti
+# Conosci gli agenti {#agents}
 
 Quando avvii un rail di tipo **Implement**, Specrails non affida la tua spec a una singola AI sperando che vada bene. Mette al lavoro una piccola squadra di *agenti* specializzati, ognuno con un compito preciso, in un ordine ben pensato. Questa pagina ti presenta chi fa parte della squadra e di cosa si occupa ciascuno.
 

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

@@ -39,3 +39,5 @@ Vedrai:
 Questo è tutto l'onboarding — nessun account da creare, nessuna registrazione. Specrails funziona interamente sulla tua macchina.
 
 Clicca su **Aggiungi il tuo primo progetto** e prosegui con [Aggiungere il tuo primo progetto](adding-your-first-project).
+
+Oppure inizia con il [progetto di esempio](try-the-sample-project): un piccolo gioco e tre spec già pronte, con il costo indicato in anticipo.

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

@@ -0,0 +1,35 @@
+# Prova il progetto di esempio
+
+Vuoi vedere una spec diventare una modifica rivista prima di puntare specrails al tuo codice? Il **progetto di esempio** è un piccolo gioco web del tris con tre spec già pronte. Richiede pochi minuti e termina in un vero **pacchetto di revisione**.
+
+## Avviarlo
+
+Nella schermata di benvenuto, fai clic su **Provalo su un progetto di esempio** (accanto a **Aggiungi il tuo primo progetto**). La finestra ti dice, prima che accada qualsiasi cosa:
+
+- **Cosa viene creato**: un piccolo gioco web nel suo repository git, con tre spec già sulla tua bacheca.
+- **Dove**: per impostazione predefinita `~/Specrails Samples/tic-tac-toe`, nella tua cartella personale. Puoi cambiare cartella; una cartella esistente non viene mai sovrascritta.
+- **Quanto costerebbe un'esecuzione**: una stima come «≈ $0,30–$1 · circa 3–5 min». Compare in dollari solo se il tuo provider fattura a consumo. Con un piano in abbonamento dice che non ci sono costi aggiuntivi, e con un motore locale non c'è alcun costo API.
+
+Creare l'esempio non costa nulla e non esegue nulla. Fai clic su **Crea progetto di esempio** e arrivi alla Bacheca.
+
+## I tre passi
+
+Una piccola scheda guida indica la vera Bacheca, un passo alla volta. Puoi chiuderla in qualsiasi momento; si riduce a una pillola **Progetto di esempio** da cui **Mostra la guida** la riporta.
+
+1. **La spec.** Le tre spec sono scritte per te. Ognuna dice cosa costruire e come capire che è finita.
+2. **Il rail.** Fai clic su **Esegui la prima spec**. L'esempio è impostato per essere economico e limitato: modalità rapida, il modello più economico disponibile e un tetto morbido per esecuzione (l'esecuzione si ferma e chiede prima di superare $1). Se hai un motore locale configurato puoi sceglierlo, senza costi API.
+3. **La revisione.** Nulla viene unito da solo. Quando l'esecuzione finisce, un **pacchetto di revisione** mostra cosa è cambiato e ti lascia accettarlo o scartarlo.
+
+## Nessun provider di IA pronto?
+
+Prima di offrirti l'esecuzione, specrails controlla che un provider sia installato e con accesso effettuato. Se nessuno è pronto, ottieni **Guarda un'esecuzione registrata**: la riproduzione di un'esecuzione completata che termina in un pacchetto di revisione. È chiaramente indicata come registrazione; nulla viene eseguito e nulla viene addebitato. Installa un provider o accedi, poi scegli **Controlla di nuovo** per passare a un'esecuzione reale.
+
+## Poi, il tuo progetto
+
+La guida termina con **Ora aggiungi il tuo progetto**. Quando hai finito con l'esempio, **Rimuovi l'esempio** lo rimuove con un clic. La cartella resta sul disco, a meno che tu non selezioni **Elimina anche la cartella dell'esempio**, che non può essere annullato.
+
+## Rivedere il tour della piattaforma
+
+Il tour non è più nella schermata di benvenuto. Apri **Docs** e scegli **Rivedi il tour**, oppure apri la palette dei comandi e scrivi «Rivedi il tour». È anche in **Impostazioni ▸ Aspetto**.
+
+Avanti: [Aggiungere il tuo primo progetto](adding-your-first-project).

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

@@ -37,11 +37,15 @@ Una sottile striscia corre lungo il bordo inferiore della finestra. È piccola m
 - **Spesa totale** (a destra) — un totale aggiornato di quanto hai speso, così il costo è sempre a portata di sguardo.
 - **Interruttore del terminale** (all'estrema destra) — apre il pannello del terminale integrato. Premi **Cmd+J** (macOS) o **Ctrl+J** (Windows/Linux) per aprirlo o chiuderlo in qualsiasi momento. È una shell completa, aperta direttamente nella cartella del tuo progetto.
 
-## Qualche scorciatoia utile
+## Qualche scorciatoia utile {#shortcuts}
 
-- **Cmd/Ctrl+B** — fissa o comprimi le barre laterali.
+- **Cmd/Ctrl+B** — fissa o comprimi la barra laterale sinistra; **Option+Cmd+B** (**Ctrl+Alt+B**) fa lo stesso con quella destra.
 - **Cmd/Ctrl+J** — apri o chiudi il pannello del terminale.
-- **Cmd/Ctrl+K** — apri la ricerca.
+- **Cmd/Ctrl+K** — la palette dei comandi: cerca missioni, progetti e job ed **esegui azioni**. Digita un verbo ("nuova", "avvia", "sposta", "cambia") o inizia con **>** per elencare le azioni: Nuova spec (anche in Esplora), Avvia o Sposta una spec, Apri la sua revisione, Consegna o metti in pausa un Flow, Nuova missione, Cambia tema, Passa tra modalità Missione e Board, Apri le impostazioni dell'app o del progetto su una sezione, Esegui un loop, mostra/nascondi le barre laterali, Torna indietro o avanti, Annulla l'ultima modifica ed Eliminati di recente. Le azioni che richiedono una scelta (un rail, uno stato, un tema, una sezione) aprono una seconda pagina; **Backspace** a ricerca vuota torna indietro. Ogni azione mostra la propria scorciatoia da tastiera, così la palette insegna i tasti. Offre solo ciò che funziona dove ti trovi e rispetta le stesse regole dei pulsanti (una spec che non può essere avviata non viene proposta). A ricerca vuota elenca le tue **Azioni recenti** e i **Luoghi recenti**.
+- **Cmd+[ / Cmd+]** (**Alt+← / Alt+→** su Windows/Linux), i pulsanti **←  →** nella barra del titolo o i pulsanti indietro/avanti del mouse — tornano indietro o avanti tra i luoghi visitati: spec, missioni, job, progetti e pannelli a schermo intero. Clic destro (o pressione prolungata) su un pulsante mostra gli ultimi luoghi.
+- **Cmd+Maiusc+I** (**Ctrl+Alt+I** su Windows e Linux) o il pulsante **Da gestire** nella barra del titolo — l'elenco **Da gestire**: tutto ciò che ti aspetta in tutti i progetti, in un'unica lista raggruppata per progetto. Raccoglie le revisioni pronte da decidere, le domande a cui un agente sta aspettando risposta, le esecuzioni fallite o bloccate, le esecuzioni in pausa per il budget giornaliero e gli aggiornamenti Jira che non si sono potuti sincronizzare. Ogni riga ha l'azione principale a portata di mano (**Apri revisione**, **Rispondi**, **Riprendi**, **Riprova**) più **Posticipa** (1 ora o fino a domani) e **Fatto**. Un elemento posticipato o fatto torna da solo se il suo stato cambia. Il pulsante mostra quanti elementi attendono e una notifica di limite del provider apre l'elenco. L'elenco è anche un link (`?inbox=1`) e un'azione della palette dei comandi.
+- **M** — con una scheda spec a fuoco nella bacheca, apre un selettore per spostarla in uno stato o in un rail, l'equivalente da tastiera del trascinamento. Funziona anche su una selezione multipla, e la palette lo offre come **Sposta la spec a fuoco…**.
+- **?** — la guida rapida alle scorciatoie. Scrivi nel suo campo di ricerca per filtrare le scorciatoie e trovare pagine e sezioni di questa guida, che si aprono nella guida senza lasciare la schermata. Le piccole icone **ⓘ** e i link **Scopri di più** accanto a impostazioni, rail, Flow, slider del contesto e budget aprono la guida nella sezione corrispondente allo stesso modo.
 
 ## Dove andare adesso
 

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

@@ -0,0 +1,34 @@
+# Ricerca universale (⌘K)
+
+Premi **⌘K** (**Ctrl+K** su Windows e Linux) per cercare quasi tutto in Specrails da un solo posto: missioni, specs, log dei job, file, impostazioni e questa guida. Scrivi una ricerca normale per cercare tra missioni, progetti, specs e job recenti come prima, oppure inizia con un **prefisso** per cercare in una sola fonte.
+
+## Prefissi
+
+| Scrivi | Cerca | Invio apre |
+| --- | --- | --- |
+| `#` | Specs: titolo, riepilogo, descrizione, etichette, note fuori ambito, addendum e commenti. `#12` trova la spec 12. | La spec |
+| `@` | Missioni: titolo e contenuto della conversazione. | La missione |
+| `/` | Impostazioni (di Desktop e del progetto) per nome o per come le chiameresti. | La finestra delle impostazioni su quel blocco, visibile e con il focus |
+| `f:` | File del progetto, per nome o percorso. | Il file nell’esplora codice |
+| `log:` | Log dei job: comandi, nomi dei loop, titoli delle fasi e diagnosi degli errori. | Il job |
+| `?` | Questa guida: titoli delle pagine e intestazioni. | La guida su quell’intestazione |
+
+Quando scrivi un prefisso diventa un **chip** nella casella di ricerca e la casella conserva solo la tua ricerca. Premi **Backspace** a casella vuota (o clicca la × del chip) per togliere l’ambito. A casella vuota la palette elenca i prefissi sotto la casella; clicca su uno per iniziare. `>` continua a elencare le azioni, come prima.
+
+## Evidenziazione
+
+I risultati mostrano un breve estratto attorno alla prima corrispondenza, con il testo trovato evidenziato. La ricerca ignora maiuscole e accenti, quindi `revision` trova «Révision».
+
+## Impostazioni
+
+`/` conosce i principali blocchi di impostazioni, nella tua lingua: tema, lingua, editor, budget, notifiche, webhook, aggiornamenti, branch, ambiente, telemetria, regole e altro. Le impostazioni del progetto vengono proposte quando un progetto è aperto. Sceglierne una apre la finestra giusta su quel blocco. Senza prefisso, una corrispondenza forte (tre o più caratteri) aggiunge fino a tre impostazioni ai risultati normali. `/budget` trova anche il pannello Budget (limiti, proiezione, e se…), dove si trovano i limiti settimanale e mensile. Un comando con barra come `/implement` compare sotto le impostazioni, in un gruppo a parte, quindi il prefisso `/` non lo nasconde mai.
+
+## Log dei job
+
+`log:` cerca in un indice compatto, non nell’output grezzo di un’esecuzione: il comando, il nome del loop, i titoli delle fasi e la breve diagnosi di un’esecuzione fallita, bloccata o ferma. Non memorizza mai flussi di token né output degli strumenti, quindi resta piccolo e veloce. È tenuto per progetto e contiene le esecuzioni più recenti.
+
+## Da sapere
+
+- `#`, `f:` e `log:` cercano nel progetto attivo; apri prima un progetto.
+- L’ambito dei file rispetta le regole di esclusione dell’esplora codice.
+- Ogni gruppo mostra solo i risultati migliori; affina la ricerca per restringere.

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

@@ -6,15 +6,17 @@ Aprila dalla barra laterale destra (è etichettata **Analytics**). Tutto ciò ch
 
 ## Cosa conta come spesa
 
-Specrails tiene traccia di cinque tipi di attività AI, chiamati *origini*. A ciascuna è associato un colore coerente in tutti i grafici, così puoi riconoscerla a colpo d'occhio:
+Specrails etichetta ogni esecuzione AI con un'*origine*: la parte dell'app che ha generato la spesa. Le origini principali hanno ciascuna un colore fisso e un proprio chip di filtro, così le riconosci a colpo d'occhio:
 
-- **Job** — un rail della pipeline che esegue Architect → Developer → Reviewer → Ship.
+- **Job** — un job della pipeline messo in coda (Architect → Developer → Reviewer → Ship), comprese le esecuzioni Freestyle.
+- **Loop** — ogni passo AI di un'esecuzione di loop. I rail girano come loop per impostazione predefinita, quindi gran parte della spesa dei rail finisce qui.
 - **Quick** — una spec generata tramite il percorso rapido di Add Spec.
 - **Explore** — una conversazione Explore in cui dai forma a una spec chiacchierando.
 - **Raffinamento** — un raffinamento assistito dall'AI su un agente o su un file.
-- **Riepiloghi file** — i riepiloghi in linguaggio semplice che alimentano il Code explorer.
+- **SMASH** — la suddivisione di una spec epica in spec più piccole.
+- **Riepiloghi file** — i riepiloghi in linguaggio semplice e le storie dei file che alimentano il Code explorer.
 
-Un paio di cose, di proposito, *non* vengono tracciate: sia la chat nella barra laterale sia il setup wizard avviano CLI AI, ma non compaiono mai nella tua spesa. Così la dashboard riflette lavoro reale e ripetibile, non chiacchiere occasionali.
+Vengono tracciate anche origini minori, senza un chip proprio: la chat nella barra laterale, il launcher di spec OpenSpec, le proposte di spec, Agent Studio e la vecchia chat di setup. Anche le missioni fissate al progetto contano nella sua spesa. Nulla di ciò che esegue una CLI AI viene escluso, quindi i totali riflettono tutta l'attività AI del progetto.
 
 ## Leggere la dashboard
 
@@ -76,3 +78,15 @@ Le esportazioni rispettano i filtri di periodo e origine che hai attualmente app
 ## Sempre aggiornato
 
 Non devi ricaricare. Quando una nuova invocazione viene registrata in qualsiasi punto del progetto, la dashboard aperta si aggiorna in silenzio un istante dopo, così il meter di consumo tiene il passo con il lavoro man mano che si completa.
+
+## Budget giornalieri {#daily-budget}
+
+Imposta un budget giornaliero per limitare quanto può costare una giornata. Tutti i limiti (giornaliero, settimanale, mensile e per esecuzione) si modificano in un unico posto: **Analisi → Budget**. **Impostazioni → Avanzate** e **Impostazioni del progetto → Budget** mostrano solo il limite giornaliero attuale, con un pulsante **Apri Budget** che porta lì.
+
+Quando la spesa registrata della giornata raggiunge un budget, la coda si mette in pausa da sola, i rail e le esecuzioni dei loop non partono e mostrano *Budget giornaliero raggiunto*, e un’esecuzione di loop in corso si ferma tra un passo e l’altro, in pausa per il budget. Aumenta o rimuovi il budget, oppure attendi il reset giornaliero, poi riprendi.
+
+Il budget del progetto conta la tua giornata locale; quello dell’intera app conta la giornata UTC. L’avviso di costo per job è un’impostazione separata.
+
+**Limiti settimanali, mensili e per esecuzione.** I limiti più lunghi funzionano allo stesso modo. Apri **Analisi → Budget** per impostare un limite **settimanale** e uno **mensile**, per progetto e per l’intera app, e un **limite morbido per esecuzione** (*metti in pausa e chiedi a $X*). Le settimane iniziano il lunedì e i mesi il giorno 1, nel tuo fuso orario locale. Un limite settimanale o mensile mette in pausa le code, rifiuta gli avvii e ferma i loop in corso esattamente come il budget giornaliero; aumentalo o rimuovilo lì, oppure aspetta il ripristino. Quando il costo riportato di un’esecuzione raggiunge il limite per esecuzione, si mette in pausa e **Riprendi** chiede se continuare senza il limite o aumentarlo. Raggiungere un limite aggiunge anche un elemento **Aumenta limite** alla posta in arrivo.
+
+Il pannello Budget mostra oggi, questa settimana e questo mese rispetto a ogni limite. La sua **proiezione** a fine mese è una stima (la media degli ultimi 14 giorni completi per i giorni rimasti, più quanto hai già speso) e non viene mai sommata alla spesa fatturata. **E se** ricalcola gli ultimi 30 giorni di uso di token registrato con un altro modello, usando il listino prezzi dell’app, e dice *Nessun prezzo* per un modello senza prezzo. Con un piano in abbonamento non c’è un costo in dollari per uso, quindi il pannello mostra turni e limiti del piano invece dei dollari.

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

@@ -1,4 +1,4 @@
-# Il terminale integrato
+# Il terminale integrato {#integrated-terminal}
 
 Specrails ha un vero terminale incorporato — il pannello che scorre verso l'alto dal fondo della finestra, proprio come quello di VS Code o Cursor. Esegue la tua shell reale, nella directory reale del tuo progetto, così puoi lanciare `git`, `npm`, i test o qualunque altra cosa senza uscire dall'app.
 

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

@@ -1,4 +1,4 @@
-# Code explorer
+# Code explorer {#code-explorer}
 
 La sezione **Code** ti offre una finestra amichevole e in sola lettura sul tuo repository — pensata in particolare per chi vuole capire cosa ha costruito l'AI senza dover vivere in un editor. Hai un albero dei file a sinistra, un visualizzatore di codice a destra e, sopra il codice, un riepilogo in linguaggio semplice di cosa fa davvero ogni file.
 

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

@@ -1,4 +1,4 @@
-# Provider AI (Claude, Codex)
+# Provider AI (Claude, Codex) {#ai-providers}
 
 ## I due provider
 

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

@@ -1,4 +1,4 @@
-# Plugin (Integrazioni)
+# Plugin (Integrazioni) {#plugins}
 
 La sezione **Integrazioni** è un marketplace per progetto di componenti aggiuntivi opzionali che ampliano ciò che l'AI può fare. Ogni progetto decide in autonomia quali plugin vuole — installare un plugin in un progetto non tocca mai gli altri.
 

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

@@ -15,7 +15,7 @@ Tutti i riscritti verso Jira passano attraverso un outbox durevole e resistente
 
 ## Connettere una board
 
-Ti connetti dalla pagina **Impostazioni** di un progetto (c'è anche un passo facoltativo "Configura Jira" alla fine della procedura guidata di Add Project). La procedura guidata di connessione ti accompagna passo dopo passo:
+Ti connetti dalla pagina **Plugin** nella barra laterale sinistra: fai clic su **Installa** nella scheda Jira e scegli il progetto. La procedura guidata di connessione ti accompagna passo dopo passo:
 
 1. **Prova** — inserisci l'URL e le credenziali di Jira, e Specrails verifica la connessione.
 2. **Scegli un progetto** — scegli con quale progetto Jira sincronizzarti.
@@ -52,7 +52,7 @@ Così puoi sperimentare liberamente — attivala, esegui qualche rail, disattiva
 
 ## Il giorno per giorno
 
-Una volta connesso, la pagina Impostazioni del progetto mostra una **scheda di connessione** dove puoi:
+Una volta connesso, la scheda Jira nella pagina **Plugin** passa a **Gestisci**. Scegli lì il progetto per aprire la sua **scheda di connessione**, dove puoi:
 
 - **Sincronizza ora** — forza un polling immediato invece di aspettare il timer.
 - **Riprova i dead-letter** — riesegui qualsiasi riscritto rimasto bloccato.
@@ -69,4 +69,4 @@ Le spec appoggiate a Jira mostrano un **badge con la chiave Jira** (come `PROJ-1
 
 ## Disattivarla
 
-Se in qualsiasi momento vuoi tornare completamente indietro, basta **Disconnettere** dalle Impostazioni. Le tue spec tornano al comportamento solo-locale e i metadati Jira semplicemente restano inutilizzati — niente viene distrutto.
+Se in qualsiasi momento vuoi tornare completamente indietro, basta **Disconnettere** dalla scheda di connessione. Le tue spec tornano al comportamento solo-locale e i metadati Jira semplicemente restano inutilizzati — niente viene distrutto.

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

@@ -1,4 +1,4 @@
-# L'app companion per il telefono
+# L'app companion per il telefono {#mobile-companion}
 
 Specrails ha un'app companion per il telefono così puoi tenere d'occhio i tuoi rail anche quando sei lontano dalla scrivania — guarda i job in esecuzione, vedili terminare e resta aggiornato senza dover stare davanti alla dashboard.
 

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

@@ -1,4 +1,4 @@
-# Controlla Specrails da qualsiasi AI (server MCP)
+# Controlla Specrails da qualsiasi AI (server 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/it/integrations/6-agent-chat.md

@@ -33,6 +33,8 @@ L'agente può toccare tutta l'app, quindi decidi tu quanta libertà ha tramite u
 
 Inizia da **Osserva** e alza il livello solo quando vuoi che l'agente agisca. Se prova qualcosa oltre il livello attuale, si ferma e ti dice esattamente quale livello attivare — non aggira mai il limite. Questo è distinto dai livelli di Impostazioni ▸ MCP, che regolano gli assistenti *esterni*; il livello qui riguarda solo questo agente interno all'app.
 
+Alzare il livello **ad Autonomo** non avviene mai con un solo tasto: Shift+Tab da Opera mostra un avviso con **Passa ad Autonomo**, e un altro Shift+Tab torna invece a Osserva. Abbassare il livello è sempre immediato.
+
 ## Alcune cose che puoi chiedere
 
 Una volta su **Opera**, prova:
@@ -47,16 +49,21 @@ Una volta su **Opera**, prova:
 
 Le risposte arrivano fluide e già formattate (titoli, tabelle, elenchi), ciascuna con un piccolo pulsante **copia**. Un'etichetta di stato in basso mostra cosa sta facendo l'agente in questo momento — *Sto pensando…*, *MCP · jobs*, *Terminal* — così conosci sempre il suo stato.
 
+I blocchi di codice mostrano il linguaggio e hanno il proprio pulsante **copia**. Se scorri verso l'alto mentre l'agente sta ancora scrivendo, sopra la casella compare la pillola **Nuovi messaggi**: cliccala per tornare all'ultima risposta.
+
 ## Dettagli pratici
 
 - **Super spec da una conversazione.** Chiedi all’agente di *dare forma* a una spec insieme a te invece di generarla in un colpo solo: prima legge il codice reale, ti fa qualche domanda e mostra la bozza che evolve come una card dal vivo nella conversazione. Al tuo sì crea la spec e — per impostazione predefinita — la arricchisce in background con un **Contract Layer** (percorsi file esatti, forme dei dati, invarianti) perché gli agenti che implementano non improvvisino. Di’ "senza contract layer" per saltare l’arricchimento.
 - **Clicca ciò che menziona.** In una missione fissata a un progetto, i numeri di spec (`#12`) e gli id di job/run nelle risposte dell'agente sono chip cliccabili: una spec apre il modale di dettaglio della board, un id di job apre la vista del job dal vivo. Se il riferimento non esiste più, compare una discreta nota "non trovato".
-- **La scheda di implementazione resta in vista.** Quando l'agente implementa delle spec, una scheda dal vivo segue il lavoro — e finché ha bisogno di qualcosa da te (creare la PR, pubblicarla, riprovare, scartare) resta **fissata appena sopra la casella dei messaggi**, per quanto scorra la conversazione; al suo posto nella cronologia compare un discreto segnaposto «fissata sopra». Più schede attive si impilano come piccoli chip (cliccane uno per portarla in primo piano), e un chevron riduce la scheda a una barra sottile. Una volta pubblicata la PR — o quando il lavoro viene unito o scartato — la scheda torna al suo posto nella cronologia della conversazione.
+- **Una striscia per le tue esecuzioni.** Quando l'agente avvia del lavoro, un'unica striscia appena sopra la casella del messaggio lo segue: cosa sta facendo l'esecuzione, in parole semplici («Scrittura della spec dalle tue modifiche»), quante esecuzioni sono terminate, il tempo e il costo reale finora (`—` finché il provider non fattura). Quando un'esecuzione ha bisogno di te — creare la PR, riprovare, tornare in Flow — la striscia lo dice con un'icona e a parole e offre quell'unica azione; fai clic sulla striscia per aprire la scheda completa dell'esecuzione appena sopra (Esc la chiude). Con più esecuzioni, la striscia mostra prima quella che ha bisogno di te e un piccolo selettore («Rail 1 · Rail 2 · +1»). La conversazione conserva solo ciò che è successo — «Avviato su Rail 1», «Rail 1 non riuscito: …», «Consegnato: PR #812» — e ogni riga apre la sua esecuzione. Le missioni in attesa della tua decisione mostrano un punto nell'elenco delle missioni. Le azioni che avviano una nuova esecuzione a pagamento (**Rilancia**, **Recupera e riprova**) o che altri vedono (Crea PR, Pubblica) non partono mai dalla striscia: apre la scheda con il focus su quel pulsante, così confermi lì.
+- **La striscia da tastiera.** **⌥R** (**Alt+R** su Windows/Linux) passa dalla casella del messaggio alla striscia della missione in cui ti trovi; premilo di nuovo per mostrare o nascondere i dettagli dell’esecuzione, e **Esc** ti riporta dov’eri. Fuori da un campo di testo, **⌥[** e **⌥]** passano da un’esecuzione all’altra. Con la striscia attiva, **P** sospende o riprende un Flow e **H** lo affida; queste lettere non fanno nulla altrove. Premi **?** per l’elenco completo.
 - **Cronologia dei prompt.** Con la casella vuota, premi **↑**/**↓** per scorrere ciò che hai chiesto prima (mostrato attenuato mentre scorri); inizia a scrivere per modificarlo, oppure premi Invio per inviarlo.
 - **Modifica la coda.** Hai inviato altro mentre l'agente era occupato? Finché ci sono messaggi in coda, **↑**/**↓** scorre *quelli*: la casella mostra il selezionato, lo modifichi sul posto e **Invio lo salva di nuovo in coda** (Esc annulla; la tua bozza non inviata torna com'era).
+- **Rispondi con un tasto.** Quando l'agente propone delle scelte, ogni chip ha un numero: premi **⌥1**…**⌥9** (**Alt+1**…**Alt+9** su Windows/Linux) con la casella vuota per sceglierne una.
+- **Annulla l'eliminazione di un messaggio in coda.** Eliminando un messaggio in coda compare **Annulla** per qualche secondo; lo rimette in coda.
 - **Riduci a icona, senza perdere nulla.** Clicca la ✕ per rimettere il pannello nella bolla — la conversazione continua a girare. Riaprilo e atterri sull'ultimo messaggio; nulla viene riscritto.
 - **Nuova conversazione.** Il pulsante **+** avvia un thread pulito; la cronologia vive a livello di app, sopra qualunque singolo progetto.
-- **Cambia missione.** Il selettore di missioni accanto al selettore di progetto elenca le conversazioni dalla più recente alla più vecchia — un punto pulsante segnala quelle in cui l'agente sta ancora lavorando, e un piccolo badge conta i messaggi in coda. La ricerca compare quando la lista supera le otto voci, e l'icona del cestino su ogni riga elimina una missione dopo una rapida conferma in linea — anche una in corso (prima avvisa, poi ferma l'agente).
+- **Cambia missione.** Il selettore di missioni accanto al selettore di progetto elenca le conversazioni dalla più recente alla più vecchia — un punto pulsante segnala quelle in cui l'agente sta ancora lavorando, e un piccolo badge conta i messaggi in coda. La ricerca compare quando la lista supera le otto voci, e l'icona del cestino su ogni riga elimina subito una missione e mostra **Annulla** (o premi **⌘Z**) per qualche secondo; poi la missione resta per 30 giorni in **Eliminati di recente**, nelle impostazioni del progetto. Una missione in cui l'agente sta ancora lavorando chiede prima conferma, perché fermare l'agente non si può annullare.
 - **Trova una missione da ovunque.** Premi **⌘K** (o il pulsante **Cerca** della barra laterale in modalità Agente) e digita un frammento qualsiasi che ricordi — una parola del titolo *o* di ciò che è stato detto dentro. Le missioni corrispondono all'istante per titolo dalla memoria e, un battito dopo, arrivano le corrispondenze per contenuto con il passaggio evidenziato, più il progetto fissato e l'ultima attività. In modalità Agente le missioni sono il primo gruppo; sulla board stanno subito dopo i Progetti. Invio apre la missione.
 
 ## Card di lancio e card di esecuzione
@@ -69,9 +76,9 @@ Le risposte arrivano fluide e già formattate (titoli, tabelle, elenchi), ciascu
 
 ## Sotto-agenti
 
-Alcuni provider possono affidare parti di un compito a **sotto-agenti**: aiutanti che lavorano in parallelo e proseguono dopo la risposta dell'agente. I sotto-agenti sono **disattivati per impostazione predefinita** perché moltiplicano il costo di una richiesta.
+Alcuni provider possono affidare parti di un compito a **sotto-agenti**: aiutanti che lavorano in parallelo e proseguono dopo la risposta dell'agente. I sotto-agenti sono **attivi per impostazione predefinita**; disattivali per progetto se vuoi contenere i costi, perché moltiplicano il costo di una richiesta.
 
-- **Attivali per progetto.** Apri **Impostazioni → Sotto-agenti** del progetto e attiva **Consenti sotto-agenti in questo progetto**. Vale per missioni, esplorazione e rifiniture del progetto; le pipeline Implement non sono mai interessate. Le missioni senza progetto seguono **Impostazioni dell'app → Provider di IA → Consenti sotto-agenti nelle missioni senza progetto**.
+- **Disattivali per progetto.** Apri **Impostazioni → Sotto-agenti** del progetto e disattiva **Consenti sotto-agenti in questo progetto**. Vale per missioni, esplorazione e rifiniture del progetto; le pipeline Implement non sono mai interessate. Le missioni senza progetto seguono **Impostazioni dell'app → Provider di IA → Consenti sotto-agenti nelle missioni senza progetto**.
 - **Scegli chi li esegue.** In **Esegui i sotto-agenti con**, l'opzione predefinita **Come l'agente della missione** lascia che il CLI della missione li avvii nativamente: è la più veloce e condividono la sua cache del prompt. Scegli invece provider, modello ed effort per combinare provider — ad esempio una missione Codex con sotto-agenti Claude. Le missioni che usano già quel provider restano native con quel modello; con un altro provider Specrails avvia da sé ogni sotto-agente, che parte a freddo e può costare di più, ma ti dà più controllo e mostra il costo reale di ciascuno. Specrails chiede conferma prima del cambio, e quei sotto-agenti mostrano un badge del provider nella missione.
 - **Guardali lavorare.** Gli agenti avviati da una risposta compaiono come una riga compatta sotto quella risposta. Resta aperta mentre lavorano e, quando finiscono tutti, si chiude in un riepilogo con tempo e token totali. Espandi una riga per leggerne il risultato e il costo, o seguirne l'attività dal vivo. Ogni avvio resta al suo punto della conversazione, quindi i successivi non si mescolano mai ai precedenti. Ferma un agente in corso dalla sua riga, o tutti dalla riga di riepilogo.
 - **L'agente riprende da solo.** Quando gli agenti in background finiscono, l'agente prosegue e pubblica ciò che hanno trovato, con l'etichetta *Proseguito dopo gli agenti in background*.