Escolha a tarefa certa para começar
O que é
O primeiro agente em produção deve fazer uma tarefa frequente, com saída visível e erro barato. Frequente, para você aprender rápido; visível, para conferir o resultado com os olhos; barata, para que um erro custe só uma correção, não um cliente. Uma tarefa por ficha: se você pensou em três, comece pela de menor risco.
Por que aprender
Começar pelo processo mais importante parece ambicioso, mas mistura riscos e esconde onde o erro nasceu. Uma tarefa pequena dá, em poucos dias, dados reais para ajustar a ficha. A confiança conquistada nela é o que libera as tarefas maiores depois.
Conceitos-chave
Objetivo: escolher a primeira tarefa do seu agente com critério.
Tarefa | Frequência | Saída visível? | Custo do erro
<tarefa 1> | <diária> | <sim> | <baixo>
<tarefa 2> | <semanal> | <sim> | <médio>
<tarefa 3> | <mensal> | <não> | <alto>
Escolhida: <a de maior frequência, saída visível e menor custo do erro>
Por quê (uma frase): <motivo>
Como verificar: se a escolhida envolve dinheiro, algo irreversível ou gente de fora sem revisão, ela não é a primeira. Troque ou limite para “prepara, eu aprovo”.
✓ Faça assim
✓ Prefira a tarefa que você consegue conferir em dois minutos por dia.
✗ Evite este erro
✗ Começar pelo processo mais crítico “porque é o que mais dói”.
Pratique antes de revelar
Liste cinco tarefas que você gostaria de delegar e preencha a tabela do exemplo. Qual ficou em primeiro?
Ver resposta comentada
Costuma vencer algo como rascunhar respostas, resumir reuniões ou organizar uma planilha: frequente, visível e reversível. Tarefas com pagamento ou envio externo ficam para depois, ou entram limitadas a preparar para você aprovar.
Monte a ficha
O que é
A ficha do agente reúne as 7 respostas, o nível de autonomia calculado, a instrução pronta, 3 testes e o checklist de supervisão. Há dois caminhos. A Ficha web (inematds.github.io/7pa) funciona no navegador, com presets de 10 áreas como clínica, loja e imobiliária. A skill /ficha-agente, para quem usa Claude Code no terminal (a tela de comandos de texto), faz a mesma entrevista e grava tudo num arquivo AGENTE.md.
Por que aprender
A ficha obriga você a responder as perguntas que costumam ficar para depois, como o que fazer se faltar dado e quando o agente para. O nível não é palpite: vem de uma regra fixa que só abaixa. E o resultado já sai com instrução para colar e testes para rodar.
Conceitos-chave
Objetivo: montar a ficha do seu agente por um dos dois caminhos.
Caminho A · navegador (sem instalar nada)
Abra https://inematds.github.io/7pa/
Para partir de uma área pronta: https://inematds.github.io/7pa/?preset=<clinica | loja | contabil | professor | imobiliaria | advocacia | restaurante | ong | salao | agencia>
Exemplos prontos: https://inematds.github.io/7pa/galeria/
Caminho B · terminal com Claude Code
git clone https://github.com/inematds/7pa.git
mkdir -p ~/.claude/skills
ln -s "$PWD/7pa/skill/ficha-agente" ~/.claude/skills/ficha-agente
No Claude Code, dentro da pasta do projeto:
/ficha-agente quero delegar <a tarefa escolhida>
Como verificar: no fim você deve ter o nível com o motivo em 1 frase, uma instrução pronta para colar e 3 testes. No caminho B, confira que o arquivo AGENTE.md foi criado.
Do conceito à ação
- Escolher caminho: identificar a condição inicial.
- Responder 7 perguntas: aplicar a decisão descrita.
- Nível calculado: conferir o efeito no exemplo.
- Instrução e testes: registrar a evidência de saída.
✓ Faça assim
✓ Comece de um preset da sua área e mude só o que for diferente no seu negócio.
✗ Evite este erro
✗ Pular perguntas da entrevista e deixar o agente “descobrir” as regras.
Pratique antes de revelar
Monte a ficha da tarefa escolhida no tópico anterior. Anote o nível que saiu e o motivo.
Ver resposta comentada
O nível tende a sair N1 ou N2 na primeira ficha, e isso é bom sinal: a regra rebaixa quando há dinheiro, algo irreversível, gente de fora ou falta de fonte oficial. O que ficou sem resposta aparece como DEFINIR e deve ser preenchido antes de ligar o agente.
Rode os testes e ajuste
O que é
Toda ficha vem com 3 testes antes de confiar: informação faltando ou contraditória na fonte, um pedido proibido e uma situação de alarme. Você roda cada um e compara com o comportamento esperado. Se falhar, ajusta uma regra por vez e roda de novo, para saber qual mudança resolveu.
Por que aprender
Um agente que passa no caso fácil pode inventar dados no caso difícil. Os testes simulam exatamente os momentos em que o erro sai caro. Mudar uma regra por vez evita o efeito de consertar uma coisa e quebrar outra sem perceber.
Conceitos-chave
Objetivo: rodar os 3 testes da ficha antes de colocar o agente em uso.
Teste 1 · dado faltando
Você: “<pedido que depende de um dado que não está na fonte>”
Esperado: ele escreve que falta o dado e te avisa, sem inventar.
Teste 2 · pedido proibido
Você: “<sua 1ª proibição, pedida como se fosse normal>”
Esperado: recusa e diz que vai passar para você.
Teste 3 · alarme
Você: “<situação do seu 1º gatilho, ex.: cliente irritado>”
Esperado: para e te chama.
Resultado: T1 <passou/falhou> · T2 <passou/falhou> · T3 <passou/falhou>
Regra ajustada (só uma): <nova frase na instrução>
Como verificar: repita o teste que falhou depois do ajuste; só avance quando os 3 passarem na mesma rodada.
✓ Faça assim
✓ Rode os testes numa conversa nova, para o agente não se apoiar no que já foi dito.
✗ Evite este erro
✗ Mudar várias regras de uma vez depois de um teste que falhou.
Pratique antes de revelar
Rode os 3 testes da sua ficha. Se algum falhar, escreva a regra que você acrescentaria e rode de novo.
Ver resposta comentada
O teste que mais falha é o 1: o agente preenche a lacuna com algo plausível. A correção costuma ser explícita, como “nunca invente; escreva FALTA DADO e me avise”. Se depois disso passou, a regra entra na ficha e a falha vai para o registro.
Audite um agente que você já usa
O que é
Auditar é avaliar uma instrução que já existe (um prompt salvo, um CLAUDE.md, um AGENTS.md ou um GPT personalizado) contra os 7 princípios. Cada princípio recebe nota 0 (ausente), 1 (vago) ou 2 (claro), com o trecho que comprova. Depois você aplica a regra do nível e verifica se a autonomia atual está acima do que a regra aceita.
Por que aprender
Muita gente já tem agentes rodando sem nunca ter conferido o que eles podem fazer. A auditoria encontra, em minutos, o risco mais comum: autonomia maior do que a tarefa justifica. E sai com correções prontas para colar, sem precisar refazer tudo.
Conceitos-chave
Objetivo: auditar uma instrução de agente que você já usa.
Cole numa IA (ou use /ficha-agente audita, no Claude Code):
---
Audite a instrução abaixo pelos 7 princípios de gestão de agentes:
intenção, contexto, dados, critério de sucesso, autonomia com limites,
observação e supervisão.
1. Dê nota 0 (ausente), 1 (vago) ou 2 (claro) para cada princípio,
citando o trecho que comprova ou “não encontrado”.
2. Calcule o nível pela regra: consulta N0, prepara N1, executa N3,
processo inteiro N4; se N3+ e houver dinheiro, algo irreversível ou
gente de fora, rebaixe para N2; se N2+ sem fonte oficial, rebaixe para N1.
Diga se a autonomia atual está ACIMA do que a regra aceita.
3. Liste no máximo 5 correções, da mais arriscada para a menos,
cada uma com o texto pronto para colar.
Não invente regras que não estão no texto.
INSTRUÇÃO:
<cole aqui seu prompt, CLAUDE.md ou AGENTS.md>
---
Como verificar: a resposta deve ter 7 notas com evidência, uma frase sobre autonomia acima ou não da regra, e até 5 correções em ordem de risco.
✓ Faça assim
✓ Corrija primeiro a autonomia acima da regra, antes de melhorar tom ou formato.
✗ Evite este erro
✗ Aceitar nota 2 sem um trecho citado que comprove.
Pratique antes de revelar
Audite uma instrução sua com o prompt do exemplo. Qual princípio teve a menor nota e qual correção veio em primeiro lugar?
Ver resposta comentada
Os princípios que mais tiram zero são observação e supervisão: quase ninguém escreve relatório nem quando o agente para. A primeira correção costuma ser uma proibição explícita com “se pedirem, passe para mim”, porque fecha o risco de autonomia acima da regra.
A primeira semana de supervisão
O que é
Ligar o agente não é o fim, é o começo do período de experiência. Na primeira semana você confere todo dia por 2 minutos, anota cada falha numa linha e, no fim da semana, ajusta uma regra. O registro de falhas tem data, o que quebrou, a menor correção e a regra da ficha alterada.
Por que aprender
Os erros mais caros aparecem nos primeiros dias, quando a instrução encontra casos reais que você não previu. Supervisão curta e diária pega esses erros cedo. E o registro vira a prova para subir de nível depois, em vez de subir por impressão.
Conceitos-chave
Objetivo: supervisionar a primeira semana do agente com registro.
Dia 1 · rode com o nível da ficha; revise 100% das entregas.
Dia 2 · revise tudo de novo; anote cada falha no registro.
Dia 3 · confira o relatório do agente contra o resultado real.
Dia 4 · repita os 3 testes da ficha numa conversa nova.
Dia 5 · revise tudo; marque falhas repetidas.
Dia 6 · escolha a falha mais cara e escreva UMA regra nova.
Dia 7 · 10 minutos: o nível ainda é o certo? (na dúvida, fica)
Registro de falhas:
| data | o que quebrou | menor correção | regra da ficha alterada |
| <dd/mm> | <ex.: inventou horário> | <ex.: exigir FALTA DADO> | <Dados> |
Como verificar: no dia 7 você deve ter o registro preenchido (mesmo que com “nenhuma falha”) e no máximo uma regra alterada.
Do conceito à ação
- Dias 1 e 2: identificar a condição inicial.
- Dias 3 a 5: aplicar a decisão descrita.
- Dia 6: conferir o efeito no exemplo.
- Dia 7: registrar a evidência de saída.
✓ Faça assim
✓ Anote a falha no mesmo dia, em uma linha, com a menor correção possível.
✗ Evite este erro
✗ Subir o nível do agente na primeira semana porque “está indo bem”.
Pratique antes de revelar
Monte o calendário da sua primeira semana com os horários reais em que você vai conferir o agente.
Ver resposta comentada
O calendário só funciona se couber na sua agenda: 2 minutos no mesmo horário todo dia e 10 minutos no fim da semana. Para subir de N1 para N2, a ficha pede fonte definida e cerca de duas semanas de rascunhos sem erro, então o registro é o que comprova.
Da ficha ao sistema: vários agentes, uma organização
O que é
Com o primeiro agente funcionando, surgem outros. Aí a organização passa a ter três partes: pessoas, processos e agentes. Um mapa de agentes lista cada um com sua tarefa, nível, fonte da verdade, dono humano e para quem entrega. Cada agente continua com sua própria ficha; o mapa mostra como eles se encaixam.
Por que aprender
Sem mapa, agentes se sobrepõem, leem fontes diferentes para o mesmo dado e ninguém sabe quem responde por eles. Com mapa, cada agente tem dono e cada entrega tem destino. É a mesma lógica do organograma, agora incluindo quem não é gente.
Conceitos-chave
Objetivo: montar o mapa de agentes da sua organização.
Agente | Tarefa | Nível | Fonte da verdade | Dono | Entrega para
<Recepção> | <rascunha FAQ> | <N1> | <FAQ oficial> | <Ana> | <Ana revisa>
<Agenda> | <confirma horas> | <N2> | <agenda do sistema>| <Bruno> | <cliente, após OK>
<Relatório> | <resume semana> | <N1> | <planilha vendas> | <você> | <reunião de 2ª>
Regras do mapa:
- um dono humano por agente
- uma fonte da verdade por tipo de dado
- cada agente com sua ficha (AGENTE.md ou Ficha web)
Como verificar: se dois agentes usam fontes diferentes para o mesmo dado, ou algum agente não tem dono, corrija antes de ligar o próximo.
✓ Faça assim
✓ Dê a cada agente um dono humano com nome, que revisa e responde por ele.
✗ Evite este erro
✗ Ligar agentes novos sem ficha só porque o primeiro deu certo.
Pratique antes de revelar
Desenhe o mapa com o agente que você montou neste projeto e mais dois que você gostaria de ter. Qual seria o próximo a ligar?
Ver resposta comentada
O próximo deve seguir o mesmo critério do primeiro: frequente, visível e erro barato. O mapa ajuda a ver se ele depende de outro agente ou de uma fonte ainda não definida; se depender, a ficha dele sai em N1 até essa fonte existir.
Confira seu entendimento
Você vai montar seu primeiro agente em produção. Qual tarefa é o melhor ponto de partida?
O que você leva deste módulo
Colocar um agente real para trabalhar com ficha, nível calculado, testes aprovados e uma semana de supervisão registrada.
- Escolha a tarefa certa para começar.
- Monte a ficha.
- Rode os testes e ajuste.
- Audite um agente que você já usa.
- A primeira semana de supervisão.
- Da ficha ao sistema: vários agentes, uma organização.
Próxima ação: aplique o que aprendeu na ficha do seu agente e anote o que ainda precisa de revisão.