❓ O que e um Prompt?

Imagine que você acabou de contratar um estagiario muito inteligente, porem ele não conhece o seu projeto, não sabe o que você precisa exatamente e so faz o que você escreve no papel. Quanto mais claro, detalhado e organizado for o seu bilhete para ele, melhor será o resultado. O prompt e exatamente esse bilhete.

Tipos de Prompt no Dia a Dia

• Pergunta simples: "Qual a capital do Brasil?" — a IA responde com informação.
• Instrução: "Resuma este texto em 3 bullet points" — a IA executa uma tarefa específica.
• Contexto + Tarefa: "Analise este código e sugira melhorias de performance" — a IA usa o que você forneceu para gerar análise.
• Prompt estruturado: Mensagens longas com contexto, regras, exemplos e formato esperado de saida — e aqui que entra a nossa ferramenta.

Prompt vs "Pergunta Normal" — Qual a Diferença?

A diferença fundamental esta na estrutura e profundidade. Uma pergunta normal pede algo de forma vaga. Um prompt estruturado fornece contexto, define restrições, especifica o formato de saida e estabelece regras claras. A nossa ferramenta gera prompts do tipo estruturado, que sao significativamente mais poderosos.

"Revise meu codigo de login
e melhore ele"

"Analise detalhadamente o repositorio
/home/z/my-project/app com foco em
src/middleware/auth.ts

INSTRUCAO DE DOMINIO:
1. Verificacao e Validacao
2. Principios SOLID
3. Atributos de Qualidade...

FORMATO DE RESPOSTA:
1. Resumo executivo
2. Diffs completos
3. Testes atualizados..."

💡 Por que a Qualidade do Prompt Importa?

Uma IA generativa e como um motor muito potente: ela pode fazer coisas incríveis, mas precisa de uma direção precisa. Se você der uma instrução vaga, recebe uma resposta genérica. Se você der uma instrução rica em contexto e detalhes, recebe uma resposta que parece feita por um especialista.

Os 5 Pilares de um Prompt Eficaz

🧹 Anatomia de um Bom Prompt

Um prompt gerado pela ferramenta Prompt Engineering Pro segue uma estrutura precisa. Veja cada parte e entenda o que ela faz:

1. CABECALHO — O que analisar e onde
   "Analise detalhadamente o repositorio [CAMINHO], com foco em [ARQUIVO]."

2. CONTEXTO — Por que esta fazendo isso
   "CONTEXTO: [Sua motivacao, o problema, o cenario]."

3. INSTRUCAO DE DOMINIO — O que verificar (frameworks e principios)
   "INSTRUCAO DE DOMINIO:
   Verifique os seguintes aspectos aplicando frameworks reconhecidos:
   1. Verificacao e Validacao (shift-left testing)
   2. Principios SOLID (SRP, OCP, LSP, ISP, DIP)
   3. Atributos de Qualidade (-ilities)
   ..."

4. REGRAS OBRIGATORIAS — O que a IA NAO pode fazer
   "REGRAS OBRIGATORIAS:
   - Mantenha a interface publica sem breaking changes
   - Siga EXATAMENTE os padroes existentes
   - O codigo deve ser indistinguivel do estilo da codebase"

5. FORMATO DE RESPOSTA — Como a IA deve organizar a saida
   "FORMATO DE RESPOSTA:
   1. Resumo executivo
   2. Justificativa por mudanca
   3. Diff completo de CADA arquivo (git apply)
   4. Novos arquivos criados
   5. Testes atualizados/criados
   6. Riscos e mitigacoes"
      

Cada seção tem um propósito claro. O cabeçalho define o alvo. O contexto justifica a análise. A instrução de domínio carrega o "conhecimento especializado" dos ebooks. As regras impedem a IA de sair dos trilhos. E o formato garante que a resposta seja útil e aplicável.

📊 Antes vs Depois — O Efeito Prático

