Mettre à jour les consignes Grace

Pour actualiser les consignes Grace de votre projet, demandez à votre agent :

Mets Grace à jour.

Cette demande autorise la mise à jour du kit Grace : ses procédures, son bloc de consignes et ses profils de relecture officiels. L’agent vérifie la version proposée, sauvegarde les fichiers concernés, puis applique la mise à jour sans demander une seconde confirmation dans la conversation. Cette opération ne change ni les talents du projet ni votre connexion à Grace.

Votre ancienne skill grace-update impose encore une application manuelle ou refuse la mise à jour faute de capacité native ? Suivez Migrer une ancienne installation.

Comprendre le contrôle au début d’un filCopier le lien de l'ancre

Au début de chaque nouveau fil, l’agent récupère la liste officielle des fichiers du kit, appelée manifeste, avec grace_check_installation. Il lit ensuite la procédure grace-update contenue dans ce manifeste, même si une ancienne version existe déjà sur votre poste. Il compare les fichiers localement, sans envoyer leur contenu à Grace.

Ce contrôle suit les consignes données à l’agent : aucun service, hook ou programme en arrière-plan ne le déclenche. Un ancien fil peut nécessiter la demande explicite décrite ci-dessous.

Si des fichiers sont différents ou manquants, l’agent présente les écarts et propose :

• Mettre à jour : appliquer la version courante, après sauvegarde, pour cette opération.
• Plus tard : continuer le travail sans modification ni nouveau rappel automatique dans ce fil.

Vous pouvez ensuite demander Mets Grace à jour pour relancer le contrôle et l’application, y compris après Plus tard. Si tout est à jour, l’agent le signale sans réécrire les fichiers. Aucune activation des mises à jour automatiques n’est nécessaire ou créée. Un ancien réglage d’activation reste intact et n’est plus utilisé. Le niveau Auto des revues est indépendant.

Retrouver le kit avant de choisirCopier le lien de l'ancre

L’agent inspecte d’abord les destinations compatibles, une par une : consignes, chacune des quatre skills, puis profils natifs séparés. Un fichier ancien trouvé reste présent, à mettre à jour ; une procédure absente du menu peut encore être présente sur disque. Les conditions de chargement du client et l’invocation effective se vérifient séparément.

Un emplacement existant non ambigu est conservé. En cas d’absence ou de copies divergentes, l’agent montre les chemins avant de demander un choix pour le seul élément concerné. Des copies identiques sont toutes actualisées après l’accord de mise à jour, dans le plan local sauvegardé. Il ne crée ni fichier de compatibilité, ni lien, ni préférence permanente et ne déplace pas les autres fichiers. Dans Antigravity, .agent/skills reste compatible avec .agents/skills ; dans Codex, les profils .codex/agents ne remplacent pas les skills .agents/skills.

Les choix compatibles et les options des scripts sont décrits dans Brancher un projet. Le guide web présente ces choix sans prétendre avoir inspecté votre disque. Une campagne pentest figée reste exclue de ce contrôle.

Ce que l’agent vérifie avant de remplacerCopier le lien de l'ancre

L’agent contrôle les destinations et leurs dossiers parents, les liens et les limites du bloc Grace. Il sauvegarde intégralement tous les fichiers à modifier avant le premier remplacement, y compris le texte extérieur au bloc. Il relit ces sauvegardes, puis chaque fichier juste avant et après son édition.

Le contenu installé doit correspondre exactement à la version officielle, sans modifier ses fins de ligne ou ses caractères. L’agent contrôle la taille et l’empreinte de chaque fichier du kit et du bloc Grace. Ces contrôles détectent des modifications concurrentes ; ils ne garantissent pas qu’aucun autre outil ne puisse intervenir entre deux vérifications.

Les outils ordinaires de lecture, d’édition et de terminal suffisent dans les permissions de votre client. Ses refus d’écriture et ses demandes d’approbation restent applicables. En mode Plan ou lecture seule, l’agent peut comparer mais ne modifie rien, pas même une sauvegarde. Une revue en cours connue reporte l’application ; l’agent ne recherche pas les autres sessions. Une campagne pentest figée conserve ses consignes sans contrôle distant ni téléchargement.

Vérifier le résultatCopier le lien de l'ancre

L’agent annonce une mise à jour vérifiée seulement après relecture et comparaison de l’ensemble du kit avec le manifeste. Il indique les fichiers modifiés et l’emplacement des sauvegardes, puis relit les nouvelles consignes avant de continuer. Une écriture partielle reste signalée comme une interruption, même si certains fichiers sont déjà à jour.

La présence des fichiers, leur découverte dans le menu de votre client IA et l’invocation d’une skill sont trois vérifications distinctes. Actualisez le menu ou démarrez un nouveau fil si le client le demande, puis vérifiez que grace-update et grace-effort sont proposés. Dans Codex, la syntaxe est $grace-effort ; un client compatible avec les commandes slash peut proposer /grace-effort. Dans T3, utilisez le sélecteur ou la syntaxe du fournisseur actif. La mise à jour du kit ne prouve pas que cette invocation a réussi.

