🟣 Entregáveis & Boas Práticas

O que é

Três arquivos que fotografam a situação atual: 01_tech_inventory (o que a empresa já usa de tecnologia), 02_pain_points (as dores, área por área) e 04_maturity_assessment (uma nota de maturidade em IA, de 1 a 5).

Por que aprender

É o ponto de partida de toda a estratégia: você só sabe para onde ir depois de entender de onde está saindo. Servem de base para o plano e para o ROI.

Conceitos-chave

• 01 = inventário de tecnologia atual
• 02 = dores mapeadas por departamento
• 04 = nota de maturidade em IA (1 a 5)

O que é

05_roadmap traça o caminho em fases (30 / 60 / 90 / 180 / 360 dias) e 06_quick_wins lista de 5 a 10 ganhos rápidos de alto impacto para começar já.

Por que aprender

É a parte que vira ação: o roadmap dá a visão do ano inteiro; os quick wins mostram o que fazer na primeira semana para gerar resultado e confiança.

Conceitos-chave

• 05 = plano por fases (30/60/90/180/360)
• 06 = ganhos rápidos de alto impacto
• Comece pelos quick wins para provar valor

O que é

09_roi_calculator mostra custo-benefício e tempo de retorno (payback); 07_vendor_comparison compara construir vs. comprar e traz uma matriz de fornecedores (OpenAI, Anthropic, Google...); 08_license_consolidation aponta como juntar ferramentas e economizar.

Por que aprender

É o que convence quem assina o cheque. Diretoria pensa em números: retorno, prazo de payback e onde dá para cortar gasto duplicado.

Conceitos-chave

• 09 = custo-benefício e payback
• 07 = build vs. buy + matriz de fornecedores
• 08 = consolidar licenças e economizar

O que é

10_ai_policy é a política de uso aceitável de IA na empresa (o que pode e o que não pode); 11_data_governance trata da gestão, segurança e conformidade (compliance) dos dados.

Por que aprender

Adotar IA sem regras é risco. Esses dois documentos protegem a empresa de vazamentos, mau uso e problemas legais — e dão segurança para as equipes usarem.

Conceitos-chave

• 10 = política de uso aceitável
• 11 = gestão, segurança e compliance de dados
• Reduzem risco e dão confiança ao time

O que é

Quatro documentos para as pessoas: 12_prompt_library (prompts prontos por área), 13_glossary (glossário para não-técnicos), 14_use_case_library (casos de uso por área) e 15_change_management (plano de treinamento e adoção).

Por que aprender

Estratégia só funciona se as pessoas embarcarem. Esses documentos transformam o plano em algo que a equipe entende, usa no dia a dia e adota de verdade.

Conceitos-chave

• 12 = biblioteca de prompts por área
• 13 = glossário para não-técnicos
• 14 = casos de uso · 15 = plano de adoção

O que é

O documento 03_mermaid_diagrams não é um texto comum: ele guarda o código (em linguagem Mermaid) que, na fase de Geração, vira cinco imagens PNG — estado atual, estado futuro, fluxo de dados, roadmap e integração.

Por que aprender

Saber que o markdown é a "fonte" e os PNGs são o "resultado" ajuda a entender por que às vezes a imagem não sai (assunto da Trilha 3.3) — e como editar o diagrama no código.

Conceitos-chave

• 03 = markdown com o código Mermaid
• Vira 5 PNGs na fase de Geração
• current, future, data_flow, roadmap, integration

O que é

A sequência natural é: Diagnóstico → Plano → Finanças → Governança → Capacitação. Cada grupo prepara o próximo, como uma história que começa no problema e termina na execução.

Por que aprender

Você não precisa ler tudo na ordem para entender — mas seguir a sequência facilita explicar a estratégia para outras pessoas e montar a apresentação.

Conceitos-chave

• Diagnóstico → Plano → Finanças → Governança → Capacitação
• Executivo começa pelo resumo executivo
• Depois: roadmap (05) e ROI (09)

O que é

O arquivo executive_summary_deck.pptx é uma apresentação curta, de 10 a 15 slides, pensada para o board (a diretoria). Traz só a visão de topo: o essencial, sem detalhes técnicos.

Por que aprender

É o material que você usa quando tem 15 minutos para convencer quem decide. Curto, direto e focado em valor e números.

Conceitos-chave

• Arquivo: executive_summary_deck.pptx
• 10-15 slides, visão de topo
• Público: diretoria / board

O que é

O arquivo full_findings_presentation.pptx é a versão completa, de 40 a 50 slides, com todos os achados e recomendações detalhados — o aprofundamento do resumo executivo.

Por que aprender

Serve para o workshop, a reunião técnica ou quando a equipe pede detalhes. É o material de fundo, para quem quer ir além da visão de topo.

Conceitos-chave

• Arquivo: full_findings_presentation.pptx
• 40-50 slides, achados + recomendações
• Público: equipe técnica / aprofundamento

O que é

O arquivo final_strategy_report.docx é o relatório escrito completo em Word: reúne todos os documentos compilados num único texto corrido, pronto para ler de ponta a ponta.

Por que aprender

É o documento "oficial" que você entrega ou arquiva. Bom para quem prefere ler em vez de ver slides, e fácil de editar no Word.

Conceitos-chave

