Que fait Envision ?
Une boucle de travail entre une personne et vous (le planificateur) pour voir ce qu'un lieu réel pourrait devenir. Restez léger : cet outil est conçu pour évoluer avec l'usage. Suivez la personne, pas ce fichier, lorsqu'elle veut quelque chose de différent ; ce sont des valeurs par défaut, pas des règles.
Les chemins ci-dessous sont relatifs au dossier de cette compétence (<skill>), que vous pouvez trouver à partir de l'endroit où vous lisez ce fichier.
0. Ouvrir ou démarrer un projet
- Si le dossier actuel contient un
project.md, c'est le projet : lisez-le,taste.mdet lelog.mdde l'espace en cours, puis reprenez là où il s'est arrêté. - Sinon, demandez un nom de projet et créez le dossier (par défaut
~/Envision/<project>/, ou là où la personne le dit) avec cette structure, en créant les parties seulement lorsqu'elles sont nécessaires :
<project>/
project.md # ce qu'est le lieu, le choix du moteur, les espaces et leur état, les décisions
taste.md # le profil de goût écrit (validé par la personne)
inspiration/ # tout ce que la personne a donné : images, dossiers décompressés, links.md, notes
moodboard/ # facultatif, pour valider le goût
place/ # plans, cartes, photos d'ensemble du lieu, le cas échéant
spaces/<space>/
originals/ # photos réelles de cet espace
prompts/ # un fichier de prompt par rendu
renders/ # sorties
log.md # chaque round : ce qui a été demandé, ce qui a été produit, ce que la personne a dit
Démarrez project.md à partir de <skill>/templates/project.md.
1. Brancher les outils (première fois dans un projet, ou sur demande)
Exécutez <skill>/scripts/doctor.sh. Il liste les moteurs d'image utilisables sur cette machine. Montrez la liste à la personne en termes simples et laissez-la choisir ; notez le choix dans project.md. Si celui qu'elle veut n'est pas prêt, guidez-la (l'en-tête de chaque adaptateur indique ce dont il a besoin). Ne demandez ni n'imprimez jamais de valeurs secrètes : les clés résident dans l'environnement shell de la personne.
Le planificateur, c'est vous, quelle que soit l'application qui a ouvert cette compétence (Claude Code, Codex...). Notion, ou tout autre endroit pour conserver une page de projet, est facultatif : si la personne le souhaite et qu'un connecteur est disponible, reflétez le brief, le goût et les images validées là-bas ; le dossier local reste la source de vérité.
2. Comprendre le goût
Prenez tout ce que la personne donne, dans n'importe quel mélange : images dans le chat, un zip ou un dossier, des tableaux ou épingles Pinterest, des liens, un style nommé ("hacienda espagnole", "japandi"), des notes vocales, du texte brut. Enregistrez le matériel dans inspiration/. Regardez chaque image ; pour les liens, lisez ce que vous pouvez atteindre et dites clairement ce que vous n'avez pas pu.
Écrivez taste.md à partir de <skill>/templates/taste.md : un résumé d'une ligne, puis ce qui revient souvent (matériaux, couleurs, lumière, meubles, plantes, ambiance), comment la personne vit dans l'espace (d'après ses mots), ce qu'elle ne veut PAS, et les questions ouvertes. Liez chaque affirmation à ses sources (par exemple "sols en terre cuite : 6 images sur 40 + dit explicitement"). Demandez ensuite à la personne de le corriger. C'est un fichier vivant : mettez-le à jour à chaque fois qu'un round vous apprend quelque chose ("rejette systématiquement les canapés blancs").
3. Mood board (facultatif)
Proposez-le ; ne le faites que si la personne souhaite valider le goût visuellement. Choisissez la voie la moins coûteuse qui répond à ce qu'elle demande : une sélection de ses propres images ou épingles (gratuit), des liens à regarder (gratuit), ou des images générées (coût/quota : dites-le d'abord). Enregistrez dans moodboard/ et notez dans taste.md ce qu'elle a validé ou rejeté.
4. Le lieu
S'il y a un plan, une carte ou un ensemble complet de photos, enregistrez-les dans place/ et écrivez dans project.md la liste des espaces et comment ils se connectent, afin que les versions restent cohérentes entre les pièces (même sol traversant, même palette). Sinon, travaillez espace par espace à partir des photos que la personne envoie. Créez spaces/<space>/ par espace et placez les photos originales dans originals/. Avant le premier rendu, décrivez ce qui est réellement là (murs, ouvertures, sol, plafond, lumière, ce qui mérite d'être conservé), afin que la personne puisse vous corriger.
5. Rounds
La personne demande quelque chose ("4 versions de la terrasse, sans meubles", "pareil mais avec un bar"). Pour chaque version :
- Écrivez le prompt dans
spaces/<space>/prompts/<render-name>.txt. Partez de la demande de la personne et detaste.md; passez 0 à 5 images d'inspiration comme références de style lorsqu'elles aident. Lorsque la version doit conserver le lieu réel, dites-le explicitement dans le prompt : mêmes murs, ouvertures, proportions, angle de caméra et cadrage ; nommez les éléments qui ne doivent pas bouger (un arbre, un escalier). Dites ce qui change et ce qui ne change pas. - Choisissez l'image de base et dites à la personne laquelle : la photo réelle pour rester fidèle au lieu, ou un rendu précédent pour conserver ce qu'elle a aimé. Les gros changements reviennent généralement à la photo réelle ; les petites retouches peuvent s'appuyer sur un rendu.
- Rendu :
<skill>/scripts/render.sh <engine> --base <img> --prompt <file> --out <png> [--ref <img>]...(les versions indépendantes peuvent s'exécuter en parallèle). Nommez les rendus de manière à ce qu'ils se trient et disent ce qu'ils sont, par exempler2-03-no-furniture-bar.png. - Regardez chaque résultat vous-même avant de le montrer. Dites honnêtement où il s'est éloigné du lieu réel (la caméra a bougé, un arbre a disparu). Envoyez les images dans le chat.
- Enregistrez le round dans
log.md: la demande, chaque rendu avec sa base, ses références, son fichier de prompt et ce que vous voyez, puis la réaction de la personne.
La personne réagit : "garde ceci, jette cela, j'aime ces deux-là, plus dans cette direction". Intégrez-le dans le round suivant (et dans taste.md quand il s'agit de goût, pas de cet espace). Continuez jusqu'à ce que la personne valide quelques images. Marquez-les validated dans log.md et listez-les dans project.md, puis passez à l'espace suivant ou à la partie suivante de l'espace.
Moteurs
Chaque moteur est un exécutable dans <skill>/engines/ avec le même contrat (voir engines/README.md). Pour en ajouter un (une autre API, un modèle local, une application web pilotée manuellement), ajoutez un fichier là-bas ; rien d'autre ne change.