Terça, a Ana corrige o rascunho da proposta: o Claude usou o preço da tabela antiga. Quarta, o Beto corrige a mesma coisa. Quinta, o Caio. Cada um ajustou o próprio texto e seguiu em frente. Na sexta, a skill continua igual, e na segunda o erro volta. O time trabalha, a IA não melhora, e todo mundo acha que «a IA é assim mesmo».
Veio do Reel? A palavra era MELHORA.
A ideia em uma frase
A IA não melhora porque você corrigiu. Ela melhora quando a correção vira regra escrita no lugar onde ela lê as regras: a skill ou as instruções do projeto. O resto deste guia é como fazer isso toda semana, sem bagunça e com alguém aprovando.
Por que a correção se perde
Três motivos, quase sempre juntos:
- A correção fica no texto final. O vendedor arruma a proposta e envia. Ninguém registra o que estava errado.
- Cada pessoa corrige sozinha. Ninguém sabe que três colegas pegaram o mesmo erro.
- A memória não é do time. O que o Claude lembra de uma conversa da Ana não vale para a conversa do Beto. Regra de empresa mora em arquivo, não em lembrança.
O que você vai montar
Um ciclo de três partes, que roda toda semana:
- Registro: uma planilha simples, «erros da IA», onde cada correção vira uma linha.
- Revisão de sexta: o Claude lê o registro e propõe mudanças na skill.
- Aprovação: a dona da skill aceita ou recusa, testa e guarda a versão nova com data.
Parte 1: o registro de erros
Na Distribuidora Modelo (empresa fictícia: distribuidora de produtos de limpeza na Grande São Paulo e em Campinas), a planilha tem cinco colunas:
| Data | Skill | O que saiu errado | Como ficou certo | Quem corrigiu |
|---|---|---|---|---|
| 10/11/2026 | proposta-comercial | Preço do desinfetante da tabela de outubro | Tabela de 03/11 | Ana |
| 11/11/2026 | proposta-comercial | Mesmo erro, sabão em pó | Tabela de 03/11 | Beto |
| 12/11/2026 | ata | Telefone do cliente na ata | Telefone removido | Rafael |
| 12/11/2026 | proposta-comercial | Prometeu entrega na quinta | Trecho removido, prazo com a Logística | Caio |
Regra do registro: leva menos de um minuto. Se demorar mais, ninguém preenche. Não precisa explicar o porquê; basta o que estava e o que ficou.
Parte 2: a revisão de sexta
Na sexta à tarde, a dona da skill (na Distribuidora Modelo, a Bianca cuida da proposta-comercial) abre o Projeto do
Claude onde a skill é mantida e cola o registro da semana:
Aqui está o registro de erros da semana e o SKILL.md atual da proposta-comercial.
Não invente; se faltar um dado, escreva FALTA.
1. Agrupe os erros iguais ou parecidos. Diga quantas vezes cada um apareceu.
2. Para cada grupo que apareceu 2 vezes ou mais, proponha UMA regra nova
ou a mudança de uma regra existente. Mostre o trecho antes e depois.
3. Para erros que apareceram 1 vez, diga se vale regra ou só observação.
4. Diga se alguma regra atual nunca foi usada e pode sair.
Não altere o arquivo. Entregue a proposta para a Bianca aprovar.
Um trecho da resposta que sairia (exemplo ilustrativo):
Grupo 1: preço de tabela antiga (3 vezes: Ana, Beto, mais 1 em 07/11).
Regra atual: "Use a tabela de preços anexada."
Proposta: "Use só a tabela de preços com a data mais recente nos arquivos
do projeto. Escreva no fim do rascunho: 'preço: tabela de DD/MM/AAAA'.
Se houver duas tabelas, pare e pergunte qual vale."
Grupo 2: prazo de entrega prometido (1 vez).
Já existe regra. Sugestão: mover a regra para o topo do SKILL.md,
porque hoje ela está no fim e é fácil de ser ignorada.
Parte 3: aprovar, testar e guardar
A Bianca não aceita tudo de uma vez. O caminho:
- Aprova ou recusa cada mudança. Recusa é normal: às vezes o erro foi da pessoa, não da skill.
- Testa com três casos antigos, dos que estão no registro. A skill nova acerta onde errava? Continua acertando o resto?
- Guarda a versão anterior com a data no nome (por exemplo,
proposta-comercial-2026-11-06) e publica a nova. - Avisa o time em duas linhas: o que mudou e por quê.
O erro do telefone na ata vai para a dona da skill ata. Cada skill tem uma dona; o registro é um só.
Onde isso mora no Claude
- A skill é a pasta com o
SKILL.md; é ali que a regra nova entra. - O Projeto guarda o registro, as versões e as instruções da revisão de sexta.
- No plano Team da Distribuidora Modelo, uma pessoa só coloca a versão nova onde o time usa, e só depois da aprovação da dona.
- Quem mexe em arquivos pelo Claude Code pode manter as skills numa pasta com histórico de versões; o método é o mesmo.
A regra
- O que não pode: o Claude não altera a skill sozinho. Ele propõe o antes e depois; a dona aprova e publica. Ninguém edita a skill no meio da semana para resolver um caso só.
- Quem aprova: a dona de cada skill. Regra que mexe em preço, desconto ou prazo passa também pelo Marcos.
- O que não entra no registro: dado pessoal de cliente (telefone, documento). Escreva «telefone do cliente», não o número.
- Quanto custa: a revisão de sexta é uma conversa por skill. Entra no teto de IA da empresa (R$ 1.500,00 por mês no exemplo), que a Juliana acompanha.
Quanto tempo isso leva?
Não prometemos número. Meça o que interessa: quantas correções por semana cada skill precisa. Conte as linhas do registro de uma skill na primeira semana e compare com a quarta. Se a mesma correção ainda aparece, a regra não pegou; reescreva. Para o tempo da revisão, cronometre as três primeiras sextas. Se passar do que o time aceita, revise só a skill com mais erros naquela semana.
Para entender onde cada regra mora, veja o mapa da IA da empresa.