Les modes d'exécution : Plan, Act, objectif et boucle infinieExecution modes: Plan, Act, autonomous goals and the infinite loop

Les modes, en deux motsModes, in two words

Un agent qui peut « penser et toucher aux fichiers en même temps » mélange deux activités très différentes : décider ce qui doit changer, et changer. VisiDog sépare les deux. Le mode Plan confine l'agent à la lecture — il conçoit, il ne modifie rien. Le mode Act lui confie l'écriture — pas à pas, avec un instantané annulable avant chaque modification. Vous restez l'arbitre entre les deux : le plan se relit, s'approuve, se rejette.

An agent that can "think and touch files at the same time" mixes two very different activities: deciding what should change, and changing it. VisiDog separates the two. Plan mode confines the agent to reading — it designs, it modifies nothing. Act mode hands it the pen — step by step, with a revertible snapshot before every change. You remain the arbiter in between: the plan can be read, approved, or rejected.

Sur ce socle, deux boucles automatiques enchaînent les cycles Plan puis Act sans vous à chaque tour : /goal poursuit un objectif précis jusqu'à un succès vérifié, dans la limite d'un plafond ; /infinite fait tourner la même mécanique sans fin d'annonce, pour améliorer le projet en continu. Le badge de mode en haut du terminal, ou les commandes /plan, /act, /goal et /infinite, basculent d'un mode à l'autre.

On this foundation, two automatic loops chain Plan then Act cycles without you at every turn: /goal pursues a precise objective up to a verified success, within a cap; /infinite runs the same machinery with no announced end, to improve the project continuously. The mode badge at the top of the terminal, or the /plan, /act, /goal and /infinite commands, switch from one mode to another.

• ✓Plan : l'agent conçoit, la lecture seule est imposée par les outils eux-mêmesPlan: the agent designs; read-only is enforced by the tools themselves
• ✓Act : l'agent applique, chaque écriture est précédée d'un instantané annulableAct: the agent applies; every write is preceded by a revertible snapshot
• ✓/goal : un objectif borné, un contrôle de succès en lecture seule/goal: a bounded objective with a read-only success check
• ✓/infinite : une boucle permanente d'amélioration, auto-commits à chaque cycle/infinite: a permanent improvement loop, auto-commits every cycle
• ✓Résilient : un rechargement de page ne perd ni le fil ni l'avancementResilient: a page reload loses neither the thread nor the progress

Plan / Act : l'architecte et l'exécutantPlan / Act: the architect and the executor

Le mode Plan transforme l'agent en architecte. Il peut lire les fichiers, chercher dans le code, inspecter l'état du projet — mais toute tentative d'écriture, d'édition ou de commande est refusée à la source, avec l'erreur PLAN_MODE_READ_ONLY. Ce n'est pas une politesse de prompt que le modèle pourrait contourner : la couche d'outils elle-même ne lui met pas la main à la pâte. Pendant ce temps, il construit un plan structuré — des étapes numérotées dont le statut suivra l'exécution.

Plan mode turns the agent into an architect. It can read files, search the code, inspect the project's state — but any attempt to write, edit or run a command is refused at the source, with the PLAN_MODE_READ_ONLY error. This is not a polite prompt the model could talk its way around: the tool layer itself keeps its hands off the files. Meanwhile, it builds a structured plan — numbered steps whose status will follow the execution.

Le plan fini, la main vous revient. Une carte d'approbation s'affiche : « Approuver le plan » — ou la commande /act — fait passer la session en mode Act. L'exécutant prend le relais : il déroule les étapes, et chaque mutation de fichier est précédée d'un instantané atomique de l'espace de travail — fichiers et répertoires. /undo rétablit le dernier état, /rewind revient plus loin : une modification approuvée n'en devient pas pour autant irréversible.

Once the plan is ready, the decision is yours. An approval card appears: "Approve the plan" — or the /act command — switches the session to Act mode. The executor takes over: it unfolds the steps, and every file mutation is preceded by an atomic snapshot of the workspace — files and directories alike. /undo restores the last state, /rewind goes further back: an approved change is not irreversible for all that.

