Pular para o conteúdo
OrquestraWorkshop de capacitação

Roteiro de ministração

Agenda operacional do workshop

Use esta seção como trilha principal da aula. Cada bloco tem duração, objetivo e saída esperada.

0120 min

Abertura e framing

Alinhar expectativa, recorte, contrato de uso e perfil esperado.

Saída esperada

Turma entende que o Orquestra exige decisão, critério e responsabilidade.

Ver descrição e fala
0235 min

Conceito do Orquestra

Mostrar o produto como camada operacional para IA, agentes e governança.

Saída esperada

Leitura comum do valor atual da ferramenta.

Ver descrição e fala
0350 min

Método, filosofia e economia de IA

Ensinar o fluxo de uso, tokens, retorno e trabalho paralelo.

Saída esperada

Modelo mental replicável para qualquer caso.

Ver descrição e fala
0445 min

Tour do produto atual

Navegar pelo desktop Windows: workspace, Fábrica, Agentes e Review.

Saída esperada

Mapa operacional da jornada.

Ver descrição e fala
0570 min

Hands-on 1 - caso prático

Baixar um caso, abrir workspace, montar contexto e gerar blueprint.

Saída esperada

Caso aberto no Orquestra, contexto mínimo e blueprint inicial.

Ver descrição e fala
0655 min

Hands-on 2 - agente e Review

Operar agente no caso escolhido, observar execução, avaliar retorno e rodar Review.

Saída esperada

Sessão acompanhada, findings e próxima decisão.

Ver descrição e fala
0735 min

Governança e gestão

Fechar guardrails de IA, projeto, recursos e operação.

Saída esperada

Critério mínimo institucionalizado.

Ver descrição e fala
0820 min

Fechamento

Consolidar o aprendizado e definir repetição em caso real.

Saída esperada

Plano curto de adoção e multiplicadores.

Ver descrição e fala

Descrição por aula

Roteiro de fala do facilitador

Ao acessar um item da agenda, use estes blocos para conduzir a aula com objetivo, fluxo, texto sugerido e fechamento.

20 min

Abertura e framing

Objetivo da aula

Alinhar objetivo do dia, perfil esperado e o contrato comportamental de uso do Orquestra.

Descrição

Esta aula posiciona o workshop como treinamento de operação, método e decisão. O foco é deixar claro que a ferramenta acelera pessoas com critério, não substitui responsabilidade técnica.

Como conduzir

  1. 1.Apresente o problema: trabalho técnico disperso, uso solto de IA e baixa rastreabilidade.
  2. 2.Explique o recorte: versão Windows, Orquestra atual, cinco casos práticos e uso com Review.
  3. 3.Defina o perfil esperado: especialista, alta autonomia, decisão e responsabilidade sobre resultado.
  4. 4.Explique o que não será feito: promessa de automação total, uso sem revisão ou migração completa em sala.

Texto para ser falado

Hoje não estamos treinando uma pessoa para conversar com IA. Estamos treinando uma pessoa para dirigir trabalho técnico com IA, evidência e governança.
O Orquestra não tira a responsabilidade de decisão. Ele organiza contexto, execução, rastros e revisão para que a decisão seja melhor e mais rápida.
Durante o hands-on, o objetivo não é terminar uma migração inteira. O objetivo é aprender o ciclo: entender, orientar, executar pouco, revisar e decidir o próximo passo.

Fechamento

Ao final desta abertura, a turma deve entender que cada pedido ao Orquestra precisa ter objetivo, contexto, restrição, saída esperada e revisão.

35 min

Conceito do Orquestra

Objetivo da aula

Mostrar onde o Orquestra se encaixa entre gestão, arquitetura, engenharia, agentes e governança.

Descrição

Esta aula apresenta o Orquestra como camada operacional para transformar contexto em entrega observável. O foco é diferenciar chat, agente, workspace, artefato e Review.

Como conduzir

  1. 1.Explique o fluxo: workspace, contexto, Fábrica, Agentes, Review e próxima decisão.
  2. 2.Mostre por que local-first importa: o trabalho parte de uma pasta real do projeto.
  3. 3.Diferencie conversa com IA de execução observável com rounds, terminal, ferramentas e alterações.
  4. 4.Conecte os cinco casos práticos aos usos do produto: legado, frontend, batch, UX e banco.

Texto para ser falado

