Desenhe fora da ferramenta antes de codar

Desenhe fora
→ da ferramenta.

Antes do prompt, o desenho. Antes do código, o pensamento. O operador que abre o terminal direto reconstrói o tempo todo; o que desenha fora da ferramenta conduz.

2 aulas T2framings de pensamento estruturado

3 superfíciesMiro, Figma, papel antes do terminal

1 esboçoportão para passar a próxima aula

Legenda de coresMapa semântico da aula

Terminal-primeiro

Desenho fora

Pensamento estruturado

Contexto antes do pedido

5 perguntas

Mapa da aula

Use este mapa para entender a sequência da aula antes de entrar nos detalhes.

Legenda de coresOs 5 estados desta aula

Terminal-primeiroabre o prompt sem desenho, reconstrói a cada iteração

Desenho foraesboça o sistema em Miro, Figma ou papel

Pensamento estruturadoa meta-habilidade que vale mais que a ferramenta

Contexto antes do pedidopergunta e desenha antes de pedir

5 perguntasmapeia o ciclo de vida antes de codar

Pensamento estruturado é a maior habilidade da era IA

A ferramenta muda toda semana. O modelo fica obsoleto. O que não fica obsoleto é a sua capacidade de estruturar um problema antes de pedir a solução.

A regra que sustenta a aulaA maior habilidade da era IA não é digitar prompt bonito. É pensar de forma estruturada antes de abrir a ferramenta. Meta-aprendizagem é o segredo: quem sabe estruturar, troca de modelo sem perder o passo.

Operador terminal-primeiro

Abre o Claude Code e digita 'cria um sistema de X'.
Deixa a ferramenta decidir a estrutura.
Itera às cegas quando o output vem torto.
Reconstrói a solução a cada tentativa.

Operador desenho-primeiro

Abre o Miro e desenha a empresa, as entidades, o ciclo de vida.
Decide a estrutura antes de tocar no terminal.
Chega no prompt com o sistema já desenhado.
Reconstrói pensamento uma vez, depois só executa.

Adriano de Marqui (host T2, t2-aula-1)Pensamento estruturado é a maior habilidade da era IA. Meta-aprendizagem é o segredo das coisas. Eu distribuo 41 modelos de framework porque o repertório visual é o que te deixa desenhar antes de pedir.

O caminho da aula

Três movimentos: entender por que desenhar antes, ver o caso de quem não desenhou, e aplicar as 5 perguntas no seu próprio processo.

Os 3 movimentos

1. Por que desenhar antespensamento estruturado vence ferramenta e prompt

2. O caso de quem não desenhouo login do Adavio: pedido sem contexto vira retrabalho

3. As 5 perguntasmapear o ciclo de vida da entidade antes de codar

[ a ] Você vai sair sabendo

Por que o desenho fora da ferramenta reduz retrabalho.
Como o Adavio transformou um pedido torto em um sistema.
As 5 perguntas para mapear qualquer entidade.

[ b ] Você vai sair fazendo

Um esboço de um sistema seu (squad ou workflow) em papel ou Miro, antes do primeiro prompt.

O ritmo do operador maduroTrês batidas que se repetem em todo projeto novo.

1Desenhafora da ferramenta, o sistema inteiro

2Perguntaquais formas existem, antes de escolher uma

3Só então pedecom o sistema desenhado e o contexto montado

Desenhar antes ou abrir o terminal?

Nem todo trabalho exige um mapa no Miro. Mas todo sistema novo exige. A decisão é sobre a complexidade do que você está criando.

Você vai criar um sistema novo (squad, workflow, entidade)?

Sistema = algo com mais de uma entidade e um ciclo de vida.

Tarefa pontual

Edição isolada, bug fix com reprodução clara, ajuste de uma linha.

signal

Sistema novo

Squad, workflow, entidade com ciclo de vida, processo recorrente.

action

↓ ↓ ↓

Dá pra explicar o sistema desenhando numa folha?

Se não dá pra desenhar, você ainda não entendeu o sistema. Não abra o terminal.

