// SESSION 09.07.26 · AGÊNCIA IA 50K MasterClass

ENGENHARIA DE CONTEXTO

Faça a IA lembrar de tudo — por projeto, entre sessões.

Por que o Claude re-explora seu projeto toda vez, e o sistema que resolve isso de vez.

RAFAEL CASTRO · ZX LAB · MENTOR PROGRAMA AGÊNCIA IA 50K

Novidades

00

O que mexeu na semana

Três lançamentos que todo mundo que usa IA precisa saber — antes do tema de hoje.

Novidades · Anthropic

Claude Cowork agora no celular e na web

O modo em que você delega tarefas ao Claude — arquivos, email, calendário, apps — saiu do desktop.

O que é

Cowork = você delega uma tarefa e o Claude executa sozinho (arquivos, email, calendário, apps de mensagem, web, ferramentas conectadas).
Mais de 90% do uso é não-código — as maiores categorias são operação de negócio e criação de conteúdo.

O que mudou (07/07/26)

Agora em iOS, Android e web (claude.ai) — antes só no app desktop. Beta rolando a partir dos usuários Max.
Continuidade entre dispositivos: começa no computador, acompanha pelo celular, pega o resultado pronto em qualquer lugar.
Roda em background: a tarefa continua mesmo sem nenhum dispositivo ligado — e dá pra agendar.
Portões de aprovação: ele só pergunta o que só você pode decidir — e a pergunta chega no seu celular no meio da tarefa.

Por que importa pra você

É exatamente o conceito desta aula: um agente que trabalha sozinho com o contexto certo — agora no seu bolso.

claude.com/blog/cowork-web-mobile

Novidades · OpenAI

GPT-Live — a voz do ChatGPT que fala e ouve ao mesmo tempo

Nova geração de modelos de voz da OpenAI: conversa em tempo real, sem o 'walkie-talkie' de turnos.

O que é

Arquitetura full-duplex: ouve e fala ao mesmo tempo. Solta 'mhmm', concorda, te interrompe e aceita ser interrompido — conversa de verdade.
Duas versões: GPT-Live-1 (padrão Plus/Pro) e GPT-Live-1 mini (padrão Free). Rollout global em iOS, Android e web.

Como funciona

Pra perguntas que exigem busca ou raciocínio pesado, ele delega pro modelo grande no fundo (GPT-5.5 no lançamento) e traz a resposta de volta pra conversa.
O ChatGPT Voice agora mostra cards visuais (clima, ações, esportes) + web search + memória.

A leitura ZX LAB

O mercado inteiro correndo pra voz natural — ótimo pra atendimento e close. Mas o trabalho pesado continua sendo agente + contexto, que é o que a gente domina.

openai.com/index/introducing-gpt-live

Novidades · xAI

Grok 4.5 — a aposta 'classe Opus' da xAI

Elon posiciona como 'nível Opus, porém mais rápido, mais eficiente em tokens e mais barato'.

Os números (segundo a cobertura — revalidar ao vivo)

Lançado 08/07/26 (dev) e 09/07 (público). Janela de contexto de 500K tokens.
Artificial Analysis: #4 de 168 modelos no Intelligence Index. Código: 83,3% no Terminal-Bench 2.1 e 64,7% no SWE-Bench Pro.
Preço citado: US$2/milhão de tokens de entrada · US$6/milhão de saída. Tem function calling, JSON, busca na web e no X, execução de código.

A leitura ZX LAB

Toda rodada de modelo aperta o mesmo botão: mais barato e mais 'agêntico'. Quem tem o processo e o contexto montados troca de motor sem dor — e é isso que a gente constrói hoje.

x.ai/news/grok-4-5

Agenda

O que vamos cobrir hoje

Um problema que todo mundo tem, o conceito que resolve, e o sistema pronto pra você usar hoje.

01

O problema: context rot

Por que toda sessão começa do zero

~8 MIN

02

O conceito: engenharia de contexto

Contexto como artefato, não como conversa

~8 MIN

03

O sistema: o trio de documentos

CLAUDE.md · MAPA-PROJETO.md · HISTORICO-SESSOES.md

~12 MIN

04

Demo ao vivo

Mapear um projeto real — e o que a IA achou sozinha

~12 MIN

05

Por que muda o jogo pra agência

N projetos de cliente sem perder o fio

~7 MIN

06

Git, equipe e mão na massa

Versionar, trabalhar junto e começar hoje — sem ser dev

~13 MIN

Bloco 01

01

O problema: context rot

Você já sentiu isso — só nunca deu nome.

01.1 · O sintoma

Toda sessão, o Claude começa do zero

Abre o projeto de novo e é como se ele nunca tivesse estado ali.

Os três vazamentos

