Frontends com Vibecoding · Capítulo 3 de 35 · 15 min
Levar o repertório da marca para o briefing antes do prompt
Você sai com três linhas a mais no briefing (referências de fora do algoritmo, eixos fixos da marca e a frase de assinatura) e com o teste do sósia para conferir de quem é a tela.
Este capítulo faz parte do curso gratuito Frontends com Vibecoding.
O briefing do capítulo anterior já tem destinatário e critério, e ainda produz tela genérica enquanto não carregar referências de fora do algoritmo e eixos visuais fixados pela marca.
A ferramenta de IA amplia o que já existe no briefing, inclusive a falta de repertório, e devolve a saída mais provável entre tudo que já viu. Repertório é o acervo de referências próprias da marca: a loja, a embalagem, o letreiro, o jeito de falar com o cliente.
Quando o cliente reconhece a ferramenta antes da marca na própria página, o prejuízo é de identidade. O teste do sósia decide de quem é a tela. Três itens novos entram no briefing para vencer a média: referências de fora do algoritmo, eixos fixos da marca e uma frase de assinatura.

Se a figura ultrapassar a área visível, deslize para os lados. Pelo teclado, foque a figura e use as setas.
Design é escolha, repertório, contexto e identidade. Caio Camargo escreveu que a IA começou como design para quem não é designer e está virando design para quem não entende de design. O consumidor já tem a frase pronta: "isso tem cara de IA".
Quando a pessoa reconhece a ferramenta antes da marca, o problema é de marca. No mesmo artigo, uma estrategista de branding lembra que a marca com DNA bem definido e bem gerido "é rei diante de tanta coisa igual". Um head de UX completa: a IA expôs quem já era fraco, designers incluídos.
A média tem um mecanismo simples: o modelo devolve a saída mais provável entre tudo o que viu. O índigo que aparece em botão de página gerada tem endereço verificável. Ele vem do Tailwind, o kit de estilos usado em boa parte dos sites, onde é uma das cores que já vêm prontas.
Em repositório público está documentada a cadeia que espalha essa cor. O shadcn/ui, a coleção de componentes prontos sobre o Tailwind, é a biblioteca padrão de vários geradores de página. Ninguém declarou essa preferência, e ela chega pela cadeia de ferramentas.
A página gerada hoje volta para o treino de amanhã, e o laço se fecha: quanto mais igual a web fica, mais igual nasce a próxima página.
Quem assina a página: a ferramenta ou a marca
A página que a ferramenta assina
evite
- Fundo, cor de destaque e letra iguais aos de qualquer produto de tecnologia
- Foto de banco de imagem ou ilustração genérica no lugar do material do ramo
- Texto que serve para qualquer empresa: troque o nome e continua verdadeiro
- Sem logotipo, a pessoa de fora responde "alguma empresa de tecnologia"
A página que a marca assina
faça assim
- Cor, textura e letra vindas da loja, da embalagem, do letreiro e do uniforme
- Foto do balcão, do produto ou da equipe, feita no lugar
- Texto com o vocabulário do ramo e uma frase que só faria sentido ali
- Sem logotipo, a pessoa de fora acerta o ramo e chega perto do nome
Vibe coding é construir telas por conversa com o agente de IA, o programa que escreve o código do pedido. Um estudo da Universidade de Washington testou seis dessas plataformas, e todas reproduziram as convenções do treino.
Os autores chamam isso de armadilha do bom o suficiente. O leigo aceita o que parece pronto porque nada, na tela, pergunta se aquilo reflete a marca dele.
A perda de variedade já foi medida em texto por estudos revisados por pares. Quem escreve com ajuda de IA tem mais ideias sozinho, enquanto o conjunto do grupo fica mais parecido.
Essa causa tem endereço: o ajuste que deixa o modelo agradável ao gosto humano é o que reduz a variedade, e o modelo sem esse ajuste não reduz. Quando o modelo passa a treinar sobre a própria saída, as pontas raras somem de vez.
Para cor de site ainda não existe número publicado. A decisão prática não muda por isso: quando a sua página sai igual à do concorrente, o problema já está na sua mesa.
Se a figura ultrapassar a área visível, deslize para os lados. Pelo teclado, foque a figura e use as setas.
A web já convergia antes da IA. Os sistemas de design das grandes empresas, os manuais que padronizam botão, cor e espaçamento, já achatavam as diferenças. As marcas de luxo fizeram o mesmo ao trocar o logotipo desenhado pelo nome em caixa alta.
Nesse quadro a IA entrou como fotocopiadora de alta velocidade e como motor de média, e os antídotos cabem em qualquer negócio. Busque referências de fora do algoritmo, use a IA na geração e deixe o acabamento com a mão humana.
Referência de fora do algoritmo é a que você não achou rolando a tela: um livro, um filme, o prédio da esquina, a embalagem antiga guardada na loja.
O teste do sósia decide de quem é a tela. Tire logotipo e nome, mostre a página a alguém de fora do ramo e pergunte de quem é. Se a resposta for "alguma empresa de tecnologia", a peça é da ferramenta. Se a pessoa acerta o ramo e chega perto do nome, a peça é da marca.
A versão textual funciona igual: três parágrafos do site, sem nome, para a mesma pessoa. Se a ferramenta é reconhecida antes da marca, a marca perdeu. O critério final de Camargo vale como meta: alguém olhar a peça sem logotipo e pensar "isso só poderia ser dessa marca".
Essa saturação repete o ciclo dos bancos de imagem, os catálogos de fotos prontas que todo mundo compra: surpresa, comum, previsível, cansativo e repulsa. A tabela diz o que fazer em cada estágio, e quanto mais cedo você entra, menos estágios o site percorre.
O ciclo dos bancos de imagem aplicado ao site gerado
| Estágio | O que o público sente | O que você faz nesse estágio |
|---|---|---|
| Surpresa | A tela parece nova e o dono aprova na primeira olhada | Aplique o teste do sósia antes de aprovar; a surpresa some em semanas |
| Comum | O mesmo visual aparece nos concorrentes e ninguém estranha | Leve ao briefing três referências de fora do algoritmo e os eixos fixos da marca |
| Previsível | A pessoa adivinha a próxima seção antes de rolar a página | Troque a foto genérica pela foto do lugar e reescreva a frase de assinatura |
| Repulsa | O visual sinaliza descuido e a pessoa reconhece a ferramenta antes da marca | Refaça a página a partir do repertório, com a IA só na geração |
Quanto antes o teste do sósia entra, menos estágios do ciclo o site percorre.
Fonte: Ciclo descrito por Caio Camargo (LinkedIn, 7 de setembro de 2026) por analogia com os bancos de imagem; a coluna da direita é critério do autor.
Tudo isso entra no briefing da aula anterior como três linhas a mais. Primeiro, três a cinco referências de fora do algoritmo: o material do ramo, a loja, a embalagem, o letreiro. Segundo, os eixos fixos da marca, que o agente segue à risca. Terceiro, a frase de assinatura: "o que só poderia ser nosso".
O prompt (o pedido escrito que vai para o agente) carrega o repertório porque a ferramenta amplia o que recebe. Sem repertório, volta a média; com repertório, volta uma versão maior do que a marca já era.
A referência que serve é a que nenhum concorrente conseguiria copiar. Numa cafeteria de bairro, a primeira versão da página tinha foto de banco de imagem e um azul qualquer, e ninguém a distinguia das outras.
O dono fotografou a xícara esmaltada no balcão e o letreiro pintado à mão. A cor da xícara virou o destaque e a letra do letreiro virou o título. Quem viu a página sem logotipo passou a responder "uma cafeteria", em vez de "uma empresa de tecnologia".
Antes de aprovar a próxima tela, esconda o logotipo, mostre a página e três parágrafos do texto a alguém de fora do ramo e anote a resposta literal. Fotografe três referências que nenhum concorrente conseguiria tirar.
Escreva em uma linha o que só poderia ser da sua marca e liste os eixos que o agente não pode mudar. Cole essas três linhas no briefing, gere de novo e repita o teste: só aprove quando a resposta acertar o ramo.
Guia prático: começar de um template que já traz CLAUDE.md e DESIGN.md
A página em branco obriga o agente a decidir tudo, e ele decide pelo padrão da moda. Um template profissional chega com as decisões tomadas e com dois arquivos que o agente lê antes de editar: o CLAUDE.md, que diz como rodar e onde está cada coisa, e o DESIGN.md, que guarda a identidade. A galeria de 51 templates estudada em 07/10/2026 traz os dois arquivos em todos os 51.
Os 51 não são iguais. Medidos um a um, eles caem em três famílias
| Família | Templates | O que é | Onde ficam os textos |
|---|---|---|---|
| Premium em português | 12 | React 19, TypeScript, Tailwind v4, GSAP e Lenis, com mídia local | Num único objeto de configuração no topo da página |
| Importados de gerador de interface | 36 | React 18 ou 19 em JSX, Tailwind v3, maioria em inglês | Espalhados, em média por 8 componentes |
| HTML puro | 3 | Tudo num index.html de até 2.479 linhas | No próprio HTML |
A família muda o pedido que você faz ao agente: num template premium, você edita um objeto; num importado, caça texto em vários arquivos. O setor também pesa. Advocacia (5 templates) e clínicas (4) estão só na família premium; SaaS (9), alimentação (5) e fitness (3), só na importada.
O custo de manter entra na escolha. Os 12 premium carregam dependências que a página não usa, como um driver de banco de servidor num projeto que se diz sem backend, e só aproveitam 12 dos 53 componentes de interface que vêm junto. A mídia local tem mediana de 6,9 MB por template. Nos importados, 35 templates puxam imagens do Unsplash e 19 apontam para o armazenamento do próprio fornecedor: se ele sair do ar, a imagem quebra no seu site.
# [Nome do negócio]: site institucional
## Como rodar
npm install | npm run dev | npm run build | npm run lint
## Onde está cada coisa
- Textos, contatos e listas: [arquivo e objeto de configuração]
- Imagens: [pasta], no tamanho em que aparecem, em WebP
- Identidade, ordem das seções e movimento: DESIGN.md
## Regras para o agente
1. Personalize sem reconstruir: troque conteúdo, mantenha estrutura.
2. Não mude paleta nem fonte sem pedido; se mudar, atualize o DESIGN.md.
3. Edite o componente da seção; não crie arquivo paralelo.
4. Nenhum dado de exemplo vai ao ar: registro profissional, telefone, link vazio.
5. Antes de dizer que terminou, rode build e lint e abra a página em 390 px.Do template escolhido ao projeto que você consegue manter
Cinco passos antes do primeiro pedido de personalização.
Passo 1: Escolha pelo setor e pelo estilo, nessa ordem
Filtre os templates do seu setor primeiro, porque a ordem das seções já vem testada para aquele cliente. Entre os que sobram, escolha o estilo que serve à tarefa da página.
Deu certo quando: Você tem dois candidatos do seu setor e sabe dizer por que cada um serve.
Erro comum: Escolher o mais bonito de outro setor e reescrever a estrutura inteira depois.
Passo 2: Peça ao agente o diagnóstico da família
Antes de editar, peça para dizer se o projeto é React em JSX, TypeScript com componentes prontos ou HTML puro, onde ficam os textos e quantos arquivos você precisa tocar para trocar nome, telefone e serviços.
Deu certo quando: Você sabe em quantos arquivos mora o conteúdo e se existe um objeto de configuração.
Erro comum: Pedir "adapte para o meu negócio" sem saber onde estão os textos e receber trocas pela metade.
Passo 3: Meça o que vem junto e não é usado
Peça a lista de dependências que nenhum arquivo importa, os componentes de exemplo e o peso da pasta de mídia por tipo. Remova o que sobra antes de construir em cima.
Deu certo quando: Cada dependência restante tem um arquivo que a usa.
Erro comum: Deixar o boilerplate inteiro e atualizar, por anos, pacotes que a página nunca chamou.
Passo 4: Traga a mídia remota para dentro do projeto
Liste toda imagem que vem de outro servidor, baixe, converta para WebP na largura em que aparece e troque o endereço. Vídeo acima de 5 MB vai para armazenamento de objetos, não para o repositório.
Deu certo quando: Nenhuma imagem depende de servidor de terceiros e você sabe o peso total da mídia.
Erro comum: Publicar com imagem apontando para o armazenamento do fornecedor do template.
Passo 5: Reescreva o CLAUDE.md com as suas regras
Use o molde do bloco acima: como rodar, onde está cada coisa e cinco regras de conduta. Curto de propósito; o detalhe de identidade fica no DESIGN.md.
Deu certo quando: O CLAUDE.md cabe numa tela e aponta para o DESIGN.md.
Erro comum: Manter o CLAUDE.md genérico do template, que não fala de dado de exemplo nem de teste em 390 px.
No fim você tem: Um projeto que nasce de decisões já tomadas, sem peso morto, e com instruções que o agente lê antes de cada edição.
Sócio de um escritório de contabilidade em Campinas, que quer o site novo em uma semana
Serviços profissionais, captação por WhatsApp
Dor
Ele começou do zero com um agente e, depois de três dias, tinha uma página de SaaS em inglês com faixa de logos e plano de assinatura mensal.
Solução
Escolheu um template de contabilidade da família premium, pediu o diagnóstico antes de editar e descobriu que todo o conteúdo morava num objeto só. Removeu as dependências sem uso, converteu as fotos para WebP e reescreveu o CLAUDE.md com a regra de não publicar registro profissional de exemplo.
Resultado
A personalização virou edição de um único arquivo de conteúdo, e o projeto ficou mais leve do que o template original.
Cenário construído para fins didáticos. Números não correspondem a cliente específico.
Seu caderno neste capítulo
Abrir o caderno completoSelecione um trecho do capítulo para destacar ou anotar. Nos vídeos e áudios, use Anotar este momento. No teclado, selecione com Shift e as setas e use Alt+Shift+D para destacar ou Alt+Shift+N para anotar.
Salvo neste navegador. Entre na sua conta para levar o caderno a outros aparelhos.
Entre na sua conta para compartilhar o que aprendeu e convidar alguém para estudar com você.
Conexões deste capítulo
Veja o que estudar antes e para onde seguir depois, explore os conceitos e compare abordagens em outros cursos. Sugestões marcadas como “sugerido pelo grafo” vêm dos assuntos em comum, não do índice do curso.
Estude antes
- CursoClaude Code CLI: Programação com IA
- Montar vídeo em React com Remotion e renderizar na sua máquina ou na AWSsugerido pelo grafoApresenta o conceito “React”, usado em “Levar o repertório da marca para o briefing antes do prompt”.
- Montar vídeo em HTML com HyperFrames e escolher entre ele e o Remotionsugerido pelo grafoApresenta o conceito “HTML”, usado em “Levar o repertório da marca para o briefing antes do prompt”.
- CursoSíntese e didática com IAsugerido pelo grafoDepois de escolher a informação essencial e desenhar hierarquia, gráficos e fluxos compreensíveis, o aluno pode aplicar esses critérios às interfaces do curso de frontend. A ponte conecta clareza da mensagem, acessibilidade e decisões de apresentação.
Depois, siga para
- CursoAPI Design: REST, GraphQL e Boas Práticassugerido pelo grafoAs aulas de formulários do curso de frontend compartilham a validação entre navegador e servidor, e o estudo da Stripe separa o campo do cartão do sistema da loja. API Design aprofunda essa fronteira com contratos REST e GraphQL, autenticação e limites de chamadas no servidor.
- CursoPrompt Engineering para Executivossugerido pelo grafo6 capítulos de “Prompt Engineering para Executivos” usam conceitos apresentados em “Frontends com Vibecoding”.
- CursoLLM FinOps: o custo da IA para quem assina o orçamentosugerido pelo grafo3 capítulos de “LLM FinOps: o custo da IA para quem assina o orçamento” usam conceitos apresentados em “Frontends com Vibecoding”.
Conceitos deste capítulo
O mesmo assunto em outros cursos
- Motor de crescimento para IAA experiência de chegada decide o que a mídia comprouExaminar conexões de A experiência de chegada decide o que a mídia comprou
- Autoridade Temática e SEO de EntidadesO trecho que a IA consegue usar sozinhoExaminar conexões de O trecho que a IA consegue usar sozinho
- GEO Universal FrameworkReconheça as cinco decisões que são suas e escolha a rota de leituraExaminar conexões de Reconheça as cinco decisões que são suas e escolha a rota de leitura
- GEO e Knowledge GraphA resposta pronta tomou o lugar da lista de linksExaminar conexões de A resposta pronta tomou o lugar da lista de links
Terminou a leitura?
Marque como concluído para o capítulo contar no seu painel e no certificado.
Voltar ao capítulo anterior: Escrever o pedido de uma tela sem deixar buraco
Leve uma ideia para a prática
Escolha uma atividade no painel e volte a este curso quando quiser.
Atividades e evolução ficam reunidas no painel da sua conta.
Laboratórios ao vivo deste curso
Cada laboratório monta a biblioteca real dentro da aula, com controles para você mexer e o código do exemplo para copiar. O texto de reserva descreve a demonstração para quem lê sem JavaScript. O link abre o capítulo já no ponto do laboratório.
Base UI
Prenda o foco num diálogo sem escrever o comportamento
Abra a janela Agendar visita, percorra os campos com Tab, feche com Esc e acompanhe no painel onde o foco está e para onde ele volta.
Pacote
Abrir no capítuloConstruir componentes, usar o registro e publicar o catálogo@base-ui/reactLucide e Iconify
Mantenha uma família de ícones coerente e nomeie cada botão
Mude tamanho, traço e cor da barra, veja o símbolo do Iconify acompanhar o Lucide e rode a auditoria de nomes acessíveis.
Pacote
Abrir no capítuloProjetar uma linguagem de ícones e ilustraçãolucide-react, @iconify/reactMotion
Testar os três sinais que autorizam o terceiro degrau
Reproduza a entrada em sequência, aperte o botão com mola e arraste o cartão; ajuste rigidez e amortecimento e veja o que muda.
Pacote
Abrir no capítuloProjetar movimento, assinatura e narrativas por rolagemmotionVidstack
Ver o que separa um player de um vídeo cru
Dê o play, troque a velocidade e ligue a legenda; o painel ao lado mostra o estado que o player publica e que a etiqueta crua esconde.
Pacote
Abrir no capítuloProjetar movimento, assinatura e narrativas por rolagem@vidstack/reactcmdk
Achar um destino entre quarenta digitando três letras
Abra a paleta, digite fat e escolha um item só pelo teclado; o painel embaixo conta o que o filtro deixou passar e quanto tempo levou.
Pacote
Abrir no capítuloConstruir formulários e estados de interaçãocmdknumber-flow
Animar indicadores que mudam ao vivo com formato pt-BR
Veja três indicadores fictícios rolarem a cada troca e compare com o número em texto puro. Pause, reinicie e observe o separador de milhar.
Pacote
Abrir no capítuloProjetar gráficos e painéis pela decisão@number-flow/reactApache ECharts
Medir o custo de desenhar 200 mil pontos com o ECharts
Troque o tipo de gráfico e o volume de pontos, leia o tempo de desenho e alterne o eixo em zero. Mude o tema do site e veja as cores refazerem.
Pacote
Abrir no capítuloProjetar gráficos e painéis pela decisãoechartssharp e svgo
Escolher a variante certa da imagem e conferir o teto de 150 KB
Arraste a largura da tela simulada, troque a densidade entre 1x e 2x e veja qual arquivo o navegador escolhe, quanto ele pesa e se cabe no orçamento.
Pacote
Abrir no capítuloValidar desempenho, autenticação e segurançasharp, svgoReact Flow (xyflow)
Disparar um pedido e ver o orquestrador distribuir, conferir e responder
Alterne paralelo e sequencial, ligue e desligue a verificação e use a medição real; observe o tempo de parede em cada combinação.
Pacote
Abrir no capítuloConstruir as cenas do orquestrador, do paralelismo e do robô@xyflow/reactGSAP, Web Workers e number-flow
Dividir mil tarefas entre trabalhadores reais e correr três ritmos de geração
Execute com um trabalhador, depois com quatro e oito, e compare o tempo; em seguida percorra a corrida e separe a espera inicial do ritmo.
Pacote
Abrir no capítuloConstruir as cenas do orquestrador, do paralelismo e do robôgsap, @number-flow/reactThree.js com React Three Fiber, drei, Rapier e XR
Carregar o braço robótico, ver a física trabalhar e entrar na cena com o visor
Carregue a cena pelo botão, inicie o ciclo, mostre os ângulos das juntas, troque a câmera e a velocidade; com visor, entre em realidade virtual.
Pacote
Abrir no capítuloConstruir as cenas do orquestrador, do paralelismo e do robôthree, @react-three/fiber, @react-three/drei, @react-three/rapier, @react-three/xrMotion
Ver quatro agentes em raias trocando mensagens e a revisão devolvendo um trecho
Reproduza os 60 s de modelo, percorra o tempo pelo controle e esconda as mensagens para comparar a leitura; repare no tempo de parede contra a soma.
Pacote
Abrir no capítuloEspecificar, medir e produzir as cenas da máquinamotionMediaRecorder, Canvas 2D e Long Animation Frames (plataforma)
Medir o quadro da cena e gravar seis segundos dela em vídeo
Suba as partículas, force um bloqueio de 300 ms e leia o medidor; depois grave seis segundos, veja o codec escolhido e baixe o arquivo.
Pacote
Abrir no capítuloEspecificar, medir e produzir as cenas da máquinasem pacotesigma.js, graphology com ForceAtlas2 e cosmos.gl
Ver o grafo real do curso e um grafo de milhares de nós se organizarem em aglomerados
Rode o layout no grafo real, passe o mouse pelos nós e busque uma entidade; troque para 20 mil nós e leia o medidor; depois carregue o modo massivo na placa de vídeo.
Pacote
Abrir no capítuloAnimar um grafo de conhecimento amplo em movimentosigma, graphology, graphology-layout-forceatlas2, graphology-generators, @cosmos.gl/graph
Capítulos vizinhos em Frontends com Vibecoding
- 01Enxergar as três camadas de uma tela e o custo de manter
- 02Escrever o pedido de uma tela sem deixar buraco
- 03Levar o repertório da marca para o briefing antes do prompt
- 04Dirigir o prompt e avaliar a entrega do agente
- 05Escolher a stack e projetar suas dependências