O atalho que custa caroPular o desenho parece economizar 10 minutos. Custa horas de reconstrução. O terminal te deixa começar errado rápido.

Cluster 1 / 4pensamento estruturado vence ferramenta · desenho fora antes do prompt · quando desenhar vs ir direto

Você entendeu a tese. Agora vê o que acontece com quem ignora ela: o caso do login do Adavio.

Caso Real

O login do Adavio

Um pedido de uma linha, 'cria um login', virou retrabalho. O mesmo pedido, depois de desenhado e pesquisado, virou um sistema. A diferença foi o contexto antes do pedido.

Cria um login (e a pergunta que mudou tudo)

Quando o operador pede sem contexto, ele aceita o primeiro caminho que a IA inventa. Quando pesquisa antes, ele escolhe.

Rota · action

Começou comoPedido de uma linha: cria um login pra mim.

VirouSistema de autenticação desenhado: métodos pesquisados, fluxo no Miro, hierarquia de usuários definida.

ProvaA pergunta 'qual a chance disso dar errado' obrigou a pesquisar formas de autenticação antes de codar.

LiçãoContexto antes do pedido transforma retrabalho em sistema.

SituaçãoAdavio pede 'cria um login' direto no terminal. A IA escolhe um método qualquer. O resultado funciona, mas é frágil e não cabe no resto do sistema.

DecisãoParar antes de pedir. Perguntar quais são as formas de autenticação. Desenhar o fluxo e a hierarquia de usuários fora da ferramenta.

EvidênciaAdriano pergunta ao vivo: qual a chance disso dar errado? A resposta força a pesquisa antes do pedido.

Mensagem ao alunoO pedido sem contexto é o atalho que parece rápido e cobra caro depois.

ContextoEm t2-aula-2, Adriano conduz um diálogo com Adavio sobre como criar um login. Em vez de aceitar o primeiro 'cria login', ele freia e investiga.

Percepção-chavePedir 'cria login' sem contexto entrega retrabalho. Pesquisar métodos de autenticação, desenhar o fluxo e mapear a hierarquia de usuários entrega um sistema que cabe no todo.

DecisãoPesquisar as formas, desenhar fora da ferramenta, montar o contexto, e só então pedir com referência específica.

1Pedido crucria um login pra mim, sem contexto nenhum.

2A perguntaqual a chance disso dar errado? Força a pensar antes de pedir.

3Pesquisa e desenhoquais formas de autenticação existem? Desenha fluxo e hierarquia no Miro.

4Pedido com contextoagora o prompt carrega o sistema desenhado. Output cobrável.

1 linhapedido cru vs sistema desenhado

Antespesquisar formas antes de pedir, não depois

Cabe no todofluxo desenhado vs método aleatório da IA

Adriano de Marqui (host T2, t2-aula-2)Nos meus PSs eu não reconstruo a solução, eu reconstruo o pensamento. Se você desenhou o sistema, qualquer modelo refaz o código. Se você só tem o código, você está refém dele.

O impacto medido de desenhar antes

Desenhar fora da ferramenta muda três números: quantas iterações até o output certo, quanto retrabalho, e se o sistema cabe no resto.

AbordagemIterações até acertarRetrabalhoCabe no sistema

Terminal-primeiro (pedido cru)

Iterações até acertarmuitas

Retrabalhoalto

Cabe no sistemararamente

Desenho-primeiro (Miro antes)

Iterações até acertarpoucas

Retrabalhobaixo

Cabe no sistemapor design

Pesquisa + desenho + pedido

Iterações até acertarmínimas

Retrabalhoquase zero

Cabe no sistemasempre

Onde o tempo do operador vai (terminal-primeiro vs desenho-primeiro)

Terminal-primeiro: tempo em reconstrução
65%
Terminal-primeiro: tempo em execução útil
35%
Desenho-primeiro: tempo em desenho
20%
Desenho-primeiro: tempo em execução útil
80%

Cluster 2 / 4caso do login do Adavio · contexto antes do pedido · métricas de desenhar antes

