# Flux de travail axés sur la planification (/fr/docs/verdent-for-vscode/configuration/plan-workflows)

> Utiliser la planification assistée par IA pour les tâches complexes



Les flux de travail axés sur la planification exploitent **Plan Mode**, un mode d'exécution en lecture seule où Verdent analyse le code, effectue des recherches et crée des plans détaillés avant d'exécuter la moindre modification. Ce flux de travail sépare la planification stratégique de l'implémentation, permettant une revue et un affinement avant de s'engager dans des modifications de code.

### Quand utiliser Plan Mode [#quand-utiliser-plan-mode]

* Modifications complexes touchant plusieurs fichiers et nécessitant une coordination
* Incertitude quant à la meilleure approche d'implémentation
* Modifications à fort enjeu sur du code critique en production
* Tâches dans des bases de code peu familières nécessitant une exploration
* Besoins de planification stratégique nécessitant une approbation avant exécution

***

## Découpage des tâches assisté par IA [#découpage-des-tâches-assisté-par-ia]

Verdent décompose automatiquement les demandes complexes en étapes séquentielles et gérables grâce au découpage de tâches assisté par IA.

### Processus de découpage [#processus-de-découpage]

<Steps>
  <Step title="Analyse de la demande">
    Verdent analyse votre demande en langage naturel pour identifier :

    * L'objectif principal et le résultat souhaité
    * Les fichiers, composants ou systèmes concernés
    * Les opérations techniques et dépendances requises
    * Les facteurs de complexité potentiels
  </Step>

  <Step title="Contexte de la base de code">
    Verdent examine la structure de votre projet pour comprendre :

    * L'architecture existante et les schémas établis
    * L'organisation des fichiers et la pile technologique
    * Les implémentations actuelles nécessitant une modification
  </Step>

  <Step title="Décomposition de la tâche">
    Verdent découpe la demande en sous-tâches logiques :

    * Identifie les points de rupture naturels et les phases d'implémentation
    * Ordonne les tâches par dépendance (les tâches prérequises en premier)
    * Regroupe les opérations liées entre elles
    * Estime la portée et la complexité de chaque sous-tâche
  </Step>

  <Step title="Clarification interactive">
    Verdent peut poser des questions pour affiner le découpage :

    * « Dois-je modifier la validation existante ou créer un nouveau validateur ? »
    * « Souhaitez-vous mettre à jour les tests pour tous les composants concernés ? »
    * « Cette modification doit-elle s'appliquer aux composants web et mobile ? »
  </Step>
</Steps>

### Caractéristiques du découpage [#caractéristiques-du-découpage]

