PTENES
Pular para o conteúdo
TRILHA 3

⚙️ Rotear e executar

Com as pontes ligadas, falta decidir quem faz o trabalho e como provar que terminou. Escolha o modelo certo para render a cota, monte um time de três papéis, solte sessões em segundo plano e deixe um agente trabalhar por horas até a verificação passar.

4
Módulos
24
Tópicos
~2h20
Duração
Médio
Nível
0 de 240%
super topo executor menor comece aqui 🧭 planejador 🛠️ executor 🔍 revisor verificar 4/4 OK modelo certo · time em paralelo · pronto com prova

Mapa da trilha

Conteúdo detalhado

3.1~35 min

🎚️ Modelo certo, cota rende

O ROTEAMENTO.md: quatro níveis de modelo no Claude Code, no Codex e no Ollama, e quatro regras para gastar menos cota sem perder qualidade.

0 de 60%
O que é:

Cada chamada consome a cota da sua assinatura, o limite de uso por período. Não é cobrança por uso, como na API.

Por que aprender:

Usar sempre o modelo mais forte esgota a cota antes da hora e trava o trabalho do dia.

Conceitos-chave:

Cota, assinatura, API, consumo por chamada.

O que é:

A tabela do ROTEAMENTO.md: quando usar cada nível e qual modelo corresponde a ele no Claude Code, no Codex e no Ollama (local, grátis).

Por que aprender:

Com a tabela à mão, você escolhe o modelo pela tarefa, e não pelo hábito.

Conceitos-chave:

Nível de modelo, esforço, modelo local, Ollama.

O que é:

A regra 1: triagem, formatação e checagem vão no menor modelo; você sobe de nível só quando ele erra.

Por que aprender:

A maior parte das tarefas do dia a dia cabe nos níveis de baixo, e a cota sobra para o que é difícil.

Conceitos-chave:

Menor que resolve, subir de nível, triagem.

O que é:

A regra 3: a revisão feita por outro modelo, como o Codex pela ponte da receita R1, pega erros que o mesmo modelo não vê.

Por que aprender:

Um modelo tende a concordar consigo mesmo; um segundo olhar quebra esse ponto cego.

Conceitos-chave:

Segunda opinião, ponte codex-exec, ponto cego.

O que é:

As regras 2 e 4: time de agentes só quando o trabalho supera o custo de montar o time, e agente dentro de agente carrega as instruções do projeto.

Por que aprender:

Time em tarefa pequena só multiplica o consumo; pasta enxuta ou o modo --bare deixam pontes simples mais leves.

Conceitos-chave:

Custo de montar o time, pasta enxuta, --bare.

O que é:

Conferir os nomes dos modelos com claude --help e codex --help e atualizar a tabela do ROTEAMENTO.md.

Por que aprender:

Modelos são renomeados e substituídos; tabela velha manda o agente pedir um modelo que não existe mais.

Conceitos-chave:

--help, nome de modelo, tabela viva.

Ver Completo
3.2~35 min

👥 Time de três papéis

A receita R2: planejador, executor e revisor, cada um com o modelo que precisa, rodando numa sessão só do Claude Code.

0 de 60%
O que é:

Três subagentes do Claude Code: o planejador (forte) planeja, o executor (médio) faz e o revisor (leve) confere.

Por que aprender:

Cada papel usa o modelo que precisa, e a cota rende mais do que com um modelo forte fazendo tudo.

Conceitos-chave:

Subagente, papel, planejador, executor, revisor.

O que é:

Os três arquivos em .claude/agents/, com nome, descrição, modelo, ferramentas e instruções de cada papel.

Por que aprender:

Lendo os arquivos você entende o que cada papel pode fazer: planejador e revisor só leem, o executor altera (N3).

Conceitos-chave:

Arquivo de papel, model:, ferramentas, N3.

O que é:

Abrir o claude na pasta e pedir ao time que crie saudacao.txt com a frase "Olá, comunidade INEMA".

Por que aprender:

É o jeito mais fácil de ver os três papéis trabalhando em sequência, com o revisor fechando em APROVADO.

Conceitos-chave:

Sessão interativa, prova, APROVADO.

O que é:

O mesmo pedido num comando só, com claude -p, terminando com a resposta do revisor.

Por que aprender:

Sem tela, o time pode ser chamado por script; a prova do kit custou o equivalente a ~US$ 0,73 de API, que na assinatura é cota.

Conceitos-chave:

-p, execução sem tela, cat saudacao.txt, cota.

O que é:

Trocar a tarefa: a Sônia resume o CSV do ERP com o revisor conferindo os totais; a Clara lista horários livres e o revisor confere que nenhum ocupado apareceu.

Por que aprender:

O time só vale a pena quando resolve o seu trabalho real, com uma conferência que você entende.

Conceitos-chave:

