¿Qué hace envision?
Un bucle de trabajo entre una persona y tú (el planificador) para ver en qué podría convertirse un lugar real. Mantenlo ligero: esta herramienta está pensada para crecer con el uso. Sigue a la persona, no este archivo, cuando quiera algo diferente; estos son valores predeterminados, no reglas.
Las rutas a continuación son relativas a la carpeta de este skill (<skill>), que puedes encontrar desde donde lees este archivo.
0. Abrir o iniciar un proyecto
- Si la carpeta actual tiene un
project.md, ese es el proyecto: léelo,taste.mdy ellog.mddel espacio en curso, luego retoma donde se detuvo. - De lo contrario, pide un nombre de proyecto y crea la carpeta (por defecto
~/Envision/<project>/, o donde la persona indique) con esta estructura, creando partes solo cuando sean necesarias:
<project>/
project.md # qué es el lugar, elección del motor, espacios y su estado, decisiones
taste.md # el perfil de gusto escrito (la persona lo valida)
inspiration/ # todo lo que la persona dio: imágenes, carpetas descomprimidas, links.md, notas
moodboard/ # opcional, para validar el gusto
place/ # planos, mapas, fotos generales del lugar completo, si las hay
spaces/<space>/
originals/ # fotos reales de este espacio
prompts/ # un archivo de prompt por render
renders/ # resultados
log.md # cada ronda: qué se pidió, qué se creó, qué dijo la persona
Inicia project.md desde <skill>/templates/project.md.
1. Conectar las herramientas (primera vez en un proyecto, o cuando se pida)
Ejecuta <skill>/scripts/doctor.sh. Muestra la lista de motores de imagen utilizables en esta máquina. Presenta la lista a la persona en palabras sencillas y deja que elija; anota la elección en project.md. Si el que quieren no está listo, guíalos paso a paso (el encabezado de cada adaptador indica lo que necesita). Nunca pidas ni imprimas valores secretos: las claves viven en el entorno shell de la persona.
El planificador eres tú, sea cual sea la aplicación que abrió este skill (Claude Code, Codex, ...). Notion, o cualquier otro lugar para mantener una página de proyecto, es opcional: si la persona lo quiere y hay un conector disponible, refleja allí el resumen, el gusto y las imágenes validadas; la carpeta local sigue siendo la fuente de verdad.
2. Comprender el gusto
Toma todo lo que la persona dé, en cualquier combinación: imágenes en el chat, un zip o una carpeta, tableros o pines de Pinterest, enlaces, un estilo con nombre ("hacienda española", "japandi"), notas de voz, texto simple. Guarda el material en inspiration/. Mira cada imagen; para los enlaces, lee lo que puedas alcanzar y di claramente lo que no pudiste.
Escribe taste.md a partir de <skill>/templates/taste.md: un resumen de una línea, luego lo que se repite (materiales, colores, luz, muebles, plantas, ambiente), cómo vive la persona en un espacio (según sus palabras), lo que NO quieren y preguntas abiertas. Vincula cada afirmación a sus fuentes (ej. "suelos de terracota: 6 de 40 imágenes + lo dijo"). Luego pide a la persona que lo corrija. Es un archivo vivo: actualízalo cada vez que una ronda te enseñe algo ("sigue rechazando sofás blancos").
3. Moodboard (opcional)
Ofrécelo; hazlo solo si la persona quiere validar el gusto visualmente. Elige la ruta más barata que responda a lo que preguntan: una selección de sus propias imágenes o pines (gratis), enlaces para mirar (gratis), o imágenes generadas (cuestan dinero/cuota: diles primero). Guarda en moodboard/ y anota en taste.md lo que validaron o rechazaron.
4. El lugar
Si hay un plano, un mapa o un conjunto completo de fotos, guárdalo en place/ y escribe en project.md la lista de espacios y cómo se conectan, para que las versiones sean consistentes entre habitaciones (el mismo suelo continuo, la misma paleta). Si no, trabaja espacio por espacio a partir de las fotos que la persona envíe. Crea spaces/<space>/ por espacio y coloca las fotos originales en originals/. Antes del primer render, describe lo que realmente hay (paredes, aberturas, suelo, techo, luz, lo que vale la pena conservar), para que la persona pueda corregirte.
5. Rondas
La persona pide algo ("4 versiones de la terraza, sin muebles", "lo mismo pero con una barra"). Para cada versión:
- Escribe el prompt en
spaces/<space>/prompts/<nombre-render>.txt. Empieza desde la petición de la persona ytaste.md; pasa de 0 a 5 imágenes de inspiración como referencias de estilo cuando ayuden. Cuando la versión debe conservar el lugar real, dilo explícitamente en el prompt: mismas paredes, aberturas, proporciones, ángulo de cámara y encuadre; nombra las cosas que no deben moverse (un árbol, una escalera). Di qué cambia y qué no. - Elige la imagen base y dile a la persona cuál: la foto real para ser fiel al lugar, o un render anterior para conservar lo que les gustó. Los cambios grandes suelen volver a la foto real; los ajustes pequeños pueden basarse en un render.
- Renderiza:
<skill>/scripts/render.sh <engine> --base <img> --prompt <file> --out <png> [--ref <img>]...(las versiones independientes pueden ejecutarse en paralelo). Nombra los renders para que se ordenen y digan qué son, ej.r2-03-no-furniture-bar.png. - Mira tú mismo cada resultado antes de mostrarlo. Di honestamente dónde se desvió del lugar real (la cámara se movió, un árbol desapareció). Envía las imágenes en el chat.
- Registra la ronda en
log.md: la petición, cada render con su base, referencias, archivo de prompt y lo que ves, luego la reacción de la persona.
La persona reacciona: "conserva esto, descarta aquello, me gustan estos dos, más alrededor de eso". Incorpóralo en la siguiente ronda (y en taste.md cuando se trate de gusto, no de este espacio). Continúa hasta que la persona valide algunas imágenes. Márcalas como validated en log.md y listalas en project.md, luego pasa al siguiente espacio o a la siguiente parte del espacio.
Motores
Cada motor es un ejecutable en <skill>/engines/ con el mismo contrato (ver engines/README.md). Para añadir uno (otra API, un modelo local, una aplicación web manejada a mano), agrega un archivo allí; nada más cambia.