<Tabs>
  <Tab title="Granularité">
    * Tâches dimensionnées pour 15 à 45 minutes de travail concentré
    * Points de rupture naturels pour les tests et la validation
    * Suffisamment complexes pour avoir du sens, suffisamment simples pour être exécutées
  </Tab>

  <Tab title="Séquencement">
    * Dépendances respectées (mise en place avant implémentation)
    * Progression logique (couche de données → logique métier → interface utilisateur)
    * Étapes de vérification après les phases majeures
  </Tab>

  <Tab title="Personnalisation">
    Le format de découpage du plan peut être personnalisé via `plan_rules.md` pour contrôler :

    * Le niveau de détail (vue d'ensemble vs. granulaire)
    * La structure et les sections du plan
    * Les informations incluses (estimations de temps, risques, dépendances)
  </Tab>
</Tabs>

***

## Revue et approbation du plan [#revue-et-approbation-du-plan]

Après avoir soumis une demande en Plan Mode, Verdent génère un plan structuré affiché dans la vue de conversation pour votre revue.

### Processus de revue [#processus-de-revue]

<Steps>
  <Step title="Recevoir le plan structuré">
    Verdent génère un plan avec des sections claires, des étapes numérotées, les fichiers concernés et les dépendances identifiées
  </Step>

  <Step title="Analyser la qualité du plan">
    Vérifiez :

    * **Justesse :** L'approche résout-elle le problème ?
    * **Exhaustivité :** Toutes les étapes nécessaires sont-elles incluses ?
    * **Efficacité :** Est-ce la meilleure approche ?
    * **Risque :** Qu'est-ce qui pourrait mal se passer ? Cas particuliers ou préoccupations de sécurité ?
  </Step>

  <Step title="Poser des questions de clarification">
    Demandez des informations supplémentaires si quelque chose n'est pas clair :

    ```
    Can you explain step 3 in more detail?
    Why are we modifying both the service and controller?
    What happens if the API call fails in step 5?
    ```
  </Step>

  <Step title="Demander des modifications">
    Fournissez des retours pour réviser le plan :

    ```
    Let's use JWT tokens instead of OAuth2
    Can we break step 4 into smaller substeps?
    Add error handling considerations to the plan
    ```
  </Step>

  <Step title="Choisir votre prochaine action">
    Une fois que Verdent a généré le plan, deux options sont proposées :

    * **Modifier** : demander des modifications, poser des questions de clarification ou affiner davantage le plan
    * **Démarrer la construction** : passer en Agent Mode et commencer l'exécution du plan approuvé
  </Step>
</Steps>

### Options d'interaction avec le plan [#options-dinteraction-avec-le-plan]

Après avoir examiné le plan généré, Verdent propose deux options :

**Modifier :**

Choisissez cette option pour :

* Demander des changements spécifiques à l'approche du plan
* Poser des questions de clarification sur les détails d'implémentation
* Ajouter des éléments ou considérations manquants
* Simplifier ou développer certaines étapes
* Explorer des approches alternatives

Cela vous maintient en Plan Mode pour un affinement itératif sans exécuter aucune modification.

**Démarrer la construction :**

Choisissez cette option pour :

* Passer en Agent Mode et commencer l'exécution
* Implémenter le plan approuvé en toute autonomie
* Effectuer des modifications de fichiers et exécuter des commandes selon le plan

Vous pouvez également opter pour :

* **Implémentation manuelle** : examiner le plan et implémenter les modifications vous-même
* **Exécution incrémentale** : demander à Verdent d'implémenter des phases spécifiques avec des points de contrôle pour la revue entre les étapes

<Tip>
  Utilisez **Modifier** pour itérer sur le plan autant de fois que nécessaire. Ne choisissez **Démarrer la construction** que lorsque vous êtes certain que l'approche est correcte et complète.
</Tip>

***

## Planification itérative [#planification-itérative]

Les utilisateurs peuvent librement modifier et itérer sur les plans en choisissant **Modifier** et en fournissant des retours conversationnels. Verdent traite la génération de plan comme un processus interactif et itératif.

### Méthodes de modification [#méthodes-de-modification]

**Demander des changements spécifiques :**

```
Change step 3 to use Redux instead of Context API
Add input validation before the database insert
Swap the order of steps 4 and 5
```

**Ajouter des éléments manquants :**

```
Add error handling for network failures
Include rollback procedures
Add performance optimization considerations
```

**Simplifier ou développer :**

```
This is too complex - can we simplify the approach?
Break down step 5 into more detailed substeps
Give me more detail on the database schema changes
```

**Explorer des alternatives :**

```
What if we used webhooks instead?
Show me an alternative plan using microservices architecture
Can we accomplish this without changing the database schema?
```

### Exemple de flux d'itération [#exemple-de-flux-ditération]

```
User: "Add user authentication to the API"

[Verdent generates initial plan with JWT tokens]

User: "Actually, let's use OAuth2 instead of JWT"

[Verdent revises plan to use OAuth2]

User: "Add step for migrating existing users"

[Verdent adds migration step to plan]

User: "Can you break down the migration step more?"

[Verdent expands migration with detailed substeps]

User: Chooses **Start Building**

[Verdent switches to Agent Mode and begins execution]
```

**Itérations illimitées :**

* Aucune limite sur le nombre de révisions
* Chaque itération conserve le contexte de la conversation
* Les versions précédentes sont conservées dans l'historique de conversation
* Vous pouvez faire référence à des versions antérieures du plan : « reviens à la première approche »

<Note>
  Le rejet d'un plan fait naturellement partie du processus de planification itérative. Cela garantit que seules des stratégies approuvées et bien comprises sont exécutées, réduisant les efforts gaspillés sur des implémentations incorrectes.
</Note>

***

## FAQ (questions fréquemment posées) [#faq-questions-fréquemment-posées]

<Accordion title="Plan Mode écrit-il réellement du code dans mes fichiers ?">
  **Non.** Plan Mode est strictement en lecture seule :

  * Verdent peut lire des fichiers, rechercher dans le code et analyser votre base de code
  * **Aucune écriture, modification ou suppression de fichier** ne se produit pendant Plan Mode
  * Les plans sont affichés uniquement dans la vue de conversation
  * L'exécution du code ne commence qu'après votre approbation explicite et le passage en Agent Mode

  **Garantie de sécurité :** Plan Mode ne peut pas modifier accidentellement votre code. Il est conçu pour une exploration sûre et le développement de stratégies.
</Accordion>

<Accordion title="Puis-je exécuter un plan de façon incrémentale plutôt qu'en une seule fois ?">
  **Oui.** L'exécution incrémentale est entièrement prise en charge :

  **Schéma d'approbation incrémentale :**

  ```
  Let's start with Phase 1 first, then we'll review before continuing
  Implement steps 1-3, then stop for review
  Do the database migration first, I'll review before the API changes
  ```

  **Fonctionnement :**

  1. Verdent exécute les étapes spécifiées
  2. S'arrête à un point de contrôle pour revue
  3. Vous examinez les résultats et fournissez des retours
  4. Continuez avec la phase suivante ou ajustez l'approche
  5. Répétez jusqu'à l'achèvement

  **Idéal pour :** les modifications à haut risque, les schémas peu familiers, le code critique en production où un déploiement par phases réduit le risque.

  <Tip>
    L'exécution incrémentale vous permet d'approuver certaines parties d'un plan tout en différant d'autres, ce qui est utile lorsque les priorités changent en cours de tâche.
  </Tip>
</Accordion>

<Accordion title="Que se passe-t-il si je rejette un plan ?">
  **Le rejet d'un plan est totalement normal et attendu :**

  * Verdent génère un nouveau plan en fonction de vos retours
  * Les versions précédentes du plan restent dans l'historique de conversation pour référence
  * Aucune modification de code ne se produit (Plan Mode est en lecture seule)
  * Vous pouvez itérer un nombre illimité de fois jusqu'à satisfaction

  **Raisons courantes de rejet :**

  * L'approche est trop complexe ou trop simple
  * Des cas particuliers ou une gestion des erreurs sont manquants
  * Une meilleure architecture alternative existe
  * Les exigences ont été mal comprises

  **Astuce :** le rejet fait partie du processus. Il est préférable d'affiner les plans de façon itérative plutôt que de gaspiller des efforts à exécuter des stratégies incorrectes.
</Accordion>

<Accordion title="Comment basculer entre Plan Mode et Agent Mode ?">
  **Le basculement est instantané via la zone de saisie :**

  **Pour entrer en Plan Mode :**

  * Cliquez sur le bouton **Changer de mode** dans la zone de saisie
  * Sélectionnez **Plan Mode** dans le menu déroulant
  * OU dites : « passe en Plan Mode »

  **Pour quitter Plan Mode :**

  * Cliquez sur le bouton **Changer de mode** dans la zone de saisie
  * Sélectionnez **Agent Mode** dans le menu déroulant
  * OU choisissez **Démarrer la construction** après avoir examiné un plan

  **Persistance du mode :**

  * Le choix du mode persiste au sein de la session en cours
  * Les nouvelles sessions démarrent dans le mode Agent Mode par défaut
  * Vous pouvez changer de mode librement à tout moment

  **Flux de travail typique :** Plan Mode → revue → Agent Mode → exécution → retour à Plan Mode pour la prochaine fonctionnalité complexe.
</Accordion>

<Accordion title="Puis-je personnaliser le format et le niveau de détail des plans générés ?">
  **Oui, en utilisant `plan_rules.md` :**

  **Emplacement :** `~/.verdent/plan_rules.md` (répertoire de configuration global)

  **Ce que vous pouvez personnaliser :**

  * **Niveau de détail :** vue d'ensemble vs. étapes granulaires
  * **Structure du plan :** sections à inclure (résumé, risques, dépendances, tests)
  * **Informations incluses :** estimations de temps, chemins de fichiers, étapes de vérification
  * **Préférences de format :** listes numérotées, phases, catégorisation

  **Exemple de plan\_rules.md :**

  ```markdown
  # Plan Rules

  ## Plan Structure
  - Start with a brief summary (2-3 sentences)
  - Include estimated time for each major step
  - List prerequisites before implementation steps
  - Identify potential risks and mitigation strategies

  ## Level of Detail
  - Break tasks into subtasks of 15-30 minutes
  - Include specific file paths for modifications
  - List functions or components to create/modify
  - Provide verification steps for each phase
  ```

  **Les modifications s'appliquent immédiatement** aux nouvelles sessions Plan Mode.
</Accordion>

<Accordion title="Plan Mode utilise-t-il le même contexte que Agent Mode ?">
  **Non, Plan Mode dispose d'une gestion du contexte distincte :**

  * **Contexte Plan Mode :** optimisé pour l'analyse et la réflexion stratégique
  * **Contexte Agent Mode :** optimisé pour l'exécution et l'implémentation
  * **Avantage :** les plans ne polluent pas le contexte d'exécution avec des recherches exploratoires

  **Pourquoi cette séparation est importante :**

  * Plan Mode peut explorer plusieurs approches sans encombrer Agent Mode
  * Les tentatives de plan rejetées ne consomment pas le contexte de Agent Mode
  * Table rase lors du passage à l'exécution

  **Réinitialisation du contexte :** le changement de mode fournit un contexte neuf pour le nouveau type de tâche.
</Accordion>

<Accordion title="Que se passe-t-il si Verdent pose des questions de clarification pendant la planification ?">
  **Les questions de clarification font partie du processus de découpage :**

  **Pourquoi des questions sont posées :**

  * Des exigences ambiguës nécessitent une clarification
  * Plusieurs approches valides existent (il faut en choisir une)
  * Des cas particuliers ou contraintes ne sont pas encore spécifiés
  * Les préférences ne sont pas claires à partir de la demande initiale

  **Comment répondre :**

  * Répondez directement en langage conversationnel
  * Fournissez des exemples si utile
  * Dites « à votre discrétion » si vous faites confiance au jugement de Verdent
  * Posez des questions en retour si vous n'êtes pas sûr

  **Exemple d'échange :**

  ```
  Verdent: "Should I modify the existing validation or create a new validator?"
  You: "Create a new validator - we'll deprecate the old one later"
  Verdent: [Updates plan with new validator approach]
  ```

  **Astuce :** les questions aident Verdent à générer des plans précis et pertinents, adaptés à vos besoins spécifiques.
</Accordion>

***

## Voir aussi [#voir-aussi]

<CardGroup cols="2">
  <Card title="Modes d'exécution" icon="sliders" href="/docs/verdent-for-vscode/execution-modes/overview">
    En savoir plus sur Plan Mode et les autres modes d'exécution
  </Card>

  <Card title="Bonnes pratiques : prompts" icon="message" href="/docs/verdent-for-vscode/best-practices/prompts">
    Rédigez des prompts efficaces pour Plan Mode
  </Card>
</CardGroup>
