Operação
10x.

Claude não é um chatbot

O Claude é uma I.A da Anthropic que entende contexto, toma decisões e executa. Diferente de chatbots comuns, ele não apenas responde perguntas — ele colabora com você em tarefas complexas, cria documentos, analisa dados e constrói ferramentas.

Onde o Claude vive

Os 3 modos

Planos do Claude

A comparação que muda o seu dia

O valor da I.A não é "substituir gente" — é te dar superpoderes. O mesmo profissional, com o Claude do lado, entrega muito mais e gasta o tempo no que realmente exige cérebro. Olha a diferença no dia a dia:

O que cabe na mensalidade?

Nos planos Pro e Max, você paga uma mensalidade fixa — não é cobrado por tarefa individual. O que muda entre os planos é o limite de uso:

Os 3 modelos do Claude

Dentro de qualquer plano, você escolhe qual modelo usar. Cada um tem um nível de inteligência e um consumo de tokens diferente:

O que é o Cowork?

O Cowork transforma o Claude de um chat em um funcionário. Ele acessa plugins, lê e cria arquivos, pesquisa na web e executa ações — tudo sozinho, sem precisar da sua intervenção a cada passo.

Como ativar

1. Abra o Claude Desktop App

   Baixe em claude.ai/download se ainda não tem.

2. Clique na aba Cowork

   Está no topo do app, ao lado de Chat e Code.

3. Conceda acesso a pastas

   O Claude precisa acessar pastas no seu computador para ler e salvar arquivos. Escolha uma pasta de trabalho.

11 plugins oficiais

A Anthropic lançou 11 plugins oficiais open-source em janeiro de 2026 — cada um focado em um departamento (Marketing, Sales, Legal, Finance, etc.). Além disso, a comunidade cria plugins customizados.

Antes de instalar, entenda onde cada plugin vive. Cowork e Claude Code são ecossistemas separados — plugin de um não aparece no outro:

Esses são os 11 plugins oficiais da Anthropic pra Cowork. A aba Claude Code tem seu próprio catálogo (skill-creator, frontend-design, code-review, etc.) — instale pelo botão + → Plugins → Add plugin, ou simplesmente peça pro Claude instalar no chat.

Conectores (MCPs) — o crachá do funcionário

Além dos plugins, existe outro conceito importante: conectores. A Anthropic também chama de MCP (Model Context Protocol) — é o mesmo.

Antes e depois

Exemplos práticos

• GitHub — lê repositórios, issues e PRs; ajuda a revisar e documentar código
• Google Workspace — lê e cria Docs, Sheets, Gmail, Calendar
• Perplexity — pesquisa na web em tempo real com fontes
• Notion — acessa sua base de conhecimento, cria páginas, atualiza tasks

Você vai ver o Cowork em ação com 2 demos reais: analisando uma planilha de dados de ponta a ponta, e criando páginas profissionais do zero.

Demo 1 — Análise de Dados (sua planilha → dashboard)

Nesta demo, você entrega uma planilha qualquer (vendas, leads, atendimentos, métricas, logs — o que for) e o Claude lê, cruza os números, encontra padrões e gera um dashboard visual com insights — direto na conversa, em segundos.

Por que isso impressiona

O Cowork acessa arquivos reais na sua máquina. Em vez de abrir o Excel, montar tabela dinâmica e fazer gráfico na mão, você descreve o que quer entender — e o Claude faz a análise inteira e ainda explica o que os dados estão dizendo.

Passo a passo

1. Abra o Cowork e dê acesso à pasta

   No Claude Desktop App, vá na aba Cowork e autorize a pasta onde está a sua planilha (.xlsx ou .csv).

2. Aponte o arquivo e descreva o que quer

   Diga o nome do arquivo e o que precisa entender. Não precisa formatar nem limpar nada antes — o Claude lida com a bagunça.

3. Receba o dashboard e os insights

   O Claude gera os gráficos, destaca tendências e anomalias e te dá recomendações. Dá pra iterar na hora: "agrupa por mês", "compara com o trimestre anterior".

Demo 2 — Criação de Páginas com Plugins

Nesta demo, o Claude cria páginas profissionais completas usando os plugins de Marketing (copy e estratégia) e Design (visual e código). Dois exemplos: criar do zero e melhorar algo existente.

O que são os plugins de Marketing e Design?

