Grupo JCA
Treinamento AI-First · Subfase 3.1

Treinamento AI-First
do time do Vanilla

Projeto Robustos Canais Digitais, transformação AI-First da ODPTech.

Setembro de 2026

AI for ROI
Abertura

Quem conduz o treinamento

Danilo SousaEscol.ai
Danilo Sousa
CTO

Graduado em Análise e Desenvolvimento de Sistemas, com pós-graduações em Inteligência Artificial pela FIAP, Games e DataScience. Atua como Líder de Tecnologia e IA na Escol.ai. Possui ampla experiência em educação, em instituições como Senac e na TOTVS. Especialista em Tecnologia, Análise de dados e Inteligência Artificial.

Henrique Andrade
Henrique Andrade
CTO

Executivo de tecnologia com mais de 30 anos de experiência em liderança tecnológica. Como aVP de Inovação na OSF Digital, liderou estratégias globais de GTM para soluções de IA. Especialista em arquitetura multicloud, integração de sistemas e Big Data. Fundador da iFactory Solutions (adquirida pela OSF Digital), atuando também como consultor estratégico e investidor.

Adriano Patrão
Adriano Patrão
CEO

Executivo de tecnologia e estratégia com mais de 25 anos de experiência. Fundou e liderou a iFactory Solutions até sua venda para a OSF Digital em 2018. Na OSF, conduziu crescimento acelerado e aquisições, gerenciando P&L de US$ 25 milhões e expandindo operações de 200 para mais de 700 pessoas na América Latina e Ibéria. Especialista em go-to-market, transformação digital, IA e M&A.

Abertura

Introduções

Antes de começar, uma rodada rápida com todo mundo. Cada um fala seu nome e seu papel no squad.

AV
André Domingues Vieira
Agilista
AB
Antonio Balbino
Dev
CL
Carlos Lima
QA
EH
Esther Angelica Hinrichsen
Coordenadora de Engenharia
ER
Eugenio Rosario
Dev
GP
Gabriel Bardelli Pereira
Designer
HM
Helder Morato Axhcar Junior
Tech Lead
JR
João Reis
PO
KM
Kelvi da Silva Marim
Analista DevOps
LF
Lucas Figueiredo
Dev
MR
Marcelo Rezende
Coordenador VSM
MA
Matheus Cardoso de Abreu
Dev
MS
Mauro Cesar da Silva
Arquiteto Backend Sr
MD
Maysa Di Marco
Gerente de Produto e Design
PD
Pedro Henrique Fortunato Dropa
Gerente de Engenharia e Arquitetura
clique em quem já se apresentou · 0 / 15
Abertura

O projeto e este treinamento

Estamos aqui
Fase 0 · Iniciação
Fase 1 · Fundação Estratégica e Diagnóstico
Fase 2 · Habilitação — pessoas, processos e ferramentas
Fase 3 · Pilotos e Aceleração
Fase 4 · Rollout (7 squads)
O projeto e onde estamos
  • Fase atual — planejamento do Vanilla
Este treinamento
  • Foco é ferramenta e método. O processo mostrado hoje é rascunho, ainda em aprovação
Abertura

Agenda do Dia

Manhã · Conceito e demonstração
  • Abertura — o que muda no dia a dia com AI-First e o papel do Vanilla como piloto
  • Modelos — por que a forma de pedir importa, janela de contexto e risco de resposta inventada
  • Modelo, ferramenta, sistema — Chat, Code, Cowork e Design, as quatro interfaces do Claude, e quando usar cada uma
  • Prompt — papel, contexto e formato de saída, os três ingredientes de um prompt bem escrito
  • Skills — o que é, por que versionar, construção de uma skill ao vivo
  • MCP — conectar o Claude ao Azure DevOps, Figma e Datadog
  • Governança e Uso Responsável — onde a conferência humana é obrigatória e o mínimo de LGPD
  • Mapa da tarde — o fluxo etapa a etapa, ligando a manhã à prática