Você viu o custo de não desenhar. Agora vê a técnica formalizada: as camadas e as 5 perguntas.

Trilogia

WHY / WHAT / HOW do desenho-primeiro

As 3 camadas da técnica. Pular qualquer uma reduz o desenho a um rabisco sem consequência operacional.

WHY - Pensamento estruturado sobrevive ao modelo

A ferramenta e o modelo ficam obsoletos. O sistema que você desenhou não. Quem estrutura o problema troca de IA sem perder o passo. Meta-aprendizagem é a vantagem composta.

WHYmeta-habilidade

WHAT - Desenhar fora da ferramenta

Miro, Figma ou papel. Você desenha a empresa, as entidades, o ciclo de vida e as tasks antes de tocar no terminal. O desenho é o contrato; o código é só a execução dele.

WHATfora da ferramenta

HOW - Pergunte e mapeie antes de pedir

Contexto antes do pedido. Pergunta quais formas existem, desenha o fluxo, mapeia o ciclo de vida com as 5 perguntas. Só então o prompt carrega o sistema.

HOW5 perguntas

O fluxo: do papel ao prompt

A sequência que o operador maduro roda antes de abrir o terminal. Cada etapa reduz o que a IA tem que adivinhar.

Da intenção crua ao prompt com contexto

Empresa

desenha o que o sistema serve: a entidade-mãe.

Entidades

lista as entidades e como elas se relacionam.

Ciclo de vida

para cada entidade, mapeia nascimento, estados e fim.

Tasks

deriva as tasks recorrentes de cada ciclo de vida.

Prompt

só agora abre o terminal, com o sistema já desenhado.

As 5 perguntas para mapear o ciclo de vida

O exercício guiado que o Adriano dá no T2. Liste 5 processos recorrentes do seu trabalho e responda 5 perguntas para cada um, antes de modelar no sistema.

◇▶ signal_plus_action

Mapear o ciclo de vida de uma entidade

Use antes de criar qualquer entidade, squad ou workflow novo.

processo→dados→documentacao→formato→ciclo

processo — Qual é o processo? Descreva em uma frase o que acontece do início ao fim.
dados — Quais dados únicos essa entidade carrega? O que só ela tem?
documentação — Onde esses dados estão documentados hoje? Planilha, cabeça, lugar nenhum?
formato — Qual o formato ideal pra esse dado viver? YAML, tabela, doc?
ciclo — Modele o ciclo de vida: como a entidade nasce, que estados percorre, como termina.

Liste 5 antes de modelar 1Antes de codar, liste 5 processos recorrentes do seu trabalho. Rode as 5 perguntas em cada um. Só depois escolha qual virar squad ou workflow primeiro. O mapa vem antes do martelo.

Modelagem na pressa

Cria a entidade direto no código.
Descobre os dados que faltam depois, quebrado.
Refaz o ciclo de vida 3 vezes.

Modelagem com as 5 perguntas

Responde as 5 perguntas no papel primeiro.
Chega no código com os dados e o ciclo já definidos.
Modela uma vez, ajusta detalhe.

Não confunda desenhar com enrolar

Desenhar antes não é procrastinar nem fazer diagrama bonito. É reduzir o que a IA precisa adivinhar. Três confusões comuns.

Não confundaDesenhar fora da ferramenta, não fazer diagrama bonito

O desenho serve pra estruturar o pensamento, não pra impressionar.

Esclareça: Um rabisco no papel que define entidades e ciclo de vida vale mais que um Figma lindo sem decisão.

Não confundaPensamento estruturado, não planejamento infinito

Estruturar é decidir a forma do sistema, não adiar a execução.

Esclareça: Se o desenho já responde as 5 perguntas, pare de desenhar e abra o terminal.

Não confundaContexto antes do pedido, não terceirizar a decisão

Você pesquisa as formas pra escolher, não pra a IA escolher por você.

Esclareça: Perguntar quais são as opções é operador. Aceitar a primeira opção sem avaliar é refém.

'Cria um sistema de X'

pedido cru: a IA inventa a estrutura.

'Desenhei X com estas entidades'