Veja a diferença concreta entre pedir de forma simples e usar a ferramenta para gerar um prompt estruturado:

"Olha esse codigo de login e melhora,
precisa estar mais seguro e seguindo
boas praticas"

"Analise detalhadamente o repositorio
/home/z/my-project/app com foco em
src/middleware/auth.ts

CONTEXTO: Preparando endpoints de
autenticacao para producao, preciso
garantir conformidade LGPD.

INSTRUCAO DE DOMINIO:
1. OWASP Top 10 (A01-A10)
2. Privacy by Design (7 principios)
3. LGPD (bases legais, dados sensiveis)
...

FORMATO: Diffs completos + Guia
de compliance + Plano de resposta
a incidentes"

🎯 Visão Geral da Ferramenta

A ferramenta Prompt Engineering Pro e uma página HTML que funciona direto no navegador. Não precisa de internet, servidor ou instalação. Você abre o arquivo prompt-engineering-pro.html no Chrome, Firefox ou Edge e pronto — ela esta pronta para usar.

A ferramenta tem duas grandes funcionalidades principais:

🏗 Estrutura e Navegação

A ferramenta e dividida em tres partes visuais principais:

1. Sidebar (Barra Lateral Esquerda)

E o menu de navegação. Esta organizada em tres seções com icones coloridos:

• Análise — Visão Geral e Mapa de Domínios. São telas informativas que mostram como o conhecimento foi mapeado.
• Ebooks Analisados — Os 20 ebooks mapeados (DevOps, Transformação Digital, UX, APIs, Arquitetura, Analytics, Privacidade, Qualidade, Algoritmos, Processos, Cloud Computing, Eng. Requisitos, Métodos Ágeis, Tech Squads, Lideranca, IA, Dados, Arq. Software II, Métricas, Gestão de Projetos). Clique em qualquer um para ver os insights detalhados.
• Gerador Avançado — Os 6 geradores práticos (Revisão, API, Arquitetura, Segurança, UX, Canivete Suico). Clique para abrir o formulário.

Em telas pequenas (celular), a sidebar se esconde e aparece um botao de hamburger (☰) no canto superior.

2. Barra Superior (Topbar)

Mostra o titulo da seção atual com um badge colorido indicando o tipo: Análise para telas informativas, Gerador para telas de formulário.

3. Área de Conteúdo (Centro)

E onde o conteúdo de cada seção aparece. Pode conter cards informativos, tabelas, grids de ebooks, formulários com campos de entrada e áreas de saida com os prompts gerados.

📊 Seção de Análise

A seção de análise e puramente informativa — ela não gera prompts, mas te ensina o que esta por trás de cada gerador. E como o "livro de instruções" que explica o conhecimento embutido na ferramenta.

Visão Geral

Quando você abre a ferramenta, a primeira tela e a Visão Geral. Ela contem:

• Objetivo da Análise: Explica que a ferramenta analisou 20 ebooks de pós-graduação para extrair conhecimento de domínio e incorpora-lo nos prompts.
• Domínios Identificados: Mostra os 10 domínios mapeados com chips coloridos: DevOps, Arquitetura, APIs, UX, Qualidade, Transformação Digital, Analytics, Privacidade, Padrões e Processos.
• Melhoria no Prompt: Lista 5 benefícios concretos de adicionar contexto de domínio: especificidade técnica, rigor metodológico, perspectiva multidimensional, crítica profissional e alinhamento regulatorio.
• Matriz de Impacto por Template: Uma tabela que cruza cada tipo de prompt com cada domínio, mostrando o nível de influência (baixa, media, alta). Isso te ajuda a entender quais ebooks sao mais relevantes para cada situação.

Mapa de Domínios

A segunda tela da análise mostra uma grade de cards com todos os 20 ebooks. Cada card mostra o nome do domínio, o autor, os topicos principais e um resumo do primeiro insight. Ao clicar em um card, ele fica marcado como selecionado (borda verde).