Tarde · Prática sobre o processo do time
  • Abertura da tarde — contas prontas e caso de treino apresentado
  • Discovery e Refinamento — escrita de história com Chat e Design, item no board via MCP
  • Contrato e Desenvolvimento — contrato de API e código com Code
  • Testes e Revisão — subagente de QA e revisor no pull request
  • Documentação e Deploy — documentação com Cowork, pipeline com Code
  • Fechamento — ponta a ponta na ferramenta e o que fica em aberto
Abertura

O que muda no dia a dia com AI-First

PO e Designer

História e critério de aceite saem prontos do Chat e do Design. Menos ida e volta escrevendo do zero, mais tempo validando com o time.

Tech Lead e Arquiteto

Contrato de API sai no dia zero. Front, BFF e backend começam juntos, ninguém fica esperando ninguém.

Dev

Código nasce aderente ao contrato, menos código repetitivo. Revisão de pull request já passa por um subagente antes de chegar no humano.

QA

Teste deixa de ser a etapa que trava o fluxo. O Claude assume a geração de caso de teste junto com o desenvolvimento, não depois dele. É a proposta que o Vanilla vai validar.

Time todo

Documentação fica registrada no Cowork ao longo do fluxo, não na cabeça de quem saiu do time.

O Vanilla como piloto

Testa esse fluxo primeiro, com escopo pequeno e reversível. O que funcionar vira padrão pros outros squads, o que não funcionar é ajustado aqui antes.

Fundamentos

Modelo Ferramenta Sistema

Confundir os três é o erro número um. O modelo é o motor, a ferramenta é a carroceria, o sistema é a estrada onde o trabalho acontece.

01 · Motor

Modelo

Opus · Sonnet · Haiku
  • Prevê o próximo token. Não tem acesso a nada por conta própria
  • Tarefa de volume e formato conhecido: modelo rápido
  • Decisão irreversível ou depuração difícil: modelo profundo, mais esforço
02 · Carroceria

Ferramenta

As quatro interfaces do Claude
  • Mesmo motor, superfícies diferentes de trabalho
  • A ferramenta define o que o modelo consegue ver e tocar
  • Skills, contexto e conectores vivem aqui
03 · Estrada

Sistema

Azure DevOps · Figma · Datadog · repositório
  • Onde o trabalho do time realmente vive
  • O Claude chega neles via MCP, nunca o contrário
  • Permissão e governança são do sistema, não da IA
Claude ChatPesquisa, requisito, história, critério de aceite, análise e priorização
Claude CodeContrato, código, teste, revisão de PR, pipeline e log, direto no repositório
Claude CoworkDocumentação e organização a partir de um clone do repositório, via Git
Claude DesignProtótipo, artefato visual e trabalho conectado ao Figma
Fundamentos · Engenharia de Prompt

Papel, contexto e formato

Mesmo pedido, resultado completamente diferente. A diferença não é a palavra mágica, é o que você entrega junto.

pedido_vago.txt
pedido_engenheirado.txt
PAPEL · quem respondeCONTEXTO · o que entra juntoFORMATO · como sai↻ rodar de novo
Fundamentos · Engenharia de Contexto

Contexto é a mesa de trabalho

Prompt é o pedido. Contexto é tudo que está na mesa quando o pedido chega. E a mesa tem tamanho: tudo compete pelo mesmo espaço.

SESSÃO NOVA · janela saudável CLAUDE.md skills contrato + código lido histórico pedido espaço para a resposta 3 HORAS DEPOIS · repositório inteiro + 60 mensagens CLAUDE.md skills repositório inteiro colado 60 mensagens ↑ resposta espremida: sai curta, genérica ou cortada // mesmo pedido, mesmo modelo. O que mudou foi quanto entrou junto.
01O que vai na mesa: CLAUDE.md, contrato OpenAPI, padrões do time, um exemplo aprovado
02Mudou de assunto? Sessão nova
03Nunca o repositório inteiro. Aponte o arquivo, o Claude lê o que precisa
04Regra permanente vai pro CLAUDE.md ou pra skill, não pro chat
Fundamentos · Engenharia de Loop

