Vibe Coding — a tua primeira app sem saber programar — 1. O que é o vibe coding?

17 min read min de lecture
Capítulo 01

O que é o vibe coding?

Capítulo 1 de 10 · 10%

Objetivos deste capítulo

  • Compreender o princípio do vibe coding
  • Conhecer as suas forças e os seus limites
  • Adotar a mentalidade certa

O princípio

Descreves em linguagem natural o que queres, a IA gera o código, tu testas e afinas. Não precisas de conhecer a sintaxe — mas tens de saber descrever claramente e testar o que sai. É uma verdadeira deslocação de competência: o esforço já não recai sobre a escrita do código, mas sobre a precisão do teu pensamento.

Concretamente, uma sessão de vibe coding parece-se com uma conversa. Escreves «quero uma página com um botão que adiciona um hábito a uma lista», a IA produz o ficheiro correspondente, abres a pré-visualização, clicas, e constatas o que funciona ou não. Depois reformulas: «o botão funciona, mas a lista desaparece quando recarrego a página — faz com que fique guardada». E assim sucessivamente, até a app fazer exatamente o que querias.

Este modo de trabalho explodiu com os assistentes como o Claude, o ChatGPT e os editores especializados como o Cursor. O termo «vibe coding» foi popularizado no início de 2025 por Andrej Karpathy, um investigador em IA, para descrever esta forma de programar deixando-se levar pelo diálogo em vez de digitar cada linha. Por trás do lado descontraído do nome esconde-se um método sério — aquele que vais aprender aqui.

flowchart LR
  D["Descreves em linguagem natural"] --> G["A IA gera o código"]
  G --> T["Testas o resultado"]
  T --> A["Afinas o pedido"]
  A --> D
O ciclo do vibe coding: descrever, gerar, testar, afinar.

Porque é que funciona agora

Há cinco anos, pedir a um computador «faz-me uma app de acompanhamento de hábitos» era ficção científica. Hoje, os grandes modelos de linguagem foram treinados com milhares de milhões de linhas de código público: conhecem os padrões recorrentes do desenvolvimento web muito melhor do que qualquer humano poderia memorizar. Uma página com uma lista, botões e armazenamento local é um problema que eles já «viram» dezenas de milhares de vezes.

Isto explica também os limites. A IA é excelente no que é comum e documentado; é menos fiável no que é raro, muito recente ou muito específico ao teu contexto. Para uma primeira app web clássica, estás em plena zona de conforto dela — e é exatamente por isso que este curso começa com um projeto simples.

O que isto permite (e o que não)

Ideal paraprotótipos, landing pages, ferramentas internas, MVP, pequenas automatizações, apps pessoais ou de turma.
Mais arriscado parasistemas críticos (saúde, banca), segurança sensível, dados pessoais em grande escala, carga muito elevada.

Começa pequeno, irás subindo em complexidade. O Tom não pretende uma app para 10 000 utilizadores: quer uma ferramenta simples e útil, já. Esta modéstia não é um defeito, é uma estratégia. Uma pequena app terminada e usada ensina-te cem vezes mais do que um grande projeto abandonado aos 20 %.

A fronteira entre «ideal» e «arriscado» depende sobretudo das consequências de um erro. Se a app do Tom perder uma marcação de hábito, é chato mas sem gravidade. Se uma app bancária perder uma transação, é um desastre. Em vibe coding iniciante, escolhe projetos em que o pior bug possível permaneça inofensivo: poderás experimentar livremente, sem stress.

O vibe coding não substitui a compreensão — acelera-a. Quanto mais compreendes o que lês, mais longe vais. Habitua-te a pedir à IA que explique o que acabou de fazer: é uma explicação particular grátis, integrada na tua ferramenta.

A mentalidade certa

Tu és o chefe de projeto, a IA é o teu programador. Descreves a intenção, verificas o resultado, pedes ajustes. O teu valor é a clareza dos teus pedidos e o teu rigor de teste. Um bom chefe de projeto não sabe necessariamente assentar tijolos, mas sabe distinguir uma parede direita de uma parede inclinada.

Este papel implica duas atitudes. Primeiro, a curiosidade sem complexos: tens o direito de não perceber nada de uma linha de código e de pedir «explica-me esta parte como se eu tivesse dez anos». Depois, o ceticismo benevolente: a IA engana-se por vezes com um aplomb total. Pode afirmar que uma funcionalidade funciona quando nunca a testou — quem testa és tu, sempre.

Prepara-te também para uma montanha-russa emocional. A primeira geração que funciona à primeira vai dar-te uma sensação de omnipotência; o primeiro bug incompreensível vai dar-te vontade de fechar tudo. Ambos são normais. Os vibe coders que têm sucesso não são os que nunca têm bugs, são os que têm um método para os atravessar — vais aprendê-lo no capítulo 4.