📖 Ebooks Analisados

Cada ebook foi mapeado para extrair insights que podem ser incorporados nos prompts. Quando você clica em um ebook na sidebar, veja:

• Card de cabeçalho: Titulo, autor e topicos principais (chips coloridos).
• Principios (blocos roxos): Cada insight e apresentado com um domínio e uma explicação detalhada de como ele melhora os prompts. Por exemplo, o ebook de Arquitetura traz o insight "Atributos de Qualidade (-ilities)" que ensina a pedir a IA para identificar escalabilidade, performance, segurança etc.
• Bloco de Recomendação: Um bloco preto no final que mostra as recomendações formatadas em texto pronto para copiar e colar. Você pode usar essas recomendações diretamente nos seus prompts, mesmo sem usar os geradores.

Abaixo, a tabela com os 20 ebooks e seus topicos principais:

📋 Matriz de Impacto

A Matriz de Impacto esta na tela Visão Geral e e uma das partes mais importantes da ferramenta. Ela cruza cada tipo de prompt (linha) com cada domínio de conhecimento (coluna) e mostra o nível de influência. Funciona como um guia de "qual ebook usar para qual situação".

⚙ O que sao os Geradores Avançados?

Os Geradores Avançados sao a parte prática da ferramenta. Eles sao formulários inteligentes que montam prompts completos e especializados para você. Em vez de escrever um prompt do zero, você preenche alguns campos e a ferramenta faz o resto.

Como funciona qualquer gerador (fluxo padrão)

🔄 Gerador: Revisão + Qualidade

Campos do Formulário

Quando usar: Sempre que precisar de uma revisão de código rigorosa que va além de "olho nu" — incluindo principios SOLID, atributos de qualidade, teste em múltiplos níveis e análise estatica. E o gerador mais usado para o dia a dia.

🌐 Gerador: Design de API

Campos Específicos

Quando usar: Ao criar novos endpoints, revisar design de API existente, ou preparar APIs para produção. Garante que a IA verifique métodos HTTP corretos, anti-patterns comuns, observabilidade e segurança.

🏗 Gerador: Refatoração Arquitetural

Checkboxes Específicos

• 4 Pilares da Arquitetura — Estrutura, atributos de qualidade, decisões arquiteturais e principios de design.
• Atributos de Qualidade (-ilities) — Escalabilidade, performance, segurança, disponibilidade, manutenibilidade, testabilidade.
• Leis do Trabalho Arquitetural — "Toda decisão tem seu preço" e "Avalie no contexto específico".
• Documentação C4 — Gera documentação nos níveis Contexto, Container, Componente e Código.
• Refatoração e Evolução — Redução de acoplamento, automação de testes, padrões emergentes.
• Cloud / DevOps — Arquiteturas distribuidas, containers, microsserviços.

Quando usar: Ao planejar grandes mudancas estruturais como migração de monolito para microsserviços, reorganização de módulos, ou qualquer refatoração que impacte a arquitetura do projeto como um todo.

🛡 Gerador: Segurança + LGPD

Campos Específicos

Quando usar: Sempre que o projeto lida com dados pessoais de usuários brasileiros. Especialmente útil antes de lançamentos em produção, auditorias, ou quando se trata de dados sensíveis/críticos. O prompt gerado inclui verificação OWASP completa e os principios legais da LGPD.

🎨 Gerador: UX + Usabilidade

Campos Específicos

Quando usar: Ao revisar componentes de interface, criar novas telas, melhorar a experiência do usuário, ou preparar o frontend para produção. Garante que a IA va além da estetica e avalie acessibilidade, usabilidade e jornada do usuário.

🤝 Gerador: Canivete Suico Pro

Campos Adicionais

Quando usar: Quando você precisa da análise mais completa possível — por exemplo, antes de um PR grande, para débito técnico acumulado, ou quando não tem certeza de qual gerador específico usar. O Canivete Suico Pro cobre todos os angulos.

