estimer

/estimer — Estimation de projet forfaitaire

Vue d'ensemble

Cette commande produit un document d'estimation comparant deux modèles :

1. Traditionnel — jours-personne par rôle avec taux du marché québécois
2. IA-assisté — mêmes rôles avec facteurs d'accélération IA par type de tâche

Inclut une analyse de risque par bloc (complexité technique + dépendances hors contrôle) et une sous-décomposition en tâches de chaque bloc fonctionnel.

Prérequis

• Un fichier .docx de cahier des charges (CDC) accessible dans le workspace
• Si aucun argument fourni, chercher un CDC dans le workspace : **/*cahier*des*charges*.docx, **/*CDC*.docx, **/*specification*.docx
• Python 3 disponible (pour génération Excel)

Pipeline

Phase 1.0 — Qualification du projet

1. Analyser le CDC pour identifier la nature du projet (custom / data-BI / config / migration / hybride)
2. Demander : "Ce projet utilise-t-il la stack standard Somtech (React + Supabase + Tailwind + shadcn/ui + Netlify) ?"
   • Si oui → charger ${CLAUDE_PLUGIN_ROOT}/templates/stack.json et appliquer :
     • Bonus IA : +10% réduction Dev, +5% Designer, +5% QA (en plus des facteurs de base)
     • Réduction infrastructure : coût infra × 0.60 (Supabase Auth, Netlify CI/CD, shadcn/ui sont du built-in)
     • Fonctionnalités gratuites : identifier les tâches couvertes par la stack (API REST auto-générée, auth, types TS, realtime) et les exclure ou réduire drastiquement
   • Si non → estimation standard sans bonus
3. Présenter la qualification :

   Nature : [identifiée]
   Stack : Somtech standard (bonus IA appliqué) / Autre
   Impact : [types privilégiés, équipe probable]
   

4. Demander : "Ce module fait-il partie d'un système existant ou est-ce le premier module ?"
   • Si premier module → noter qu'un bloc infra sera ajouté (avec réduction stack si applicable)
   • Si additionnel → demander le pourcentage d'infrastructure (0-50%)
5. Détecter facteur de reproduction : si le CDC mentionne un remplacement d'outil existant, proposer facteur (défaut 0.65)
6. Attendre validation de la qualification

Phase 1.1 — Extraction et sous-décomposition

1. Localiser le CDC : utiliser l'argument fourni, ou chercher dans le workspace
2. Lire le skill estimation-engine : ${CLAUDE_PLUGIN_ROOT}/skills/estimation-engine/SKILL.md
3. Extraire les blocs fonctionnels selon les instructions du skill
4. Présenter la liste extraite à l'utilisateur pour validation rapide :

   J'ai extrait X blocs fonctionnels du CDC :
   1. [Bloc] — Type: [type], Complexité: [complexité]
   2. ...
   Ça te semble correct ? Tu veux ajouter/modifier/retirer des blocs ?
   

5. Attendre la validation avant de continuer
6. Sous-décomposition : pour chaque bloc validé, décomposer en tâches concrètes et présenter :

   Voici la décomposition en tâches :
   
   **1. [Bloc]**
   - [Tâche 1]
   - [Tâche 2]
   - [Tâche 3]
   
   **2. [Bloc]**
   - ...
   
   Tu veux ajuster des tâches avant le calcul ?
   

7. Attendre la validation de la décomposition avant de continuer

Phase 1.5 — Proposition d'équipe projet

1. Analyser les tâches identifiées et calculer le volume par rôle
2. Proposer l'équipe :

   ✅ [Rôle] — X personne(s) (justification), volume estimé : ~Xj
   ❌ [Rôle] — non requis (justification)
   

3. Attendre validation

Phase 1.8 — Sélection du mode d'estimation

1. Évaluer les critères de mode direct (voir estimation-engine Phase 1.8) :
   • Compter les blocs fonctionnels extraits, la taille de l'équipe validée, la nature du projet
2. Proposer le mode recommandé :

   Mode recommandé : [Direct / Formule]
   Raison : [critère(s)]
   
   Direct — Estimation directe des jours dev + overhead fixe en bloc.
   Formule — Calcul automatique via fourchettes et allocation par rôle.
   
   Quel mode ?
   

3. L'utilisateur choisit le mode → conditionne Phase 2A ou 2B

Phase 2.0 — Calcul

Le calcul suit le mode choisi en Phase 1.0 (étape 6).

Phase 2A — Mode formule (calcul automatique)

1. Charger les données de référence : ${CLAUDE_PLUGIN_ROOT}/templates/defaults.json
2. Consulter le skill : ${CLAUDE_PLUGIN_ROOT}/skills/estimation-engine/SKILL.md (section Phase 2A)
3. Appliquer le facteur de reproduction sur les blocs identifiés comme reproduction, avant toute allocation : effort_ajusté = effort_base × facteur_reproduction
4. Appliquer la composition d'équipe validée : mettre à 0% l'allocation des rôles exclus, redistribuer proportionnellement aux rôles restants
5. Pour chaque bloc :
   • Calculer l'effort traditionnel (jours par rôle, coûts) en tenant compte des tâches
   • Évaluer les risques du bloc (complexité + dépendances) → facteur de risque propre au bloc
   • Calculer l'effort IA-assisté (facteurs Dev + non-Dev par type)
   • Calculer sous-total brut et sous-total avec risque du bloc
6. Si premier module : calculer le bloc infrastructure initiale selon defaults.json section infrastructureInitiale
7. Si module additionnel : appliquer le pourcentage d'infrastructure validé sur le coût de référence infrastructure
8. Calculer les totaux : architecte (5% sur le brut global), facteur de risque global pondéré, totaux avec risque

Phase 2B — Mode direct (estimation par expertise)

1. Charger les données de référence : ${CLAUDE_PLUGIN_ROOT}/templates/defaults.json
2. Consulter le skill : ${CLAUDE_PLUGIN_ROOT}/skills/estimation-engine/SKILL.md (section Phase 2B)
3. Appliquer le facteur de reproduction si applicable : jours_ajustés = jours_estimés × facteur_reproduction
4. Pour chaque tâche : estimer directement les jours dev (trad + IA) sans passer par les fourchettes ni l'allocation par rôle
   • Utiliser effortBaseJours_ia comme référence indicative (pas de calcul automatique)
   • Coût calculé au taux dev_senior (équipe réduite)
5. Évaluer les risques par bloc (identique au mode formule)
6. Estimer l'overhead fixe en bloc pour le projet entier :
   • Charger la grille overheadFixe selon le total des jours dev
   • Estimer PM, QA, Designer, Architecte en jours fixes (trad + IA)
   • L'architecte est dans l'overhead (pas de surplus 5% séparé)
7. Si premier module : calculer le bloc infrastructure initiale (même logique, mais jours estimés directement)
8. Si module additionnel : appliquer le pourcentage d'infrastructure validé
9. Calculer les totaux : dev avec risque + overhead + infrastructure

Phase 3.0 — Review utilisateur

1. Présenter le tableau récapitulatif par bloc avec tâches :

   Format Mode Formule (Phase 2A)

   ## Résumé de l'estimation (Mode Formule)
   
   ### Bloc 1 : [Nom du bloc]
   Tâches : [Tâche 1], [Tâche 2], [Tâche 3]
   
   | # | Bloc | Tâche | Type | Trad. (j) | Risque | IA factor | IA (j) | Trad. ($) | IA ($) |
   |---|------|-------|------|-----------|--------|-----------|--------|-----------|--------|
   | 1 | [Bloc 1] | [Tâche 1] | crud | X | ×1.XX | -XX% | X | X XXX $ | X XXX $ |
   | 1 | [Bloc 1] | [Tâche 2] | ui_composant | X | ×1.XX | -XX% | X | X XXX $ | X XXX $ |
   | **Sous-total brut** | | | | **X** | | | **X** | **X XXX $** | **X XXX $** |
   | **Sous-total avec risque (×1.XX)** | | | | | | | | **X XXX $** | **X XXX $** |
   
   ### Totaux
   
   | | Traditionnel | IA-assisté |
   |---|---|---|
   | Total brut | XX XXX $ | XX XXX $ |
   | Architecte (5%) | X XXX $ | X XXX $ |
   | Marge de risque (×X.XX) | X XXX $ | X XXX $ |
   | Infrastructure (XX% du coût initial) | X XXX $ | X XXX $ |
   | **Total projet** | **XX XXX $** | **XX XXX $** |
   | **Économie projetée** | | **XX% (XX XXX $)** |
   

   Format Mode Direct (Phase 2B)

   ## Résumé de l'estimation (Mode Direct)
   
   ### Bloc 1 : [Nom du bloc]
   
   | # | Tâche | Type | Jours Trad | Jours IA | Coût Trad | Coût IA |
   |---|-------|------|-----------|----------|-----------|---------|
   | 1 | [Tâche 1] | crud | X | X | X XXX $ | X XXX $ |
   | 2 | [Tâche 2] | logique_metier | X | X | X XXX $ | X XXX $ |
   | **Sous-total bloc** | | | **X** | **X** | **X XXX $** | **X XXX $** |
   | **Avec risque (×1.XX)** | | | | | **X XXX $** | **X XXX $** |
   
   ...
   
   ### Overhead projet (bloc fixe)
   
   | Rôle | Jours Trad | Jours IA | Coût Trad | Coût IA |
   |------|-----------|----------|-----------|---------|
   | PM | X | X | X XXX $ | X XXX $ |
   | QA | X | X | X XXX $ | X XXX $ |
   | Designer | X | X | X XXX $ | X XXX $ |
   | Architecte | X | X | X XXX $ | X XXX $ |
   | **Total overhead** | **X** | **X** | **X XXX $** | **X XXX $** |
   
   ### Totaux
   
   | | Traditionnel | IA-assisté |
   |---|---|---|
   | Total dev (brut) | XX XXX $ | XX XXX $ |
   | Marge de risque dev (×X.XX) | X XXX $ | X XXX $ |
   | Overhead projet (hors risque) | X XXX $ | X XXX $ |
   | Infrastructure | X XXX $ | X XXX $ |
   | **Total projet** | **XX XXX $** | **XX XXX $** |
   | **Économie projetée** | | **XX% (XX XXX $)** |
   

   Tu veux ajuster quelque chose (jours, risques, overhead) ou on génère le rapport ?
   

2. Si ajustements demandés : modifier les valeurs, recalculer, re-présenter le tableau

3. Si validation : passer à Phase 4

Phase 4.0 — Génération du rapport

1. Lire le skill estimation-report : ${CLAUDE_PLUGIN_ROOT}/skills/estimation-report/SKILL.md
2. Créer le dossier estimations/ si absent : mkdir -p estimations
3. Générer le markdown dans estimations/YYYY-MM-DD-<nom-projet>-estimation.md
4. Générer le fichier Excel (.xlsx) :
   • Vérifier que openpyxl est disponible : python3 -c "import openpyxl"
   • Si absent : pip install openpyxl --quiet
   • Écrire et exécuter le script Python inline pour générer estimations/YYYY-MM-DD-<nom-projet>-estimation.xlsx
   • Le fichier Excel contient 5 feuilles : Traditionnel, Accéléré IA, Comparatif, Risque, Paramètres
   • La feuille "Paramètres" documente : nature du projet, mode d'estimation (formule/direct), équipe retenue, facteur de reproduction, infrastructure %, taux utilisés, facteurs IA (mode formule) ou jours overhead (mode direct), modifications manuelles
5. Confirmer :

   Rapport d'estimation généré :
   - Markdown : estimations/YYYY-MM-DD-<nom-projet>-estimation.md
   - Excel : estimations/YYYY-MM-DD-<nom-projet>-estimation.xlsx (5 feuilles)
   
   Traditionnel : XX XXX $ | IA-assisté : XX XXX $ | Économie : XX%
   

Règles critiques

• Ne jamais inventer des blocs ou tâches qui ne sont pas dans le CDC
• Toujours attendre la validation avant de passer à la phase suivante (blocs, tâches, calculs)
• Montants en CAD, séparateur d'espace, convention québécoise (12 500 $)
• Taxes exclues de tous les montants
• Risque par bloc : chaque bloc a son propre facteur de risque, visible dans le tableau Phase 3 et dans le rapport
• Si le CDC a 20+ blocs, regrouper par module/section dans les tableaux
• Le facteur de risque global est la moyenne pondérée des facteurs par bloc (pondérée par les coûts bruts)