vibe-build

Vibe Build

Um fluxo de trabalho completo de construção que o agente executa de forma autônoma. O usuário toma decisões de produto; você toma decisões de processo. Nunca peça ao usuário para explicar o fluxo de trabalho — siga-o. Pergunte ao usuário apenas sobre o que construir, preferências e aprovação nos portões.

A única regra

Decisões de produto = entrada do usuário. Processo = seu. Antes de perguntar qualquer coisa ao usuário, verifique se é uma decisão de produto. Se não for, decida você mesmo e siga em frente.

Fase 0 — Inicialização (apenas projetos novos)

1. Identifique o stack. Se o projeto estiver completamente indefinido, faça exatamente uma pergunta: "O que devemos construir? (uma frase é suficiente)". Não faça entrevista.
2. Pesquise o stack você mesmo: versões atuais dos frameworks, configuração recomendada e layout padrão do projeto, usando pesquisa na web e documentação dos frameworks (use a capacidade de consulta de documentação do projeto ou pesquisa na web). Resuma as decisões em no máximo 5 linhas — não cole muralhas de pesquisa para o usuário.
3. Escreva AGENTS.md na raiz do projeto usando o template em references/agentsmd-template.md. Esta é a constituição do projeto: toda fase posterior a lê antes de decisões estruturais, para que o usuário nunca precise reexplicar convenções.
4. Instale skills temporárias que o projeto precisar (máx. 5), seguindo references/temp-skills.md. Pule a instalação de skills completamente se o projeto for simples ou se suas skills existentes já cobrirem.
5. Relate a inicialização em ≤ 15 linhas, apresente seu plano numerado proposto e aguarde aprovação antes de escrever qualquer código do projeto.

Fase 1 — Planejar

• Produza um plano numerado e com escopo definido. Tarefas pequenas que você pode fazer em uma sessão, itens explicitamente adiados para depois.
• Obtenha aprovação explícita. Se o usuário editar o plano, as edições vencem.
• Cuidado com intercalação: não comece a construir enquanto o plano ainda estiver aberto.

Fase 2 — Construir

• Siga a disciplina de testes quando for adequada ao projeto: testes para lógica, verificação manual para cola descartável. Não invente frameworks de teste pesados para construções simples; não pule testes para lógica onde um bug causaria dano.
• Mantenha as dependências mínimas. Cada dependência é um passivo que o usuário herda — prefira stdlib/sem dependências a menos que haja um ganho claro.
• Verifique AGENTS.md antes de cada decisão estrutural. Faça commits em pequenos passos nomeados para que o trabalho seja bissecável.

Fase 3 — Verificar (antes de declarar "pronto")

Execute o projeto, então prove que funciona:

• UI existe → percorra-a em um navegador real (Playwright ou a ferramenta de navegador do seu agente), verifique erros no console, valide os fluxos principais de ponta a ponta.
• Web UI → audite acessibilidade e qualidade de interação (estados de foco, formulários, modo escuro, toque): use uma skill de revisão de diretrizes de design se disponível, caso contrário faça a verificação manual.
• Autenticação, segredos, pagamentos ou entrada do usuário envolvidos → faça uma passada de segurança: validação de entrada, tratamento de segredos (nunca commite segredos; use substituição de env), padrões de privilégio mínimo.
• Evidências antes de afirmações: relate o que foi executado e o que passou, ou admita a falha e corrija primeiro.

Fase 4 — Implantar

• "Implantar / subir ao vivo / link de pré-visualização" → implante pelo caminho documentado do projeto. Para projetos hospedáveis no Vercel, faça git-push para o projeto vinculado, recorra a vercel deploy --temporary quando não existir login, e devolva a URL.
• Pull requests: corpo conciso — o que mudou, por que, como testar — não narração do diff.
• Um commit "pronto" significa que a construção+testes passam com as evidências que você acabou de coletar.

Fase 5 — Higiene de skills temporárias

Skills temporárias (Fase 0 passo 4) têm escopo de projeto. Ao final do projeto ou quando uma skill temporária se mostrar amplamente útil, recomende promovê-la ao diretório de skills compartilhadas do usuário (ou excluí-la). Nunca deixe skills temporárias se transformarem silenciosamente em instalações globais permanentes.

Economia de tokens (todas as fases)

Leia o menor intervalo de arquivo suficiente; não releia arquivos inteiros que você já viu. Resuma uma fase concluída uma vez em vez de narrar cada passo. Prefira executar scripts e ferramentas a colar seus conteúdos no chat. Deixe as skills carregarem preguiçosamente por gatilho — nunca despeje o corpo de uma skill na conversa.

Referências

• references/agentsmd-template.md — leia e preencha durante a Fase 0 passo 3.
• references/temp-skills.md — leia durante a Fase 0 passo 4, antes de instalar qualquer skill temporária.