São dois dos 11 plugins oficiais da Anthropic. Quando ativados no Cowork, funcionam como dois especialistas trabalhando juntos:

• Plugin de Marketing: pesquisa mercado, define posicionamento, escreve copy de conversão, cria estratégia de conteúdo
• Plugin de Design: extrai design systems de sites existentes, cria páginas em HTML/CSS, gera layouts profissionais, aplica identidade visual

Exemplo 1 — Criar uma página do zero

Cenário: você tem um negócio (ou cliente) e precisa de uma página de vendas. Não tem nada — só o nome e a ideia.

O que acontece:

1. O plugin de Marketing pesquisa o mercado de cafés especiais, define o posicionamento e escreve a copy (headline, benefícios, FAQ, CTA)
2. O plugin de Design cria o layout visual completo — paleta de cores, tipografia, seções, responsivo
3. O Claude gera imagens de exemplo em alta qualidade para ilustrar o produto
4. Resultado: arquivo HTML pronto para abrir no navegador

Exemplo 2 — Melhorar um site existente

Cenário: você (ou seu cliente) já tem um site, mas está desatualizado, com design antigo e copy fraca. Quer uma versão melhor sem começar do zero.

O que acontece:

1. O Claude acessa o site e extrai tudo: conteúdo, profissionais, especialidades, contato, cores, fontes
2. O plugin de Marketing analisa a copy atual e reescreve com framework de conversão (problema → solução → prova → CTA)
3. O plugin de Design extrai o design system original e cria uma versão melhorada — moderna, responsiva, profissional
4. Onde faltam imagens, o Claude gera exemplos em alta qualidade
5. Resultado: página completa mantendo as informações reais do negócio, mas com design e copy de outro nível

O que o Code faz que o Cowork não faz

Por que NÃO é bicho de 7 cabeças

Você instrui em português. Não precisa programar. As skills são texto. Se você sabe escrever um manual de procedimentos, você sabe criar uma skill.

Como acessar (recomendado)

1. Abra o Claude Desktop App

   Aquele que você já baixou em claude.ai/download. Mac ou Windows.

2. Clique na aba Claude Code no topo

   Está ao lado de Chat e Cowork. Pronto — você já está dentro do Claude Code.

3. Comece a conversar

   Tudo que você vai aprender nesta imersão (skills, agentes, squads) acontece aqui dentro. Sem terminal externo.

3 perguntas pra levar pra sua rotina

1. Qual é a tarefa mais repetitiva do seu trabalho hoje?

   Aquela que você faz toda semana, sempre do mesmo jeito. É a primeira candidata a virar trabalho do Claude — e te devolver tempo.

2. Onde você mais perde tempo no dia a dia?

   Pesquisa, documentação, formatação, análise de dados... ache o maior ralo de tempo. É ali que o Claude gera mais impacto pra você.

3. Que processo você consegue explicar em 5 passos?

   Se você consegue descrever, o Claude consegue executar junto. Esse é o tipo de tarefa pronta pra fazer com I.A.

Como começar ainda hoje

• Anote suas 3 respostas num caderno ou no próprio Claude (Chat ou Cowork).
• Abra o Claude e jogue ali a tarefa mais chata da sua semana — só pra sentir como é.
• Escolha 1 tarefa pra resolver com a I.A já nesta semana. Comece pequeno, ganhe confiança e vá expandindo.

10 de Julho 2026 · 9h às 11h · Administrado por Willian e Lucas

Hoje o assunto é design: criar interfaces com I.A., entender o que é um design system, e aplicar tudo num app real — do Claude Design ao Claude Code.

O que você vai levar desse módulo

Roteiro do dia

Duas opções gratuitas do Google, pra quem ainda não tem acesso ao Claude — mesma lógica: descrever o que quer, deixar a I.A. desenhar.

Stitch (stitch.withgoogle.com)

Ferramenta de design de UI do Google Labs. Você descreve a tela (ou sobe um print de referência) e ele gera o design — mobile ou web. Dá pra refinar por conversa, anotar direto na tela, e exportar pro Figma ou como código.

Os 4 modos do Stitch

Quando você abre o Stitch, no topo tem um seletor de modo. São 4, e cada um roda um modelo diferente do Gemini pra um propósito específico:

Exportando o resultado

Um ponto forte do Stitch: ele não te prende dentro dele. Quando o design fica pronto, tem um botão Exportar que oferece 9 destinos, agrupáveis assim:

Google AI Studio (aistudio.google.com)

Plataforma gratuita do Google pra construir com os modelos Gemini direto no navegador. O modo "Build" deixa descrever um app em linguagem natural e ele gera o projeto completo — não só a tela, a lógica também.

O que é o Claude Design

Chat de um lado, canvas do outro — você descreve, ele desenha. Acesso por claude.ai/design no navegador, ou pela aba Design no Claude Desktop. A primeira tela é a "What will you design today?": campo pra descrever o que quer, um + pra anexar arquivos, e dois seletores importantes no topo — Design system e Template.

Como o design vira app: a ponte com o Claude Code

O Claude Code trabalha em cima de uma pasta no computador — é lá que os arquivos do projeto (como o index.html) vivem. O Claude Design é um app à parte, na nuvem: ele não enxerga essa pasta sozinho. A ligação entre os dois é o botão Share, que existe no topo de qualquer coisa criada no Claude Design. Ele gera um bloco de texto já pronto pra colar no Claude Code — algo tipo "Use o MCP claude_design (auth via /design-login) pra importar este projeto: [link]. Implemente: os designs deste projeto." É ridiculamente simples — e é o que vamos fazer agora.

🖐️ Mão na massa — todos juntos

Objetivo: todo mundo passa pelo fluxo Design → Code pelo menos uma vez, e sai deste bloco com um todolist funcionando no navegador.

1. Abra o Claude Design

   Em claude.ai/design ou pela aba Design do Claude Desktop.

2. Peça um todolist

   Cole o prompt abaixo na tela inicial "What will you design today?". O Claude gera a tela no canvas.

   Prompt — Todolist no Claude Design Copiar

   Cria uma tela de app de lista de tarefas completo: - Campo pra adicionar tarefa e botão de adicionar - Lista das tarefas com opção de marcar como concluída e apagar - Categorias/tags nas tarefas (ex: trabalho, pessoal, estudos) - Filtros no topo: Hoje, Semana, Concluídas - Prioridade (alta, média, baixa) com cores diferentes - Data e prazo em cada tarefa - Uma visão em kanban (colunas: A fazer / Em progresso / Concluído), alternável com a visão de lista Visual limpo, moderno, pronto pra virar um app web funcional.

3. Clique em Share no topo e copie o texto inteiro

   Aquele bloco que começa com "Use o MCP claude_design..." — não é só o link, é uma instrução completa pro Code.

4. Abra o Claude Code na pasta que você quer usar

   Uma pasta nova ou uma pasta de trabalho — pelo terminal ou pela aba Code do Claude Desktop.

5. Rode /design-login

   Isso autoriza o Claude Code a ler seus projetos do claude.ai/design. Se aparecer "Design-system access authorized", tá tudo certo. Só precisa fazer uma vez por sessão.

6. Cole o texto do Share + peça a implementação

   Cole primeiro o texto do Share, em seguida o prompt abaixo. O Code cria o index.html do todolist na pasta.

   Prompt — depois do texto do Share Copiar

   Implementa esse design como um app web funcional num único arquivo index.html, com HTML/CSS/JS. As tarefas devem salvar no navegador (localStorage). Tudo precisa funcionar de verdade: adicionar, concluir, apagar, categorias, filtros, prioridades, datas e a troca entre visão de lista e kanban.

7. Rode o arquivo no navegador

   Abra o index.html e teste: adicionar, concluir, apagar, os filtros e a troca lista/kanban. Pronto: você desenhou com I.A. e transformou num app completo.

Pra brincar depois: refinar o design no próprio canvas

Hoje quem aplica o visual é o Claude Code, então não vamos usar isso agora — mas se quiser refinar um design ali mesmo no canvas do Claude Design, tem quatro caminhos:

O pulo do gato: por que o "Design system" importa

Se você abrir o Claude Design sem nada e pedir um redesign, ele até gera algo bonito — mas genérico, igual vimos no Stitch, no Google AI Studio e no todolist que acabamos de criar. Com um design system anexado, cada projeto novo já nasce com cores, tipografia e componentes no padrão. É o "DNA visual" da marca: paleta, fonte, espaçamento, botões, cards — tudo documentado de um jeito que a I.A. consegue replicar sem reinventar a cada tela.