Re-explora o codebase — lê os mesmos arquivos, refaz o mesmo mapa mental, gasta os mesmos tokens que gastou ontem.
Esquece o que já foi feito — a decisão de ontem, o bug que você já corrigiu, o 'não mexe nisso que quebra'.
Empurra tudo pra memória global — que incha, mistura projetos e vira ruído em vez de ajuda.

Por que isso acontece

O conhecimento do projeto vive só na sua cabeça e no histórico da conversa.
Quando a sessão fecha, o histórico some — e o conhecimento vai junto.
Resultado: você paga o 'imposto de re-exploração' toda vez que volta.

01.2 · O custo

Isso custa três coisas ao mesmo tempo

Não é só chato — é caro, e escala mal.

O que você perde

Tokens — meia sessão só reconstruindo o que já era conhecido.
Tempo — você re-explica o projeto pro assistente antes de qualquer trabalho útil.
Continuidade — quanto mais projetos você toca, pior: nenhum mantém contexto.

Onde dói mais

Quem toca vários projetos de cliente ao mesmo tempo sente na pele — troca de contexto o dia inteiro.
Projetos que ficam semanas parados e você retoma sem lembrar de nada.

Bloco 02

02

O conceito: engenharia de contexto

A virada de chave: parar de tratar contexto como conversa.

// engenharia de contexto · o trio

Três documentos, três papéis — um por pergunta.

CLAUDE.md

as regras da casa

Como eu devo agir aqui?

Regras e convenções do projeto. Você já usa — é nativo do Claude Code.

MAPA-PROJETO.md

a planta baixa

Como o projeto funciona por dentro?

Arquitetura, arquivos-chave, fluxos, tabelas, armadilhas. Gerado pela skill /mapear-projeto.

HISTORICO-SESSOES.md

o diário de bordo

O que mudou, sessão a sessão?

Decisões, entregas e pendências. Gravado pelo zx-worklog.py.

Contexto pronto na 1ª mensagem

// sem re-explorar · sem esquecer · sem inchar a memória global

02.1 · A virada

Contexto vira artefato versionado, não conversa

Ele mora na pasta do projeto — não na janela do chat que some quando você fecha.

Três documentos, três papéis claros

CLAUDE.md — como eu devo agir aqui? Regras e convenções. (você já usa; é nativo do Claude Code)
MAPA-PROJETO.md — como o projeto funciona por dentro? Arquitetura, arquivos, fluxos, tabelas, armadilhas.
HISTORICO-SESSOES.md — o que mudou, sessão a sessão? Decisões, entregas, pendências.

O ganho

Os três juntos entregam ao assistente, já na primeira mensagem, o que ele levava meia sessão pra reconstruir.
Não é memória global genérica — é contexto específico do projeto, no lugar certo.

Bloco 03

03

O sistema: como funciona

Duas ferramentas mantêm o trio no automático.

03.1 · A skill /mapear-projeto

/mapear-projeto — gera o mapa por você

Você não escreve o MAPA-PROJETO.md à mão. A skill faz — e confere contra o código.

Como funciona

Dispara agentes de exploração em paralelo (estrutura, dados, fluxos, gotchas).
Verifica cada afirmação contra o código atual antes de escrever — nada de copiar suposição velha.
Escreve o MAPA-PROJETO.md pronto na raiz do projeto.

O golpe (auditoria de brinde)

Como ela confere tudo, acha defeito real no caminho: README desatualizado, config apontando pro lugar errado, até segredo vazado no histórico.
Você pediu documentação — e ganhou uma auditoria junto.

03.2 · O histórico

zx-worklog.py — o diário de bordo automático

Ao terminar de trabalhar, um comando registra o que mudou.

O que ele faz

Prepend no HISTORICO-SESSOES.md do projeto (mais recente no topo).
Upsert num índice central — todo projeto que tem histórico aparece num mapa só.
Funciona com ou sem git — é markdown, não depende de commit.

# ao terminar de trabalhar num projeto zx-worklog.py add --dir . \ --title "o que você fez" \ --summary "1 linha pro índice" ✓ histórico gravado: ./HISTORICO-SESSOES.md ✓ índice atualizado: ~/.context-worklogs/INDEX.md

Bloco 04

04

Demo ao vivo

Vamos mapear um projeto real — e ver o que a IA acha sozinha.

04.1 · Demo

Rodando /mapear-projeto num projeto de verdade

Sem preparo, sem roteiro plantado — o projeto como ele está.

O que você vai ver

A skill abrindo vários agentes em paralelo pra entender o projeto.
O MAPA-PROJETO.md nascendo: stack, páginas, tabelas, fluxos, armadilhas.
E — no piloto real que fizemos — os defeitos que ela pegou sem ninguém pedir.

O que ela pegou no piloto (histórias reais)

Um README dizendo '3 plataformas' quando na verdade eram 6 — e apontando pro serviço de fundo errado.
Um doc de contexto com um fluxo desatualizado (uma integração que tinha saído semanas antes).
Um token de acesso vazado no endereço remoto de um dos repositórios.