Pourquoi ce binôme évite les effets non voulusWhy this duo avoids unintended effects

Trois protections s'additionnent. D'abord, la séparation physique : pendant qu'on discute de l'approche, aucun fichier ne bouge, car le mouvement est impossible — pas juste découragé. Ensuite, l'approbation humaine : le passage de la conception à l'application est un geste explicite, jamais un effet de bord d'une phrase ambiguë. Enfin, la réversibilité : quand l'exécution révèle un imprévu, /undo ramène l'espace de travail exactement en arrière — un instantané partiel ne détruit jamais ce qu'il n'a pas capturé, et une restauration incomplète reste réessayable.

Three protections stack up. First, physical separation: while you discuss the approach, no file moves, because movement is impossible — not merely discouraged. Second, human approval: going from design to application is an explicit gesture, never a side effect of an ambiguous sentence. Third, reversibility: when execution reveals a surprise, /undo takes the workspace exactly back — a partial snapshot never destroys what it could not capture, and an incomplete restoration stays retryable.

Ce même binôme sert de brique aux deux boucles autonomes qui suivent : dans /goal comme dans /infinite, chaque cycle repasse par une phase Plan en lecture seule puis une phase Act où toutes les écritures redeviennent possibles — et restent checkpointées.

This same duo is the building block of the two autonomous loops that follow: in /goal as in /infinite, every cycle goes through a read-only Plan phase then an Act phase where all writes become possible again — and stay checkpointed.

Le mode objectif (/goal) : la boucle qui se termineThe goal mode (/goal): the loop that ends

/goal suivie d'une description lance un objectif autonome : l'agent enchaîne les cycles Plan puis Act jusqu'à ce que la demande soit réalisée — ou jusqu'à un garde-fou. Chaque cycle suit la même mécanique en quatre temps.

A /goal followed by a description starts an autonomous objective: the agent chains Plan then Act cycles until the request is fulfilled — or until a guard fires. Every cycle follows the same four-beat mechanism.

• 1Le plan se réalise intégralement. La phase Act ne s'arrête pas à la première réponse qui sonne bien : tant que le plan structuré compte des étapes en attente, des relances ciblées poursuivent l'exécution. Un cycle ne se clôt jamais sur un plan à moitié fait.The plan is fully realized. The Act phase does not stop at the first good-sounding reply: as long as the structured plan has pending steps, targeted follow-ups keep the execution going. A cycle never closes on a half-done plan.
• 2Le contrôle de succès est en lecture seule. Quand l'agent annonce avoir terminé, ce n'est qu'une demande de validation : un tour distinct, replacé en mode Plan, réinspecte l'état réel du projet contre la demande initiale et tous ses critères. Son verdict — GOAL_VERIFIED ou GOAL_REMAINING — est la seule chose qui peut clore l'objectif en succès ; un verdict absent ou ambigu laisse la boucle continuer.The success check is read-only. When the agent claims completion, that is only a request for validation: a separate turn, back in Plan mode, re-inspects the project's real state against the initial request and all its criteria. Its verdict — GOAL_VERIFIED or GOAL_REMAINING — is the only thing that can close the goal in success; a missing or ambiguous verdict lets the loop continue.
• 3Le relais entre cycles est borné. À chaque nouveau cycle, les messages de l'itération précédente sont retirés et remplacés par un relais compact : un bilan d'environ 2 000 caractères, les chemins modifiés, les étapes restantes et les dernières erreurs d'outils. Le contexte reste maigre — donc le cache efficace et les coûts bas — sans perdre ce qui oriente le plan suivant.The relay between cycles is bounded. At each new cycle, the previous iteration's messages are retired and replaced by a compact relay: a roughly 2,000-character summary, the changed paths, the remaining steps and the latest tool errors. Context stays lean — cache stays effective and costs low — without losing what steers the next plan.
• 4Les arrêts sont francs. /goal stop ou le bouton Arrêter interrompt la boucle à tout moment. Un budget épuisé ou un plafond d'itérations atteint arrêtent la boucle sans jamais présenter un échec comme un succès : le statut final dit ce qui s'est passé.Stops are frank. /goal stop or the Stop button interrupts the loop at any time. An exhausted budget or a reached iteration cap stops the loop without ever dressing a failure up as a success: the final status says what happened.

