O problema não é você. O tutorial foi escrito por dev, pra dev.

Quero contar como um tutorial de programação é escrito, porque eu já escrevi muitos.

O autor senta pra explicar como publicar um app. Ele faz isso há anos, então o cérebro dele já comprimiu a tarefa inteira em quatro passos. Ele escreve os quatro passos. Relê, acha claro, publica. E está sendo honesto: pra ele, aquilo é o procedimento completo.

O que ele não vê é que entre o passo 1 e o passo 2 existem onze coisas que ele faz no automático. Instalar uma ferramenta que ele instalou uma vez em 2019 e nunca mais pensou. Ter uma conta num serviço que ele já tinha. Saber que aquela mensagem vermelha no terminal é aviso e não erro. Saber que quando o comando não devolve nada, deu certo.

Aí você chega. Faz o passo 1. Trava na etapa quatro do buraco entre o 1 e o 2. E a internet inteira te dá a mesma resposta:

"É só rodar npm install."

Isso não é uma explicação. É uma senha de clube.

As 15 etapas que somem

Peguei um caso que aparece toda semana: publicar na internet um app que a IA gerou. O tutorial diz três passos. O caminho real, pra quem nunca fez, tem uns dezoito. Estes são os que quase sempre somem do texto:

1. Instalar o Node — e descobrir que existem versões, e que a errada quebra tudo
2. Descobrir o que é terminal, e onde ele fica no seu sistema
3. Entender que cd muda de pasta, e que a pasta importa
4. Saber que npm install baixa coisas e demora, e que aquilo é normal
5. Entender que localhost:3000 é o seu computador falando com ele mesmo
6. Descobrir que fechar o terminal derruba o site
7. Criar conta no serviço de publicação — e escolher entre três planos sem saber a diferença
8. Entender o que é uma variável de ambiente (um valor que fica guardado fora do código, tipo senha)
9. Descobrir que as variáveis que funcionavam na sua máquina não vão junto no envio
10. Descobrir isso depois que o site publicado ficou em branco, sem nenhuma mensagem
11. Achar o log (o registro do que aconteceu) num painel que ninguém te mostrou
12. Ler uma mensagem de erro em inglês escrita para quem já sabe o que ela significa
13. Entender a diferença entre o que roda no seu navegador e o que roda no servidor
14. Descobrir que chave secreta não pode ficar do lado do navegador
15. Comprar um domínio e ligar ele no serviço, o que envolve DNS, que ninguém explicou

Nenhuma dessas quinze é difícil. Todas juntas, sem mapa e com mensagem de erro em inglês, são uma parede.

E olha o detalhe que me irrita: o autor do tutorial não escondeu nada de propósito. Ele não enxerga mais essas etapas. É o que acontece com qualquer perícia — você para de ver os degraus que já subiu. O problema não é má fé individual, é que a categoria inteira normalizou escrever assim e chamar o resultado de documentação.

A conclusão errada que te vendem

O que acontece depois é o que me faz escrever este post.

Você trava. Procura ajuda. E encontra três respostas padrão:

"É só..." — seguida de qualquer coisa que não é só.

"Isso é básico." — que não informa nada sobre a tarefa e informa tudo sobre quem escreveu.

"Vibe coding não presta, contrata um dev." — a única com interesse comercial embutido.

Daí sai a conclusão que quase todo mundo tira sozinho: eu não tenho perfil pra isso.

Essa conclusão é falsa, e ela é cara. Ela faz gente que estava a seis horas de ter o próprio problema resolvido desistir e voltar a esperar o setor de TI.

O que aconteceu ali não foi falta de perfil. Foi ausência de documentação para o seu ponto de partida. São coisas completamente diferentes, e a segunda tem conserto.

Sobre o desprezo

Tem uma camada a mais, e ela é feia. Vou citar sem edição, porque a versão suavizada não mostra o tamanho da coisa. Isso é um programador falando de gente como você, em fórum público brasileiro:

"Esses energuminos são tão limitados tecnicamente que eles se acham especiais por pagarem uma assinatura do lovable e conseguirem fazer um app CRUD..."

E tem a variação educada, que é mais comum e igualmente eficaz:

"SaaS banalizou porque o sobrinho 'faz'."

Eu programo há quinze anos e faço questão de me posicionar do outro lado dessa linha.

Isso não é preocupação com qualidade. Quem se preocupa com qualidade escreve o tutorial que faltava. Quem despreza está fazendo outra coisa: defendendo a assimetria de informação de que dependia o valor dele.

Repare no que o desdém nunca inclui. Nunca vem junto o passo a passo. Nunca vem "olha, o ponto onde você travou é este, e resolve assim". Vem só a fronteira, reafirmada.

E existe um motivo pra isso ter aumentado justamente agora. Durante muito tempo, saber montar um cadastro com login e banco de dados era um diferencial que se cobrava caro. Hoje a IA faz a primeira versão disso em minutos. Quem construiu identidade profissional em cima daquela habilidade específica está com medo — e medo, em fórum público, sai como deboche.

Vou dizer o que eu realmente penso: o valor de um bom programador nunca esteve em digitar o CRUD. Está em saber o que dá errado com o tempo, o que quebra quando dobra o número de usuários, onde vaza dado, o que é reversível e o que não é. Nada disso a IA entrega pronto. Quem tem essa competência não perdeu nada — só precisa parar de fingir que ela mora no npm install.

O reframe que eu te ofereço

Você não vai virar programador. Não precisa e, na maioria dos casos, nem deveria querer.

Você vai virar dono: quem manda, quem define e quem confere.

Traduzindo em prática, é conseguir fazer estas coisas — nenhuma delas exige escrever código:

• Descrever o que quer com precisão suficiente pra IA não inventar o resto
• Reconhecer que ela entrou em loop, antes do terceiro crédito queimado
• Exigir prova de que a correção aconteceu, em vez de aceitar "pronto, corrigido"
• Rodar a bateria de testes que mostra o que quebrou depois da última mudança
• Saber que checar permissão só na tela não protege nada
• Ter backup e saber voltar atrás
• Reconhecer o dia em que faz sentido chamar um profissional — e chegar nele sabendo o que pedir

É um conjunto pequeno e finito de conceitos. Não são quatro anos de faculdade. É o que a sua categoria de tutorial não escreveu.

E é o que eu vou escrever aqui.

Como usar este blog

Toda vez que você travar em alguma coisa e a resposta que encontrar for "é só", trate isso como sinal de que o degrau existe e não foi escrito. Não como sinal de que você é lento.

Se for uma das paredes que eu já mapeei, o post tá aqui. Se não for, me manda — sério. As perguntas que chegam aqui viram os próximos posts, e cada uma vale mais do que qualquer palpite meu sobre o que "as pessoas devem estar querendo saber".

Você não é intruso nisso aqui. Você é o dono.