# SPEC — Générateur de calculateur Excel de break-even pour un pilote d’agent IA ## 1. Objectif du classeur Créer un fichier Excel `.xlsx` permettant d’évaluer si un pilote d’agent IA, d’assistant de codage ou d’outil d’automatisation couvre ses coûts mensuels par les gains réellement capturables. Le fichier doit aider un utilisateur à répondre à la question suivante : > À partir de combien d’heures réellement économisées par mois cet outil devient-il économiquement défendable ? Le classeur ne doit pas être présenté comme un outil de décision automatique. Il doit produire une base chiffrée, explicite et reviewable pour aider à décider si un pilote doit être poursuivi, ajusté, élargi ou arrêté. Le cas d’usage par défaut est un pilote d’agent de codage IA, mais le modèle doit rester adaptable à d’autres contextes : support, documentation, QA, automatisation métier, analyse de données, revue technique, production éditoriale ou assistance opérationnelle. ## 2. Livrable attendu Générer un fichier Excel `.xlsx` complet, lisible et utilisable directement. Le fichier doit contenir au minimum les onglets suivants : 1. `Mode emploi` 2. `Hypotheses` 3. `Workflows` 4. `Scenarios` 5. `Synthese` 6. `Checks` Le fichier doit contenir des formules Excel réelles, pas seulement des valeurs statiques. Les cellules d’entrée doivent être visuellement distinguées des cellules calculées. Les résultats doivent être compréhensibles sans avoir besoin de lire les formules. Le classeur doit être utilisable “out of the box” avec un jeu de valeurs d’exemple réaliste. ## 3. Paramètres personnalisables Avant génération, l’utilisateur peut adapter les paramètres suivants. ```text Nom du fichier : calculateur-break-even-agent-ia.xlsx Langue du fichier : Français Devise : EUR Cas d’usage par défaut : Pilote d’agent de codage IA Nom de marque affiché : [optionnel] Logo : [optionnel] Palette graphique : [optionnel] Nombre de scénarios : 3 par défaut Scénarios par défaut : Prudent, Central, Ambitieux Nombre de workflows d’exemple : 8 par défaut ```` Si aucune charte graphique n’est fournie, utiliser une charte sobre : ```text Couleur principale : #0ABF53 Couleur principale sombre : #07853A Information : #334AC0 Warning : #F39568 Danger : #692340 Texte principal : #2D374B Texte secondaire : #51596C Fond clair : #F5F7FA Fond technique clair : #F8FAFC Fond sombre pour prompt : #24292E Blanc : #FFFFFF Bordure légère : #DCE0E5 ``` ## 4. Logique économique du modèle Le modèle doit comparer : ```text Valeur créée par les gains ajustés + valeur des défauts ou incidents évités - coûts mensuels complets du pilote = valeur nette mensuelle ``` Le modèle doit distinguer clairement : 1. les coûts d’outil ; 2. les coûts humains ; 3. le setup initial amorti ; 4. les gains bruts estimés ; 5. les gains ajustés ; 6. la valeur économique des gains ; 7. la valeur des défauts évités ; 8. le break-even en heures ; 9. la décision indicative. Le modèle ne doit pas considérer que toute heure gagnée est automatiquement une heure de valeur. Les gains doivent être réduits par : ```text taux de réalisation des gains taux de risque / rework valeur du temps réellement réalloué ``` ## 5. Onglet `Mode emploi` ### Objectif Créer un onglet d’accueil pédagogique qui explique à quoi sert le fichier, dans quel ordre l’utiliser et quelles erreurs éviter. ### Contenu attendu L’onglet doit contenir les sections suivantes : ```text Titre : Calculateur break-even IA — mode d’emploi À quoi sert ce fichier : Ce classeur sert à estimer si un pilote d’agent IA couvre ses coûts mensuels par les heures réellement économisées et les défauts évités. Message important : Le fichier ne remplace pas une décision de management. Il fournit une base de discussion chiffrée, explicite et reviewable. Parcours recommandé : 1. Remplir Hypotheses 2. Adapter Workflows 3. Ajuster Scenarios 4. Lire Synthese 5. Vérifier Checks Code couleur : - Cellules bleues : entrées utilisateur - Cellules jaunes : hypothèses sensibles - Cellules grises : formules automatiques - Rouge : alerte, no-go ou valeur négative - Orange : attention ou incertitude - Vert : résultat positif ou validé Erreurs fréquentes : - Saisir 70 au lieu de 70% ou 0,70 - Estimer les gains sans baseline - Oublier le coût de review humaine - Ne regarder que le scénario ambitieux - Confondre gain brut et gain réellement capturable Prompt IA utile : Inclure un prompt que l’utilisateur pourra copier-coller pour demander à une IA d’analyser le fichier. ``` ### Prompt IA à inclure dans l’onglet ```text Voici un calculateur break-even pour un pilote d’agent IA. Analyse les hypothèses, repère les variables qui pèsent le plus sur le résultat, identifie les entrées fragiles, puis propose trois actions concrètes pour rendre le pilote mesurable et économiquement défendable. Ne conclus pas uniquement à partir du scénario ambitieux. ``` ## 6. Onglet `Hypotheses` ### Objectif Centraliser les hypothèses globales du pilote. Cet onglet contient les entrées principales du modèle. Les valeurs doivent être modifiables par l’utilisateur. ### Colonnes attendues Créer un tableau avec les colonnes suivantes : ```text Paramètre Valeur Unité Type Commentaire Exemple / aide à la saisie ``` ### Lignes attendues Inclure au minimum les paramètres suivants. ```text Utilisateurs pilotes Coût horaire complet moyen Abonnement fixe mensuel Abonnement mensuel par utilisateur Coût usage variable mensuel Coût setup initial Amortissement setup Formation par utilisateur Revue humaine supplémentaire Gouvernance mensuelle Taux de réalisation des gains Valeur du temps réalloué Taux de risque / rework Défauts évités Coût moyen par défaut évité Budget mensuel maximum ``` ### Définitions des paramètres `Utilisateurs pilotes` Nombre de personnes réellement incluses dans le pilote. `Coût horaire complet moyen` Coût chargé moyen d’une heure de travail : salaire, charges, environnement, management, support, coût d’opportunité. `Abonnement fixe mensuel` Coût mensuel fixe du dispositif, indépendamment du nombre d’utilisateurs. `Abonnement mensuel par utilisateur` Coût mensuel par utilisateur ou par siège. Si le coût est déjà inclus dans l’abonnement fixe, saisir `0`. `Coût usage variable mensuel` Coûts variables : API, tokens, crédits, dépassements, options, compute, stockage, proxy, monitoring. `Coût setup initial` Coût initial de cadrage, configuration, prompts, sécurité, documentation, intégration, formation initiale. `Amortissement setup` Nombre de mois sur lesquels lisser le coût de setup initial. `Formation par utilisateur` Nombre d’heures mensuelles consacrées à l’accompagnement de chaque utilisateur pilote. `Revue humaine supplémentaire` Volume mensuel total de contrôle humain ajouté par le pilote : revue de sorties IA, tests, validation de PR, contrôle sécurité. `Gouvernance mensuelle` Temps mensuel total consacré au pilotage : arbitrages, suivi des risques, amélioration des règles, gouvernance. `Taux de réalisation des gains` Part des gains bruts qui devient réellement du temps récupérable. Valeur attendue entre `0` et `1`. `Valeur du temps réalloué` Part du temps récupéré qui crée une valeur économique réelle. Valeur attendue entre `0` et `1`. `Taux de risque / rework` Part des gains consommée par les corrections, reprises, erreurs, vérifications ou frictions générées par l’IA. Valeur attendue entre `0` et `1`. `Défauts évités` Nombre mensuel de défauts, incidents, oublis, régressions ou erreurs plausiblement évités grâce au dispositif. `Coût moyen par défaut évité` Valeur économique moyenne d’un défaut évité. `Budget mensuel maximum` Seuil de dépense mensuelle à ne pas dépasser sans décision explicite. ### Valeurs d’exemple réalistes Préremplir avec des valeurs prudentes : ```text Utilisateurs pilotes : 5 Coût horaire complet moyen : 65 Abonnement fixe mensuel : 200 Abonnement mensuel par utilisateur : 0 Coût usage variable mensuel : 350 Coût setup initial : 2500 Amortissement setup : 6 Formation par utilisateur : 3 Revue humaine supplémentaire : 12 Gouvernance mensuelle : 4 Taux de réalisation des gains : 0,70 Valeur du temps réalloué : 0,85 Taux de risque / rework : 0,10 Défauts évités : 2 Coût moyen par défaut évité : 450 Budget mensuel maximum : 1200 ``` ### Mise en forme Les cellules d’entrée simples doivent être en bleu clair. Les hypothèses sensibles doivent être en jaune clair : ```text Taux de réalisation des gains Valeur du temps réalloué Taux de risque / rework Défauts évités Coût moyen par défaut évité ``` Les taux doivent être formatés en pourcentage. Ajouter une note visible indiquant : ```text Les taux doivent être saisis comme 70% ou 0,70, pas 70. ``` ## 7. Onglet `Workflows` ### Objectif Lister les workflows mesurés et calculer les gains économiques associés. Chaque ligne correspond à un cas d’usage réel ou supposé du pilote IA. ### Colonnes attendues Créer un tableau avec les colonnes suivantes : ```text Workflow Volume / mois Baseline h / unité Gain brut estimé Gain brut h Gain ajusté h Valeur EUR Commentaire Mesure recommandée Confiance ``` ### Définitions `Workflow` Nom du cas d’usage mesuré. `Volume / mois` Nombre d’occurrences mensuelles du workflow. `Baseline h / unité` Temps moyen sans IA pour une occurrence. `Gain brut estimé` Gain théorique avant correction. Exemple : `0,25` signifie 25 %. `Gain brut h` Heures théoriques économisées avant prudence. Formule : ```text Volume / mois × Baseline h / unité × Gain brut estimé ``` `Gain ajusté h` Heures réellement récupérables après taux de réalisation et rework. Formule : ```text Gain brut h × Taux de réalisation des gains × (1 - Taux de risque / rework) ``` `Valeur EUR` Valeur économique du gain ajusté. Formule : ```text Gain ajusté h × Coût horaire complet moyen × Valeur du temps réalloué ``` `Commentaire` Explication courte du workflow. `Mesure recommandée` Méthode proposée pour mesurer le gain réel. `Confiance` Niveau de confiance dans l’estimation : `Faible`, `Moyenne`, `Haute`. ### Workflows d’exemple Préremplir les lignes suivantes : ```text Reproduction de bugs Préparation de PR Ajout de tests Refactoring local Documentation technique Analyse cause racine Support niveau 3 Dette technique ciblée ``` ### Valeurs d’exemple ```text Reproduction de bugs | 8 | 3,5 | 0,25 Préparation de PR | 10 | 1,2 | 0,20 Ajout de tests | 6 | 2,5 | 0,30 Refactoring local | 4 | 5 | 0,18 Documentation technique | 5 | 2 | 0,35 Analyse cause racine | 3 | 4 | 0,22 Support niveau 3 | 6 | 1,5 | 0,15 Dette technique ciblée | 2 | 8 | 0,20 ``` ### Totaux Ajouter une ligne `Totaux` calculant : ```text Total gain brut h Total gain ajusté h Total valeur EUR ``` ### Notes pédagogiques Ajouter en bas d’onglet : ```text Gain brut h = volume mensuel × baseline × gain brut estimé. Gain ajusté h = gain brut h × taux de réalisation × (1 - rework). Valeur EUR = gain ajusté h × coût horaire × valeur du temps réalloué. ``` ## 8. Onglet `Scenarios` ### Objectif Comparer plusieurs hypothèses de réalisation du pilote. Le fichier doit contenir trois scénarios par défaut : ```text Prudent Central Ambitieux ``` ### Colonnes attendues ```text Scénario Multiplicateur gain brut Réalisation gains Rework Coût variable Gain ajusté h Valeur nette EUR Décision indicative Interprétation ``` ### Logique Le scénario `Central` doit reprendre les hypothèses globales principales. Le scénario `Prudent` doit réduire les gains et augmenter le rework. Le scénario `Ambitieux` doit augmenter les gains, mais ne doit pas être utilisé seul pour décider. ### Valeurs d’exemple ```text Prudent | 0,75 | 0,55 | 0,18 | 450 Central | 1,00 | 0,70 | 0,10 | 350 Ambitieux | 1,25 | 0,85 | 0,06 | 500 ``` ### Formules `Gain ajusté h` : ```text Total gain brut h des workflows × Multiplicateur gain brut × Réalisation gains × (1 - Rework) ``` `Valeur des gains du scénario` : ```text Gain ajusté h × Coût horaire complet moyen × Valeur du temps réalloué ``` `Valeur nette EUR` : ```text Valeur des gains du scénario + valeur des défauts évités - coût mensuel total du pilote avec le coût variable du scénario ``` `Décision indicative` : ```text Si valeur nette EUR > 0 : "Poursuivre avec garde-fous" Sinon si valeur nette EUR est proche de 0 : "Ajuster avant extension" Sinon : "Arrêter ou réduire" ``` Le seuil “proche de 0” peut être défini comme une valeur nette comprise entre `-10 %` et `+10 %` du coût mensuel total. ### Texte pédagogique à inclure ```text Valeur nette positive : le pilote peut être poursuivi, mais seulement avec review humaine et evidence de gains. Valeur proche de zéro : le pilote mérite un ajustement des workflows, coûts ou garde-fous. Valeur fortement négative : réduire le périmètre, revoir les hypothèses ou arrêter le pilote. ``` ## 9. Onglet `Synthese` ### Objectif Créer un tableau de bord exécutif lisible en moins d’une minute. Cet onglet doit être la page principale de lecture. ### Sections attendues 1. Titre et marque 2. Résultat central 3. Lecture immédiate 4. Indicateurs clés 5. Tableau comparatif des scénarios 6. Graphique des scénarios 7. Explication de lecture du modèle ### Indicateurs clés Afficher les indicateurs suivants : ```text Coût mensuel total pilote Coût setup amorti Coûts humains de contrôle Gains ajustés workflows Valeur workflows Valeur défauts évités Valeur nette mensuelle Break-even hors défauts évités Break-even après défauts évités Écart vs break-even Heures nettes attendues / utilisateur Décision indicative ``` ### Formules détaillées `Coût setup amorti` : ```text Coût setup initial / Amortissement setup ``` `Coûts humains de contrôle` : ```text (Formation par utilisateur × Utilisateurs pilotes × Coût horaire complet moyen) + (Revue humaine supplémentaire × Coût horaire complet moyen) + (Gouvernance mensuelle × Coût horaire complet moyen) ``` `Coût outil mensuel` : ```text Abonnement fixe mensuel + (Abonnement mensuel par utilisateur × Utilisateurs pilotes) + Coût usage variable mensuel ``` `Coût mensuel total pilote` : ```text Coût outil mensuel + Coût setup amorti + Coûts humains de contrôle ``` `Gains ajustés workflows` : ```text Total des gains ajustés h de l’onglet Workflows ``` `Valeur workflows` : ```text Total valeur EUR de l’onglet Workflows ``` `Valeur défauts évités` : ```text Défauts évités × Coût moyen par défaut évité ``` `Valeur nette mensuelle` : ```text Valeur workflows + Valeur défauts évités - Coût mensuel total pilote ``` `Break-even hors défauts évités` : ```text Coût mensuel total pilote / (Coût horaire complet moyen × Valeur du temps réalloué) ``` `Break-even après défauts évités` : ```text (Coût mensuel total pilote - Valeur défauts évités) / (Coût horaire complet moyen × Valeur du temps réalloué) ``` Si le coût mensuel total est inférieur à la valeur des défauts évités, le break-even après défauts évités peut être affiché à `0`. `Écart vs break-even` : ```text Gains ajustés workflows - Break-even après défauts évités ``` `Heures nettes attendues / utilisateur` : ```text Gains ajustés workflows / Utilisateurs pilotes ``` `Décision indicative` : ```text Si valeur nette mensuelle > 0 : "Poursuivre avec garde-fous" Sinon si valeur nette mensuelle est proche de 0 : "Ajuster avant extension" Sinon : "Ajuster workflows, coûts ou garde-fous" ``` ### Lecture immédiate Ajouter un bloc narratif qui traduit le résultat central. Exemples : Si valeur nette positive : ```text Signal : le pilote couvre ses coûts avec les hypothèses actuelles. À vérifier : qualité des mesures, stabilité des gains, risques de rework. Décision : poursuivre avec garde-fous et evidence de gains. ``` Si valeur nette négative : ```text Signal : le pilote ne couvre pas encore ses coûts avec les hypothèses actuelles. À vérifier : coûts humains, taux de réalisation, rework et workflows peu mesurés. Décision : ajuster avant extension ou refaire une mesure plus stricte. ``` ### Tableau scénarios Reprendre depuis l’onglet `Scenarios` : ```text Scénario Gain ajusté h Valeur nette EUR Décision ``` ### Graphique Ajouter un graphique simple comparant la valeur nette des scénarios. Type recommandé : ```text Histogramme vertical ou bar chart ``` Couleurs recommandées : ```text Prudent : orange ou rouge Central : bleu information Ambitieux : vert principal ``` ## 10. Onglet `Checks` ### Objectif Créer une feuille de contrôle permettant de détecter les erreurs visibles avant partage du fichier. Les checks ne doivent pas prétendre prouver le ROI. Ils servent uniquement à repérer les incohérences les plus évidentes. ### Colonnes attendues ```text Contrôle Résultat Détail Action si alerte Pourquoi ``` ### Checks obligatoires `Budget maximum respecté` ```text OK si Coût mensuel total pilote <= Budget mensuel maximum Sinon "À vérifier" ``` `Amortissement setup valide` ```text OK si Amortissement setup > 0 Sinon "Erreur" ``` `Utilisateurs pilotes valide` ```text OK si Utilisateurs pilotes >= 1 Sinon "Erreur" ``` `Taux entre 0% et 100%` ```text OK si Taux de réalisation, Valeur du temps réalloué et Rework sont tous entre 0 et 1 Sinon "Erreur" ``` `Gains ajustés positifs` ```text OK si Gains ajustés workflows > 0 Sinon "À vérifier" ``` `Scénarios complets` ```text OK si les trois scénarios ont un multiplicateur, un taux de réalisation, un rework et un coût variable Sinon "À compléter" ``` `Workflows commentés` ```text OK si chaque workflow renseigné contient aussi un commentaire, une mesure recommandée et un niveau de confiance Sinon "À compléter" ``` ### Mise en forme conditionnelle Appliquer une couleur au résultat : ```text OK : vert doux À vérifier : orange / warning Erreur : rouge / danger À compléter : bleu information ou orange ``` ## 11. Règles de mise en forme globales ### Style général Le fichier doit être professionnel, clair, sobre et lisible. Éviter les feuilles trop denses. Ne pas chercher à tout mettre dans une seule page. Utiliser des largeurs de colonnes suffisantes pour éviter les libellés tronqués. Activer le retour à la ligne sur les colonnes de commentaire et d’aide. Figer les lignes d’en-tête sur les onglets tabulaires. ### Code couleur Utiliser le code couleur suivant : ```text Entrées utilisateur : bleu clair ou fond technique clair Hypothèses sensibles : jaune / warning clair Formules : gris clair Résultats positifs : vert Résultats négatifs : rouge Alertes : orange Titres principaux : couleur principale sombre Sous-titres : texte secondaire ``` ### Protection visuelle Les cellules calculées doivent être distinguées des cellules modifiables. Si possible, protéger les cellules de formule ou au minimum les colorer en gris pour indiquer qu’elles ne doivent pas être modifiées. ### Formats numériques Utiliser les formats suivants : ```text Montants : # ##0 € Heures : 0,0 h Pourcentages : 0 % Décimales techniques : 0,00 Entiers : 0 ``` Si le fichier est généré en environnement anglophone, utiliser les formats compatibles Excel local, mais conserver la lisibilité pour un utilisateur francophone. ## 12. Exigences de qualité Le classeur généré doit respecter ces critères : ```text Le fichier s’ouvre correctement dans Excel. Les formules sont actives. Aucune cellule clé ne contient d’erreur de type #REF!, #DIV/0!, #VALUE! ou #NAME?. Les onglets sont dans l’ordre demandé. Les cellules d’entrée sont visuellement identifiables. Les résultats de Synthese se mettent à jour si l’utilisateur modifie Hypotheses ou Workflows. Les scénarios se mettent à jour si l’utilisateur change les hypothèses. Le tableau de bord Synthese reste lisible sans comprendre les formules. Le fichier contient un jeu de données d’exemple réaliste. Le fichier contient un mode d’emploi exploitable sans documentation externe. ``` ## 13. Critères d’acceptation fonctionnels Le fichier est accepté si l’utilisateur peut faire les actions suivantes sans assistance : ```text Comprendre à quoi sert le fichier en lisant Mode emploi. Remplacer les hypothèses globales dans Hypotheses. Remplacer les workflows d’exemple dans Workflows. Comparer prudent, central et ambitieux dans Scenarios. Lire la décision indicative dans Synthese. Identifier les erreurs évidentes dans Checks. Tester plusieurs hypothèses sans modifier les formules. Utiliser le fichier comme base de discussion avec une IA ou une équipe. ``` ## 14. Cas de test minimal Après génération, vérifier le comportement suivant. ### Test 1 — Valeur nette négative Avec les valeurs d’exemple prudentes, le fichier peut produire une valeur nette négative. C’est acceptable. Le fichier doit alors afficher une décision du type : ```text Ajuster workflows, coûts ou garde-fous ``` ou ```text Arrêter ou réduire ``` ### Test 2 — Valeur nette positive Modifier temporairement les workflows pour augmenter les gains ou réduire les coûts. Le fichier doit alors afficher une valeur nette positive et une décision du type : ```text Poursuivre avec garde-fous ``` ### Test 3 — Erreur de taux Saisir une valeur invalide supérieure à `1` dans un taux. L’onglet Checks doit signaler une erreur ou une alerte. ### Test 4 — Budget dépassé Saisir un budget mensuel maximum inférieur au coût mensuel total. L’onglet Checks doit afficher : ```text À vérifier ``` pour le contrôle budgétaire. ## 15. Optionnel — Adaptation à une marque Si une marque est fournie, appliquer la charte visuelle au fichier. Inclure éventuellement le nom de marque ou le logo dans les onglets `Mode emploi` et `Synthese`. Ne pas surcharger le fichier graphiquement. La marque doit améliorer la lisibilité, pas transformer le classeur en support marketing. ## 16. Optionnel — Variante sans agent de codage Si l’utilisateur ne travaille pas sur un agent de codage IA, renommer les workflows d’exemple. Exemples pour un pilote support : ```text Analyse de ticket Préparation de réponse Recherche documentaire Synthèse d’incident Rédaction de procédure Classification de demande Diagnostic initial Escalade technique ``` Exemples pour un pilote éditorial : ```text Préparation de plan Recherche documentaire Synthèse de sources Réécriture éditoriale Contrôle de cohérence Production de variantes Préparation publication Relecture finale ``` Exemples pour un pilote data : ```text Nettoyage de données Analyse exploratoire Préparation de rapport Génération de graphique Contrôle qualité dataset Documentation de métrique Recherche d’anomalies Synthèse décisionnelle ``` ## 17. Contraintes importantes Ne pas faire un simple CSV. Ne pas produire uniquement une table statique. Ne pas masquer la logique de calcul. Ne pas donner une décision trop affirmative. Ne pas supposer que tous les gains bruts sont réalisés. Ne pas confondre productivité théorique et valeur économique réelle. Ne pas omettre les coûts humains de review, formation, gouvernance et rework. Ne pas faire dépendre la décision uniquement du scénario ambitieux. ## 18. Résultat attendu final Produire un fichier Excel `.xlsx` nommé : ```text calculateur-break-even-agent-ia.xlsx ``` Le fichier doit être complet, stylé, calculé, vérifié et prêt à être utilisé par un utilisateur non expert en modélisation financière.