A gente ainda não tem nenhum criado — então vamos criar um agora, todos juntos, usando um .md baixado do getdesign.md (Stripe, Linear, Notion...). Cada um escolhe a marca que curte.

🖐️ Mão na massa — passo a passo (tela por tela)

1. Baixe o .md da marca escolhida

   Em getdesign.md, escolha uma marca (Linear, Stripe, Notion...) e baixe o arquivo .md pro computador.

2. Na tela inicial do Claude Design, clique no campo "Design system" (tá em "None")

   Vai aparecer um mini-popup: "Set up a design system so every project starts from your colors, type, and components" com o botão Set up your design system. Clique nele.

3. Escolha "Create here"

   Vai abrir a janela "Add a design system" com duas opções:

   Opção	Quando usar
   Create here	É o que vamos usar hoje. Aceita upload de arquivos (o .md do getdesign.md, slides, logos, .fig do Figma) ou link de GitHub.
   Create using Claude Code (badge BEST FIDELITY)	Pra quem já tem um projeto real com componentes em código. Em vez de continuar no navegador, o Claude gera um comando pra você colar no Claude Code — ele lê o repositório inteiro localmente e extrai os valores exatos direto do código (hex, spacing, tipografia). Por isso é "best fidelity". Não é o nosso caso hoje — ignore.

   Detalhe: o "Create using Claude Code" precisa de uma pasta com um projeto real (React, Vue, HTML/CSS estruturado). Uma pasta com só o .md do getdesign.md dentro não é suficiente pra esse caminho — o certo aí é o Create here.

4. Preencha a tela "Set up your design system"

   • Company name and blurb: nome curto pro design system (ex: "Estilo Linear — teste").
   • Add fonts, logos and assets: arraste aqui o .md baixado. É esse campo que aceita o arquivo do getdesign.md.
   • Os outros campos (GitHub, .fig, computador) ficam vazios — são pra outros cenários.

5. Clique em "Continue to generation"

   Canto superior direito. O Claude lê o .md e gera paleta, tipografia, componentes e padrões de layout automaticamente.

6. Teste com um card ou botão simples

   Peça algo curto — "crie um card de produto" — pra ver se saiu com a cara da marca. Se sim, o design system tá pronto.

7. Clique em Share no design system e copie o texto inteiro

   Igual fizemos com o todolist. Guarde esse texto — é ele que vamos colar no Claude Code no próximo bloco. Se você tá na mesma sessão do Code desde o Bloco 3, nem precisa rodar /design-login de novo.

Você tem um todolist rodando (Bloco 3) e um design system criado, com o texto do Share copiado (Bloco 4). Agora é juntar os dois: o Claude Code puxa o design system pelo MCP e reescreve o HTML/CSS do app inteiro no padrão da marca — mantendo toda a lógica intacta.

Escolha sua rota

🖐️ Mão na massa — todos juntos

1. No Claude Code, cole o texto do Share do design system

   Aquele que você copiou no fim do Bloco 4. Se abriu uma sessão nova do Code, rode /design-login antes.

2. Em seguida, cole o prompt de aplicação

   Prompt — depois do texto do Share do design system Copiar

   Aplica esse design system no meu app de lista de tarefas (index.html) — cores, tipografia, componentes, espaçamento. Mantém toda a lógica que já existe, só atualiza o HTML e CSS pra ficar com a cara desse design system.

3. Recarregue o app no navegador

   Compare o antes e o depois: mesma lógica, mesmas tarefas salvas — mas agora com a cara da Stripe, do Linear ou da marca que você escolheu.

Prompt de incremento — só pra Rota 2

Se você trouxe um todolist antigo e quer deixar ele mais rico antes de aplicar o design system, use este prompt no Code antes da mão na massa acima.

Pra conhecer: os três caminhos da ponte Design ↔ Code

Hoje usamos o botão Share porque funciona em qualquer conta, é visual e não depende de comando decorado. Mas existe um comando com nome enganoso que vale conhecer: /design-sync faz o caminho oposto — empurra componentes locais (React) do seu projeto pra dentro de um design system no Claude Design. Só faz sentido quando você já tem uma biblioteca de componentes em código e quer transformar isso num design system pra reusar.

As 4 ideias pra levar pra casa

O fluxo completo que você aprendeu hoje

