A Revolução Silenciosa do "Vibe Coding"

Há uma revolução silenciosa acontecendo na forma como construímos software, e ela não tem nada a ver com um novo framework JavaScript. Trata-se de uma mudança em quem — ou o que — faz o trabalho pesado.

Imagine este cenário: Você está esperando um voo. Você tem uma ideia. Quando aterrissa, você não tem apenas anotações no telefone; você tem um MVP totalmente implantado com banco de dados, autenticação e frontend, rodando ao vivo em uma URL. Você não escreveu uma única linha de sintaxe. Você apenas gerenciou o fluxo.

Isso não é ficção científica. É o que as pessoas estão começando a chamar de "Vibe Coding" (codificação baseada na vibe/fluxo), e isso está mudando fundamentalmente a economia das startups.

A maioria dos fundadores ainda está presa no antigo ciclo: Ideia -> Contratar/Codar -> Debugar -> Deploy. Esse ciclo é muito lento. O novo ciclo se parece com isto: Contexto -> Agente de IA -> Verificação.

Passei as últimas semanas refinando uma stack que automatiza a parte complicada do meio do desenvolvimento. Isso me permite rodar dez potenciais MVPs em ciclos paralelos. Aqui está a configuração exata, o fluxo de trabalho e a verdade nua e crua sobre onde isso falha.

A Stack "Vibe"

Para fazer isso funcionar, você precisa de ferramentas que conversem entre si. Não estamos procurando as soluções corporativas mais complexas; queremos velocidade e integração. Aqui está o kit de ferramentas:

1. Framework: create-t3-turbo (Uma configuração de monorepo construída sobre o Turborepo que lida com frontend e backend em um só lugar. Inclui Next.js, tRPC, Tailwind e Prisma. Perfeito para MVPs).
2. Cérebro: Claude Code (A ferramenta CLI que atua como seu engenheiro líder).
3. Gerenciamento de Projetos: Linear (A fonte da verdade).
4. Rastreamento: GitHub Issues (Sincronizado com o Linear).
5. Infraestrutura: Vercel (Hospedagem) + Neon (Postgres Serverless).

Tanto a Vercel quanto a Neon têm planos gratuitos generosos, o que significa que seu custo para experimentar é efetivamente zero.

A Fase de Configuração

Antes de escrever uma linha de código, você precisa "conectar a fiação" da máquina. Aqui está o processo exato de configuração:

1. Inicialize o Projeto

Comece criando um novo projeto create-t3-turbo. Isso lhe dá uma estrutura de monorepo pronta para produção com tudo configurado:

npx create-turbo@latest -e https://github.com/t3-oss/create-t3-turbo

Este comando cria o esqueleto de uma stack completa com Next.js para o frontend, tRPC para APIs type-safe, Prisma para gerenciamento de banco de dados e Tailwind CSS para estilização — tudo em uma estrutura de monorepo Turborepo.

2. Instale o Claude Code

Em seguida, instale o Claude Code, seu assistente de desenvolvimento impulsionado por IA. Siga o guia de instalação em code.claude.com. Uma vez instalado, você pode iniciá-lo do diretório do seu projeto:

claude

3. Configure a Integração com GitHub Actions

Dentro da CLI do Claude Code, instale a integração do GitHub Actions executando:

/install-github-app

Este comando configura o bot do GitHub Actions que permitirá ao Claude criar pull requests, rodar workflows de CI/CD e interagir com seu repositório. A integração permite que o Claude execute alterações de código através de fluxos de trabalho automatizados em vez de apenas sugeri-los. Para instruções detalhadas de configuração, veja a documentação oficial do GitHub Actions.

4. Conecte o Linear ao GitHub

A mágica acontece quando você conecta o Linear ao GitHub para sincronização bidirecional de issues. Veja como:

1. Vá para a página de integração do Linear com GitHub
2. Clique em "Add Integration" e autorize o Linear a acessar sua conta do GitHub
3. Selecione o repositório que você deseja sincronizar
4. Configure as definições de sincronização:
   • Sincronização bidirecional: Issues criadas no GitHub aparecem automaticamente no Linear, e vice-versa
   • Mapeamento de status: Mapeie os estados do fluxo de trabalho do Linear (Todo, In Progress, Done) para os estados das issues do GitHub
   • Sincronização de prioridade: Mantenha os níveis de prioridade sincronizados entre ambas as plataformas
   • Linkagem automática: Vincule automaticamente branches e PRs às issues do Linear usando IDs de issue

Uma vez configurado, quando uma issue é criada no GitHub, ela aparece no Linear. Quando você atualiza a prioridade ou status no Linear, a mudança reflete no GitHub. Isso cria um fluxo de trabalho unificado onde você pode gerenciar tarefas de qualquer plataforma.

5. Implante a Infraestrutura

Finalmente, faça o deploy na Vercel com um banco de dados Neon:

• Conecte seu repositório GitHub à Vercel
• Provisione um banco de dados Postgres serverless na Neon (plano gratuito disponível)
• Adicione a string de conexão do banco de dados às suas variáveis de ambiente na Vercel

