Escolha um exemplo que merece ser repetido
O que é
Engenharia reversa começa com uma saída que você considera boa e com as entradas que a produziram. Um relatório isolado mostra a aparência, mas não explica filtros, fórmulas e decisões. Guarde também a origem dos dados.
Por que aprender
Copiar só o formato pode reproduzir um erro elegante. Antes de transformar o exemplo em referência, confira números, datas e contexto. Um bom exemplo de referência tem qualidade conhecida, não apenas aprovação por impressão geral.
Conceitos-chave
Relatório esperado
Período observado: 2026-09-14 a 2026-09-17
Total: R$ 500,00
Loja: R$ 320,00 | Site: R$ 180,00
Pendências: nenhuma no arquivo de exemplo.
✓ Faça assim
Confirme a soma do exemplo antes de usá-lo como gabarito.
✗ Evite este erro
Escolher a saída mais bonita sem conhecer os dados.
Pratique antes de revelar
Liste três características obrigatórias desse relatório.
Ver resposta comentada
Período explícito; soma exata de R$ 500,00; totais por canal que reconciliam com o total. O modo de redigir a introdução pode variar.
Entreviste o processo, não apenas o estilo
O que é
Pergunte como o trabalho foi feito: quais fontes entraram, quais registros foram excluídos, como duplicatas foram tratadas e quem aprovou o resultado. Faça perguntas que explicitem decisões escondidas, em vez de pedir apenas um “estilo profissional”.
Por que aprender
Quem executa uma tarefa há anos toma atalhos sem perceber. O agente não conhece esses atalhos. Uma entrevista curta recupera o conhecimento tácito e ajuda a descobrir dependências que precisam existir antes da automação.
Conceitos-chave
1. Este total inclui cancelamentos?
2. Que data define a semana: compra ou pagamento?
3. Dois registros iguais são duplicatas ou duas vendas?
4. O que você confere antes de compartilhar?
Do conceito à ação
- Fonte: identificar a condição inicial.
- Filtro: aplicar a decisão descrita.
- Cálculo: conferir o efeito no exemplo.
- Apresentação: registrar a evidência de saída.
✓ Faça assim
Registre “não sabemos” quando a resposta não existe.
✗ Evite este erro
Deduzir regra de negócio olhando uma única linha.
Pratique antes de revelar
Crie uma pergunta que impeça a soma indevida de reembolsos.
Ver resposta comentada
“Valores negativos representam reembolsos autorizados? Devem abater o total ou aparecer em seção separada?” A resposta vira uma regra explícita de negócio.
Converta preferências em critérios de aceite
O que é
“Quero algo bom” não permite reprovar uma saída de forma consistente. Divida qualidade em itens observáveis: presença do período, correspondência entre dados e tabela, tamanho do resumo e clareza das pendências. Separe obrigatórios de preferências.
Por que aprender
Critérios antecipados evitam mudar a régua depois de ver qual modelo gerou o resultado. Eles também ajudam a distinguir um bloqueio sério, como número inventado, de uma melhoria editorial, como uma frase comprida.
Conceitos-chave
Critério | Evidência
Total correto | soma independente das linhas
Período explícito | cabeçalho com duas datas
Clareza | leitor identifica total e pendências sem procurar
Sem invenção | afirmações rastreáveis à entrada
✓ Faça assim
Defina falhas bloqueantes antes da primeira avaliação.
✗ Evite este erro
Aprovar pelo número de itens do checklist sem olhar o conteúdo.
Pratique antes de revelar
Reescreva “relatório bem organizado” como dois critérios.
Ver resposta comentada
“Total e período aparecem antes dos comentários” e “pendências ficam em seção própria, com ação proposta”. Ambos tornam a organização inspecionável.
Separe o que é fixo do que pode variar
O que é
O template deve preservar a informação necessária e permitir adaptação onde ela ajuda. No relatório, nomes de colunas e regras de soma são fixos; a redação dos comentários depende do conteúdo. Essa divisão será a base do nível de liberdade.
Por que aprender
Congelar tudo gera texto genérico. Deixar tudo aberto permite omitir números importantes. Uma boa receita combina um esqueleto estável com decisões editoriais delimitadas, sem tentar prever cada frase.
Conceitos-chave
FIXO: período → total → canais → pendências.
VARIÁVEL: observações sobre concentração por canal.
VEDADO: “a campanha causou a alta” sem dados da campanha.
✓ Faça assim
Dê exemplos de duas redações diferentes que seriam aceitáveis.
✗ Evite este erro
Exigir a mesma conclusão quando os dados mudaram.
Pratique antes de revelar
Se só houver um canal no arquivo, a skill deve criar uma comparação entre canais?
Ver resposta comentada
Não. Ela informa que há um único canal e limita a análise. Preservar o contrato exige adaptar o comentário à entrada, não fabricar variedade.
Monte seus primeiros casos de referência
O que é
Um conjunto de referência reúne entradas, saídas esperadas ou critérios, e o motivo de cada caso existir. Inclua o caminho comum, um dado ausente e uma situação ambígua. O conjunto representa a tarefa, não só o seu exemplo favorito.
Por que aprender
Uma correção que resolve o arquivo original pode quebrar um arquivo vazio. Casos variados revelam esse efeito cedo. Reserve alguns casos para a avaliação final, sem usá-los para editar a instrução a cada tentativa.
Conceitos-chave
C01: quatro vendas válidas → total 500,00.
C02: sem coluna valor → erro claro, sem relatório.
C03: CSV vazio → informar ausência de dados.
C04: valor negativo → seguir política explícita.
Do conceito à ação
- Normal: identificar a condição inicial.
- Ausente: aplicar a decisão descrita.
- Ambíguo: conferir o efeito no exemplo.
- Reservado: registrar a evidência de saída.
✓ Faça assim
Anote por que cada caso está no conjunto.
✗ Evite este erro
Chamar uma única execução de benchmark definitivo.
Pratique antes de revelar
Adicione um caso que detecte erro de separador decimal.
Ver resposta comentada
Uma linha com valor “120,50” deve ser rejeitada pelo contrato com ponto decimal, ou normalizada por uma regra deliberada. No kit, a decisão é rejeitar com mensagem clara.
Escreva o briefing que vira skill
O que é
O briefing reúne finalidade, entradas, saída, passos, limites e critérios. Ele ainda não precisa ser uma skill instalada. Primeiro verifique se outra pessoa consegue executar o processo com essas instruções sem depender de você a cada etapa.
Por que aprender
Esse ensaio encontra ambiguidades antes de atribuí-las ao modelo. Se nem você consegue dizer quando o trabalho termina, a automação apenas acelera a indefinição. Use um briefing pequeno e completo como ponto de partida.
Conceitos-chave
Transforme o CSV informado em um relatório semanal local.
Valide data, canal e valor; calcule sem alterar a entrada.
Produza período, total, canais e pendências.
Confira as somas e entregue relatorio.md + qa.json.
Se faltar campo obrigatório, explique e pare o cálculo.
✓ Faça assim
Peça ao agente para listar ambiguidades antes de formalizar.
✗ Evite este erro
Pedir “crie a skill perfeita” sem fornecer referência.
Pratique antes de revelar
Use o template de briefing do kit para descrever seu próprio processo.
Ver resposta comentada
A entrega deve incluir uma entrada de exemplo, uma saída desejada e pelo menos três critérios. Se faltar uma regra de negócio, registre a pendência em vez de completá-la por imaginação.
Confira seu entendimento
Você recebeu um relatório bonito, mas sem o período. Qual é o diagnóstico?
O que você leva deste módulo
Produzir uma especificação de saída e um conjunto inicial de casos.
- Escolha um exemplo que merece ser repetido.
- Entreviste o processo, não apenas o estilo.
- Converta preferências em critérios de aceite.
- Separe o que é fixo do que pode variar.
- Monte seus primeiros casos de referência.
- Escreva o briefing que vira skill.
Próxima ação: guarde o exercício no seu laboratório e registre o que ainda precisa de revisão.