Que fait 3d-builder ?
Ne devinez pas un modèle 3D. Écrivez ce qui sera construit, clarifiez les ambiguïtés avec l'utilisateur, enregistrez chaque hypothèse, et ne modélisez qu'ensuite. Un modèle créé sur des dimensions supposées sera corrigé sans cesse ; un cahier des charges intercepte les suppositions avant qu'elles ne deviennent de la géométrie.
Le flux de travail comporte ces phases, toujours dans cet ordre : cahier des charges → questions → plans d'étage (bâtiments uniquement) → modèle. N'ouvrez pas Blender ou FreeCAD, et n'écrivez pas de code de modélisation, avant que le cahier des charges n'existe et que les questions ne soient terminées. Pour un bâtiment, l'utilisateur doit également avoir approuvé les plans d'étage au préalable.
Structure du projet
Un projet peut contenir plusieurs modèles, donc tout ce qui appartient à un modèle vit dans son propre dossier :
models/
<nom>/
specs/
<aaaa-mm-jj-hhmmss>-<demande>.md # un cahier des charges par demande
plans/ # bâtiments uniquement
layout.json
etage-<id>.svg
<nom>.blend | <nom>.FCStd # le modèle
<nom>.py # script de repli uniquement
<nom>.glb | <nom>.fbx # exports jeu/web uniquement
.3d-builder.json # choix d'outil mémorisé, pour tout le projet
<nom> est un nom court en kebab-case pour l'objet (support-phone, support-mural-routeur). Il nomme le dossier et les fichiers du modèle. Tous les chemins ci-dessous sont relatifs à models/<nom>/ sauf indication contraire.
Les projets plus anciens peuvent encore utiliser l'ancienne structure plate (specs/ et plans/ à la racine du projet, models/<nom>.blend). Si vous en trouvez un, travaillez avec tel quel et proposez une fois de déplacer les fichiers dans cette structure. Ne déplacez rien sans demander.
Phase 1 : Rédiger le cahier des charges
- Choisissez le
<nom>du modèle. Pour un nouveau modèle, vérifiez quemodels/<nom>/n'existe pas encore, puis créez-le ainsi que son dossierspecs/. - Récupérez l'horodatage depuis l'horloge système (ex.
date +%%Y-%%m-%%d-%%H%%M%%S) plutôt que d'en inventer un. - Créez
specs/<aaaa-mm-jj-hhmmss>-<demande>.mden utilisant le modèle dans references/spec-template.md.<demande>est un libellé court en kebab-case pour cette demande :initialpour un nouveau modèle, ou la modification pour une édition (crochet-plus-epais,deplacer-mur-cuisine).
Remplissez ce que la demande indique déjà, puis listez les points ouverts : tout ce qui affecte la géométrie mais n'a pas été spécifié. Points ouverts typiques :
- Dimensions globales et unités, et lesquelles sont fixes vs. libres
- Ajustement et jeu par rapport à des objets réels (un téléphone de 60 mm a besoin d'une fente légèrement plus large que 60 mm ; de combien ?)
- Épaisseur de paroi, congés/chanfreins, tailles de trous, types de vis
- Méthode de montage, orientation, charge
- Objectif et fabrication (impression 3D → porte-à-faux, parois minimales, base plate ; CNC ; rendu seul ; asset jeu/web)
- Pour les assets jeu/web : moteur cible, budget de polygones, échelle en unités moteur, position du pivot, UVs et textures vs. couleurs unies, LODs, mesh de collision
- Niveau de détail, matériaux (Blender), besoins paramétriques (FreeCAD)
- Pour les bâtiments : étages, empreinte au sol, pièces et leurs dimensions, escaliers, portes et fenêtres. Ceux-ci sont réglés dans la Phase 3 avec les plans d'étage, donc listez-les là et pas ici
Modification d'un modèle existant : trouvez d'abord le dossier de l'objet dans models/. Écrivez un nouveau cahier des charges pour la modification (chaque demande a son propre fichier, ainsi l'historique reste lisible), liez-le au cahier des charges précédent, et indiquez ce qui change et ce qui doit rester identique. Lisez le modèle existant (via MCP, ou le script qui l'a construit) avant de modifier, pour que la modification parte de ce qui est réellement présent. Pour un bâtiment avec un dossier plans/, une modification de l'agencement passe d'abord par les plans (Phase 3, "Modification d'un bâtiment").
Phase 2 : Questions de clarification
Si la demande laisse des points ouverts, posez des questions avant de modéliser. L'utilisateur sait des choses que vous ne pouvez pas déduire (la largeur réelle du téléphone, où vont les vis murales), et une question maintenant évite une reconstruction plus tard.
Règles :
- Une question à la fois. Attendez la réponse avant de poser la suivante. Ordonnez les questions par leur impact sur la géométrie : dimensions générales et objectif d'abord, détails cosmétiques en dernier.
- Oui/non quand c'est possible. "La fente du câble doit-elle être centrée ?" est mieux que "Où doit être la fente du câble ?".
- Sinon, à choix multiples : l'option recommandée en premier et marquée "(recommandé)", puis les alternatives, et une réponse libre en dernier. Utilisez l'outil de question de l'agent (ex. AskUserQuestion) s'il en a un ; il ajoute généralement l'option de texte libre pour vous.
- Par lots de 5. Après chaque série de 5 questions, demandez s'il faut continuer avec jusqu'à 5 de plus, en indiquant approximativement combien de points ouverts restent. Si l'utilisateur dit non, arrêtez de demander.
- Ne demandez pas des choses qui n'ont pas d'importance pour ce modèle, et ne demandez pas ce que l'utilisateur a déjà dit.
- Enregistrez chaque réponse dans la section Décisions du cahier des charges immédiatement, afin que le cahier des charges soit toujours à jour.
Arrêtez-vous lorsque rien d'important n'est flou, ou lorsque l'utilisateur cesse de répondre. Pour chaque point ouvert restant, décidez par vous-même, en choisissant la valeur par défaut raisonnable pour l'objectif déclaré, et inscrivez-la dans Hypothèses avec une justification d'une ligne. L'utilisateur doit pouvoir lire le cahier des charges et voir chaque choix fait en son nom.
Si la demande est déjà entièrement spécifiée, sautez les questions et dites-le en une ligne.
Phase 3 : Plans d'étage (bâtiments uniquement)
Si le modèle est un bâtiment ou comporte des pièces, réglez l'agencement sur papier avant de modéliser. Lisez references/floorplans.md et suivez-le :
- Discutez du plan d'étage avec l'utilisateur, en utilisant les règles de questions ci-dessus : étages, empreinte, pièces, adjacence, escaliers, portes et fenêtres.
- Dessinez un plan vectoriel pour chaque étage. Écrivez
plans/layout.jsonet générezplans/etage-<id>.svgavec le script fourni scripts/draw_plans.py. - Revoyez les plans avec l'utilisateur et révisez-les jusqu'à ce que l'utilisateur approuve. Enregistrez l'approbation dans Décisions.
Le layout.json approuvé est la source de vérité pour les murs, ouvertures, pièces et escaliers du modèle. Sautez cette phase pour tout ce qui n'est pas un bâtiment.
Phase 4 : Modèle
Enregistrez le résultat dans <nom>.blend (Blender) ou <nom>.FCStd (FreeCAD) dans le dossier du modèle. Pour un asset de jeu ou web, exportez-le également à côté du fichier source (voir Export pour les moteurs).
Choisir l'outil
Vérifiez quels serveurs MCP sont configurés : regardez vos outils disponibles pour les outils MCP Blender ou FreeCAD (les noms contiennent généralement blender ou freecad).
- Choix mémorisé : si
.3d-builder.jsonexiste à la racine du projet, utilisez son"tool"("blender"ou"freecad") à moins que l'utilisateur ne demande autre chose. - Exactement un serveur MCP configuré : utilisez cet outil.
- Les deux ou aucun configuré : demandez à l'utilisateur quel outil utiliser (une question à choix multiples). Recommandez FreeCAD pour les pièces fonctionnelles aux dimensions précises (supports, boîtiers, tout ce qui est imprimé ou usiné), et Blender pour les formes organiques, les objets sculptés ou décoratifs, tout ce qui est destiné au rendu, et les assets de jeu ou web (les maillages tessellés de FreeCAD sont mal adaptés à l'utilisation en temps réel).
- Mémorisez le choix en écrivant
{"tool": "blender"}ou{"tool": "freecad"}dans.3d-builder.json. Enregistrez également l'outil dans le cahier des charges.
Construire via MCP (préféré)
- Faites d'abord un appel simple (ex. obtenir les informations de la scène/du document). S'il génère une erreur ou ne répond pas dans les 10 secondes, traitez le serveur comme indisponible et passez au script de repli. Expliquez pourquoi en une ligne à l'utilisateur.
- Construisez le modèle étape par étape à partir du cahier des charges. Vérifiez les dimensions au fur et à mesure (interrogez les boîtes englobantes ou les propriétés des objets) plutôt que de faire confiance au code pour avoir fait ce que vous vouliez.
- Sauvegardez dans le chemin ci-dessus.
Script de repli
Lorsqu'aucun serveur MCP n'est utilisable, écrivez un script Python autonome, <nom>.py dans le dossier du modèle, qui construit le modèle à partir de zéro et enregistre <nom>.blend ou <nom>.FCStd à côté de lui. Mettez les dimensions clés en tant que constantes nommées en haut afin que l'utilisateur puisse les ajuster. Pour un bâtiment, le script lit plans/layout.json et ne copie pas les coordonnées dans le code (voir references/floorplans.md, "Construire le modèle à partir de l'agencement").
Essayez ensuite de l'exécuter en mode non interactif, si l'outil est installé :
- Blender :
blender --background --python models/<nom>/<nom>.py - FreeCAD :
freecadcmd models/<nom>/<nom>.py(sur certains systèmesFreeCADCmdoufreecad.cmd)
S'il s'exécute, vérifiez la sortie (le fichier existe, la boîte englobante affichée correspond au cahier des charges). S'il échoue, corrigez le script et relancez-le. Si l'outil n'est pas dans le PATH, indiquez à l'utilisateur la commande exacte à exécuter.
Pièges spécifiques à l'outil et squelettes de scripts : references/blender.md, references/freecad.md. Lisez celui de l'outil choisi avant d'écrire du code.
Export pour les moteurs
Uniquement pour les assets de jeu ou web. Conservez le .blend comme source éditable et exportez à côté :
| Cible | Format | Fichier |
|---|---|---|
| Web (three.js, Babylon.js), Godot, usage général | glTF binaire | <nom>.glb |
| Unity, Unreal | FBX (ou .glb si le pipeline de l'utilisateur importe du glTF) | <nom>.fbx |
Les moteurs sont temps réel, donc l'asset doit respecter le budget du cahier des charges : vérifiez le nombre de triangles, appliquez les transformations, placez le pivot là où le cahier des charges l'indique, et respectez l'échelle et les axes du moteur. Paramètres d'export et pièges : la section "Assets de jeu et web" dans references/blender.md.
Cette compétence livre le fichier d'asset. Le charger dans une scène, écrire des scripts moteur ou construire une page three.js dépasse son périmètre ; si l'utilisateur le souhaite également, faites-le comme une étape distincte après la fin de ce flux de travail.
Terminer
- Vérifiez le modèle par rapport au cahier des charges : dimensions globales, chaque fonctionnalité listée présente, et toute exigence d'ajustement ou de jeu. Pour les assets jeu/web, vérifiez aussi le nombre de triangles par rapport au budget et la boîte englobante du fichier exporté en unités moteur. Pour les bâtiments, vérifiez également par rapport aux plans approuvés : dimensions globales, positions des murs, chaque porte et chaque fenêtre, et les niveaux d'étage.
- Mettez à jour le cahier des charges : définissez Statut sur
fait, remplissez Sortie (chemins des fichiers, y compris les exports et plans, outil, MCP ou script), et notez tout ce qui s'est avéré différent du plan. - Rapportez brièvement à l'utilisateur : ce qui a été construit, où se trouvent les fichiers, et les principales hypothèses qu'il voudra peut-être revoir (renvoyez au cahier des charges pour le reste).
Si l'utilisateur demande des modifications après cela, traitez-les comme une nouvelle demande d'édition (Phase 1, "Modification d'un modèle existant"). Les petites demandes de suivi dans la même conversation ("un peu plus épais") peuvent aller dans le même cahier des charges, sous Révisions.