📝 Workflows (Instrucoes MD)
Workflows sao arquivos Markdown que funcionam como SOPs (Standard Operating Procedures) para o agente. Eles descrevem processos completos em linguagem natural - exatamente como voce explicaria uma tarefa para um colega de trabalho.
📄 Estrutura de um Workflow
💡 Por que Markdown?
- Legivel: Humanos e IA entendem facilmente
- Versionavel: Funciona perfeitamente com Git
- Editavel: Qualquer editor de texto serve
- Documentacao: Serve como doc automatica do processo
🧠 Agents (Decisao)
O Agent e o Claude Code em si - a camada de raciocinio probabilistico. Ele le workflows, decide quais tools usar, em que ordem, e como lidar com erros. O agente conecta intencao (o que voce quer) a execucao (o que acontece).
🎯 Responsabilidades do Agent
Coordenacao
Le o workflow e decide a sequencia de execucao dos tools
Tratamento de Erros
Quando um tool falha, investiga, corrige e retenta
Clarificacao
Faz perguntas quando informacoes estao incompletas
Adaptacao
Ajusta abordagem baseado em resultados intermediarios
📊 O Problema da Precisao Acumulada
Se a IA tenta fazer tudo diretamente (sem tools), a precisao cai exponencialmente:
E por isso que delegamos execucao para tools deterministicos (100% precisos).
🔧 Tools (Execucao .py)
Tools sao scripts Python que fazem o trabalho pesado de forma deterministica. Cada tool faz uma unica coisa bem feita - chamar uma API, transformar dados, enviar email. Eles sao testaveis, confiaveis e rapidos.
Exemplos de Tools
Busca dados de canais e videos via YouTube Data API
Processa metricas e calcula tendencias
Cria graficos com matplotlib/plotly
Envia relatorio via Gmail API
💡 Principio Fundamental
Um tool = uma funcao. Se um script faz duas coisas, divida em dois scripts. Tools atomicos sao mais faceis de debugar, testar e reutilizar em outros workflows.
🔄 Self-Improvement Loop
O que torna o framework WAT especial e o loop de auto-melhoria. Quando algo falha, o agente nao apenas corrige - ele atualiza o workflow para que o erro nunca mais aconteca.
Identificar o Erro
Le o stack trace completo e entende o que deu errado
Corrigir o Tool
Modifica o script Python para resolver o problema
Verificar a Correcao
Roda o tool novamente para confirmar que funciona
Atualizar o Workflow
Documenta o aprendizado para evitar repeticao do erro
📖 Exemplo Real
O agente bate em rate limit da YouTube API → Pesquisa a documentacao → Descobre o batch endpoint → Refatora o tool para usar batching → Verifica que funciona → Atualiza o workflow com a nova abordagem. Nunca mais vai ter esse problema.
📂 Estrutura de Pastas
O framework WAT usa uma estrutura de pastas padrao que o agente conhece e respeita. Isso elimina ambiguidade sobre onde colocar cada tipo de arquivo.
Estrutura Completa
Persiste (commitar)
- • claude.md
- • workflows/*.md
- • tools/*.py
- • .gitignore
NAO persiste (gitignored)
- • .env (secrets!)
- • credentials.json
- • token.json
- • .tmp/* (regeneravel)
🔐 Sistema .env
O arquivo .env e onde voce guarda todas as credenciais sensiveis. NUNCA coloque API keys diretamente no codigo dos tools ou nos workflows.
Exemplo de .env
🚨 REGRA DE OURO
Secrets SO no .env. Se voce ver uma API key hardcoded em qualquer outro arquivo, mova imediatamente para o .env. Um vazamento de credencial pode custar muito caro.
🚀 Proximo Passo
Com o framework WAT entendido, no proximo modulo vamos ver como usar o claude.md como system prompt e dominar o Plan Mode para criar automacoes bem planejadas.
📋 Resumo do Modulo
Proximo Modulo:
5.3 - Planejamento com IA: claude.md, plan mode e iteracao de planos