documentação — time de agentes

Um time misto: Claude Code, agentes 24/7 e automações

Tudo neste portfólio é construído por uma pessoa com um time de agentes de IA. Não é um agente só nem uma plataforma só: são três tipos de executor, cada um no que faz melhor, e uma convenção de arquivos que deixa qualquer um deles retomar o trabalho de onde o outro parou.

Quem faz o quê

executor	faz	quando
Claude Code principal	A maior parte da construção: código, arquitetura, pesquisa, revisão. Uma sessão por projeto, com contexto isolado, mais uma sessão de entrada que só roteia pedidos pro projeto certo.	Sob demanda — pelo computador ou pelo celular
Agentes OpenClaw 24/7	Sete agentes especializados num servidor próprio, conversando por Telegram: iteração do dia a dia, código, pesquisa/planejamento, uma faixa só-Google, e agentes dedicados a projetos (base de conhecimento, Deep History, Founder Dag).	Sempre ligados
Automações dos produtos agendadas	Rotinas próprias de cada produto — curadoria noturna, compilação de conhecimento, digests diários, editor automático — rodando em horário fixo, sem conversa.	Por agenda
Você (humano) gate	Decide. Nenhum executor aprova o próprio trabalho: decisão de produto passa pelo Founder Dag e termina numa decisão humana.	Em todo ponto de decisão

Como os agentes 24/7 são montados

Free-first. Cada agente tem uma cadeia longa de modelos gratuitos ou abertos; um único modelo pago fica no fim, como rede de segurança — nada trava de vez.
Isolado por provedor. Se um provedor cai ou estoura cota, só os agentes que dependem dele são afetados.
Failover escalonado. Erro de cota, autenticação ou timeout passa pro próximo modelo da cadeia; requisição inválida ou contexto estourado, não.
Especializado. Cada agente tem papel e ferramentas próprios; um agente generalista não faz o trabalho de um dedicado.

Protocolo de handover: como passam o bastão

Qualquer agente consegue ler o repositório inteiro — o problema nunca foi acesso, foi continuidade: saber onde o outro parou. A solução é uma convenção de arquivos dentro de cada repositório. Não depende de plataforma: Claude Code, agentes OpenClaw e outras ferramentas (Cursor, Antigravity, Windsurf) seguem a mesma.

arquivo	pra quê
`AGENTS.md`	Porta de entrada: “leia o handoff primeiro, atualize ao terminar”. Ferramentas que suportam o padrão AGENTS.md acham sozinhas.
`.agent-context/HANDOFF.md`	Onde parou: estado atual, próximo passo, quem mexeu por último, perguntas em aberto. Texto livre, pra humano e agente.
`.agent-context/context.json`	O mesmo estado, estruturado. É dele que sai o card de cada projeto na página inicial — só a parte marcada como pública.
`.agent-context/DECISIONS.md`	Decisões duráveis e o porquê — memória que sobrevive a qualquer sessão.
`.dag/`	Só em projetos no loop de produto: oportunidades e decisões do Founder Dag. Convive com o handover, com outro propósito.

O fluxo

O agente abre o repositório e lê AGENTS.md → HANDOFF.md.
Trabalha.
Antes de terminar, atualiza HANDOFF.md e context.json.
Envia pro GitHub — a fonte da verdade. O que não foi enviado não está salvo.
O próximo executor — outro agente, ou eu semanas depois — começa do passo 1.

Funciona sempre? Não 100% — e é por isso que existe verificação. A convenção está na maior parte dos repositórios ativos, não em todos. Num teste, um agente de modelo mais fraco declarou sucesso sem ter lido os arquivos de referência. Por isso alguns repositórios têm uma trava técnica: o envio pro GitHub é bloqueado se o handover não foi atualizado — e um verificador automático confere as páginas públicas antes de publicar.