Porque se tornam frustrantes as ferramentas de IA: um mapa prático de aprendizagem

Encontrará mais instruções para trabalhar com o Ailoot na documentação.

Uma metáfora de aprendizagem, não uma lei psicológica universal#

A pergunta prática deste artigo é mais limitada do que um diagnóstico psicológico: as suas expectativas correspondem aos resultados que consegue verificar? Compare o que esperava concluir com o que funciona efetivamente e ajuste a tarefa seguinte com base nessa evidência.

Não use só a confiança como medida de competência; inspecione um resultado real e as verificações que o sustentam.

Desde então, a curva de Dunning–Kruger tornou-se uma ilustração popular de quatro fases. Primeiro, a confiança dispara até ao «Pico do Monte da Estupidez». Depois, desaba no «Vale do Desespero». A seguir, sobe lentamente a «Encosta da Iluminação», em direção ao «Planalto da Sustentabilidade».

A curva é uma metáfora usada neste artigo. Nenhum estudo dos seus leitores estabelece uma taxa de desistência, uma duração fixa da aprendizagem ou um percurso universal por estes rótulos.

As 4 fases da programação por vibe — em que fase está agora?#

É possível reconhecer cada fase pelos pensamentos e comportamentos típicos. Aqui está o mapa.

Fase 1 — Pico do Monte da Estupidez

Lê um artigo sobre Claude Code. Talvez tenha visto um vídeo. Tudo parece claro: instalar a ferramenta, escrever um prompt, obter código. Os autores dos artigos descrevem como «criaram um SaaS numa noite». Também quer fazer isso numa noite.

Pensamentos na sua cabeça:

• «Acho que percebi.»
• «É só um chat, mas mais inteligente.»
• «Sou empreendedor; não preciso de programadores.»
• «Vou dominá-lo num mês e partir para o Dubai.»

Comportamento:

• Descarrega e instala o Claude Code.
• Escreve «Cria-me uma aplicação de reservas» no chat.
• Obtém código que não funciona.
• Pensa que o modelo está errado e compra uma subscrição Max.

Este é um possível ponto de partida. Se as expectativas continuarem desligadas de um resultado funcional, a frustração pode crescer; um projeto pequeno e verificações explícitas dão-lhe algo concreto com que aprender.

Para uma autoavaliação prática, peça a outra pessoa que inspecione o mesmo resultado segundo critérios explícitos. Uma autodescrição confiante, como «especialista em IA», não estabelece a qualidade de um resultado gerado.

Trate uma primeira impressão confiante como hipótese. Execute o código, inspecione a saída e deixe o resultado alterar a estimativa do que consegue fazer.

Fase 2 — Vale do Desespero

Aprofunda-se. Lê sobre MCP e tenta ligar um servidor. Descarrega uma Skill pronta e tenta perceber como funciona. Inicia o Plan Mode — o agente escreve um plano e depois desvia-se do rumo no terceiro passo. Abre ~/.claude/ — há 12 pastas e não percebe para que serve nenhuma delas.

Pensamentos na sua cabeça:

• «Não sei fazer absolutamente nada.»
• «Todas aquelas pessoas nas redes sociais estão só a mentir.»
• «O que funciona para os outros não funciona comigo.»
• «Se calhar estou a meter-me nisto demasiado cedo.»
• «Gastei $200 em tokens — e o que é que tenho para mostrar?»

Comportamento:

• Abre 20 separadores de documentação ao mesmo tempo.
• Todas as conversas começam com «esquece o contexto anterior».
• Navega em fóruns e lê tópicos como «X estragou o meu projeto».
• Compara Claude com Cursor, Cursor com Codex, Codex com Cline. Pensa que escolheu a ferramenta errada.
• Senta-se para programar de manhã, mas à hora de almoço já está a percorrer o feed.

Esta pode ser uma situação frustrante. O artigo não tem uma taxa medida de desistência para ela; use os sinais abaixo para identificar uma mudança que valha a pena experimentar.

Fase 3 — Encosta da Iluminação

Para. Abranda. Deixa de tentar agarrar tudo o que é novidade. Escreve o seu primeiro CLAUDE.md e coloca-o no projeto. Cria uma pasta business/ e coloca lá uma descrição do produto, dos preços e do público-alvo. Faz /compact dez vezes e finalmente percebe que partes do contexto deve manter. Cria a sua primeira Skill — para uma tarefa específica, com 30 linhas.