Un avancement qui survit au rechargementProgress that survives a reload

Une boucle autonome peut durer longtemps — et le navigateur, lui, vit sa vie : onglet fermé par erreur, batterie, mise à jour. VisiDog journalise donc les jalons de chaque run — démarrage, raffinement de l'objectif avec ses critères d'acceptation, attente de validation, itérations enregistrées, auto-commits, arrêts — dans une base dédiée, distincte des sessions. À la réouverture, l'avancement est reconstruit : rien n'est rejoué sur vos fichiers (les modifications déjà appliquées y sont déjà), et les checkpoints restent disponibles via /undo.

An autonomous loop can run for a long time — and the browser, well, lives its own life: a tab closed by mistake, the battery, an update. VisiDog therefore journals the milestones of every run — start, goal refinement with its acceptance criteria, approval wait, recorded iterations, auto-commits, stops — in a dedicated store, separate from the sessions. On reopening, the progress is rebuilt: nothing is replayed onto your files (changes already applied are already there), and the checkpoints remain available through /undo.

La reprise est prudente par construction. Un run n'est marqué « interrompu » qu'après vérification que l'onglet qui le tenait est bien parti : tant qu'une autre fenêtre fait tourner la boucle, son verrou de session la protège — jamais deux boucles pour la même session, et un rechargement ne perd pas le run en cours. L'objectif restauré arrive en pause, avec son rapport : état, itérations accomplies, durée, jetons, dernière activité. /goal resume repart de là — ou /goal avec une nouvelle description ouvre un nouveau run, l'ancien restant archivé.

Resumption is cautious by design. A run is only marked "interrupted" after checking that the tab holding it is really gone: as long as another window runs the loop, its session lock protects it — never two loops for the same session, and a reload never loses the running run. The restored goal arrives paused, with its report: state, completed iterations, duration, tokens, last activity. /goal resume picks up from there — or /goal with a new description starts a new run, the old one staying archived.

• ✓Jalons persistés : chaque itération, attente et arrêt sont consignés, plafonnés et consultablesPersisted milestones: every iteration, wait and stop is recorded, capped and readable
• ✓Reprise explicite : l'objectif restauré est en pause — rien ne tourne sans votre gesteExplicit resume: the restored goal is paused — nothing runs without your gesture
• ✓Fichiers intouchés : la reprise ne rejoue aucune modification déjà appliquéeUntouched files: resuming never replays an already-applied change

Le mode Infinite (/infinite) : la boucle permanenteThe infinite mode (/infinite): the permanent loop

/infinite reprend exactement la mécanique de /goal — cycles Plan puis Act, checkpoints, budget, journal — et en retire ce qui fait finir : plus de plafond d'itérations, plus d'attente d'approbation (les plans sont auto-approuvés), plus de contrôle de complétion globale. Quand une phase Act se termine, le cycle suivant démarre : l'agent analyse l'état courant du projet et choisit lui-même la prochaine amélioration qui vaut le coup — correction de cas limite, optimisation, test manquant, refactoring ciblé — en 2 à 10 étapes par cycle.

/infinite reuses the exact machinery of /goal — Plan then Act cycles, checkpoints, budget, journal — and removes what makes it end: no iteration cap, no approval wait (plans are auto-approved), no global completion check. When an Act phase ends, the next cycle starts: the agent analyzes the project's current state and picks the next high-value improvement itself — an edge case fix, an optimization, a missing test, a targeted refactoring — in 2 to 10 steps per cycle.