A diferença principal é que o Orquestra não trata IA como uma janela isolada de conversa. Ele coloca a IA dentro de uma jornada de trabalho.
O workspace é a unidade operacional. É ali que evidências, decisões, sessões e artefatos precisam se encontrar.
Quando usamos Fábrica, estamos consolidando direção. Quando usamos Agentes, estamos materializando. Quando usamos Review, estamos decidindo se aquilo é aceitável para seguir.

Fechamento

Feche reforçando que o produto deve ser usado como sequência de decisão, não como coleção de telas.

50 min

Método, filosofia e economia de IA

Objetivo da aula

Ensinar o método de prompt e a economia de uso: tokens, tempo de agente, paralelismo e retorno.

Descrição

Esta aula aprofunda o método central do workshop e mostra como evitar desperdício. O participante deve sair sabendo quando explorar, estruturar, produzir, revisar ou criticar.

Como conduzir

  1. 1.Apresente o fluxo: evidência, contexto, objetivo, restrições, modo, artefato, revisão e ação.
  2. 2.Mostre um pedido ruim e reescreva com o prompt-base.
  3. 3.Explique uso consciente de tokens: contexto mínimo, rodada curta e artefato verificável.
  4. 4.Explique paralelismo: abrir frentes só quando houver dono, objetivo e critério de consolidação.

Texto para ser falado

Um prompt bom não é um texto grande. Um prompt bom é um pedido com direção, limite e critério de aceite.
Tokens não são só custo financeiro. Eles representam tempo, exposição de contexto e carga de revisão humana.
Paralelismo só vale quando as saídas serão comparáveis ou independentes. Caso contrário, ele aumenta ruído e retrabalho.
A pergunta de controle é simples: essa rodada vai produzir uma decisão, um artefato ou uma próxima ação clara?

Fechamento

Antes do tour, peça que todos escolham mentalmente um caso e formulem o primeiro objetivo usando o prompt-base.

45 min

Tour do produto atual

Objetivo da aula

Navegar pela versão Windows e mostrar onde cada etapa do método aparece no produto.

Descrição

Esta aula é uma demonstração guiada. O facilitador deve abrir o Orquestra, mostrar a jornada principal e evitar dispersão por telas fora do escopo.

Como conduzir

  1. 1.Abra um workspace de exemplo.
  2. 2.Mostre onde a turma deve observar arquivos, briefing e evidências.
  3. 3.Passe pela Fábrica como espaço de consolidação de direção.
  4. 4.Mostre Agentes como execução observável.
  5. 5.Mostre Review como filtro de qualidade e decisão.

Texto para ser falado

Reparem que eu não começo pelo agente. Eu começo pelo workspace e pelas evidências.
A Fábrica serve para reduzir ambiguidade antes de gastar execução. Ela ajuda a transformar intenção em blueprint.
Nos Agentes, observem rounds, ferramentas, terminal e alterações. Isso é diferente de aceitar uma resposta textual sem rastro.
Review não é burocracia. Review é onde a equipe decide se o resultado pode seguir, precisa ajuste ou deve ser descartado.

Fechamento

Feche abrindo a seção de downloads e orientando cada dupla a escolher um caso para o hands-on.

70 min

Hands-on 1 - caso prático

Objetivo da aula

Fazer cada dupla abrir um caso, montar contexto e gerar o primeiro blueprint ou plano revisável.

Descrição

Esta aula é a primeira prática. Cada dupla baixa um zip, extrai localmente e abre a pasta no Orquestra. O foco é contexto e direção, não implementação extensa.

Como conduzir

  1. 1.Distribua os casos entre as duplas.
  2. 2.Confirme que todos extraíram o zip e abriram a pasta correta.
  3. 3.Peça que leiam `workshop/orquestra-briefing.md` antes de chamar agente.
  4. 4.Oriente a montagem de contexto mínimo: problema, evidências, restrições e saída esperada.
  5. 5.Conduza a geração de blueprint, plano ou diagnóstico conforme o caso escolhido.

Texto para ser falado

A primeira tarefa é resistir à vontade de pedir implementação imediatamente.
Leiam o briefing. Identifiquem quais arquivos realmente importam. Depois formulem a primeira rodada.
Se o caso for mainframe, o ganho agora é rastreabilidade e direção. Se for UI, o ganho pode ser diagnóstico e primeira versão visual. Se for IMS, o ganho é modelo e dúvidas para especialista.
O objetivo deste bloco é terminar com algo que outra pessoa consiga revisar.

Fechamento

Cada dupla deve registrar: caso escolhido, evidências usadas, saída gerada, riscos percebidos e próximo pedido ao agente.

55 min

Hands-on 2 - agente e Review

Objetivo da aula

