CommunityImagemgithub.com

Envision

Reimagine um lugar real a partir de fotos. Constrói um perfil de gosto por projeto a partir de qualquer inspiração (imagens, zip, pasta, Pinterest, nomes de estilo, palavras simples), opcionalmente um moodboard para validá-lo, depois trabalha espaço por espaço nas fotos reais, gerando versões (com ou sem móveis) e iterando com o usuário até que algumas imagens sejam validadas. Os mecanismos de imagem são plug-and-play (plano Codex/ChatGPT, API OpenAI, manual ou qualquer adaptador adicionado depois). Use quando o usuário quiser reformar, redecorar ou imaginar uma casa, cômodo, jardim, terraço, escritório, loja ou qualquer espaço real a partir de uma foto.

O que é Envision?

Envision é uma habilidade para agentes de IA que estabelece um ciclo colaborativo entre uma pessoa e o planejador (você, o agente) para visualizar como um espaço real poderia ser transformado. Ela é útil para reformas, decoração de interiores ou qualquer redesign de ambientes, permitindo que o agente construa um perfil de gosto único por projeto, a partir de diversas entradas como imagens, pastas, boards do Pinterest, estilos nomeados ou descrições textuais. O fluxo de trabalho é dividido em etapas: configuração do projeto e escolha do mecanismo de geração de imagem (Codex, OpenAI API, etc., de forma plug-and-play), compreensão aprofundada do gosto do usuário documentado em um arquivo `taste.md`, criação opcional de um moodboard para validação visual, e, por fim, rodadas iterativas de geração de imagens para cada espaço. A habilidade suporta plataformas como Claude Code e Codex, mantendo-se adaptável. O processo é guiado por um arquivo de projeto (`project.md`) e registros detalhados (`log.md`), garantindo consistência e rastreabilidade. Cada renderização é cuidadosamente preparada com prompts detalhados, referências visuais e validação do usuário até que algumas imagens sejam aprovadas. A estrutura modular de mecanismos de imagem permite adicionar novos adaptadores sem alterar o restante da lógica.

Funciona com✓Claude Code✓Codex CLI~Cursor
npx skills add https://github.com/dtazi/envision/tree/HEAD

Installed? Explore more Imagem skills: steipete/songsee, affaan-m/frontend-design, mattpocock/improve-codebase-architecture · View all 6 →

Perguntar na sua IA favorita

Abre um novo chat com esta habilidade de agente já pré-carregada.

Documentação

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.md e o log.md do 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:

  1. Escreva o prompt em spaces/<space>/prompts/<nome-da-renderizacao>.txt. Comece a partir do pedido da pessoa e de taste.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.
  2. 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.
  3. 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.
  4. 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.
  5. 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.

Habilidades Relacionadas