pedido com desenho: a IA executa a estrutura.

'Pesquisei as formas, escolhi esta'

pedido com contexto: a IA refina uma decisão sua.

Pipeline: desenhar-antes-de-codar

As 4 fases que transformam intenção em sistema desenhado, antes do primeiro prompt.

1. Desenhar

Abre Miro, Figma ou papel. Desenha empresa, entidades e relações. Nada de terminal ainda.

Fase 1 · Outputdesenho-sistema.miro (ou foto do papel)

Fase 2 · GateDá pra explicar o sistema apontando pro desenho? Se não, continue desenhando.

2. Perguntar

Pergunta à IA quais formas existem para as partes que você não domina. Pesquisa antes de escolher.

Fase 1 · Outputlista-de-formas.md com prós e contras

Fase 2 · GateVocê escolheu por critério, não pegou a primeira opção?

3. Mapear ciclo de vida

Roda as 5 perguntas em cada entidade. Define dados, formato e estados.

Fase 1 · Outputciclo-de-vida.yaml por entidade

Fase 2 · GateToda entidade tem nascimento, estados e fim definidos?

4. Pedir com contexto

Só agora abre o terminal. O prompt carrega o desenho e o ciclo de vida.

Fase 1 · Outputprimeiro prompt com sistema anexado

Fase 2 · GateO prompt referencia o desenho, não pede do zero?

Cluster 3 / 4trilogia WHY/WHAT/HOW · fluxo do papel ao prompt · 5 perguntas · pipeline desenhar-antes-de-codar

Você tem a técnica. Agora vê o ferramental: os estados do operador, as mecânicas e os KPIs.

Visualizações

Visualizações do desenho-primeiro

Como o desenho fora da ferramenta muda a curva de retrabalho e o trade-off entre tempo de desenho e tempo de execução.

Matriz desenho x complexidade do sistema

Quando vale desenhar fora da ferramenta e quando ir direto.

Sistema simples + pouco desenho

OK. Tarefa pontual não precisa de Miro.

Sistema simples + muito desenho

Over-engineering. Você está enrolando, não estruturando.

Sistema complexo + pouco desenho

Risco máximo. Reconstrução garantida no terminal.

Sistema complexo + muito desenho

Operador maduro. O desenho paga cada minuto em execução limpa.

1. Motor do desenho

Tira o sistema da cabeça e bota numa superfície visível. Externalizar reduz erro.

intençãorabiscoentidadesrelações

2. Motor da pergunta

Mapeia o espaço de soluções antes de escolher. Pesquisa vence achismo.

dúvidaquais formasprós e contrasescolha

3. Motor do ciclo de vida

Garante que cada entidade tem começo, meio e fim definidos antes de codar.

entidadenascimentoestadosfim

Estados e mecânicas do operador

O operador transita por 4 estados na maturidade de desenhar antes. Cada transição tem uma mecânica concreta.

Digitador✕ pain

Abre o terminal e pede direto. Reconstrói a cada iteração.

Rascunhador◇ signal

Rabisca alguma coisa, mas ainda pula etapas do ciclo de vida.

Desenhista◇ signal

Desenha o sistema inteiro fora da ferramenta antes do prompt.

Arquiteto✦ insight

Desenha, pergunta as formas e mapeia o ciclo de vida com as 5 perguntas.

Digitador para Rascunhador✦ insight

Abre o Miro antes do terminal uma vez. Sente a diferença de chegar com algo no papel.

Rascunhador para Desenhista◇ signal

Completa o desenho até empresa, entidades, ciclo de vida e tasks. Para de pular etapas.

Desenhista para Arquiteto▶ action

Adiciona a pergunta 'quais formas existem' e as 5 perguntas antes de pedir.

Arquiteto para Mentor▶ action

Distribui o repertório visual (modelos, frameworks) pro time desenhar antes também.

KPIs do operador que desenha antes

Os indicadores objetivos que separam o digitador do arquiteto.

Tempo em reconstrução

abaixo de 20%20% a 50%acima de 50%