Pensamentos na sua cabeça:

• «Ah, é assim que funciona.»
• «Hoje consegui fazer algo que não conseguia fazer há uma semana.»
• «Acho que percebo a diferença entre business/ e ai-clone/.»
• «Já tenho um prompt pronto para a tarefa X.»

Comportamento:

• Volta ao Plan Mode antes de cada nova tarefa.
• Antes de escrever seja o que for para o Claude, pergunta a si próprio: «Isto está no meu CLAUDE.md?»
• Procura a próxima regra metodológica; uma nova ferramenta já não lhe prende a atenção.
• Ajuda outras pessoas nos chats: «Também fiquei bloqueado nisto — experimente assim.»

Fase 4 — Planalto da Sustentabilidade

Este não é o momento em que tudo se torna fácil. É o momento em que o seu conhecimento finalmente corresponde à sua confiança.

Pensamentos na sua cabeça:

• «Sei aquilo que não sei.»
• «Esta tarefa vai levar-me três horas; já a fiz antes.»
• «Isto precisa de uma Skill nova; vou prepará-la agora.»
• «Se o Claude se desviar do plano, conheço três razões possíveis.»

Comportamento:

• Constrói produtos de forma consistente — um numa noite, outro ao longo de um fim de semana.
• Tem a sua própria pasta Skills, os seus próprios subagentes e a sua própria pasta business/ para cada projeto.
• Contrata prestadores de serviços de forma seletiva — para partes que não consegue mesmo tratar sozinho.
• Raramente recorre a tutoriais em vídeo de outras pessoas — sobretudo para obter ideias novas, não para aprender o básico.

Lista de verificação para autoavaliação — em que fase está agora?

• Se ainda não experimentou o Claude Code e pensa «Ah, consigo fazer isto numa noite», está na fase 1.
• Se já o experimentou, abriu o MCP, tentou ler Skills e pensa «Porque é que me meti nisto?», está na fase 2.
• Se criou um CLAUDE.md e consegue ver como ele realmente muda o comportamento do Claude, está na fase 3.
• Se constrói produtos de forma consistente e sabe exatamente que ferramenta usar em cada situação, está na fase 4.

7 sinais de que está agora no Vale do Desespero#

O vale não surge de repente. Vai-se instalando. Eis os sinais:

1. Compara ferramentas em vez de construir. Abre um separador «Cursor vs Claude Code». Acaba de ler. Abre «Cline vs Cursor». Depois, «Codex vs todo o resto». A cada comparação, pensa: «Se calhar estou a procurar no sítio errado.» Ao fim do dia, escreveu zero linhas de código e gastou quatro horas.

2. Começa cada conversa nova com «esquece tudo o que veio antes». Não tem um CLAUDE.md, não domina /compact e não percebe o que é uma janela de contexto. Cada sessão começa do zero. Uma semana depois, vai reparar que já explicou a mesma coisa ao Claude pela décima quinta vez.

3. Reúne prompts, mas não os usa. Criou uma pasta «Claude Code Prompts» no Notion. Tem lá 47 marcadores. Não usou nenhum deles mais do que uma vez. De cada vez, pensa: «Este é definitivamente aquilo de que preciso.»

4. Pensa que os outros «têm sucesso porque têm contactos». Abre as redes sociais e vê alguém lançar a primeira versão de um produto ao longo de um fim de semana. Pensa: «Têm uma equipa. Têm contactos. Eu não consigo.» Não considera que essa pessoa está na fase quatro enquanto você está na fase dois.

5. Abandona um projeto ao terceiro dia. Todos os projetos novos começam com entusiasmo («Isto vai ser incrível!») e acabam ao terceiro dia. Quando o desafio passa de «uma saudação no chat» a «processar um pagamento», desiste. Fazer algo difícil mete medo.

6. Procura respostas no ChatGPT porque o Claude não resultou. O Claude deu-lhe uma resposta má, por isso abre o ChatGPT. O ChatGPT deu-lhe uma resposta má, por isso abre o Gemini. Nunca lhe ocorre que o pedido estava mal formulado — pensa sempre que a culpa é da ferramenta.

7. Diz a si próprio: «Isto simplesmente não é para mim.» Esse pensamento pode refletir frustração, não incapacidade de aprender. O «vale» é uma metáfora neste artigo; não há percentagem medida nem calendário fixo que mostre quem se sente assim ou o que acontece depois.