1. Desenhar: descrever a tela no Claude Design (ou Stitch/AI Studio, nas opções gratuitas)
2. Implementar: botão Share → colar no Claude Code → app funcionando
3. Padronizar: criar um design system a partir de um .md (getdesign.md) ou da sua marca
4. Aplicar: Share do design system → Claude Code redesenha o app inteiro no padrão

Você já viveu isso

Você pede pra I.A. mudar uma coisinha e ela quebra três outras. Você volta na segunda-feira e ela decide diferente do que decidiu na sexta. Você passa o projeto pra outra pessoa e ela não consegue continuar. Isso não é defeito da I.A. — é ausência de planta.

No Encontro 03 saímos com um protótipo de TO-DO List validado. Ele é bonito e funciona na tela. Mas repare no que ele não tem resposta:

As 5 causas do Frankenstein

Esse é o diagnóstico. Repare em uma coisa enquanto lê: nenhuma delas é um problema de programação.

Os 4 antídotos

O que separa "prompt que dá certo" de "projeto que se sustenta" são quatro artefatos. Três deles são texto em português. Nenhum é código.

A analogia da obra

Cowork trabalha com arquivos. Code trabalha com um projeto.

Você já viu a tabela completa no Ato 1. Aqui interessam só as duas diferenças que mudam a aula de hoje:

Onde ele roda

Mesma engine, várias portas de entrada:

O CLAUDE.md e as configurações valem em todas as portas. MCPs, plugins e alguns atalhos variam entre elas — e é exatamente aí que a maioria dos tutoriais confunde a cabeça de quem está começando.

Contexto é o recurso escasso

Se você levar um conceito técnico deste encontro, leve este.

Os 5 controles que resolvem 90% dos problemas

Na aba Code do Claude Desktop:

“E o Cursor?”

O Cursor é o principal concorrente e é uma ferramenta excelente. Não vamos abrir hoje — a filosofia dele é diferente da desta aula — mas você precisa saber que ele existe e quando faz sentido.

PRD é a sigla de Product Requirements Document — Documento de Requisitos do Produto. Em português claro: o contrato entre a ideia e a execução.

Ele responde três perguntas que, sem resposta escrita, o Claude responde por você — e diferente a cada sessão: o quê vamos construir, pra quem, e o que significa estar pronto.

Anatomia de um PRD

Por que "Fora de escopo" salva o projeto

Todo projeto feito com I.A. cresce sozinho. Você pede uma lista de tarefas e três prompts depois tem notificação, etiqueta, tema escuro e exportação em PDF — nenhum deles pedido, todos plausíveis.

A seção "Fora de escopo" é o único freio que funciona, porque ela dá ao Claude — e a você — uma razão escrita pra dizer não.

Critério de aceite: bom vs. ruim

Um critério de aceite serve pra uma coisa só: encerrar a discussão sobre se está pronto. Se duas pessoas podem ler e discordar, ele está ruim.

O prompt que gera o PRD

Você não escreve o PRD sozinho — você deixa o Claude te entrevistar. É a diferença entre um documento genérico e um documento que pega os buracos que você não tinha visto.

Leia o protótipo do TO-DO List nesta pasta e me diga, em lista curta,
o que o usuário consegue fazer hoje.

Depois me entreviste com a ferramenta AskUserQuestion para escrever o
PRD deste produto, seguindo exatamente estas 6 seções: problema,
usuário-alvo, escopo, fora de escopo, critérios de aceite e métricas.

Regras da entrevista:
- Não pergunte o óbvio. Vá nas decisões difíceis que eu ainda não pensei.
- No máximo 4 rodadas (cada rodada pode ter mais de uma pergunta).
- Se eu não souber responder, proponha um default e marque como premissa.

Escreva cada critério de aceite assim: "quando [ação], então [resultado
observável]" — verificável em 3 segundos.

No fim, me proponha o PRD completo. Não grave arquivo ainda.

Modelo em branco

ADR é a sigla de Architecture Decision Record — Registro de Decisão de Arquitetura. Em português claro: a ata de uma decisão técnica.

Um arquivo por decisão, numerado, guardado junto com o código. Registra o que estava em jogo, quais eram as opções, o que escolhemos e o que essa escolha vai custar.

Anatomia de um ADR

Quando escrever um ADR?

Existe uma regra de bolso única, e ela é suficiente:

E se eu mudar de ideia?

Essa é a pergunta que sempre aparece — e a resposta é o que fecha o conceito.

Os prompts que geram os ADRs

