🍳 O framework WAT

WAT é o nome do curso: Workflow (receita), Agent (cozinheiro) e Tools (ingredientes/eletrodomésticos).

Fixa o modelo mental que sustenta o curso inteiro — sem ele, cada trilha seguinte fica solta.

Workflow, Agent, Tools, papéis distintos.

Uma sequência de passos em texto simples (markdown) dizendo o que fazer e em que ordem.

É a peça que guarda a intenção — sem ela, o agente reinventa o processo a cada pedido.

Markdown, passo a passo, não é código.

O Claude Code: lê o workflow, escolhe a ferramenta certa, executa e ajusta se algo sair diferente.

É a peça que dá julgamento ao processo — interpreta a receita em vez de só repeti-la.

Interpretação, escolha de tool, correção.

As ações concretas que o agente aciona: ler arquivo, rodar comando, enviar e-mail, chamar uma API.

Sem ferramentas, o agente só teria opinião — as trilhas 2 e 4 tratam de dar e conectar tools.

Ferramenta, API, execução real.

Cada peça guarda um papel diferente: intenção (workflow), julgamento (agente) e capacidade (tools).

Separar é o que torna o sistema previsível e flexível ao mesmo tempo.

Separação de responsabilidades.

Agente sem receita fica caro e errático; tool sem receita nem cozinheiro fica parada, inútil.

Entender essas duas falhas evita pedir automação sem preparar a receita primeiro.

Custo, imprevisibilidade, ferramenta parada.

Ler o passo, escolher a tool, executar, observar o resultado, decidir o próximo passo.

É esse laço, repetido, que transforma a receita escrita em trabalho de verdade feito.

Ciclo, laço, repetição até terminar.

O agente identifica em que ponto da receita está, usando a conversa e os arquivos já existentes.

Sem saber 'onde está', o agente não consegue decidir o próximo passo corretamente.

Estado, contexto, memória da sessão.

Dado o passo e o menu de ferramentas disponíveis, o agente escolhe a mais adequada.

Quanto mais claras as ferramentas disponíveis, melhor a escolha — tema das Trilhas 2 e 3.

Escolha de ferramenta, menu de opções.

Depois de executar, o agente lê o que voltou: deu certo, deu erro, ou saiu diferente do esperado.

Essa leitura é o que dispara a correção — sem ela, erros passariam despercebidos.

Observação, verificação de resultado.

Repetir corrigindo um erro temporário é normal; repetir sem mudar de estratégia é travamento.

Reconhecer a diferença evita ficar preso num loop caro sem perceber.

Loop saudável, loop travado, custo.

Sucesso, pausa para perguntar algo que só você sabe, ou travamento pedindo intervenção.

Saber reconhecer qual dos três está acontecendo é uma habilidade que se desenvolve com a prática.

Sucesso, pausa, travamento.

Auto-correção é real, mas é vendida como maior do que é: uma IA pensando sozinha para sempre.

Confundir as duas fases é a origem da maioria das expectativas quebradas sobre IA.

Auto-correção, exagero de marketing.

No Claude Code, o agente tenta um passo, lê o erro, ajusta e tenta de novo, várias vezes.

É a fase que sustenta a fama de 'IA que se corrige sozinha' — e é verdade, aqui.

Tentativa-erro-correção, supervisão.

Publicado e agendado, o agente executa o workflow fixado, como qualquer automação tradicional.

É previsibilidade que você quer numa automação rodando sozinha todo dia.

Determinismo, workflow fixado.

Dentro do Claude Code interativo: flexível. Publicado e agendado: fixo.

Não é sobre 'quão esperto' o agente é — é sobre onde ele está rodando.

Publicação como linha divisória.

Demonstrações mostram a fase de construção e deixam implícito que continua para sempre.

Entender isso evita duas frustrações: esperar demais, ou desconfiar do curso inteiro.

Generalização, expectativa quebrada.

Use a construção para deixar o workflow robusto; monitore em produção, sem esperar autocorreção.

Ajuda a planejar o tempo certo de teste antes de publicar algo de verdade.

Monitoramento, manutenção manual.

Workflow que não diz o suficiente para o agente decidir sem adivinhar.

Não é o agente que 'não entendeu' — é a receita que não disse o bastante.

Vaguidão, suposição errada.

Ferramentas exigem chave de API ou permissão — sem isso, o passo não pode ser executado.

A solução nunca é reescrever o workflow, é configurar a credencial que falta.

Chave de API, permissão, credencial.

O agente erra a decisão por faltar contexto — exemplos e regras do CLAUDE.md.

O CLAUDE.md existe justamente para carregar esse contexto de forma persistente.

Contexto, CLAUDE.md, exemplos.

Instruções que competem entre si permitem mais de uma leitura razoável.

Diferente de vago, ambíguo tem excesso de regra conflitante.

Ambiguidade, prioridade não definida.

Resultado diferente, pedido de senha, foge do padrão, ou oscila entre sessões.

Aprender a ler as pistas evita 'brigar' com o agente sem entender por quê.

Diagnóstico pelo comportamento.

Receita clara? Chave configurada? Contexto suficiente? Sem instruções competindo?

Percorrer o checklist resolve a maioria das falhas antes de reescrever tudo do zero.

Checklist, diagnóstico rápido.

Uma automação de newsletter: pesquisa um assunto, redige um rascunho, prepara o envio.

Pequena o bastante para caber numa sessão, completa o bastante para exercitar tudo.

Pesquisa, redação, envio.

Escrever a receita em 5 passos, evitando o erro de receita vaga.

É o investimento que mais economiza tempo e tokens no resto do build.

Workflow escrito, freio de segurança.

Um prompt completo, pronto para colar, com as partes variáveis marcadas.

Copiar e rodar de verdade é o que fixa o aprendizado — não só ler sobre.

Prompt copy-run, variáveis marcadas.

Ler o rascunho, dar feedback específico, pedir para refazer só a parte que falhou.

Exercita a fase de construção do módulo 1.3 na prática.

Feedback específico, correção pontual.

Os três erros do módulo 1.4 aparecem quase sempre na primeira tentativa deste build.

Reconhecer os erros comuns acelera o conserto na primeira tentativa.

Erros recorrentes, diagnóstico rápido.

Dar a ferramenta de e-mail real (Trilha 2) e publicar/agendar (Trilhas 4 e 6).

Fecha o círculo mostrando aonde este build chega quando as próximas trilhas entram.

Deploy, agendamento, próximos passos.