Se reconhecer vários sinais, escolha um resultado funcional pequeno como objetivo seguinte. Registe o obstáculo e altere uma parte do método; a lista não prevê quanto demorará a melhorar.

Porque é que as pessoas desistem no vale — e porque não é preguiça#

A frustração com uma ferramenta não é uma medida fiável de capacidade. Examine a dimensão da tarefa, o conhecimento em falta e o ambiente de execução antes de tomar uma decisão duradoura sobre a ferramenta.

Em vez de inferir um mecanismo cerebral a partir de uma semana difícil, registe os factos observáveis: o que tentou, o que funcionou, que erro bloqueou o passo seguinte e quanto tempo demorou. Esse registo dá-lhe um ponto concreto a melhorar.

No vale, sofre dois golpes de uma só vez. Primeiro, o seu próprio progresso fica aquém das expectativas. Segundo, as pessoas à sua volta publicam resultados que você não tem. Abre as redes sociais — alguém lançou a primeira versão de um produto, alguém criou um agente, alguém ganhou os primeiros cem dólares com a API do Claude. Você passou três semanas sem conseguir sequer ligar uma base de dados.

Registe o tempo decorrido, além da impressão de velocidade. Um agente pode parecer produtivo e ainda acrescentar revisão e retrabalho; compare uma tarefa representativa com o método anterior, em vez de assumir que uma sensação de ganho é uma medição.

O progresso lento numa tarefa desconhecida não prova falta de capacidade. Separe o custo de aprendizagem do resultado da ferramenta e defina um resultado mais pequeno que consiga inspecionar.

Sem um passo seguinte repetível, é fácil mudar de ferramenta ou abandonar a tarefa. A estrutura de três pilares abaixo é uma proposta do autor, não uma explicação estatisticamente demonstrada das desistências.

3 pilares — uma metodologia para sair do vale#

Na experiência do autor descrita aqui, sair do vale demorou três meses: durante esse período, foram experimentadas dezenas de ferramentas. E percebi uma coisa: o Claude não era o problema. O problema era começar sempre do zero. Sem memória, sem regras, sem limites.

Depois disso, montei uma estrutura. Chamei-lhe «os três pilares». O nome refere-se a três tipos de componentes em que assenta todo o fluxo de trabalho do Claude Code. Retire qualquer um deles e a estrutura desmorona-se.

Pilar 1 — Um clone de IA seu

Um clone de IA é a sua experiência profissional empacotada num formato que o Claude aplica automaticamente.

No Vale do Desespero, escreve ao Claude «Ajuda-me com esta tarefa» e explica a sua abordagem do zero todas as vezes. O Pilar 1 resolve isto: as suas metodologias ficam na pasta ai-clone/, num conjunto de ficheiros. Uma Skill sobre «como trato um caso de cliente». Uma Skill sobre «como escrevo uma publicação no Telegram». Um subagente chamado «arquiteto de produto» que pensa como você durante a fase de planeamento.

O aspeto do pilar 1 na prática:

• Skills — ficheiros com instruções para tarefas específicas (/build-article, /build-reel-script).
• Subagentes — personas com diferentes áreas de especialização, entre as quais o Claude delega subtarefas.
• A pasta ai-clone/feedback/ — regras aprendidas através de erros. Cada regra segue o formato Regra - Porquê - Como.

Abordei este tema em detalhe no guia de Skills, Subagents, MCP e Plugins — um mapa sobre o que usar e quando.

Pilar 2 — Um segundo cérebro

Um segundo cérebro é um repositório estruturado de conhecimento sobre um projeto a que o Claude pode aceder diretamente.

No Vale do Desespero, explica ao Claude em cada sessão o que é o produto, quem é o público-alvo e qual é o modelo de negócio. No fim da terceira semana, percebe que já explicou a mesma coisa pela décima quinta vez. O Pilar 2 resolve isto: organiza o conhecimento sobre o projeto em ficheiros junto ao código. O próprio Claude lê-os quando necessário.

O aspeto do pilar 2 na prática:

• CLAUDE.md — o ponto de entrada do agente. Regras de comportamento, percursos e ligações para todo o resto.
• A pasta business/ — produto, público-alvo, economia, objetivos, planos de conteúdo e concorrentes.
• A pasta plans/ — planos técnicos por fase, com o estado de cada um.
• A pasta retrospectives/ — lições de sessões anteriores para evitar repetir os mesmos erros.