Dois movimentos: o primeiro é interativo (a decisão é sua), o segundo é em lote (as menores).

Com base no docs/PRD.md, a decisão técnica mais cara de reverter aqui é
onde os dados das tarefas vão morar.

Escreva o ADR-001 em docs/adr/ seguindo exatamente estas 7 seções:

1. Cabeçalho — número, título, status, data, autor, projeto e tags
2. Contexto — a situação e por que isso precisa ser decidido agora
3. Opções consideradas — no mínimo 3, cada uma com prós, contras e
   custo/risco
4. Decisão — o que fica valendo, os requisitos que passam a ser
   obrigatórios por causa dela, e o trade-off que estamos aceitando
5. Consequências — positivas esperadas, negativas e riscos aceitos,
   e o que precisamos monitorar
6. Revisão — quando revisitar e quais gatilhos reabrem a decisão
7. Links — o PRD, ADRs relacionados e de onde veio a decisão

Me apresente as opções e me pergunte qual eu quero ANTES de preencher
a Decisão e marcar como Aceito.

Agora escreva mais dois ADRs em docs/adr/, com as mesmas 7 seções,
decidindo pela opção mais simples em cada um e registrando as
alternativas que descartamos:
- as tecnologias que vamos usar e por quê
- a estrutura de pastas e a separação entre dados, regras de negócio
  e interface

Exemplo real — como fica o ADR-001

O CLAUDE.md é um arquivo de texto que o Claude Code lê no início de toda sessão, automaticamente, sem você pedir. É onde moram as regras que valem sempre: como se trabalha aqui, o que ler antes de mexer, o que nunca fazer.

O mapa do projeto

Antes de gerar qualquer coisa, entenda onde cada arquivo mora. Sem isso, você vê arquivos aparecendo em pastas e não entende de onde vieram.

As 3 gavetas

A regra de arquitetura de código mais importante — e a mais fácil de entender sem programar.

As outras 4 regras

O que entra e o que não entra no CLAUDE.md

Gerando o seu

/init

Ele lê o projeto inteiro e propõe um CLAUDE.md inicial com o que descobriu: comandos de build, framework de teste, padrões que encontrou. Vai aparecer bastante jargão na tela — você não precisa entender nada disso. O que importa é o refino a seguir.

Ajuste o CLAUDE.md com as regras deste projeto:

- Antes de qualquer implementação, leia docs/PRD.md e docs/adr/
- Nunca contrarie uma decisão registrada em um ADR. Se achar que a decisão
  está errada, pare e me proponha um ADR novo que substitua o anterior,
  em vez de mudar o código
- Separe dados, regras de negócio e interface em arquivos diferentes
- Um arquivo, um assunto. Nomes descritivos em português
- Não repita a mesma regra em mais de um lugar
- Entregue em fatias que rodam de ponta a ponta, não em camadas
- Depois de cada mudança, rode a aplicação e me mostre a evidência de que
  funcionou

Mantenha o arquivo abaixo de 200 linhas e não escreva nada que você
conseguiria descobrir lendo o código.

Conferindo que ele leu

/context

Mostra tudo que está carregado na memória da sessão. Procure o CLAUDE.md na lista de Memory files. Se ele não estiver ali, o Claude não está vendo suas regras — e nenhuma delas vale.

Segurança: o que nunca pode entrar

1. Abra a pasta e mude o modo para Plan

   Na aba Code do Claude Desktop, abra a pasta do protótipo. Use o seletor de modo ao lado do botão de enviar e escolha Plan.

   Nesse modo ele lê, pensa e propõe — mas não escreve nada. Você está pedindo pra ele pensar antes de agir.

2. Deixe ele te entrevistar

   Rode o Prompt 1 (bloco anterior). Responda em voz alta. Quando ele perguntar algo que você não tinha pensado — tipo "o que acontece se a mesma tarefa for editada em duas abas?" — esse é o valor do documento aparecendo.

   Ao aprovar o PRD, mude o seletor de modo para Accept edits. Você já revisou o que ele vai fazer; agora deixa ele escrever sem perguntar a cada arquivo.

3. Transforme o PRD em decisões

   Rode o Prompt 2 (o ADR-001, decidindo junto) e depois o Prompt 3 (os outros dois, em lote). Escolha deliberadamente a opção mais simples em cada um.

   O ADR registrou as opções descartadas e o motivo. Daqui a seis meses, quando a escolha simples não der mais conta, a discussão não recomeça do zero.