Sistema desenhado antes do prompt

sempreàs vezesnunca

5 perguntas respondidas por entidade

5 de 52 a 40 a 1

KPIDigitadorDesenhistaArquiteto

Iterações até output certo

Digitadormuitas

Desenhistapoucas

Arquitetomínimas

Tempo em reconstrução

Digitadoralto

Desenhistabaixo

Arquitetoquase zero

Sistema cabe no todo

Digitadorraramente

Desenhistaquase sempre

Arquitetopor design

Desenho antes do prompt

Digitadornunca

Desenhistasempre

Arquitetosempre + pesquisa

Cluster 4 / 4matriz desenho x complexidade · estados e mecânicas · KPIs do desenho-primeiro

Ferramental visto. Agora a adoção e a prática: você vai esboçar um sistema seu antes de qualquer prompt.

Adoção

Como adotar sem virar burocracia

Desenhar antes não pode virar cerimônia que trava o trabalho. Adote pelo tamanho do sistema, não pela vontade de parecer organizado.

Não faça

Desenhar tudo, até o que é tarefa de uma linha.
Diagrama bonito sem decisão de entidade ou ciclo de vida.
Parar de desenhar só quando estiver perfeito.

Faça

Desenhar quando for sistema novo com entidades e ciclo de vida.
Rabisco que responde as 5 perguntas vale mais que Figma vazio.
Parar de desenhar quando as 5 perguntas estiverem respondidas.

Prática: esboce um sistema antes de pedir

Escolha um processo recorrente do seu trabalho e desenhe ele fora da ferramenta, respondendo as 5 perguntas, antes de abrir o terminal.

aula.yaml10 linhas

01# Preencha ANTES de abrir o terminal. Uma folha por entidade.02entidade: "{nome da entidade}"03processo: "{o que acontece do inicio ao fim, em 1 frase}"04dados_unicos: ["{dado que so essa entidade tem}", "{outro}"]05documentado_em: "{planilha | doc | cabeca | lugar nenhum}"06formato_ideal: "{yaml | tabela | markdown}"07ciclo_de_vida: 08  nascimento: "{como a entidade entra no sistema}"09  estados: ["{estado 1}", "{estado 2}", "{estado 3}"]10  fim: "{como a entidade sai ou se encerra}"

Portão da aulaAntes de seguir para a próxima aula: você desenhou um sistema seu fora da ferramenta e respondeu as 5 perguntas para a entidade principal, sem ter aberto o terminal. Se você abriu o terminal primeiro, volte e desenhe.

Liste 5 processos: Escreva 5 processos recorrentes do seu trabalho que poderiam virar squad ou workflow.
Escolha 1: Pegue o mais doloroso ou o mais frequente. Só um.
Desenhe fora da ferramenta: Em papel ou Miro, desenhe a entidade-mãe, as entidades relacionadas e como elas se ligam.
Responda as 5 perguntas: Para a entidade principal: processo, dados únicos, onde documentado, formato ideal, ciclo de vida.
Só então escreva o primeiro prompt: Abra o terminal e escreva o prompt referenciando o desenho, não pedindo do zero.

Glossário

Os termos desta aula em uma frase cada.

Pensamento estruturado

A capacidade de organizar um problema antes de pedir a solução. A maior habilidade da era IA.

Desenhar fora da ferramenta

Esboçar empresa, entidades, ciclo de vida e tasks em Miro, Figma ou papel antes de abrir o terminal.

Contexto antes do pedido

Pesquisar as formas e desenhar o fluxo antes de pedir, para escolher em vez de aceitar o primeiro caminho.

5 perguntas

Processo, dados únicos, documentação, formato ideal e ciclo de vida. O roteiro para mapear qualquer entidade.

Reconstruir pensamento, não solução

Quando o sistema está desenhado, qualquer modelo refaz o código. Sem o desenho, você é refém do código existente.

Próxima aulaVocê já sabe diagnosticar repertório e desenhar antes de codar. A partir de M1, você monta o sistema AIOX em si: agentes, executores e a anatomia do que você vai conduzir.