Deux différences méritent le détour. À la fin de chaque cycle, la boucle crée un auto-commit Git — chore(infinite): cycle N continuous improvement — uniquement si un dépôt existe déjà et porte des modifications en attente : chaque cycle se trouve ainsi un point d'ancrage dans l'historique, et un espace de travail sans dépôt Git est laissé intact. Et la température du modèle progresse par paliers — focalisée au départ, elle monte lentement vers un plafond raisonnable — pour que les premiers cycles restent prudents et que les suivants gagnent en audace sans jamais devenir erratiques.

Two differences deserve a closer look. At the end of each cycle, the loop creates a Git auto-commit — chore(infinite): cycle N continuous improvement — only if a repository already exists and carries pending changes: every cycle thus gets an anchor in history, and a workspace without a Git repo is left untouched. And the model's temperature climbs in steps — focused at first, it rises slowly toward a reasonable ceiling — so early cycles stay careful while later ones gain boldness without ever becoming erratic.

Quand choisir /infinite plutôt que /goalWhen to choose /infinite over /goal

Tout se joue sur une question : votre demande a-t-elle une ligne d'arrivée vérifiable ? Si oui, /goal est fait pour elle — un objectif, des critères, un contrôle de succès, une fin annoncée. Si non, /infinite prend le relais : son « objectif » est une direction, pas un état final.

It all turns on one question: does your request have a verifiable finish line? If it does, /goal is made for it — an objective, criteria, a success check, an announced end. If it does not, /infinite takes over: its "objective" is a direction, not a final state.

Les garde-fous de la boucle permanenteThe permanent loop's guards

Une boucle qui ne s'arrête pas d'elle-même doit être entourée. Celle-ci l'est à plusieurs étages : vous coupez quand vous voulez — /goal stop ou un clic sur le badge de mode ; le budget de dépense reste armé et arrête la boucle franchement quand le plafond est atteint ; chaque écriture reste précédée de son checkpoint, donc /undo défait n'importe quel pas ; chaque cycle achevé se fixe dans l'historique Git, ce qui borne mécaniquement la portée d'un cycle raté ; la température plafonne, et le journal conserve la trace de chaque cycle pour comprendre ce qui a été fait pendant votre absence.

A loop that never stops by itself must be surrounded. This one is, at several layers: you cut it whenever you want — /goal stop or a click on the mode badge; the spend budget stays armed and stops the loop plainly when the ceiling is hit; every write stays preceded by its checkpoint, so /undo undoes any single step; every completed cycle anchors itself in Git history, mechanically bounding the blast radius of a bad cycle; the temperature is capped; and the journal keeps the trace of every cycle so you can understand what was done while you were away.

L'utiliser dans VisiDogUsing it in VisiDog

Ce que ça vous apporteWhat it brings you

• ✓Discuter sans risque : en Plan, l'agent ne peut physiquement rien modifier — la conception reste une conversation.Risk-free discussion: in Plan, the agent physically cannot change anything — design stays a conversation.
• ✓Appliquer sans peur : en Act, chaque écriture est précédée d'un instantané annulable en un clic.Fearless application: in Act, every write is preceded by a one-click revertible snapshot.
• ✓Déléguer sans perdre le contrôle : /goal ne s'arrête que sur un succès vérifié — ou sur un garde-fou franc.Delegate without losing control: /goal only stops on a verified success — or on a frank guard.
• ✓Améliorer en continu : /infinite fait avancer le projet cycle après cycle, chaque cycle ancré par un commit.Improve continuously: /infinite moves the project forward cycle after cycle, each cycle anchored by a commit.
• ✓Contexte maîtrisé : le relais borné entre cycles garde les coûts bas sans amnésie sur le travail restant.Controlled context: the bounded relay between cycles keeps costs low without forgetting the remaining work.
• ✓Insensible aux accidents : rechargement, fermeture d'onglet — l'avancement est reconstruit, la reprise reste un geste explicite.Accident-proof: reload, closed tab — progress is rebuilt, resuming stays an explicit gesture.

Points d'attentionPoints of attention