Flux de travail axés sur la planification

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

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

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

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

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

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

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 ? »

Caractéristiques du découpage

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

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

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)

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

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

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é ?

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?

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

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é

Options d'interaction 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

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.

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

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

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 »

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.

FAQ (questions fréquemment posées)

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.

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 :

Verdent exécute les étapes spécifiées
S'arrête à un point de contrôle pour revue
Vous examinez les résultats et fournissez des retours
Continuez avec la phase suivante ou ajustez l'approche
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.

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.

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.

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.

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 :

# 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.

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.

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.