4. Escreva as regras da casa

   Rode /init e depois o Prompt 5 de refino. Confira com /context que o arquivo foi carregado.

5. Coloque a fundação no Git

   O primeiro commit do projeto não tem uma linha de código — tem a planta, as decisões e as regras.

   Prompt 7 · a fundação vai pro histórico Copiar

   Inicialize um repositório git nesta pasta, crie um .gitignore adequado e
   faça o primeiro commit com o PRD, os ADRs e o CLAUDE.md. Mensagem:
   "fundação do projeto: PRD, ADRs e regras de trabalho".

Os dois momentos que confundem

Comece com o contexto limpo

/clear

Toda a conversa da primeira metade já cumpriu o papel dela — virou arquivo. Se você carregar isso pra frente, só ocupa memória. Contexto limpo com documento bom rende mais que contexto cheio com histórico bagunçado.

Planejar antes de executar

Volte o seletor de modo para Plan.

Leia docs/PRD.md, todos os ADRs em docs/adr/ e o CLAUDE.md.

Monte um plano de implementação dividido em fatias que rodam de ponta a
ponta. Para cada fatia, diga: o que o usuário consegue fazer ao final dela,
quais arquivos são criados ou alterados, e como eu verifico que funcionou.

A fatia 1 tem que ser a menor possível: adicionar uma tarefa e ela aparecer
na lista, persistindo. Nada além disso.

Não escreva código ainda.

Quando o plano aparecer, corrija em português. Você não precisa abrir editor nenhum:

Inverte a ordem das fatias 2 e 3 e tira o item de exportação — isso está
fora de escopo no PRD.

Executar com verificação

Aprove o plano e volte o modo para Accept edits.

Implemente apenas a fatia 1 do plano.

Ao terminar: rode a aplicação, tire um screenshot e compare com o protótipo
original que está em docs/prototipo-original/. Me mostre a evidência. Se
houver diferença visual, liste e corrija antes de me chamar.

O teste do ADR

Agora o momento que prova a tese do encontro. Volte o modo para Plan antes deste prompt — assim, mesmo que ele decida obedecer, ele propõe em vez de reescrever.

Muda o armazenamento pra um banco de dados na nuvem.

Pontos de restauração

/rewind

Todo prompt que você manda cria um ponto de restauração. Dá pra restaurar só o código, só a conversa ou os dois. Isso te dá permissão pra ser ousado: mande ele tentar a ideia arriscada; se quebrar, você volta.

Refatorar contra um critério

Refatorar é melhorar a estrutura sem mudar o que o programa faz. Com I.A., a diferença entre um refactor bom e um desastre é uma só: você refatora contra um critério, não contra um gosto.

Aponte a regra de negócio que está escrita em mais de um lugar neste
projeto. Consolide numa fonte única, sem mudar o comportamento, e rode
a verificação.

Debug assistido

Um bom prompt de debug tem três partes. Falta uma, e você vira o depurador.

[sintoma concreto]. Deve estar em [local provável]. Escreva primeiro um
teste que reproduza o erro, depois corrija, e me mostre o teste passando.
Ataque a causa raiz, não esconda o sintoma.

Segunda opinião

Use um subagente para revisar o diff desta implementação contra o
docs/PRD.md. Verifique se todos os critérios de aceite foram cumpridos e
se nada fora do escopo foi alterado. Reporte lacunas de correção, não
preferências de estilo. Apenas leitura e relatório — não altere arquivos.

Um subagente é uma segunda cabeça, com memória própria e limpa. Ele não viu você escrever esse código, então revisa de verdade — e não gasta a memória da sua conversa principal.

Higiene de contexto: o quadro de sobrevivência

O que nunca delegar sem olhar

O Claude Security é um plugin oficial da Anthropic, em beta, que roda uma varredura de vulnerabilidades com vários agentes dentro de uma sessão do Claude Code. Um time de agentes mapeia a arquitetura do seu projeto, monta um modelo de ameaça, caça vulnerabilidades e revisa cada achado de forma independente antes de escrever o relatório.

Pré-requisitos