O agente trabalha em loop

Chat responde uma vez. Agente pede, age, verifica e corrige até o critério fechar. O harness é o que torna esse loop repetível, não dependente de quem digita.

$ implementar: parte recusada não derruba as outras partes da divisão
[pensa] lê contracts/divisao-pedido.v1.yaml e .claude/skills/padroes-jca
[age] escreve useDivisaoPedido.js + 3 testes a partir do Gherkin
[verifica] npm test → 1 falha: "recusa de uma parte mantém as outras"
[corrige] status da divisão passa a ser derivado das partes, não da última resposta
[verifica] npm test → 3/3 verdes · contrato intacto
[pronto] PR aberto · subagente revisor passou · humano aprova
PedirPapel, contexto e formato. O critério de aceite é o alvo.
AgirLê, escreve, roda comando. Dentro do que a ferramenta enxerga.
VerificarTeste, lint, contrato. Sem verificação não há loop, há chute.
CorrigirVolta pro passo anterior com o erro na mão. Quantas vezes precisar.
Humano decidePR revisado por gente. O loop sugere, quem assina é o time.
Harness = CLAUDE.md + skills + subagentes + MCPVerificação automática é o que separa agente de chatNa terceira repetição, vira skill
Fundamentos · Skills

Skill: o prompt que virou ativo do time

Uma pasta com um arquivo de texto que ensina o Claude a fazer uma tarefa do jeito da JCA, disparada sozinha quando a tarefa aparece. Versionada no repositório, não no computador de alguém.

01É só um SKILL.md. Texto em português, não código
02Nome e descrição definem  quando ela dispara
03Vive em .claude/skills/ do repositório. Commit, revisão, dono
04Não construa do zero: importe, adapte, parta de skill open source
escrita-de-historiapadroes-jcarevisor-backendrevisor-frontendrevisor-testesclique numa skill para ver o prompt que a cria
.claude/skills/padroes-jca/SKILL.md
--- name: padroes-jcaidentidade description: Padrões de código do front headless e do BFF da POC Vanilla. Use SEMPRE que for criar ou alterar componente React, hook, rota de BFF ou teste.quando dispara --- # Padrões JCA · front headless + BFFa instrução ## Domínio antes de tudo Nenhum nome do core (COD_, VLR_) atravessa o BFF. Vocabulário: pedido, divisão, parte, participante, meio. ## Contrato manda O OpenAPI em /contracts é a fonte da verdade. Quebra de contrato trava o PR. ## Front dinheiro nunca é float · 5 estados visíveis ## Testes um test() por Then do Gherkin
Fundamentos · MCP

MCP é conexão, não ferramenta

Skill dá instrução. MCP dá mãos: é o protocolo pelo qual o Claude alcança os sistemas onde o trabalho vive. A seta tem um sentido só. Não é "o Azure conversando com o Claude".

ClaudeChat, Code ou Cowork. O mesmo conector serve as três.
CHATCODECOWORK
MCP
Azure DevOpstestado · a validar
Figmaem uso
Datadoga validar
Sonarse houver
Clique num sistema para ver o alcance.
Ele acessa o que você acessa: permissão é do sistemaComece lendo, depois libere escritaAção que escreve pede confirmação humana
Treinamento AI-First · Subfase 3.1

Governança e Uso
Responsável

Setembro de 2026

AI for ROI
Governança e Uso Responsável

Governança e Uso Responsável

Regras mínimas pra usar o Claude no dia a dia, direto da política de uso de IA da POC.

