Mode CODE

Le mode CODE est le workflow d’interface pour générer et refactoriser des scripts FileMaker, avec des commandes de révision et d’application intégrées au chat.

À quoi sert CODE

• Créer des scripts à partir du langage naturel.
• Refactoriser une logique existante à partir du contexte de scripts attachés.
• Relire la sortie générée avant de l’appliquer au Script Workspace.

Avant d’envoyer une demande CODE

1. Dans Script Workspace, assurez-vous que le script cible est visible.
2. Si vous voulez une modification ciblée, sélectionnez les lignes précises dans le script.
3. Cliquez sur Add Selection pour le script ou la sélection actuelle, ou sur Add Scripts si la tâche dépend de plusieurs onglets ouverts du Script Workspace.
4. Vérifiez que le badge de contexte live ou les badges de scripts attachés correspondent à la portée visée.
5. Rédigez un prompt clair pour la génération ou le refactoring.

Workflow CODE de bout en bout

1. Envoyez une demande en mode CODE.
2. Attendez que les trois phases de génération se terminent.
3. Utilisez les liens Preview Code et Apply Code dans le message lorsqu’ils sont disponibles.
4. Surveillez l’indicateur de progression Applying….
5. Validez les changements générés dans l’aperçu avant d’appliquer.
6. Validez le résultat dans Script Workspace.

1) Structurer l’intention

CODE commence par structurer votre demande avant la génération.

• Si certains détails sont flous, Genie peut poser de courtes questions de clarification.
• Les limites de clarification sont contrôlées dans Settings > Clarification Budget > Preflight Questions.

2) Planifier les capacités

Une fois l’intention structurée, Genie planifie les capacités nécessaires pour votre demande.

3) Générer le XML

Genie génère ensuite la sortie XML correspondant au travail demandé sur le script. Pendant cette phase, le chat indique que la génération est en cours.

4) Réponse avec liens Preview et Apply

Lorsque Genie accepte un artefact CODE sûr, il affiche des liens d’action directement dans le message de l’assistant.

5) Comportement de Preview Code

Preview Code ouvre la visionneuse pour vous permettre d’inspecter la sortie avant application.

• Relecture XML dans la visionneuse avec recherche et surlignage.
• Vue texte pour une lecture compacte.
• Prise en charge de la copie pour les workflows de repli manuels.

6) Comportement de Apply Code

Apply Code utilise une opération native pour écrire en sécurité les changements dans FileMaker. Genie détermine automatiquement la meilleure méthode d’application selon la sortie générée :

• Active Selection Edit : applique le changement au bon endroit dans la sélection actuelle de votre script lorsque c’est possible.
• Full Script Apply : écrit le corps complet d’un script lorsque vous demandez une sortie script complet.
• Selection Fallback : si le placement précis dans la sélection échoue, Genie colle le bloc généré complet avec des commentaires à l’emplacement de la ligne active.
• Progress Indicator : affiche un état Applying... dans le chat pendant l’opération.
• Safety : s’arrête si l’état du Script Workspace change, par exemple si vous changez de script ou modifiez une ligne avant la fin de l’application.
• Confirmation : affiche un message de réussite une fois le script mis à jour.

Quand Preview et Apply restent désactivés

Il arrive que Genie puisse quand même afficher un brouillon dans le chat sans pouvoir exposer un artefact d’application sûr.

• Dans ce cas, Genie affiche un brouillon en consultation seule inline.
• Preview Code et Apply Code restent désactivés.
• Considérez cet état comme un signal de relecture : affinez le prompt, recapturez le bon contexte avec Add Selection ou Add Scripts, ou réessayez après avoir corrigé le problème sous-jacent.

Project Rules en mode CODE

Project Rules peut orienter le comportement de CODE pour la base active.

• Les règles peuvent influencer un même résultat généré, y compris les modifications delta, lorsque le travail demandé reste dans la portée autorisée.
• Les règles ne créent pas une seconde passe garantie.
• Les règles n’élargissent ni l’autorité de CODE, ni les limites de sélection, ni les permissions d’application.

Par exemple, une règle telle que When editing an existing script, update the top-of-script change log if one already exists. peut influencer la modification générée lorsque cet en-tête se trouve déjà dans la tâche que Genie est autorisé à modifier.

Sécurité et contraintes

• Si un prompt n’est qu’une question, Genie peut suggérer une redirection vers le mode ASK.
• Pour les grands scripts, Genie peut utiliser le mode compact pour une gestion du contexte plus fiable.

Récupération et repli

• Si l’application échoue, remettez le focus sur Script Workspace et réessayez.
• Si nécessaire, vous pouvez copier manuellement depuis Preview puis coller manuellement.
• Si la tâche couvre plusieurs scripts liés, utilisez Add Scripts plutôt que d’essayer de faire porter tout le contexte à une seule sélection live.

Bonnes pratiques

• Gardez le contexte capturé aligné sur la tâche exacte en utilisant Add Selection pour les modifications live et Add Scripts pour le travail multi-script.
• Surveillez l’état Applying... pour vous assurer que l’opération se termine correctement.

Pages associées

• Capture de contexte
• Mode ASK
• Règles de projet
• Guide des réglages
• Actions du Script Workspace