E1 · Pasta e dados fictícios
30 minCom o gestor, crie a pasta, o AGENTS.md, a spec.md e 20 registros inventados. Faça o primeiro commit.
Pronto quando: git log mostra o primeiro commit e não há nenhum dado real na pasta.
Aula 3 · 20 min
Protótipo em um dia
Com a spec aprovada, o gestor monta o primeiro protótipo numa sessão de trabalho com você. Ele dirige o teclado; você segura o escopo, os dados fictícios e a conferência. No fim do dia há uma ferramenta rodando no computador dele e uma lista honesta do que falta.
Começar a aula
Nesta aula você vai
- 1Preparar a pasta com regras e dados fictícios
- 2Pedir só o que está na spec
- 3Conferir com três casos
- 4Salvar, desfazer e anotar lacunas
Objetivo: conduzir a sessão em que o gestor monta o protótipo com um agente, com dados fictícios, Git e lista de lacunas.
01O ciclo da sessão de protótipo
Cinco etapas, repetidas até o fim do dia. Clique em cada bloco.
Role a página: cada etapa abaixo acende a sua parte do diagrama.
- 1/6
Preparar
Uma pasta só para o protótipo, com o AGENTS.md (o manual que o agente lê antes de trabalhar), a spec e uma planilha de dados inventados. Nenhum dado real de cliente entra hoje.
- 2/6
Pedir
O gestor pede ao agente uma coisa só, com o resultado esperado. Pedido grande demais gera mudança que ninguém consegue conferir.
- 3/6
Agente constrói
Um agente de código no terminal ou o agente de trabalho do app de chat. Qual usar depende do que a empresa já tem; a lista do mês está na aula 8. O método é o mesmo.
- 4/6
Conferir
Abrir e testar com um caso comum, uma exceção e um dado faltando. "Abriu e ficou bonito" não é conferir.
- 5/6
Salvar ou desfazer
Gostou: commit. Não gostou: git restore. Tudo o que o agente fez sem a spec mandar vira linha no lacunas.md, que alimenta a constituição (aula 4) e os testes (aula 5).
- 6/6
Um dia, várias voltas
Preparar uma vez; depois pedir, construir, conferir e salvar quantas vezes for preciso. O que sobra no fim é um protótipo que roda e uma lista de lacunas.
Quem digita é o gestor. O mentor pergunta, aponta e confere.
02A sessão em quatro blocos
Um dia de trabalho, ou duas meias manhãs.
1. Antes da sessão
Combine o equipamento: notebook do gestor, conta da empresa no agente escolhido, Git instalado. Gere com ele uma planilha de 20 clientes inventados, com nomes e valores fictícios.
Antes de construir, vale um ensaio: colar a spec num chat e pedir que ele faça o papel da ferramenta num caso. As perguntas que ele fizer mostram lacunas da spec.
Regra do dia
Nenhum dado real de cliente. Nenhuma chave de API no navegador.
2. Manhã
O gestor cria a pasta, o AGENTS.md e faz o primeiro commit. Primeiro pedido: só leitura ("leia o AGENTS.md e a spec e diga o que entendeu").
Segundo pedido: a lista de orçamentos abertos com a regra da spec. Abrir, conferir, salvar.
Sinal de que está indo bem
Na hora do almoço o gestor já pede sozinho e sabe voltar uma versão com git restore.
3. Tarde
Terceiro pedido: o rascunho de mensagem para cada orçamento, citando só produtos do catálogo. Quarto: o botão de aprovar e a exportação do que foi aprovado.
Envio automático, WhatsApp oficial e desconto ficam fora: não estão na spec v0.1.
Na Horizonte
A Patrícia aprovou 12 rascunhos fictícios em 10 minutos e editou 3. Isso já é um número para a aula 7.
4. Fechamento
Rodem os três casos de conferência. Tudo o que surpreendeu vai para o lacunas.md com data, o que aconteceu e o que deveria ter acontecido.
Combine a próxima sessão: escrever a constituição com base nas lacunas.
Entrega do dia
Protótipo rodando + histórico no Git + lacunas.md com pelo menos três linhas.
03Modelos: roteiro, AGENTS.md e prompt de protótipo
Copie, troque o que está entre < > e use na sessão.
Roteiro da sessão de protótipo
SESSÃO DE PROTÓTIPO · gestor: <nome> · ferramenta: <nome> · data: <dd/mm> ANTES (mentor, 30 min) [ ] spec v0.1 aprovada pelo gestor [ ] notebook do gestor com Git e o agente na conta da EMPRESA [ ] 20 registros fictícios gerados (nenhum dado real) [ ] ensaio no chat: spec colada + 1 caso -> lacunas anotadas MANHÃ (gestor no teclado) 1. Criar pasta, AGENTS.md, dados-ficticios/, git init, primeiro commit 2. Pedido de leitura: "leia AGENTS.md e spec.md e diga o que entendeu" 3. Pedido 1: <primeira parte da spec> -> abrir, conferir, commit TARDE 4. Pedido 2: <segunda parte> -> conferir, commit 5. Pedido 3: <terceira parte> -> conferir, commit FECHAMENTO (30 min) 6. Três casos: comum · exceção · dado faltando 7. lacunas.md: data | o que aconteceu | o que deveria acontecer 8. Próxima sessão: constituição (aula 4) em <data>
AGENTS.md do protótipo
# Projeto: follow-up de orçamentos (protótipo v0.1) Dona: Patrícia Lima, gerente comercial · Mentor: <nome> · TI: Rafael ## Regras - Siga a spec.md. Se algo não estiver nela, PERGUNTE antes de fazer. - Use só os dados da pasta dados-ficticios/. Nunca peça nem use dado real. - Não coloque chave de API, senha ou token em nenhum arquivo. - Não crie envio automático de mensagem, desconto ou alteração de preço. - Página simples em HTML que abre no navegador, sem servidor. - Ao terminar cada tarefa: diga o que mudou e como eu confiro. ## O que tem aqui - spec.md: a spec de uma página - dados-ficticios/orcamentos.csv: 20 orçamentos inventados - lacunas.md: o que o protótipo ainda não resolve
Prompt de protótipo (primeiro pedido de construção)
Leia o AGENTS.md e a spec.md antes de começar. Tarefa: crie index.html, uma página que abre no navegador e: 1. carrega dados-ficticios/orcamentos.csv; 2. mostra só os orçamentos abertos há 2 dias úteis ou mais, de clientes ativos; 3. para cada um, mostra um rascunho de mensagem curta (até 5 linhas) que cita o último produto comprado e termina com uma pergunta; 4. tem um botão "Aprovar" por linha e um botão "Exportar aprovados" que baixa um CSV. Não faça: envio de mensagem, desconto, mudança de preço, chave de API. Se faltar alguma regra para decidir, pare e me pergunte citando a seção da spec. No fim, diga o que criou e como eu confiro em 3 casos.
Simulação: exemplo ilustrativo
- A página abre no navegador do gestor sem servidor e sem chave.
- Só aparecem orçamentos que a regra da spec manda mostrar.
- Nenhum rascunho cita produto fora do catálogo ou desconto.
git logmostra um commit por pedido.
- Dado real "só para ver": uma vez dentro do chat, já saiu da empresa.
- Mentor no teclado: o protótipo fica sem dono.
- Pedido de tudo de uma vez: mudança que ninguém confere e escopo que estoura.
- Chave de API no HTML: é a falha F1 do laboratório.
04Sessão simulada: a Patrícia no teclado
Conversa simulada para treinar. Escolha a resposta que você daria; o comentário aparece logo depois.
Patrícia Limagerente comercial · Horizonte Distribuidora
Escolha a sua resposta. O comentário aparece logo depois e a conversa segue conforme a escolha.
05Prática: o protótipo rodando com o gestor
Uma sessão real. Se ainda não tem gestor, faça no papel da Patrícia.
E2 · Sessão de protótipo
4 hConduza a sessão com o roteiro. O gestor digita todos os pedidos.
Pronto quando: o protótipo abre no computador do gestor e há um commit por pedido.
E3 · Três casos e lacunas
30 minRodem um caso comum, uma exceção e um dado faltando. Anote o que surpreendeu.
Pronto quando: lacunas.md tem pelo menos três linhas com data, o que aconteceu e o que deveria acontecer.
06Teste o que aprendeu
A explicação aparece depois da sua resposta.
Pergunta 1 de 4
Que dados entram no protótipo?competência
Correto
Protótipo usa dado inventado. Dado real só depois dos testes e da validação da TI, com base legal e contrato.Não é essa
Protótipo usa dado inventado. Dado real só depois dos testes e da validação da TI, com base legal e contrato.Rever: Sessão simulada: a Patrícia no tecladoPergunta 2 de 4
O protótipo precisa chamar um modelo de IA. Onde fica a chave de API?competência
Correto
Chave no JavaScript do navegador é a falha F1: qualquer visitante copia. No protótipo, regras e modelos de texto bastam; integração vai com a TI.Não é essa
Chave no JavaScript do navegador é a falha F1: qualquer visitante copia. No protótipo, regras e modelos de texto bastam; integração vai com a TI.Rever: Modelos: roteiro, AGENTS.md e prompt de protótipoPergunta 3 de 4
O agente acrescentou um desconto de 10% que ninguém pediu. Qual é a melhor resposta?
Correto
Lacuna anotada vira regra (aula 4) e teste (aula 5). Remendo à mão volta no dia seguinte.Não é essa
Lacuna anotada vira regra (aula 4) e teste (aula 5). Remendo à mão volta no dia seguinte.Rever: Sessão simulada: a Patrícia no tecladoPergunta 4 de 4
Quem digita os pedidos na sessão?
Correto
O gestor precisa sair da sessão sabendo pedir, conferir e desfazer. É o que garante uma dona para a ferramenta.Não é essa
O gestor precisa sair da sessão sabendo pedir, conferir e desfazer. É o que garante uma dona para a ferramenta.Rever: A sessão em quatro blocosTeste concluído
Você acertou {a} de {n}. Acertando todas, a aula é marcada como concluída.Escolha uma alternativa. A explicação aparece depois da sua tentativa.
07A aula em quatro frases
PrepararPasta, AGENTS.md, spec e 20 registros fictícios. Nenhum dado real, nenhuma chave.
Gestor no tecladoEle pede; você pergunta, aponta e confere.
Escopo da specUm pedido por vez, só o que está na v0.1. O resto vai para depois.
Conferir e anotarTrês casos e o lacunas.md. A lacuna vira limite e teste.