Migrer une ancienne installationCopier le lien de l'ancre

Une ancienne installation peut continuer à lire sa procédure locale périmée. Demandez explicitement à l’agent de récupérer le manifeste courant et d’en lire la procédure avant d’agir :

Mets Grace à jour. Appelle grace_check_installation pour mon agent et la langue française, puis lis entièrement la skill grace-update du manifeste retourné, même si elle existe déjà localement. Applique cette procédure après sauvegarde complète des fichiers à remplacer.

Si la connexion MCP ou cet outil est indisponible, utilisez cette demande de démarrage pour Codex :

Mets Grace à jour à partir du manifeste public officiel pour Codex. Récupère et valide ce manifeste, puis lis entièrement sa skill grace-update. Suis cette procédure pour sauvegarder et remplacer le kit local. Cette demande autorise l’application, y compris pour les contenus du kit personnalisés ou non reconnus.

Pour un autre agent, remplacez harness=codex dans le lien par harness=claude, harness=cursor, harness=vscode, harness=copilot, harness=copilot-cli, harness=windsurf, harness=mistral, harness=gemini ou harness=agents, selon votre outil. Dans T3, choisissez le fournisseur actif. L’agent utilise cette adresse publique sans mot de passe, cookie ou clé d’API. Si le manifeste est inaccessible, invalide ou fournit encore l’ancienne procédure, il explique la limite ; il n’annonce pas une migration réussie.

Reprendre après un problèmeCopier le lien de l'ancre

Pour modifier votre préférence de revue, consultez Choisir le niveau de revue.

Dépannage : anciens scripts manuelsCopier le lien de l'ancre

harness=codex
kit_dir=$(mktemp -d)
kit_script=''
if curl --fail --silent --show-error 'https://grace.hoppr.tech/setup.sh?locale=fr' -o "$kit_dir/setup.sh" && grep -Fq -- '--update-kit' "$kit_dir/setup.sh"; then
  kit_script="$kit_dir/setup.sh"
  printf 'Script prêt.\n'
else
  printf 'Vérification indisponible. Arrêtez ici ; ne lancez pas le setup ordinaire.\n'
fi

sh "$kit_script" --update-kit --harness "$harness" --check
sh "$kit_script" --update-kit --harness "$harness" --dry-run

printf 'planDigest de l’aperçu accepté : '
IFS= read -r plan_digest
sh "$kit_script" --update-kit --harness "$harness" --apply --expect-plan "$plan_digest"
sh "$kit_script" --update-kit --harness "$harness" --check

$Harness = 'codex'
$KitScript = $null
$KitDirectory = Join-Path ([IO.Path]::GetTempPath()) ('grace-kit-' + [Guid]::NewGuid().ToString('N'))
New-Item -ItemType Directory -Path $KitDirectory | Out-Null
$DownloadedScript = Join-Path $KitDirectory 'setup.ps1'
Invoke-WebRequest -UseBasicParsing 'https://grace.hoppr.tech/setup.ps1?locale=fr' -OutFile $DownloadedScript -ErrorAction Stop
if (-not ([IO.File]::ReadAllText($DownloadedScript)).Contains('-UpdateKit')) {
  throw 'Vérification indisponible. Arrêtez ici ; ne lancez pas le setup ordinaire.'
}
$KitScript = $DownloadedScript
& $KitScript -UpdateKit -Harness $Harness -Check
& $KitScript -UpdateKit -Harness $Harness -DryRun

$PlanDigest = Read-Host "planDigest de l’aperçu accepté"
& $KitScript -UpdateKit -Harness $Harness -Apply -ExpectPlan $PlanDigest
& $KitScript -UpdateKit -Harness $Harness -Check

printf 'Identifiant de transaction : '
IFS= read -r transaction
sh "$kit_script" --update-kit --harness "$harness" --recover "$transaction"

printf 'planDigest de la récupération acceptée : '
IFS= read -r plan_digest
sh "$kit_script" --update-kit --harness "$harness" --recover "$transaction" --apply --expect-plan "$plan_digest"
sh "$kit_script" --update-kit --harness "$harness" --check

$Transaction = Read-Host "Identifiant de transaction"
& $KitScript -UpdateKit -Harness $Harness -Recover $Transaction

$PlanDigest = Read-Host "planDigest de la récupération acceptée"
& $KitScript -UpdateKit -Harness $Harness -Recover $Transaction -Apply -ExpectPlan $PlanDigest
& $KitScript -UpdateKit -Harness $Harness -Check

Revue locale et lectures paginéesCopier le lien de l'ancre

Voir le parcours de revue local pour les prérequis, les lectures complètes, les reprises et les limites de preuve.