Para a explicação completa, consulte o guia para configurar o CLAUDE.md e o guia sobre um segundo cérebro no Claude Code.

Pilar 3 — Engenharia de contexto

A engenharia de contexto consiste em gerir o que entra na janela de contexto do Claude antes de carregar em Enter.

No Vale do Desespero, não percebe porque é que o Claude «se esquece» das instruções após quarenta mensagens numa conversa. Não percebe para que serve /compact. Não abre o Plan Mode porque «sem ele é mais rápido». O Pilar 3 resolve isto: direciona deliberadamente aquilo que carrega para o contexto. Isto fornece entradas mais relevantes; continua a ser necessário verificar as afirmações e o resultado.

O aspeto do pilar 3 na prática:

• Plan Mode — o agente escreve primeiro um plano para a tarefa, você aprova-o e, depois, executa-o. Se não o usar, a primeira tentativa produz um resultado caótico.
• /compact — compressão inteligente do histórico da conversa. Quando o contexto começa a ficar cheio, comprima-o e mantenha apenas as decisões principais.
• Prompts estruturados — em vez de «ajuda-me», escreva «aqui está o contexto A, aqui está a tarefa B, devolva o resultado no formato C».
• Sub-agents — delegar subtarefas em contextos novos para que o contexto principal não fique sobrecarregado.

Abordei este tema no guia de engenharia de contexto e no guia do Plan Mode.

Porque são três e não um

Pode criar apenas um segundo cérebro e o Claude conhecerá o seu projeto. Mas comportar-se-á como um estagiário sem regras.

Pode criar apenas um clone de IA e o Claude assumirá a sua experiência profissional. Mas, sem memória do projeto, cada sessão começará do zero.

A engenharia de contexto pode melhorar a entrada de uma tarefa, mas não garante uma execução sem problemas nem preserva o conhecimento por si só.

Só quando junta os três consegue o que chamo uma «estrutura previsível». O Claude lembra-se do seu projeto. Aplica automaticamente a sua metodologia. E não perde o fio à meada durante uma tarefa.

É nesse momento que sai do Vale do Desespero.

7 antipadrões que o mantêm no vale#

Antipadrões que vale a pena verificar no seu método:

1. «Escreve-me uma aplicação funcional» sem um CLAUDE.md. Abre uma nova conversa no Claude Code e dá imediatamente a tarefa. O Claude não tem contexto sobre o seu projeto, a sua metodologia ou as suas preferências. Dá-lhe um modelo genérico e você fica desiludido.

O que fazer: crie um CLAUDE.md e inclua o mínimo — a sua stack, o modelo de negócio, o público-alvo e ligações aos outros ficheiros. Todas as conversas começam com este contexto.

2. Uma conversa longa sem /compact. Faz uma sessão com 80 mensagens. O Claude já não se lembra do que decidiu na mensagem 12. A janela de contexto está cheia de histórico sem decisões importantes — apenas indecisão. A qualidade das respostas diminui.

O que fazer: use /compact a cada 30–40 mensagens e diga o que é importante manter. O contexto fica mais focado.

3. Confiar na primeira resposta. O Claude dá-lhe uma solução e você aplica-a imediatamente. Uma hora depois, descobre que estragou outros três ficheiros. Desiste porque «voltou a não funcionar bem».

O que fazer: use o Plan Mode para tarefas complexas. Primeiro, o plano; depois, discuta o plano; por fim, execute. Assim, deteta erros durante o planeamento, em vez de depois de meio dia de trabalho.

4. Um prompt disparatado e sem estrutura. Escreve «faz isto bem», à espera que o Claude perceba por si. Não percebe. Não sabe o que «bem» significa para si. Adivinha.

O que fazer: escreva prompts segundo a estrutura «contexto - tarefa - restrições - formato». Isso aumenta as probabilidades de obter um bom resultado à primeira.

5. Ignorar o acompanhamento dos custos. Não sabe quantos tokens está a gastar. O seu plano mensal esgota-se, abre o painel e vê que gastou $200. Fica surpreendido. Desiste.

O que fazer: configure ferramentas de acompanhamento do consumo de tokens. Analisei as ferramentas no guia sobre contadores de tokens. Quando consegue ver os gastos em tempo real, deixa de desperdiçar tokens.

