Entrega com agentes: uma pasta por cliente, portões humanos e segredo fora
Agentes fazem o repetitivo: rodar o raio-x, montar o relatório, propor títulos, escrever o rascunho. O que dá confiança ao cliente é que nada vai ao ar sem um humano aprovar, e que a senha dele nunca está no seu repositório. Uma pasta por cliente, sempre com a mesma estrutura.
1A estrutura de pasta que se repete em todo cliente
2Onde o agente trabalha e onde só o humano decide
3Por que o portão nunca é pulado, nem com pressa
4Segredo fora do repositório e modelo pela assinatura
Objetivo: montar a pasta de um cliente com estrutura fixa, portões humanos e segredo fora do repositório, para entregar com agentes sem perder controle.
01 · A máquina de entrega de um cliente
Clique em cada bloco.
Todo mês: observar alimenta o próximo portão 1
Clique em cada bloco do diagrama para ver o que ele faz.
O agente acelera o trabalho; os portões guardam a confiança do cliente.
02 · Como montar a entrega
Clique em cada etapa.
1. Pasta
Crie a pasta com a estrutura fixa e um arquivo de instruções para o agente (AGENTS.md ou CLAUDE.md) com as regras do cliente: tom, o que não publicar, quem aprova.
Versão no git: cada mudança tem data, autor e pode ser desfeita.
2. Segredo fora
Chaves e credenciais ficam em variáveis de ambiente, nunca no repositório nem no prompt.
Acesso aos painéis do cliente é o de leitura, autorizado por escrito (aula 7).
3. Portões
Se o cliente não tem tempo de revisar, a cadência cai. O portão não é pulado.
Ajuda: o agente entrega o resumo do que mudou e as 3 coisas para o cliente confirmar.
No INEMAUm script de links pegou o nome errado de um curso numa subpasta. Foi pego no piloto, antes do push. É para isso que serve rodar pequeno e conferir antes.
4. Conferir o agente
Todo número que o agente produz passa por uma conta de conferência: a parte não pode ser maior que o todo.
No INEMA, um export somou as impressões de marca por consulta e página e deu mais que o total da semana. A correção foi somar só por consulta.
03 · Modelos da pasta
Copie e troque o que está entre < >.
Terminal · criar a pasta do cliente
mkdir -p <cliente>/{docs,briefings,reports,scripts,data/gsc}
cd <cliente> && git init -b main
printf '.env\n*.key\ncredenciais/\n' > .gitignore
touch .env AGENTS.md data/urls-chave.txt data/consultas-alvo.txt
Estrutura (modelo do repo de trabalho do INEMA)
docs/ diagnóstico, plano, proposta, autorização
briefings/ <slug>.md, um por página
data/gsc/ export semanal (só acrescenta)
reports/ semana-<data>.md, mensal-<mês>.md
scripts/ raio-x, export, relatório
AGENTS.md regras do cliente para o agente
.env segredo (fora do git)
AGENTS.md · regras do cliente
# Regras — <cliente>
- Tom: <como o cliente fala>. Público: <quem>.
- Todo número ou citação vem de fonte do cliente; sem fonte, marcar PENDENTE e não publicar.
- Antes de publicar: checklist de qualidade completo.
- Portão 1: <nome> aprova a lista do mês. Portão 2: <nome> aprova cada página.
- Nunca: publicar sem aprovação, lote grande de uma vez, página por variação de palavra-chave.
- Modelo pela assinatura. API paga só com autorização escrita para a finalidade.
- Segredo só no .env. Nunca imprimir chave em log ou relatório.
04 · Prática: a pasta do primeiro cliente
Pode ser o seu próprio site como cliente-zero.
E1 · Pasta com segredo fora
25 min
Crie a pasta com a estrutura, o .gitignore e o AGENTS.md preenchido. Faça o primeiro commit.
Pronto quando: o comando git status não mostra o .env, o AGENTS.md tem tom, regra de fonte, os dois portões com nome e a regra de API, e o primeiro commit existe.
E2 · Os portões no papel
20 min
Escreva quem aprova cada portão, quanto tempo leva e o que acontece se a pessoa não tiver tempo naquela semana.
Pronto quando: a lista tem os dois portões com nome, tempo em minutos e a frase "se não houver revisão, a cadência cai; o portão não é pulado".
05 · Teste o que aprendeu
A explicação aparece depois da sua resposta.
Pergunta 1 de 4
O cliente sumiu nas férias e não revisou as páginas da semana. O que você faz?competência
Correto
O portão é o que dá confiança ao serviço. Pular uma vez é o que cria o problema que você não consegue explicar depois.
Não é essa
O portão é o que dá confiança ao serviço. Pular uma vez é o que cria o problema que você não consegue explicar depois.Rever: Como montar a entrega
Pergunta 2 de 4
Onde fica a credencial de leitura do Search Console do cliente?
Correto
Segredo no repositório ou no prompt vaza em commit, log ou relatório. O .gitignore garante que ele não sobe.
Não é essa
Segredo no repositório ou no prompt vaza em commit, log ou relatório. O .gitignore garante que ele não sobe.Rever: Modelos da pasta
Pergunta 3 de 4
O agente diz que as impressões de marca da semana foram maiores que o total. O que isso indica?
Correto
Conta de conferência simples pega erro do agente antes de ele ir para o relatório do cliente.
Não é essa
Conta de conferência simples pega erro do agente antes de ele ir para o relatório do cliente.Rever: Como montar a entrega
Pergunta 4 de 4
Em que ponto o agente pode trabalhar sem aprovação humana?
Correto
O repetitivo é do agente. A decisão do que fazer e do que vai ao ar é do humano.