Operar uma sessão de agente sobre o caso escolhido, observar a execução e fechar com Review.

Descrição

Esta aula aprofunda a execução. O foco é observar o agente trabalhando, controlar escopo, avaliar custo/retorno e revisar a saída.

Como conduzir

  1. 1.Cada dupla cria ou continua uma sessão de agente no workspace.
  2. 2.A instrução deve usar objetivo, contexto, restrições, modo e saída esperada.
  3. 3.A turma observa rounds, ferramentas, terminal, alterações e sinais de extrapolação.
  4. 4.Depois, cada dupla roda Review sobre o resultado.
  5. 5.A dupla decide: seguir, ajustar, descartar ou abrir nova frente.

Texto para ser falado

Durante a execução, não fiquem passivos. Observem se o agente entendeu o problema certo.
Se a execução sair do escopo, parem e redirecionem. High agency também é saber interromper.
Review é o momento de transformar impressão em critério. O que está consistente? O que está arriscado? O que falta validar?
A saída mais importante deste bloco é a decisão de próximo passo, não a quantidade de arquivos gerados.

Fechamento

Peça que cada dupla compartilhe em um minuto: caso, resultado, principal risco e próxima ação.

35 min

Governança e gestão

Objetivo da aula

Consolidar guardrails de IA, operação, tokens, projeto e responsabilidade humana.

Descrição

Esta aula transforma o aprendizado em regra operacional. O objetivo é mostrar como a organização acompanha uso, custo, risco e qualidade.

Como conduzir

  1. 1.Reforce classificação da informação: pública, interna, sensível e proibida.
  2. 2.Explique minimização de contexto e revisão proporcional ao risco.
  3. 3.Trate tokens, tempo de agente e revisão humana como recursos de projeto.
  4. 4.Mostre como uma execução assistida deve virar item de trabalho com dono e aceite.

Texto para ser falado

Governança boa não é freio. Governança boa reduz ambiguidade e evita desperdício.
Segredos, tokens, senhas e credenciais não entram em prompt. Contexto sensível exige regra explícita.
A pergunta de gestão é: qual retorno essa execução trouxe? Tempo economizado, risco reduzido, decisão melhor ou entrega acelerada?
Se uma rodada de IA não tem dono, saída esperada e critério de aceite, ela provavelmente está fora de controle.

Fechamento

Feche pedindo que a turma defina quais guardrails mínimos devem virar prática oficial depois do workshop.

20 min

Fechamento

Objetivo da aula

Consolidar aprendizado e transformar workshop em adoção real.

Descrição

Esta aula encerra com compromisso operacional. O foco é sair com um próximo experimento real, multiplicadores e critério de acompanhamento.

Como conduzir

  1. 1.Retome o ciclo aprendido: evidência, contexto, objetivo, execução, Review e decisão.
  2. 2.Peça que cada dupla diga o principal aprendizado do caso.
  3. 3.Defina um caso real pequeno para repetição guiada.
  4. 4.Nomeie multiplicadores e combine o ritual mínimo de Review.

Texto para ser falado

O workshop não termina quando a aula acaba. Ele termina quando a equipe repete a jornada em um caso real.
Escolham um caso pequeno, com evidência disponível e risco controlado. O objetivo é criar confiança operacional.
A maturidade não vem de usar mais IA. Vem de usar melhor: com contexto, critério, revisão e retorno mensurável.

Fechamento

Finalize com a mensagem central: o Orquestra é uma forma governada e observável de transformar contexto em entrega.

Contrato comportamental

O operador precisa ter high agency

O Orquestra acelera quem sabe conduzir trabalho técnico.

IA como acelerador

A IA aumenta leitura, estruturação, produção e revisão. Ela não substitui decisão humana.

Alta autonomia

O operador transforma ambiguidade em escopo, restrição, pergunta e próxima ação.

Paralelismo com dono

Frentes paralelas precisam ter objetivo, responsável, tempo limite e critério de consolidação.

Revisão proporcional ao risco

Nenhuma saída assistida vira verdade automática. Review fecha a iteração com evidência.

Mensagem para a turma

Sem zona de conforto fixa.

Cada caso muda o modo de uso: descobrir, estruturar, decidir, produzir, revisar ou criticar. O participante deve saber quando acelerar, quando pausar, quando dividir frentes e quando consolidar.

Fluxo-base

Evidência antes de execução

Este é o método que deve aparecer em todo pedido feito durante a capacitação.

01

evidência

02

contexto

03

objetivo

04

restrições

05

modo

06

artefato

07

revisão

08

ação