Tarefa real, conferência, totais, horário ocupado.

O que é:

Editar a linha model: de um papel (haiku, sonnet, opus ou inherit) e copiar um arquivo de .claude/agents/ para criar um papel novo.

Por que aprender:

O time se ajusta ao seu caso sem programar: é só editar texto.

Conceitos-chave:

model:, inherit, papel novo, descrição.

Ver Completo
3.3~35 min

🧵 Time em segundo plano

A receita R4: várias sessões com claude --bg, cada uma com nome, modo e modelo, acompanhadas pelo observar.mjs.

0 de 60%
O que é:

A versão oficial do que vídeos de mods chamavam de "Threads": sessões que trabalham sozinhas, em segundo plano.

Por que aprender:

É comando documentado: não quebra na próxima atualização como o fio improvisado dos vídeos.

Conceitos-chave:

Sessão, segundo plano, id, via oficial.

O que é:

Abrir o claude na pasta uma vez e trocar a opção "No, exit" por "Yes, I trust this folder".

Por que aprender:

Sem isso, o --bg responde Workspace not trusted e nenhuma sessão nasce.

Conceitos-chave:

Pasta confiável, aviso de confiança, Workspace not trusted.

O que é:

Duas linhas de comando: um revisor em modo plano, que só lê, e um executor no sonnet, que cria resumo.md.

Por que aprender:

Nome, modo e modelo por sessão aplicam a POLITICA e o ROTEAMENTO; e -p junto com --bg o Claude recusa.

Conceitos-chave:

--bg, --permission-mode plan, --model, --name.

O que é:

O observar.mjs mostra id, tipo, nome, estado e idade de cada sessão desta pasta (ou de todas, com --todas).

Por que aprender:

Em segundo plano ninguém vê uma sessão travar; a coluna estado mostra working, idle, done, blocked ou failed.

Conceitos-chave:

observar.mjs, estado, blocked, --todas.

O que é:

Três comandos com o id da tabela: claude logs lê a tela, claude attach entra na sessão e claude stop para.

Por que aprender:

Você destrava um blocked, lê a resposta de um done e corta uma sessão que só gasta cota.

Conceitos-chave:

logs, attach, stop, /painel.

O que é:

Cada sessão grava em arquivo e uma sessão chefe (ou o time da R2) consolida e confere no fim.

Por que aprender:

Cada sessão consome cota: comece pela R2 e só solte sessões paralelas quando o trabalho compensar.

Conceitos-chave:

Arquivo por sessão, sessão chefe, consolidar, cota.

Ver Completo
3.4~35 min

🎯 Agente longo com verificação

A receita R6: um goal com critérios comando → saída, o verificar.mjs como juiz e portões humanos escritos no próprio goal.

0 de 60%
O que é:

Em tarefas de horas, o agente perde detalhes e declara "pronto" cedo; a R6 só aceita o fim quando os critérios provam.

Por que aprender:

O erro descoberto só no uso custa mais que uma checagem automática a cada etapa.

Conceitos-chave:

Goal, critério, saída 0 e 1, portão humano.

O que é:

Uma linha de lista por critério, com o comando e o texto esperado entre crases, separados por uma seta.

Por que aprender:

Bom critério é sim ou não e impossível de passar sem o trabalho; "deixar bom" não é critério.

Conceitos-chave:

Critério verificável, texto esperado, goal de exemplo.

O que é:

Rodar o verificar.mjs no goal de exemplo, que confere a ponte da agenda da Clara, o total da Sônia e o doctor.

Por que aprender:

O script não chama modelo nem gasta cota: você testa o juiz antes de entregar o goal ao agente.

Conceitos-chave:

verificar.mjs, OK, contagem, saída 0.

O que é:

Mudar um valor esperado numa cópia do goal e ver a linha virar FALHA, com saída 1, como provado no CHANGELOG 0.2.0.

Por que aprender:

Um juiz que nunca reprova não serve; você confirma que ele pega o erro.

Conceitos-chave:

Cópia do goal, FALHA, esperado, saída 1.

O que é:

O pedido /goal da R6: cumprir o goal, rodar o verificar depois de cada etapa e só parar com todos OK ou num portão humano.

Por que aprender:

Funciona no Claude Code e no Codex, porque o juiz é o mesmo script para os dois.

Conceitos-chave:

/goal, laço faz-verifica-corrige, execução longa.

O que é:

Frases de parada escritas no goal para gasto, envio, apagar e publicar, e uma linha no FALHAS.md ou no LIMITES.md a cada problema.

Por que aprender:

Agente que persegue o OK por horas não pode decidir sozinho o que é irreversível.

Conceitos-chave:

Portão humano, teto da POLITICA, FALHAS.md, LIMITES.md.

Ver Completo
← Trilha anterior: Conectar Próxima trilha: Governar e aprender →