As armadilhas clássicas do iniciante

  • Pedir tudo de uma vez: um prompt de 40 linhas que descreve 12 funcionalidades produz uma app meio partida, impossível de depurar.
  • Nunca testar: encadear cinco pedidos sem abrir a pré-visualização, e depois descobrir que já nada funciona sem saber desde quando.
  • Aceitar sem ler: validar cada proposta da IA sem sequer passar os olhos pelo que ela diz — perdes toda a capacidade de compreender o teu projeto.
  • Mudar de ideia a cada sessão: começar uma app de receitas na segunda, um jogo na terça, um blog na quarta. Nenhum projeto passa da fase de rascunho.
  • Acreditar que é magia: a IA é uma ferramenta poderosa mas imperfeita; a tua atenção e o teu método fazem a diferença entre um brinquedo e uma verdadeira app.
Se só retiveres uma regra de todo este capítulo: um pedido de cada vez, um teste após cada pedido. Esta disciplina simples vai poupar-te 80 % das dores de cabeça de iniciante.

Mini-glossário para arrancar bem

  • Prompt: a mensagem que escreves à IA para lhe pedir algo.
  • Gerar: a ação da IA que produz código a partir do teu pedido.
  • App web: uma aplicação que corre num navegador, sem instalação, acessível por um endereço (URL).
  • MVP (Minimum Viable Product): a versão mais simples da tua app que já é útil.
  • Iterar: melhorar por pequenos retoques sucessivos, em vez de fazer tudo de uma vez.
  • Bug: um comportamento da app diferente do que esperavas.

Vais cruzar-te com estas palavras ao longo do curso e nas tuas trocas com a IA. Não precisas de as decorar: volta a esta lista quando um termo te bloquear, e nunca hesites em perguntar à própria IA «o que é um MVP?». O vocabulário vem com a prática.

O projeto condutor deste curso

Para tornar tudo isto concreto, vais seguir o Tom do início ao fim. Capítulo 2: ele escolhe a ferramenta. Capítulo 3: redige a descrição da app de acompanhamento de hábitos. Capítulo 4: constrói-a funcionalidade a funcionalidade e corrige os bugs. Capítulo 5: põe-na online e partilha-a com os alunos. A cada etapa, farás o mesmo com a tua própria ideia de app — é a melhor forma de aprender.

🛠️ É a tua vez

Contexto

O Tom ainda hesita: a ideia da app de acompanhamento de hábitos é uma boa candidata ao vibe coding? Antes de avançar, quer verificar se o projeto tem o tamanho certo — nem demasiado ambicioso, nem demasiado vago. Faz o mesmo exercício com a tua própria ideia: é ela que vais construir durante todo o curso.

Instruções

  1. Escreve numa frase a app que gostarias de criar («uma app que… para…»).
  2. Classifica-a honestamente: protótipo/ferramenta simples, ou sistema crítico com dados sensíveis?
  3. Pergunta-te qual seria o pior bug possível: se for inofensivo, o projeto está bem calibrado.
  4. Divide a tua ideia em 3 a 5 ações concretas que o utilizador poderá fazer.
  5. Lista o que terás de testar para saber se cada ação funciona.
  6. Se ela for simples e testável em 2 minutos, guarda-a para o resto do curso.
Dica — Uma boa primeira app testa-se em 2 minutos e cabe num ecrã. Se precisas de contas de utilizador, de pagamentos ou de notificações para a v1, simplifica ainda mais.

Em resumo

  • Vibe coding: tu descreves, a IA programa, tu testas e afinas — em ciclo.
  • Funciona porque a IA conhece de cor os padrões comuns da web.
  • Ideal para protótipos e ferramentas simples; prudência com o crítico e o sensível.
  • A IA acelera a compreensão, não a substitui: pede explicações.
  • És chefe de projeto: clareza dos pedidos e rigor de teste.
  • Regra de ouro: um pedido de cada vez, um teste após cada pedido.
  • Escolhe um projeto cujo pior bug possível permaneça inofensivo.

Quiz — verifica a tua compreensão

1. O que precisas de saber fazer em vibe coding?

A clareza da descrição e o teste do resultado são as tuas verdadeiras competências. A sintaxe é trabalho da IA.

2. Que projeto é um bom primeiro candidato?

Começa-se pequeno, depois sobe-se em complexidade. Uma pequena app terminada vale mais do que um grande projeto abandonado.

3. Porque é que a IA está tão à vontade numa app web simples?

Os modelos viram dezenas de milhares de variantes dos problemas comuns da web: é a zona de conforto deles.

4. A IA afirma que uma funcionalidade funciona. O que fazes?

A IA pode enganar-se com aplomb: não testa realmente a tua app. A verificação é o teu papel.

5. Qual é a armadilha de iniciante mais frequente?

Um prompt-rio de 12 funcionalidades produz uma app meio partida, impossível de depurar. Um pedido de cada vez.

Auteur(s)

R

REHOUMA Haythem

Haythem Rehouma est un ingénieur et architecte IA et cloud, formateur et enseignant technique, avec un profil orienté IA médicale, AWS, MLOps, LLM/RAG et vision par ordinateur.