Prompt-base

Objetivo: ____
Contexto essencial: ____
Evidências de entrada: ____
Restrições: prazo, formato, stack, público e aceite
Modo: explorar | estruturar | decidir | produzir | revisar | criticar
Saída esperada: ____

Checklist antes de aceitar

O problema certo foi entendido?

O contexto relevante foi absorvido?

As premissas ficaram explícitas?

Os riscos foram tratados?

O artefato está pronto ou ainda é rascunho?

Existe próxima ação clara?

Aplicação prática

Cenários para usar o Orquestra

A capacitação precisa ensinar escolha de modo. O mesmo produto pode apoiar descoberta, fábrica, execução, review e gestão.

Descoberta técnica

Ler evidências, mapear lacunas e estruturar perguntas.

Saída

Baseline e dúvidas qualificadas.

Fábrica de aplicação

Consolidar stack, escopo, arquitetura e blueprint.

Saída

Plano de implementação revisável.

Modernização de legado

Transformar artefatos em trilha de migração.

Saída

Inventário, roteiro e riscos.

Protótipo controlado

Materializar uma fatia pequena antes de ampliar escopo.

Saída

Código inicial ou prova revisável.

Revisão de entrega

Avaliar consistência, risco, segurança, testes e qualidade.

Saída

Findings e decisão de aceite.

Gestão de projeto

Acompanhar decisões, bloqueios, recursos e frentes.

Saída

Próxima ação, responsável e critério.

Material dos alunos

Casos práticos para abrir no Orquestra

Cada aluno ou dupla baixa um zip, extrai em uma pasta local e abre essa pasta como workspace no Orquestra. Os casos foram pensados para exercitar modos diferentes de uso da ferramenta.

Caso 01Legado COBOL

Mainframe para React/Vite + .NET

Transformar um recorte de cadastro COBOL, copybook, JCL e DDL DB2 em blueprint incremental para React/Vite + .NET.

Baixar zip

Artefatos

  • COBOL
  • Copybook
  • JCL
  • DDL DB2
  • Briefing Orquestra

O que fazer

  1. 1.Abrir o zip extraído como workspace.
  2. 2.Ler o briefing e os artefatos em legacy.
  3. 3.Gerar blueprint na Fábrica para React/Vite + .NET.
  4. 4.Abrir sessão de agente para propor entidades, endpoints e primeira tela.
  5. 5.Rodar Review para validar riscos e lacunas.

Saída esperada

  • Mapa de campos legados para modelo alvo.
  • Entidades e endpoints iniciais.
  • Plano incremental de migração.
  • Riscos e próxima ação.
Caso 02Migração frontend

Vue para React/Vite

Migrar um pequeno quadro Vue para React/Vite, preservando comportamento e melhorando estrutura de componentes.

Baixar zip

Artefatos

  • App.vue
  • TaskBoard.vue
  • Dados mockados
  • Package.json

O que fazer

  1. 1.Abrir o projeto Vue como workspace.
  2. 2.Pedir ao agente mapa de componentes e estado.
  3. 3.Solicitar plano de migração para React/Vite.
  4. 4.Produzir primeira versão React com escopo curto.
  5. 5.Rodar Review de estrutura, acessibilidade e estados vazios.

Saída esperada

  • Mapa de componentes.
  • Estratégia de migração.
  • Primeira implementação React/Vite.
  • Checklist de paridade funcional.
Caso 03Operação batch

Rotinas JCL

Analisar jobs JCL de fechamento, backup IMS e relatório para criar runbook moderno e plano de automação incremental.

Baixar zip

Artefatos

  • FECHDIA.jcl
  • BKPIMS.jcl
  • RELOPER.jcl
  • Runbook atual

O que fazer

  1. 1.Abrir a pasta como workspace.
  2. 2.Analisar runbook e arquivos JCL.
  3. 3.Pedir mapa de dependências, entradas e saídas.
  4. 4.Gerar proposta de runbook moderno.
  5. 5.Rodar Review para encontrar lacunas operacionais.

Saída esperada

  • Sequência operacional.
  • Dependências e datasets.
  • Riscos e pontos de observabilidade.
  • Plano de melhoria incremental.
Caso 04UX/UI operacional

Interface ruim para moderna

Transformar uma tela operacional confusa em interface moderna, responsiva e orientada a decisão.

Baixar zip

Artefatos

  • HTML ruim
  • CSS ruim
  • JavaScript simples
  • Briefing UX

