Planning Sessions
La planification est l'étape où la plupart des projets échouent. Ce n'est pas par manque d'idées ou de talent : les équipes se lancent directement dans la construction sans valider leurs hypothèses, questionner le périmètre ni identifier les risques devant elles.
Les Planning Sessions d'Almirant ne sont pas un outil de génération de tâches. Elles constituent votre sparring partner IA : il vous challenge, vous questionne et vous oblige à réfléchir avant d'écrire une seule ligne de code.
Que sont les Planning Sessions ?
Une Planning Session est une conversation multi-tour avec l'IA. Ce n'est pas un prompt unique qui produit une liste d'items : c'est un dialogue itératif dans lequel l'IA agit comme sparring partner et challenge chaque décision que vous prenez :
- Elle questionne les hypothèses que vous tenez pour acquises.
- Elle identifie les risques dans votre planification.
- Elle propose des alternatives que vous n'aviez pas envisagées.
- Elle affine le périmètre afin de clarifier ce qui est inclus et exclu.
Le résultat n'est pas seulement une liste de work items : c'est un périmètre validé et des hypothèses examinées.
La différence est fondamentale. Un générateur prend votre input et produit un output. Un sparring partner questionne votre input. Il vous demande pourquoi, quelles alternatives vous avez considérées et où se trouvent les risques.
Démarrer une session
- Accédez à la route
/plandepuis le projet où vous souhaitez planifier. - Sélectionnez le board de destination où seront créés les work items résultants.
- Facultativement, sélectionnez des seeds d'idéation pour fournir le contexte initial.
- Écrivez votre message initial en décrivant ce que vous souhaitez atteindre.
- Démarrez la conversation.
Titre de la session
Au démarrage, vous pouvez attribuer un titre descriptif à la session. Il vous aidera à l'identifier dans l'historique. Exemples :
- « Planification de l'authentification OAuth »
- « Analyse de migration de base de données »
- « Conception du système de notifications »
Workflow conversationnel
La session suit un dialogue naturel :
1. Vous présentez votre idée
Décrivez ce que vous souhaitez atteindre. Vous n'avez pas besoin de tout avoir défini : c'est précisément le rôle du sparring.
2. L'IA questionne
Au lieu de générer immédiatement des items, l'IA pose des questions :
- Pourquoi cela est-il nécessaire ?
- Quelles alternatives avez-vous envisagées ?
- Où sont les angles morts ?
- Que se passe-t-il si cela échoue ?
3. Vous défendez ou reconsidérez votre position
Vous répondez aux questions. Parfois vous défendez votre position, parfois vous réalisez qu'il existe une meilleure approche.
4. Le périmètre s'affine
À chaque itération, le périmètre devient plus clair. L'IA comprend mieux votre contexte et vous comprenez mieux les risques.
5. Génération des work items
Lorsque le périmètre est validé, l'IA génère des work items structurés : epics, features, stories et tasks avec des définitions de complétion.
6. Révision et acceptation
Vous vérifiez chaque item suggéré. Vous acceptez ceux qui s'appliquent et rejetez les autres. Les items acceptés sont créés automatiquement dans le board sélectionné.
Phases de la session
Chaque session passe par différentes phases, visibles dans l'interface :
| Phase | Description |
|---|---|
idle | Attend que vous démarriez la conversation |
booting | Prépare la session et le contexte |
chatting | Échange des messages avec l'IA |
streaming | Reçoit une réponse en temps réel |
thinking | L'IA traite et raisonne, mode thinking actif |
waiting_for_answer | L'IA attend votre réponse à une question |
reviewing | Vérifie les items suggérés à accepter ou rejeter |
completed | Session achevée avec des items créés |
paused | Session suspendue pour reprendre plus tard |
Sélectionner des seeds d'idéation
Avant de démarrer le dialogue, vous pouvez sélectionner des seeds : des idées déjà capturées dans Almirant qui servent de point de départ. Les seeds apportent à la session un contexte initial :
- Notes de brainstorming enregistrées.
- Idées de sessions précédentes.
- Exigences issues de conversations avec les stakeholders.
- Feedback utilisateur traité.
Lorsque vous sélectionnez des seeds, l'IA les analyse comme partie du contexte initial, permettant une planification plus éclairée.
Sélectionner des seeds
- Sur l'écran de démarrage de la session, vous verrez la section Available Seeds.
- Cochez les seeds pertinents pour cette planification.
- Les seeds sélectionnés seront inclus dans le contexte initial de la session.
Le champ seedsProcessed dans le résultat de la session indique combien de seeds ont été analysés.
Générer des work items
Lorsque la conversation atteint un point où le périmètre est clair, l'IA génère une proposition de work items structurés :
Types d'items générés
| Type | Description |
|---|---|
| Epic | Grande initiative regroupant plusieurs features |
| Feature | Fonctionnalité concrète apportant de la valeur |
| Story | User story avec critères d'acceptation |
| Task | Tâche technique précise et actionnable |
Structure de chaque item
Chaque item proposé comprend :
- Un titre descriptif et actionnable.
- Une description détaillée avec le contexte.
- Une priorité suggérée (urgent, high, medium, low).
- Une hiérarchie (
parentTempIdindique l'item parent). - Une origine (
fromSeedIds'il provient d'un seed précis).
Vérifier et accepter
Dans la phase de révision, vous pouvez :
- Accepter des items individuels.
- Rejeter les items qui ne s'appliquent pas.
- Tout accepter si la proposition complète vous convient.
Les items acceptés sont automatiquement créés dans le board sélectionné, en respectant la hiérarchie proposée.
Historique des sessions
Toutes les sessions sont enregistrées automatiquement et restent accessibles ensuite :
| État | Description |
|---|---|
| active | Session en cours. Vous pouvez poursuivre le dialogue. |
| completed | Session terminée. Les items ont été créés dans le board. |
| archived | Session enregistrée pour référence future. |
Depuis l'historique, vous pouvez :
- Voir le dialogue complet de toute session.
- Consulter les items créés.
- Réactiver une session archivée pour la poursuivre.
Suivi des coûts
Chaque session enregistre des métriques d'utilisation afin que vous puissiez optimiser votre consommation de quota :
| Métrique | Description |
|---|---|
totalInputTokens | Tokens envoyés à l'IA |
totalOutputTokens | Tokens reçus de l'IA |
estimatedCost | Coût estimé de la session |
durationMs | Durée totale de la session |
Ces métriques permettent de comprendre la consommation de chaque session et d'optimiser l'utilisation du quota IA.
Configuration de la session
Chaque session peut avoir sa propre configuration :
| Champ | Description |
|---|---|
model | Modèle IA à utiliser (e.g., claude-3-opus) |
provider | Fournisseur IA (anthropic, openai, etc.) |
systemPrompt | Prompt système personnalisé |
temperature | Température de génération (0.0 - 1.0) |
La configuration par défaut provient des réglages de l'organisation, mais vous pouvez la personnaliser pour certaines sessions.
Modes de réponse
L'IA peut opérer selon différents modes en fonction de la complexité du sujet :
Streaming
Vous voyez la réponse pendant qu'elle est générée. Ce mode est idéal pour une itération rapide et un dialogue fluide.
Thinking
L'IA raisonne étape par étape avant de répondre. Ce mode est mieux adapté aux problèmes complexes nécessitant une analyse approfondie.
Vous pouvez alterner entre les modes pendant la session.
Écrire des prompts efficaces
Votre premier message compte. Voici des exemples de bons points de départ :
Bons points de départ
| Prompt | Pourquoi cela fonctionne |
|---|---|
| « Je veux ajouter l'authentification sociale, mais je ne sais pas si l'effort en vaut la peine par rapport aux magic links » | Invite l'IA à comparer les alternatives |
| « Je dois améliorer les performances de la liste de produits, les utilisateurs se plaignent de lenteur » | Définit le vrai problème, pas la solution supposée |
| « Nous devons migrer de REST à GraphQL, l'équipe dit que c'est mieux mais je ne suis pas convaincu » | Ouvre un espace pour questionner la décision |
À éviter
| Prompt | Problème |
|---|---|
| « Génère des tasks pour l'authentification » | Ferme l'espace de dialogue et demande un output direct |
| « Crée un CRUD d'utilisateurs » | Aucun problème à résoudre, seulement de la mécanique |
| « Améliore tout le système » | Sans focus, impossible à questionner |
Prérequis
Pour utiliser les Planning Sessions, vous avez besoin :
- D'un fournisseur IA configuré avec une API key valide.
- De quota disponible dans votre organisation.
- D'un projet avec au moins un board actif dans lequel les items seront créés.
Structure des données
La session est stockée avec les champs principaux suivants :
| Champ | Type | Description |
|---|---|---|
id | uuid | Identifiant unique |
organizationId | text | Organisation propriétaire |
projectId | uuid | Projet associé |
boardId | uuid | Board où les items sont créés |
title | text | Titre de la session |
status | enum | active, completed, archived |
config | json | model, provider, systemPrompt, temperature |
result | json | summary, workItemsCreated, seedsProcessed |
Messages de la session
Chaque message de la conversation contient :
| Champ | Type | Description |
|---|---|---|
role | enum | user, assistant, system |
content | text | Contenu du message |
messageType | varchar | Type de message |
inputTokens | integer | Tokens d'entrée |
outputTokens | integer | Tokens de sortie |
Outils MCP
| Tool | Description | Paramètres principaux |
|---|---|---|
record_ai_session | Enregistre une session de planification | projectId, prompt, response, tokensUsed |
get_ai_sessions | Obtient l'historique des sessions d'un projet | projectId, limit |
Exemple : enregistrer une session
Tool: record_ai_session
Paramètres :
projectId: "uuid-del-proyecto"
prompt: "J'ai besoin d'un système de notifications push"
response: "Proposition générée par l'IA..."
tokensUsed: 1250
Route d'accès
La route principale des Planning Sessions est /plan. Depuis celle-ci, vous pouvez démarrer de nouvelles sessions, voir l'historique et poursuivre les sessions suspendues.