Uma vez implantado, você agora tem um pipeline de integração contínua que vai dos seus pensamentos até uma URL ao vivo. Cada merge para a branch main faz o deploy automático para produção.

O Fluxo de Trabalho Automatizado

É aqui que o papel tradicional do Gerente de Produto (PM) começa a desaparecer.

1. A Sessão de Contexto

Se você tem uma ideia, não abra uma IDE. Abra uma janela de chat. Converse com o ChatGPT ou Claude, despejando seus pensamentos brutos. Deixe a IA desafiar você. Ao final desta sessão, peça para ela gerar um PRD (Documento de Requisitos do Produto) em formato Markdown.

O que você recebe de volta geralmente é melhor do que o que a maioria dos PMs de nível médio produz. É detalhado, estruturado e profissional.

Insight: Acredito que o papel dedicado de "Gerente de Produto" será o primeiro a ser disruptado pela IA. Estamos caminhando para um mundo de "Product Designers" ou "Criadores Full-Stack" que cuidam da visão, enquanto a IA cuida das especificações.

2. O Handoff (A Passagem de Bastão)

Alimente esse PRD em Markdown para o seu Claude Code local. Este é o passo crucial onde a IA transforma requisitos em itens de trabalho acionáveis.

Dentro da CLI do Claude Code, instrua-o a analisar o PRD e gerar GitHub Issues. O Claude Code usa a GitHub CLI (gh) nos bastidores para interagir com seu repositório. Eis o que acontece:

1. Análise: O Claude analisa o PRD e o quebra em tarefas discretas e acionáveis
2. Criação de Issues: Para cada tarefa, o Claude roda comandos como:

   gh issue create --title "Implement user authentication" \
     --body "Details from PRD..." \
     --label "feature" \
     --assignee "@me"
   

3. Atribuição de Metadados: O Claude atribui automaticamente labels (feature, bug, enhancement), prioridades e até estimativas baseadas na complexidade descrita no PRD
4. Mapeamento de Dependências: Se a integração do GitHub Actions estiver configurada, o Claude também pode criar dependências de issues e marcos (milestones)

A beleza de usar a CLI gh é que ela é programável — o Claude pode criar dezenas de issues em lote em segundos, cada uma formatada corretamente com descrições em markdown, critérios de aceitação e notas técnicas.

De repente, seu quadro no Linear se ilumina. Graças à sincronização Linear-GitHub que você configurou anteriormente, você verá de 10 a 20 tickets aparecendo automaticamente — devidamente intitulados, com descrições detalhadas, prioridades e status. Todo o backlog que levaria horas para um PM criar manualmente é gerado em menos de um minuto.

3. A Execução

Agora, você atua como o Gerente de Engenharia. Você marca @claude nas issues para começar a trabalhar nos tickets. O Claude escreve o código no GitHub Actions, cria o Pull Request e aguarda revisão.

Você faz o merge.

O CI/CD da Vercel entra em ação. Minutos depois, as mudanças estão no ar.

A beleza disso é que pode acontecer no seu telefone. Você está revisando PRs e gerenciando o quadro de um táxi ou de um café. Você não está digitando boilerplate genérico de React; você está dirigindo uma equipe de construção de alta velocidade.

O Problema da "Última Milha"

Se você parar de ler aqui, pode pensar que a IA resolveu tudo. Não resolveu.

Embora o "Vibe Coding" seja poderoso, precisamos ser honestos sobre suas limitações. A IA é incrível no "trabalho sujo" e no "trabalho árduo". Ela pode montar um esquema de banco de dados, construir um formulário de login e configurar rotas de API mais rápido do que qualquer humano.

Mas ela luta com a alma do produto.

Pense nisso como construir uma casa. A IA é sua equipe de estrutura e alvenaria. Eles podem despejar o concreto, levantar as vigas e colocar o drywall em tempo recorde. Mas eles são péssimos designers de interiores. Eles não sabem que o interruptor de luz parece errado naquele canto, ou que o fluxo da cozinha faz as pessoas esbarrarem umas nas outras.

No software, essa é a "Última Milha". As interações que encantam os usuários, as animações sutis de UI, os casos extremos na lógica de negócios — é aqui que você, o construtor humano, deve intervir.

Se você confiar 100% na IA para finalizar o produto, acabará com um software que funciona tecnicamente, mas parece emocionalmente vazio. Faltará aquele "artesanato" que separa grandes produtos dos genéricos.

Conclusões Práticas

Se você quiser tentar isso hoje, aqui está meu conselho:

• Comece com o PRD: Nunca peça para a IA "apenas codar". A qualidade do código é consequência da qualidade do PRD. Gaste sua energia refinando o texto dos requisitos, não a sintaxe do código.
• Confie, mas Verifique: Agentes de codificação de IA podem alucinar dependências ou escrever lógica insegura. Leia os diffs. Trate a IA como um desenvolvedor talentoso, porém júnior.
• Abrace o Volume: Use essa velocidade para testar mais ideias. Se você pode construir um MVP em um fim de semana em vez de um mês, suas chances de encontrar o Product-Market Fit aumentam exponencialmente.

A barreira para construir desapareceu. A única coisa que resta é o seu bom gosto e a sua persistência.