6. Uma procura interminável pela «ferramenta certa». Sai o Cursor — muda para o Cursor. Aparece o Cline — experimenta o Cline. O Codex atualiza-se — volta ao Codex. De duas em duas semanas está a usar uma ferramenta nova e começa de novo todas as vezes. Nunca chega ao nível em que a ferramenta começa a trabalhar a seu favor.

O que fazer: escolha uma ferramenta. Use-a durante três meses. Não mude à primeira desculpa. Só consulto comparações quando a minha ferramenta é fundamentalmente incapaz de fazer algo.

7. «Não tenho tempo para ler a metodologia». Pensa que a ferramenta deve funcionar sem preparação. Que escrever prompts é uma competência inata. Que o CLAUDE.md é «uma camada extra». Consequentemente, no segundo mês ainda está a fazer algo que poderia ter terminado numa semana com uma metodologia.

O que fazer: aceite que o Claude Code exige aprendizagem, como qualquer ferramenta profissional. Aprende-se através da metodologia; a intuição não funciona aqui.

Relacionado: o guia sobre bajulação no Claude Code analisa como evitar o maior equívoco do vale — que o Claude tem sempre razão quando concorda com a sua ideia.

5 sinais de que está na Encosta da Iluminação — como saber que saiu do vale#

Cinco sinais de que está na fase três:

1. Tem um CLAUDE.md com mais de 200 linhas e mantém-no deliberadamente. Não o copiou de um modelo — construiu-o por si. Conhece todas as secções e sabe porque estão lá. Quando encontra um padrão novo, acrescenta uma regra.

2. Ativa o Plan Mode antes de cada tarefa não rotineira. Sem que seja preciso lembrar-lhe e não por disciplina, mas porque percebe que, sem um plano, vai desperdiçar uma hora e obter o resultado errado. Deixou de ser uma «etapa extra» e tornou-se um reflexo.

3. Tem o seu próprio catálogo de Skills e Subagents. Não os descarregou do GitHub — são seus. Para as suas tarefas específicas. Quando surge uma tarefa semelhante a uma anterior, lembra-se da sua Skill em vez de escrever um prompt do zero.

4. O seu ritmo estabilizou. Já sabe: «Uma tarefa destas demora-me 3 horas.» Nem «ah, isto é rápido» nem «ah, isto vai demorar uma eternidade». Tem uma estimativa realista do tempo. Isto significa que ultrapassou o efeito Dunning–Kruger nos dois sentidos — deixou de sobrestimar e subestimar.

5. As pessoas começam a perguntar-lhe. Alguém faz uma pergunta sobre MCP num chat e você responde com um exemplo específico: «Foi isto que me aconteceu.» Alguém pergunta sobre o Plan Mode e você mostra o seu exemplo. Este é um efeito secundário de dominar a metodologia: as pessoas no vale reconhecem a sua própria experiência na sua e procuram a sua ajuda.

Use estes sinais para refletir sobre o progresso recente, não para se atribuir uma pontuação ou prever quando chegará a um planalto. Volte a verificar se as estimativas e os resultados funcionais se tornam mais consistentes ao longo do tempo.

No planalto, o papel da pessoa numa estrutura com agentes muda.

Esse é o resultado da jornada para sair do vale: já não está a «aprender a escrever prompts». Gere uma estrutura de agentes, é o arquiteto do processo, é quem está no topo.

O que fazer AGORA se está a perder a esperança#

Três passos para experimentar na próxima tarefa.

Passo 1 — diga em voz alta o que se passa. Diga a si próprio: «Esta é uma parte frustrante do meu método atual. Consigo identificar o obstáculo concreto e escolher um passo seguinte mais pequeno.»

Passo 2 — abrande. Escolha UM projeto. Não dois, nem três — um. Escolha UM dos três pilares — aquele que resolverá mais pontos de dor neste projeto. Se o projeto é novo e não tem contexto nenhum, escolha o segundo cérebro (CLAUDE.md). Se o projeto já existe, mas o Claude não age «como você», escolha o clone de IA (Skills). Se as tarefas são longas e o contexto está a ficar cheio, escolha a engenharia de contexto (Plan Mode + /compact).

Um projeto, um pilar, duas semanas. Não tente construir tudo durante um fim de semana — isso vai fazê-lo regressar ao vale.

Passo 3 — crie estrutura. Pode construir a metodologia por si. Na experiência do autor descrita aqui, isso demorou três a seis meses.

Para continuar a trabalhar com modelos, pode aceder ao Ailoot.