O que fazer

  1. 1.Abrir a pasta como workspace.
  2. 2.Pedir diagnóstico UX objetivo.
  3. 3.Definir critérios de aceite visual.
  4. 4.Solicitar proposta moderna sem virar landing page.
  5. 5.Rodar Review de acessibilidade, contraste e responsividade.

Saída esperada

  • Diagnóstico de problemas.
  • Nova hierarquia visual.
  • Primeira tela modernizada.
  • Critérios de aceite para interface.
Caso 05Banco legado

IMS para PostgreSQL

Converter entendimento de DBD, PSB, copybook e segmentos IMS em proposta relacional PostgreSQL.

Baixar zip

Artefatos

  • DBD
  • PSB
  • Copybook
  • Amostra de segmentos

O que fazer

  1. 1.Abrir a pasta como workspace.
  2. 2.Mapear hierarquia IMS e segmentos.
  3. 3.Inferir chaves e cardinalidades com premissas explícitas.
  4. 4.Propor DDL PostgreSQL e plano de carga.
  5. 5.Rodar Review sobre perdas de semântica e dúvidas abertas.

Saída esperada

  • Mapa hierárquico IMS.
  • Tabelas PostgreSQL propostas.
  • Chaves e relacionamentos.
  • Plano de carga e riscos.

Economia de IA

Tokens são recurso de projeto

A aula deve tratar tokens, tempo de agente e revisão humana como recursos gerenciáveis.

Custo sem artefato é desperdício.

O retorno é decisão mais clara, risco reduzido, ciclo encurtado ou entrega útil.

01

Recortar contexto antes de enviar.

02

Pedir plano quando a direção ainda estiver incerta.

03

Pedir implementação apenas com aceite claro.

04

Parar sessões que repetem raciocínio.

05

Registrar decisões para não recomeçar do zero.

Prática guiada

Hands-on: contexto, Fábrica, Agentes e Review

Use esta trilha para qualquer um dos cinco casos. O objetivo é aprender a transformar evidência em artefato revisável.

Como conduzir

Uma dupla, um caso, uma decisão de próximo passo.

Cada dupla escolhe um caso, baixa o zip, extrai localmente, abre o workspace no Orquestra e executa um ciclo completo: contexto, Fábrica ou agente, observação, Review e decisão.

Critério de aceite do hands-on

O workspace correto foi aberto.

As evidências principais foram lidas.

O objetivo da rodada ficou explícito.

A saída virou artefato ou plano revisável.

O Review apontou riscos ou lacunas.

A próxima ação foi decidida com dono.

01

Abrir o workspace correto.

02

Localizar evidências iniciais.

03

Montar contexto mínimo.

04

Gerar blueprint na Fábrica.

05

Criar sessão em Agentes.

06

Acompanhar rounds, tools e terminal.

07

Executar Review.

08

Registrar próxima decisão.

Parte 1

Workspace correto, evidências iniciais, contexto mínimo e blueprint com critério de aceite.

Parte 2

Sessão de agente, observabilidade, possível paralelismo controlado e Review.

Fechamento

Decisão de seguir, ajustar, descartar ou abrir nova frente com dono claro.

Guardrails

Governança que ajuda a operar

O fechamento institucional precisa cobrir IA, operação do Orquestra, recursos e projeto.

Responsabilidade humana

Direção, aceite, validação final e decisão de risco continuam com pessoas.

Rastreabilidade

Workspace, estado local, sessões, artefatos e Review reduzem conversa solta.

Gestão do trabalho

Cada execução deve ter dono, objetivo, saída, aceite e próxima ação.

Perguntas de gestão

Esta execução tem objetivo claro?

O contexto enviado é suficiente e mínimo?

O resultado esperado justifica o custo?

Quem aceita ou rejeita a saída?

Qual artefato será atualizado?

Qual próxima ação será registrada?

Informação proibida

Segredos e chaves.

Tokens de acesso.

Senhas e credenciais.

Dados sem base de uso definida.

Contexto sensível enviado por comodidade.

Arquivos inteiros sem necessidade real.

Depois da aula

Transformar workshop em adoção

A capacitação deve terminar com um caso real pequeno, multiplicadores e critério de acompanhamento.

Escolher caso real

Pequeno, concreto, com evidência disponível e risco controlado para repetir a jornada.

Nomear multiplicadores

Pessoas com critério técnico e capacidade de decisão para sustentar a prática.

Medir retorno

Tempo economizado, risco reduzido, decisão melhor, entrega acelerada e retrabalho evitado.

Frase de encerramento

O Orquestra é uma forma mais governada e observável de transformar contexto em entrega.