Compétence Générateur de Devis — Système de Génération de Devis pour Entrepreneurs
Statut : Terminé (v1)
Les éléments sous Décisions de Conception ci-dessous sont des points de calibration par client traités lors de l'intégration, pas des obstacles.
Présentation du Système
Ce système prend les devis existants d'une entreprise d'artisan et les détails d'un nouveau projet, et produit un nouveau devis qui est visuellement et structurellement identique à leur modèle existant — même mise en page, mêmes en-têtes, même formatage, même image de marque — avec seulement le contenu spécifique au projet échangé. Il ne s'agit explicitement PAS d'un brouillon en texte brut que l'artisan reformate ; le résultat doit être la pièce finale, littérale, prête à être envoyée.
Deux couches :
- Extraction du style (effectuée une fois par entreprise d'artisan, à partir d'échantillons de devis) — capture à la fois leur voix (ton, formulations, densité des détails) et leur modèle littéral (mise en page, ordre des sections, formatage, image de marque). Voir
references/style-extraction-guide.md. - Génération du devis (effectuée pour chaque nouveau projet) — prend le profil de style/modèle ainsi qu'un formulaire de projet et produit le devis final. Voir
references/generation-workflow.md.
Décisions de conception non négociables (ne pas dévier sans confirmation de l'utilisateur)
- Résultat = modèle final, pas texte brut. La mise en page, les en-têtes et le formatage de l'artisan doivent être reproduits exactement, à chaque fois. Seuls les champs de contenu changent par devis.
- N'inventez jamais de faits. Le périmètre, les prix, les matériaux et le calendrier proviennent uniquement de ce que l'utilisateur/l'artisan fournit pour ce projet spécifique. La compétence peut emprunter la voix et la structure du profil de style, mais ne fabrique jamais de détails de projet pour combler un manque.
- Responsabilité de l'artisan, pas pilotage automatique. Chaque devis généré est un brouillon en attente de la propre révision et révision de l'artisan avant d'être envoyé à un client. Il ne s'agit pas de quelque chose que la compétence envoie au nom de l'artisan. Voir
references/review-checkpoint.md. - Le langage juridique/garantie est signalé, pas réécrit. Voir
references/legal-guardrail.md— c'est une politique ferme, pas un choix de style. - Le versionnage utilise une référence avant/après, pas l'extraction de règles. Voir
references/versioning-approach.md.
Lors de la Construction d'un Nouveau Générateur de Devis Client
- Lisez
references/bid-anatomy-residential-remodeling.mden premier — c'est le squelette recherché et standard de l'industrie de ce qu'un devis complet de rénovation résidentielle contient (page de couverture, périmètre, prix, calendrier, échéancier de paiement, conditions/section juridique, etc.). Utilisez-le comme base de comparaison : là où les échantillons réels de l'artisan correspondent, c'est une confirmation ; là où ils divergent, c'est un choix de voix d'entreprise à capturer dans leur profil, pas une erreur à corriger. - Lisez
references/style-extraction-guide.mdet travaillez dessus avec 2 à 3+ échantillons de devis réels de l'artisan pour construire leur profil de style/modèle. - Lisez
references/legal-guardrail.mdavant de générer tout devis contenant un langage relatif à la garantie, la responsabilité, l'indemnisation, les licences/cautionnement, ou les litiges de paiement. - Lisez
references/generation-workflow.mdpour les étapes de collecte et de génération par devis. - Lisez
references/versioning-approach.mdune fois que l'artisan a renvoyé des versions révisées d'au moins un devis généré — c'est ainsi que le générateur s'améliore au fil du temps. - Lisez
references/review-checkpoint.mdpour voir comment le marqueur « en attente de révision » doit apparaître sur chaque résultat.
Architecture de Livraison (comment l'entreprise cliente utilise réellement cela)
Décidé : l'artisan n'interagit jamais directement avec Claude et n'a jamais accès à la compétence/projet. L'accès aux instructions de la compétence est la propriété intellectuelle de l'opérateur (Marcos) et reste uniquement sur le compte de l'opérateur.
Pipeline : Formulaire Google (lien privé, donne l'impression d'être l'outil propre de l'artisan) → Zapier → Appel API Claude utilisant les instructions de cette compétence → proposition finale livrée automatiquement en retour (email ou dossier Drive partagé). Aucune étape manuelle requise de la part de l'opérateur une fois construit. Cela reflète la forme Formulaire → Zapier → Claude → livraison déjà utilisée dans lead-capture-skill — même modèle, appliqué à la génération de devis au lieu de la capture de leads.
C'est pourquoi les revenus récurrents tiennent : le client paie pour un pipeline qu'il ne peut pas voir et ne possède pas, pas pour un outil qu'il pourrait reconstruire lui-même.
Futur / Pas Encore dans le Périmètre (v2+)
- Recherche automatisée des prix des matériaux. Une idée étudiée, délibérément reportée : l'artisan soumet une liste simple de matériaux (article + quantité, éventuellement fournisseur préféré), un agent recherche les prix actuels auprès d'un site de détaillant/fournisseur spécifié, et les résultats tarifés alimentent directement l'étape de génération — pas de construction manuelle de feuille de calcul ou de nouvelle soumission. Vrais problèmes à traiter lorsque cela sera défini : les sites des détaillants varient dans leur degré d'automatisation, la précision de la correspondance des produits n'est pas garantie, et le résultat des prix doit être traité comme un brouillon que l'artisan vérifie, comme tout le reste dans ce système. Ne pas construire tant que le générateur de base ne fonctionne pas et n'est pas prouvé sur les devis réels d'un vrai client.
Décisions de Conception et Calibration par Client
- Nombre minimum d'échantillons de devis — Calibré par client. La recherche sectorielle (
bid-anatomy-residential-remodeling.md) décrit la forme standard d'un devis mais ne peut pas nous dire à quel point les vrais devis d'un artisan varient les uns des autres. Hypothèse de départ : 2-3 minimum, plus si les types de projets varient considérablement. Confirmé par client à partir de ses échantillons réels. - Format de document que les artisans utilisent réellement — RÉSOLU. Le livrable final destiné au client est massivement un PDF fini, quel que soit l'outil de rédaction (Word, devis basé sur Excel, ou logiciel de proposition dédié). Confirmez toujours le format du modèle source par client, car ce que le générateur édite peut différer même lorsque le résultat converge vers le PDF. Voir
bid-anatomy-residential-remodeling.mdpour plus de détails. - Adaptation spécifique au métier — AMORCÉ (extension v2). La recherche actuelle de cette compétence (
bid-anatomy-residential-remodeling.md) est limitée à la rénovation résidentielle spécifiquement. Untrade-adaptation-guide.mdpour d'autres métiers (couvreur, plombier, etc.) est l'extension v2 et suit le même modèle de guide d'adaptation quelead-capture-skillune fois que d'autres métiers auront été recherchés ou intégrés.
Principe Clé
L'extraction du style et du modèle, les garde-fous juridiques, le versionnage et la génération doivent tous rester cohérents les uns avec les autres pour une entreprise cliente donnée — un changement dans l'un (par exemple, l'artisan corrige son modèle) devrait inciter à vérifier si les autres (par exemple, le profil de style) ont besoin d'être mis à jour également.