O que Envision faz?
Um ciclo de trabalho entre uma pessoa e você (o planejador) para ver o que um lugar real pode se tornar. Mantenha leve: esta ferramenta foi feita para crescer com o uso. Siga a pessoa, não este arquivo, quando ela quiser algo diferente; estes são padrões, não regras.
Os caminhos abaixo são relativos à pasta desta habilidade (<skill>), que você pode encontrar a partir de onde leu este arquivo.
0. Abrir ou iniciar um projeto
- Se a pasta atual tem um
project.md, esse é o projeto: leia-o,taste.mde olog.mddo espaço em andamento, depois continue de onde parou. - Caso contrário, pergunte por um nome de projeto e crie a pasta (padrão
~/Envision/<project>/, ou onde a pessoa disser) com esta estrutura, criando partes apenas quando forem necessárias:
<project>/
project.md # o que é o lugar, escolha do mecanismo, espaços e seus status, decisões
taste.md # o perfil de gosto escrito (a pessoa valida)
inspiration/ # tudo que a pessoa deu: imagens, pastas descompactadas, links.md, notas
moodboard/ # opcional, para validar o gosto
place/ # plantas, mapas, fotos gerais do lugar todo, se houver
spaces/<space>/
originals/ # fotos reais deste espaço
prompts/ # um arquivo de prompt por renderização
renders/ # saídas
log.md # cada rodada: o que foi pedido, o que foi feito, o que a pessoa disse
Inicie project.md a partir de <skill>/templates/project.md.
1. Conectar as ferramentas (primeira vez em um projeto, ou quando solicitado)
Execute <skill>/scripts/doctor.sh. Ele lista quais mecanismos de imagem são utilizáveis nesta máquina. Mostre a lista para a pessoa em palavras simples e deixe-a escolher; anote a escolha em project.md. Se o mecanismo desejado não estiver pronto, guie a pessoa pela configuração (o cabeçalho de cada adaptador diz o que ele precisa). Nunca peça ou imprima valores secretos: as chaves ficam no ambiente de shell da própria pessoa.
O planejador é você, qualquer aplicativo que abriu esta habilidade (Claude Code, Codex, ...). Notion, ou qualquer outro local para manter uma página de projeto, é opcional: se a pessoa quiser e houver um conector disponível, espelhe o resumo, o gosto e as imagens validadas lá; a pasta local continua sendo a fonte da verdade.
2. Entender o gosto
Pegue tudo que a pessoa der, em qualquer combinação: imagens no chat, um zip ou uma pasta, boards ou pins do Pinterest, links, um estilo nomeado ("hacienda espanhola", "Japandi"), notas de voz, texto simples. Salve o material em inspiration/. Olhe para cada imagem; para links, leia o que conseguir alcançar e diga claramente o que não conseguiu.
Escreva taste.md a partir de <skill>/templates/taste.md: um resumo de uma linha, depois o que se repete (materiais, cores, luz, móveis, plantas, clima), como a pessoa vive em um espaço (a partir das palavras dela), o que ela NÃO quer e perguntas em aberto. Vincule cada afirmação às suas fontes (ex.: "pisos de terracota: 6 de 40 imagens + disse isso"). Depois peça à pessoa que corrija. É um arquivo vivo: atualize-o sempre que uma rodada te ensinar algo ("continua rejeitando sofás brancos").
3. Moodboard (opcional)
Ofereça; faça apenas se a pessoa quiser validar o gosto visualmente. Escolha o caminho mais barato que responda ao que ela pede: uma seleção das próprias imagens ou pins (grátis), links para olhar (grátis) ou imagens geradas (custam dinheiro/quota: avise primeiro). Salve em moodboard/ e anote em taste.md o que foi validado ou rejeitado.
4. O lugar
Se houver uma planta, um mapa ou um conjunto completo de fotos, salve em place/ e escreva em project.md a lista de espaços e como eles se conectam, para que as versões sejam consistentes entre cômodos (mesmo piso se estendendo, mesma paleta). Se não, trabalhe espaço por espaço a partir das fotos que a pessoa enviar. Crie spaces/<space>/ por espaço e coloque as fotos originais em originals/. Antes da primeira renderização, descreva o que realmente está lá (paredes, aberturas, piso, teto, luz, o que vale a pena manter), para que a pessoa possa corrigir.
5. Rodadas
A pessoa pede algo ("4 versões do terraço, sem móveis", "o mesmo mas com um bar"). Para cada versão:
- Escreva o prompt em
spaces/<space>/prompts/<nome-da-renderizacao>.txt. Comece a partir do pedido da pessoa e detaste.md; passe de 0 a 5 imagens de inspiração como referências de estilo quando ajudarem. Quando a versão deve manter o lugar real, diga isso explicitamente no prompt: mesmas paredes, aberturas, proporções, ângulo de câmera e enquadramento; nomeie as coisas que não devem se mover (uma árvore, uma escada). Diga o que muda e o que não muda. - Escolha a imagem base e informe a pessoa qual é: a foto real para permanecer fiel ao lugar, ou uma renderização anterior para manter o que ela gostou. Mudanças grandes geralmente voltam para a foto real; pequenos ajustes podem construir sobre uma renderização.
- Renderize:
<skill>/scripts/render.sh <engine> --base <img> --prompt <file> --out <png> [--ref <img>]...(versões independentes podem rodar em paralelo). Nomeie as renderizações para que ordenem e digam o que são, ex.:r2-03-no-furniture-bar.png. - Olhe cada resultado você mesmo antes de mostrar. Diga honestamente onde se desviou do lugar real (a câmera moveu, uma árvore desapareceu). Envie as imagens no chat.
- Registre a rodada em
log.md: o pedido, cada renderização com sua base, referências, arquivo de prompt e o que você vê, depois a reação da pessoa.
A pessoa reage: "mantenha isso, descarte aquilo, gosto desses dois, mais em torno deles". Incorpore na próxima rodada (e em taste.md quando for sobre gosto, não sobre este espaço). Continue até a pessoa validar algumas imagens. Marque-as como validated em log.md e liste-as em project.md, depois vá para o próximo espaço ou a próxima parte do espaço.
Mecanismos
Cada mecanismo é um executável em <skill>/engines/ com o mesmo contrato (veja engines/README.md). Para adicionar um (outra API, um modelo local, um aplicativo web operado manualmente), adicione um arquivo lá; nada mais muda.