• Arquivo: final_strategy_report.docx
• Todos os documentos compilados
• Formato Word, fácil de editar

O que é

O arquivo statement_of_work.docx é uma proposta de implementação (SOW): descreve o que será feito, com cronograma, recursos necessários e custos estimados.

Por que aprender

É a ponte entre estratégia e execução. Consultores usam como base de proposta comercial; times internos, como plano de projeto.

Conceitos-chave

• Arquivo: statement_of_work.docx
• Cronograma + recursos + custos
• Base de proposta ou de projeto

O que é

Cinco imagens PNG prontas para colar em slides: current_state (estado atual), future_state (estado futuro), data_flow (fluxo de dados), roadmap e integration (integração).

Por que aprender

Diagrama vale mais que mil palavras numa reunião. Esses PNGs ficam na pasta mermaid_images/ e podem ser arrastados direto para a apresentação.

Conceitos-chave

• 5 PNGs: current, future, data_flow, roadmap, integration
• Ficam em mermaid_images/
• Prontos para colar em slides

O que é

Um roteiro simples para conduzir a reunião: comece pelo resumo executivo, mostre o diagnóstico, apresente o roadmap e o ROI, e feche com os quick wins (o que dá para fazer já).

Por que aprender

Ter os arquivos não basta — a ordem de apresentação faz a diferença. Esse fluxo conta uma história: onde estamos, para onde vamos, quanto rende e por onde começar.

Conceitos-chave

• Resumo → diagnóstico → roadmap → ROI → quick wins
• Personalize antes de apresentar
• Revise os números (é um rascunho de IA)

O que é

O erro 401 significa "não autorizado": a chave está errada ou ausente. Verifique se o arquivo .env existe e se as chaves têm o formato certo (pplx-... / AIzaSy...), sem espaços. Depois, reinicie o app.

Por que aprender

É o erro número um de quem começa. Quase sempre é um detalhe bobo: um espaço a mais, a chave colada pela metade ou o arquivo no lugar errado.

Conceitos-chave

• 401 = chave errada ou ausente
• Formato: pplx-... e AIzaSy..., sem espaços
• Reinicie o app após corrigir o .env

O que é

O erro "Module not found" geralmente quer dizer que o ambiente virtual (venv) não está ativo. Ative o venv e rode pip install -r requirements.txt. No Windows, confira também se o Python está no PATH.

Por que aprender

É fácil esquecer de ativar o venv ao abrir um terminal novo. Sem ele, o Python não enxerga as bibliotecas instaladas e reclama que faltam módulos.

Conceitos-chave

• Ative o venv antes de rodar
• Reinstale: pip install -r requirements.txt
• Windows: Python precisa estar no PATH

O que é

Se a porta 8888 já estiver em uso, o app encontra outra porta livre automaticamente. Se preferir escolher, rode com --port 9000 (ou qualquer outro número).

Por que aprender

Esse "problema" quase nunca trava você — é só um aviso. Saber disso evita susto quando o endereço no navegador aparece com um número diferente.

Conceitos-chave

• App acha porta livre automaticamente
• Forçar: --port 9000
• Não é um erro grave

O que é

O erro 429 significa "muitas requisições" — você bateu no limite de taxa da API. Espere de 5 a 10 minutos e continue de onde parou com o comando resume. Já existe um delay de cerca de 5s embutido entre as chamadas do Gemini.

Por que aprender

Você não perde o trabalho: o resume aproveita o que já foi feito. Esperar um pouco quase sempre resolve, sem precisar começar do zero.

Conceitos-chave

• 429 = limite de taxa atingido
• Espere 5-10 min e rode resume
• Delay de ~5s já vem embutido (Gemini)

O que é

Se os diagramas saem como PNG em branco, geralmente falta o Chrome (usado pelo Puppeteer, que "tira a foto" do diagrama). A solução é instalar o Chrome no computador, ou rodar a ferramenta via Docker.

Por que aprender

Os documentos podem sair perfeitos e só as imagens falharem — é um problema isolado da fase de Geração. Saber a causa evita achar que "tudo deu errado".

Conceitos-chave

• PNG em branco = falta Chrome/Puppeteer
• Instale o Chrome no computador
• Alternativa: rodar via Docker

O que é

Quatro hábitos: comece no modo rápido (quick), dê um bom --context, rode várias empresas no rápido e só aprofunde a escolhida, e sempre revise as saídas antes de usar.

Por que aprender

Essas práticas economizam dinheiro e melhoram muito a qualidade. A diferença entre um rascunho mediano e um ótimo costuma estar no contexto e na revisão.

Conceitos-chave

• Comece no quick · dê um bom --context
• Varra no rápido, aprofunde a escolhida
• Sempre revise antes de entregar

O que é

A ferramenta usa dados públicos (não dados sigilosos da empresa), o resultado é um rascunho que precisa de revisão humana, e não é conselho jurídico nem financeiro definitivo. Acompanhe o gasto com os comandos status e list.

Por que aprender

Usar com responsabilidade protege você e a empresa. Tratar o resultado como rascunho — e não como verdade absoluta — é o que mantém a qualidade e a confiança.

Conceitos-chave

• Só dados públicos · rascunho com revisão humana
• Não é conselho jurídico/financeiro definitivo
• Acompanhe gasto com status / list