• ✓ Claude Code v2.1.154 ou superior, em plano pago
• ✓ Dynamic workflows ligado — no plano Pro, ative na linha "Dynamic workflows" do /config. É o que permite ele orquestrar os vários agentes
• ✓ Python 3.9.6+ disponível como python3. Confira com python3 --version. Nada é instalado — ele usa só a biblioteca padrão
• ✓ Git — necessário para varrer alterações e para gerar correções. A varredura completa funciona em qualquer pasta, com ou sem Git

Instalação em 3 comandos

1. Instale a partir do marketplace oficial

   Digite direto no chat de uma sessão do Claude Code:

   No chat do Claude Code Copiar /plugin install claude-security@claude-plugins-official

2. Se ele disser que não achou o marketplace

   Adicione o marketplace oficial da Anthropic e tente instalar de novo:

   Só se o passo 1 falhar Copiar /plugin marketplace add anthropics/claude-plugins-official

3. Ative na sessão atual

   Aplica as mudanças sem precisar reiniciar nada:

   Ativar Copiar /reload-plugins

Os 3 trabalhos que ele faz

O plugin adiciona um comando só, /claude-security, que abre um menu com três opções:

Por que o relatório é curto (e por que isso é bom)

A maior praga de ferramenta de segurança é o falso positivo: cem alertas, dois reais, e você para de olhar. O Claude Security ataca isso com verificação adversarial — um achado só entra no relatório depois que agentes revisores independentes analisam ele, cada um olhando por uma dimensão diferente:

Achado que não convence a maioria dos revisores não aparece no relatório. E a confiança reportada reflete isso: aprovação unânime vale confiança alta; aprovação apertada fica em média.

As famílias de problema que ele persegue

O que sai da varredura

Tudo cai numa pasta com data e hora, dentro do próprio projeto:

Cada achado no relatório vem com ID (F1, F2...), impacto, cenário de exploração, severidade, confiança e recomendação. O arquivo de revisão amarra o relatório ao commit exato que foi analisado — então um relatório nunca fica órfão do código que ele descreve.

As correções são sempre sua decisão

Antes de te entregar uma correção, ela é revisada por um agente diferente do que escreveu — que roda os testes do projeto contra a mudança (quando existem testes) e lê o diff por conta própria procurando efeito colateral. Uma correção só é escrita quando essa revisão consegue garantir três coisas: resolve aquele achado, não introduz vulnerabilidade nova, e não muda o comportamento do resto. Quando não consegue garantir, você recebe uma nota explicando o porquê — não um patch.

Onde ele se encaixa

Ele não substitui nada — ele é uma camada a mais. Segurança funciona empilhada:

Faça agora, no projeto que você acabou de construir

/claude-security

/claude-security scan my branch

Corrige o achado F1 do último relatório. Me explique em português o que
o patch muda e por que aquilo era um problema, antes de eu aplicar.

Antes de escrever qualquer código com I.A.

Durante o trabalho

• Modo Plan antes de qualquer tarefa que mexe em mais de um arquivo
• Fatie em entregas que rodam de ponta a ponta — não em camadas
• /clear entre tarefas que não têm relação
• Duas correções no mesmo erro = /clear e recomeçar com prompt melhor
• Commite cedo e sempre — rewind é o desfazer, Git é a história
• Mudou de ideia? ADR novo substituindo o antigo, nunca mudança silenciosa
• Varra antes de publicar — /claude-security scan my branch

Tarefa da semana — sem escrever código

3 perguntas pra escolher o projeto

1. Que processo do seu dia você consegue explicar em 5 passos? Se você consegue descrever, dá pra escrever um PRD.
2. Onde você já tentou usar I.A. e o resultado desandou? Provavelmente faltava exatamente um desses documentos.
3. Que ferramenta você queria ter e nunca teve orçamento pra pedir? Essa é a candidata mais divertida.

Ponte para o Encontro 05

O que a gente vai fazer com os seus 3 arquivos

• CLAUDE.md → o briefing do agente. É o arquivo que ele lê antes de agir. Lá ele deixa de ser só regra de estilo e passa a dizer quando usar cada Skill e cada MCP que a gente conectar.
• PRD.md → o limite. Agente autônomo sem definição de pronto não para sozinho. O PRD é o que diz onde a tarefa termina.
• ADR-001 → a memória das decisões. Sem ele, o agente re-decide a arquitetura a cada sessão e desfaz o que você já tinha resolvido.

E os hooks que ficaram de fora hoje entram aqui: é o que transforma uma regra do CLAUDE.md em algo que o agente não consegue ignorar.