// demo · o golpe

Não é só doc — é auditoria de brinde.

README dizia "3 plataformas" — eram 6

E ainda apontava pro serviço de fundo errado. Documentação que enganava quem lia.

PEGO SOZINHO

Doc de contexto com fluxo desatualizado

Descrevia uma integração que tinha saído do ar semanas antes. Ninguém tinha percebido.

PEGO SOZINHO

Token de acesso vazado no endereço de um repositório

Uma credencial exposta no remote do git — o tipo de coisa que vira incidente.

PEGO SOZINHO

Bloco 05

05

Por que muda o jogo pra sua agência

Pra quem toca vários projetos de cliente, isso é vantagem competitiva.

05.1 · O que você ganha

O que isso significa na prática

🧠

Cada cliente com seu contexto no lugar. Você troca de projeto o dia todo sem re-explicar nada pro assistente.

⚡

Projeto novo (seu ou herdado) fica 'conhecido' em minutos — a skill mapeia e você já produz.

💰

O assistente lê o mapa em vez de reconstruí-lo. Toda sessão começa adiantada.

🎯

Entrega consistente, retomada sem tropeço, nada 'perdido entre uma conversa e outra'.

Bloco 06

06

Git, GitHub e trabalho em equipe

Por que seu projeto vive num repositório — e como mexer nisso sem ser dev.

06.1 · Por que importa

Por que o projeto mora no GitHub

🕓

Cada mudança fica registrada. Dá pra voltar no tempo, ver quem mudou o quê e desfazer sem medo — nada se perde.

🛡️

O projeto fica na nuvem, com backup. Se seu computador morrer amanhã, o trabalho continua vivo e recuperável.

🤝

Várias pessoas mexem no mesmo projeto sem sobrescrever o trabalho uma da outra. O GitHub junta tudo de forma organizada.

// git · o fluxo sem juridiquês

Do seu computador pro mundo, em poucos movimentos.

Seu computador

Onde você (ou o Claude) edita os arquivos.

commit → push

salva um ponto e envia pra nuvem

GitHub

O projeto guardado na nuvem, com todo o histórico.

deploy

publica a versão atual

No ar

Site/produto rodando pro cliente usar.

pull e no caminho de volta: pull traz pro seu computador o que a equipe já enviou. Ninguém trabalha em cima do trabalho velho.

// git · dicionário sem susto

As palavras que assustam — traduzidas.

repositórioa pasta do projeto guardada no GitHub, com todo o histórico. Também chamada de "repo".

clonebaixar uma cópia do projeto do GitHub pela primeira vez, pro seu computador.

commitsalvar um ponto do trabalho, com um bilhetinho do que você mudou.

pushenviar seus commits pro GitHub (a nuvem), pra ficar guardado e compartilhado.

pullpuxar pro seu computador o que a equipe já enviou — antes de mexer.

branchuma via paralela pra você mexer sem bagunçar a versão principal.

mergejuntar sua via paralela de volta na principal quando estiver pronta.

deploypublicar a versão atual no ar, pro cliente/público usar.

// na prática, 90% do dia é só: pull → mexer → commit → push.

Bloco 07

07

Como usar hoje

Está tudo pronto. Três passos e você começa agora.

07.1 · Mão na massa

Clona, instala, usa

O repositório é público e o instalador cuida de tudo.

Três passos

1. Clona o repo zx-context-system e roda o install.sh.
2. Em qualquer projeto: /mapear-projeto gera o mapa e você cola o ponteiro no CLAUDE.md.
3. Ao terminar: zx-worklog.py add registra a sessão. Pronto — contexto persistente.

gh repo clone zxmarketingdigital/zx-context-system cd zx-context-system && bash install.sh ✓ skill -> ~/.claude/skills/mapear-projeto/ ✓ script -> ~/bin/zx-worklog.py ✅ Instalado.

github.com/zxmarketingdigital/zx-context-system

07.2 · O acervo completo

Isso é uma amostra. O sistema inteiro é ZX Control.

O que você leva hoje já resolve seu contexto. Mas é a ponta do iceberg.

O que você leva de graça hoje

A skill /mapear-projeto + o zx-worklog.py + o padrão dos 3 documentos, no repositório público.

O que roda a operação ZX LAB de verdade

Dezenas de skills e automações — vendas, onboarding, tráfego, deploy, monitoramento — encaixadas nesse mesmo padrão de contexto.
Esse acervo completo é exclusivo de quem está no ZX Control.

// O ACERVO COMPLETO É EXCLUSIVO DE QUEM ESTÁ NO ZX CONTROL Próximo passo

ZX CONTROL

Garanta sua vaga no ZX Control

O sistema completo de skills e automações que roda a operação ZX LAB — o que você viu hoje é a ponta do iceberg.

Garantir minha vaga agora

aponte a câmera

https://zxlab.com.br/mission-control