O que pode entrar no prompt
  • Código-fonte dos canais digitais, desde que sem credencial, chave ou dado de cliente embutido no arquivo
  • Documentação técnica interna, arquitetura, fluxo, especificação
  • Dado de teste sintético ou anonimizado de forma irreversível
O que nunca entra no prompt
  • Dado pessoal de cliente, nome, CPF, e-mail, telefone
  • Dado financeiro ou de pagamento
  • Credencial, token, chave de API ou segredo, em qualquer ferramenta
  • Dado de produção real, a POC opera só com dado de teste
  • Contrato ou dado jurídico da JCA
Na dúvida, é sensívelPolítica de uso de IA da POC
Governança e Uso Responsável
Modo agêntico

O agente tem limite

Modo agêntico é o Claude Code executando ação sozinho, sem alguém aprovando cada passo no meio. As regras abaixo dizem até onde ele vai sozinho e onde para.

01Roda só em ambiente de desenvolvimento isolado, com dado de teste
02Nunca acessa ambiente de produção, nem em modo leitura
03Não enxerga credencial, chave ou arquivo de configuração sensível, mesmo sem ninguém colocar no prompt
04Toda alteração vira pull request revisado por humano, nunca entra direto na branch principal
05Ação irreversível ou que sai da JCA pede confirmação humana explícita na hora
Governança e Uso Responsável

Conferência humana e incidente

Revisão obrigatória
  • Tudo que a IA gera deve ficar registrado e disponível pra conferência depois. Nada disso vira entrega, código publicado ou decisão sem alguém revisar antes.
  • Pra código, aprovar o pull request já é o registro formal dessa revisão
  • A responsabilidade final do que sai é sempre humana, nunca da ferramenta
Se algo der errado
  • Dado proibido submetido, mesmo sem querer, já é incidente
  • Avisar o Tech Lead e a governança na hora
  • Não apagar a sessão nem o histórico, isso vira evidência
Quem abre o PR responde pelo conteúdoSessão é evidência
Treinamento AI-First · Subfase 3.1

Mapa da Tarde

Setembro de 2026

AI for ROI
Mapa da Tarde

O mapa do fluxo, etapa e ferramenta

Recorte do fluxo oficial de Produto, simplificado nas nove etapas que a POC do Vanilla toca, cada uma com a ferramenta principal Claude.

Requisito
Chat
Priorização
Chat
Especificação
Chat
Contrato técnico
Code
Desenvolvimento
Code
Testes
Code
Code review
Code
Documentação
Cowork
Deploy
Code
01
RequisitoEstrutura a demanda e escreve histórias e critérios de aceite
Claude Chat
Claude ChatClaude CodeClaude Cowork clique numa etapa · ← → percorre as etapas
Mapa da Tarde

Situações reais usadas como pano de fundo

Problemas reais que o próprio time relatou numa etapa anterior do projeto, cada um vira um bloco de prática à tarde. Cenário real, sem entrar no mérito da correção proposta.

01
Discovery e Design

O time já usa IA pra prototipar e testar ideia, mas cada um usa do seu jeito, sem regra combinada.

02
Refinamento

O refinamento devia acontecer toda semana, mas na prática vira quinzenal e é cancelado com frequência.

03
Desenvolvimento e QA

Um item fica parado até quinze dias esperando teste, mesmo com o desenvolvimento já pronto.

04
Documentação

Quando alguém sai do time, a documentação técnica que ficou só na cabeça da pessoa se perde junto.

Treinamento AI-First · Subfase 3.1

Abertura da Tarde

Setembro de 2026

AI for ROI
Abertura da Tarde

Premissas para a tarde

Quatro combinados antes de abrir a ferramenta.

01Treino de ferramenta, não é decisão de processo
02Caso de treino é só um pretexto pra praticar
03Sem ligação com o Vanilla real, que ainda nem existe
04Contas do Claude configuradas antes de começar
Nunca no repo real do VanillaNinguém sai sem ativoTudo versionado em lugar combinado
Bloco 1 · Discovery e Refinamento