☁ Gerador: Cloud / Infra

Campos Específicos

Quando usar: Ao revisar infraestrutura em nuvem, preparar para migração, auditar segurança cloud, ou garantir compliance regulatorio em ambientes hospedados.

🧠 Gerador: IA / Machine Learning

Campos Específicos

Quando usar: Ao revisar pipelines de ML, modelos de IA, dados de treinamento, ou quando o sistema trata dados pessoais com algoritmos de IA que precisam ser auditados.

📊 Gerador: Dados / Analytics

Campos Específicos

Quando usar: Ao revisar pipelines de dados ETL, data lakes, data warehouses, sistemas de analytics ou qualquer projeto que processe grandes volumes de dados.

📅 Gerador: Gestão / Métricas

Campos Específicos

Quando usar: Ao planejar projetos, fazer auditorias de gestão, definir OKRs, medir fluxo de entrega, ou quando precisar de previsibilidade e métricas orientadas a resultado (não apenas produtividade).

👉 Passo a Passo — Tutorial Rápido

Um exemplo prático completo de como usar a ferramenta do inicio ao fim:

⭐ Dicas Avançadas

1. O contexto e tudo

Não economize no campo "Contexto/Motivação". Quanto mais detalhes você der sobre o problema, o cenário, o que ja tentou, o que precisa — melhor será o resultado da IA. Um contexto de uma linha gera resposta genérica. Um contexto de tres linhas gera resposta especializada.

2. Nem sempre mais e melhor

Marcar todos os checkboxes pode gerar um prompt tao longo que a IA perde foco. Selecione apenas os domínios relevantes para o seu caso. Para uma revisão simples de código, marque V&V + SOLID + Testes. Deixe os outros para quando realmente precisar.

3. Use os insights dos ebooks manualmente

Na seção de Ebooks Analisados, cada ebook tem um bloco de "Recomendações" em texto puro. Você pode copiar essas recomendações e adicionar a qualquer prompt que escrever manualmente, mesmo fora da ferramenta.

4. Combine geradores

Nada impede você de gerar dois prompts diferentes e combinar partes de cada um. Gere um com o gerador de "Segurança" e outro com o de "Qualidade", depois junte os melhores trechos de cada.

5. Adapte o prompt gerado

O prompt gerado e um excelente ponto de partida, mas você pode (e deve) edita-lo antes de enviar. Adicione detalhes específicos do seu projeto, remova partes irrelevantes, ajuste o tom. A ferramenta faz 80% do trabalho — você faz os 20% finais de personalização.

6. Para IAs com limite de tokens

Se estiver usando uma IA com limite curto de contexto, prefira geradores mais específicos (em vez do Canivete Suico) e selecione menos checkboxes. O prompt gerado será mais curto e consumira menos tokens.

7. Teste e itere

Se o resultado não foi satisfatorio, ajuste o prompt: mude o contexto, adicione mais detalhes, selecione outros domínios. A engenharia de prompt e iterativa — cada tentativa te ensina o que funciona melhor.

8. Use os diffs na prática

Os prompts gerados pedem diffs no formato git apply. Quando a IA retornar diffs, salve em um arquivo .patch e aplique com o comando git apply --check fix.patch (para verificar) e depois git apply fix.patch (para aplicar).

9. Consulte a Matriz de Impacto

Antes de escolher um gerador, olhe a Matriz de Impacto na Visão Geral. Ela te diz quais domínios sao mais relevantes para cada tipo de tarefa, ajudando a escolher o gerador certo e os checkboxes certos.

10. Funciona offline

A ferramenta e 100% offline. Não precisa de internet, não envia dados, não tem servidor. Você pode usar em qualquer computador apenas abrindo o arquivo HTML. Isso e útil quando você trabalha com código confidencial e não quer que dados do repositório vazem.

📗 Glossario

Termos técnicos usados na ferramenta e neste manual, explicados de forma simples: