🏗️ Construir & Publicar

A regra "55-5": de 60 minutos, invista ~55 entendendo o problema e só ~5 na pressa da solução. A maioria dos tutoriais pula direto pro código — não faça isso.

Um problema mal definido gera um app que ninguém usa. Clareza no início economiza horas de retrabalho.

Definição de problema · regra 55-5 · evitar a pressa do código.

Use a IA como parceira de treino: peça que ela desafie seu raciocínio e ajude a definir o problema. Depois, peça um SOP (procedimento) curto, com no máximo 800 caracteres.

O contraponto da IA expõe furos cedo; o SOP vira o roteiro que guia a construção.

Sparring · desafiar o raciocínio · SOP ≤ 800 caracteres.

Alimente o agente com referências visuais (screenshots de sites que você gosta). A IA é ótima em design, mas fica muito melhor com especificidade.

"Faça bonito" é vago; um print de referência transmite intenção visual em segundos.

Referência visual · especificidade · galerias (Awwwards, Dribbble, Mobbin, Land-book).

No Agent Manager você gerencia vários agentes e projetos ao mesmo tempo. Cada workspace = um projeto, e você se move muito mais rápido.

Paralelizar multiplica sua produção: enquanto um agente trabalha, você revisa ou inicia outro.

Agent Manager · workspace por projeto · paralelismo.

Trate cada agente como um funcionário: dê tarefas SEPARADAS. Nunca ponha dois agentes na mesma tarefa — eles colidem e se atrapalham.

É como uma equipe onde ninguém faz o trabalho do outro: menos conflito, mais avanço.

Divisão de trabalho · evitar colisão · um agente, uma tarefa.

Ponha o agente em modo de planejamento: ele propõe um plano, você revisa e aprova como faria com um empregado. Ações ficam aguardando aprovação no inbox.

Aprovar o plano antes da execução evita que o agente saia construindo a coisa errada.

Planning mode · revisão · aprovação no inbox.

Um arquivo .md (ex.: Gemini.md) com as regras do projeto — fonte, cores, propósito — que o agente relê sempre. Sobrevive ao "estouro" da janela de contexto. Um research.md guarda pesquisa reutilizável.

É a memória de longo prazo do projeto: o agente não "esquece" suas decisões.

Arquivo de contexto · janela de contexto · research.md.

MCP (Model Context Protocol) é a "língua universal" que permite apps e serviços conversarem. Conecte um banco (Supabase) via token e o agente cria o projeto e escreve o SQL sozinho.

Com um banco conectado, seu app guarda dados de verdade — sem você escrever SQL na mão.

MCP · token · Supabase · SQL gerado pelo agente.

Conecte o AntiGravity ao GitHub via MCP para gerenciar e publicar repositórios direto do editor. Exige um Personal Access Token (fine-grained, com validade) e o Docker instalado para a integração funcionar.

Publicar sem sair do editor reduz fricção e mantém tudo num fluxo só.

GitHub MCP · Personal Access Token · Docker.

A Vercel é a "ponte" do GitHub para o mundo: hospedagem em produção. Add New → Project → importar o repo → publicar, e o app fica no ar.

É o passo que transforma um projeto local em algo que qualquer pessoa acessa por um link.

Hospedagem · importar repo · produção.

Para proteger chaves de API, o agente só nomeia a variável; você cola a chave dentro da Vercel (Settings → Environment Variables) e dá Redeploy. A chave nunca aparece no código.

Chave exposta no código é o erro nº 1 de segurança — e pode custar caro.

Env var · nomear vs. valor · Redeploy.

Habilite Analytics e Speed Insights no painel da Vercel e instale o pacote pelo terminal (npm). Você passa a acompanhar acessos e performance, com um plano grátis generoso.

Sem dados, você adivinha. Com dados, você melhora o que importa.

Analytics · Speed Insights · npm · plano grátis.

Quando o build falha, tire um screenshot dos logs de erro e mande pro agente: "houve um erro no deploy, corrija". Use o DevTools (Console/Network) e mande o print do erro.

A imagem dá ao agente o contexto exato — ele corrige muito mais rápido.

Logs de erro · screenshot · DevTools (Console/Network).

Comite com frequência. História real: codar 6 horas sem commitar e perder a melhor versão. O controle de versão é a sua rede de segurança.

Cada commit é um ponto de retorno seguro — você nunca perde mais do que o último pedaço.

Commit frequente · histórico · ponto de retorno.

Na Vercel: Deployments → escolha a versão anterior estável → Redeploy. É "voltar no tempo". Também dá pra reverter pelo GitHub.

Um deploy ruim deixa de ser pânico: você restaura a versão boa em segundos.

Deployments · versão estável · Redeploy · reverter no GitHub.

Defina um budget de gasto na API para não tomar uma conta gigante. E torne o repositório privado depois de publicado.

Limite de gasto evita sustos na fatura; repo privado protege seu código e suas chaves.

Budget de API · teto de gasto · repositório privado.