O que se escreve: história, item e skill

O briefing impresso é a única entrada. Tudo que sai daqui é texto que o Claude escreve e vocês revisam.

E1Chat

História com critérios Gherkin

O briefing vira história com no mínimo 6 cenários Given/When/Then. O que o briefing não responde vira pergunta ao PO, não critério.

historia.md (local)
E2Code

Work item no board

A história vira item do épico DELIVERY-1. Na aula o Claude escreve o arquivo que faz o papel do Azure DevOps.

azure-simulado/boards/ISSUE-004.md
E3Code

Skill escrita-de-historia

O que foi feito à mão no E1 vira skill versionada. Quem não estava na sala roda em outra demanda e recebe o mesmo formato.

.claude/skills/escrita-de-historia/SKILL.md
Bloco 2 · Contrato e Desenvolvimento

O que se escreve: contrato e código

Dois trilhos saindo do mesmo contrato. A skill padroes-jca já está no repositório e fica ativa o tempo todo.

E4Code

Contrato OpenAPI da fatia

A partir da história e dos payloads crus do core. Publicado antes de qualquer commit de código e revisado antes de seguir.

contracts/divisao-pedido.v1.yaml
E5Code

Adapter do BFF e componente do front

BFF e front em paralelo, os dois contra o mock do contrato. Se o componente precisou mudar quando ligou no BFF real, o contrato foi descumprido.

bff/src/adapters/ · web/src/features/divisao-pedido/
Bloco 3 · Testes e Revisão

O que se escreve: dois subagentes

Nenhum teste é escrito à mão. Os dois entregáveis são arquivos de configuração de subagente, e o que eles produzem.

E6Code

Subagente de QA

Deriva testes do Gherkin do E1, não do código do E5. Um test() por Then, com o nome dizendo a regra de negócio.

.claude/agents/qa-delivery.md · __tests__/
E7Code

Subagente revisor no PR

Trava explícita: divergência entre implementação e contrato reprova. O parecer vai anexado ao PR.

.claude/agents/revisor-contrato.md · pull-requests/PR-001.md
Bloco 4 · Documentação e Deploy

O que se escreve: documento e release note

Cada artefato no destino certo: work item para o que se esgota na entrega, Wiki para o que precisa ser achado depois, repositório para o que envelhece com o código.

E8Cowork

Documento de componente

Cowork sobre o clone do repositório. Lê contrato, código e testes e escreve a página que alguém acha daqui a seis meses.

azure-simulado/wiki/Componente-Divisao-Pedido.md
E8Code

Release note no work item

Claude Code sobre o código. Resume o que entrou, o que ficou fora e as decisões tomadas, anexado ao item da história.

azure-simulado/boards/ISSUE-004.md
DemoCode · facilitador

Leitura do log de pipeline

Você conduz, ninguém executa. O Claude lê o log, aponta a anomalia e propõe o ajuste. O log tem a quebra de contrato do E7 plantada.

azure-simulado/pipelines/run-0042.log
Treinamento AI-First · Subfase 3.1

Fechamento

Setembro de 2026

AI for ROI
Fechamento

Fechamento do dia

01Fica o método e a ferramenta, não o processo. O rascunho praticado hoje não é final
02Próximo passo: esperar escopo e ambiente do Vanilla ficarem prontos
RequisitoClaude Chat
PriorizaçãoClaude Chat
EspecificaçãoClaude Chat
Contrato técnicoClaude Code
DesenvolvimentoClaude Code
TestesClaude Code
Code reviewClaude Code
DocumentaçãoClaude Cowork
DeployClaude Code
ODPTech · Grupo JCALucent MindsEscol.AIObrigado! 🙌
AI for ROI

    
Cole na ferramenta indicada. Ajuste o que estiver entre colchetes.
Índice

Treinamento AI-First · Vanilla

— slides · clique para abrir