Guia de Uso — PromptCoach

Siga as trilhas abaixo de acordo com seu nível. Cada etapa foi pensada para construir competência de forma progressiva em engenharia de prompts.

Iniciante

Você está começando agora. O objetivo é entender a plataforma e criar seus primeiros prompts com qualidade.

1Faça login na plataforma

Acesse /login e entre com suas credenciais. O token JWT será salvo automaticamente no navegador para autenticar suas ações.

2Explore a Sala de Aula

Vá em Sala de Aula e veja os módulos da sua trilha. Cada módulo tem aula, exemplos, exercícios, Coach de Prompts e uma entrevista final. Comece sempre do Módulo 01.

3Leia a aula e estude os exemplos

Dentro de cada módulo você encontra a aula teórica e pares de prompts (fraco x forte) com explicação do que mudou e por quê.

4Resolva os exercícios guiados

Cada módulo tem exercícios práticos. Escreva sua resposta e depois clique em Referência para comparar com a solução esperada.

5Pratique com o Coach de Prompts

Em cada módulo da Sala de Aula você encontra o Coach de Prompts. Cole ou escreva um prompt e receba feedback instantâneo da IA — ideal para consolidar o aprendizado antes da entrevista.

6Complete a entrevista do módulo

A entrevista é uma sequência de perguntas avaliadas automaticamente. Responda com calma — o sistema registra seu score e histórico.

7Use a Área de Trabalho pela primeira vez

Vá em Área de Trabalho, cole um prompt que você criou e clique em Analisar Estrutura. Observe quais dos 14 elementos estruturais estão presentes.

Intermediário

Você já conhece o básico. Agora o foco é desenvolver consistência técnica e aprender a usar a Área de Trabalho de forma estratégica.

1Avance pelos módulos em sequência

Complete o Módulo 01 antes de seguir para os próximos. Na Sala de Aula, os módulos se desbloqueiam pelo score — você precisa atingir a pontuação mínima da rubrica.

2Aprenda prompts condicionais

No Módulo 05, primeiro da faixa Intermediária, aprenda a adicionar lógica de decisão (se/então/caso contrário) ao prompt para que o modelo adapte a resposta a diferentes condições.

3Analise estrutura na Área de Trabalho

Use Analisar Estrutura para mapear os 14 elementos do seu prompt. Identifique o que está ausente e reescreva adicionando os elementos faltantes.

4Identifique a técnica dos seus prompts

Use Identificar Técnica na Área de Trabalho para classificar se você está aplicando Zero-shot, Few-shot, Chain of Thought ou outra abordagem — consciente ou não.

5Gere versões otimizadas e compare

Clique em Iniciar Otimização para que o sistema gere uma versão aprimorada do seu prompt. Compare lado a lado com o original e entenda cada melhoria.

6Explore a Biblioteca de Prompts

Em Biblioteca você encontra prompts prontos organizados por domínio, nível e técnica. Abra qualquer um na Área de Trabalho para estudar como ele cobre os 14 elementos e adapte ao seu caso.

7Acompanhe seu histórico de prompts

A Área de Trabalho salva suas últimas versões. Revise o histórico periodicamente para medir sua evolução e identificar padrões de melhoria.

Avançado

Você domina a base. Agora é hora de trabalhar com técnicas complexas, integrar a API e contribuir com o conteúdo da plataforma.

1Domine saída estruturada

No Módulo 04, aprenda a controlar o formato de resposta usando JSON, listas, tabelas e delimitadores. Essencial para automações com LLMs.

2Cubra os 14 elementos estruturais

Use a Área de Trabalho para criar prompts que preencham todos os elementos: persona, contexto, tarefa, formato, exemplos, restrições, tom e mais.

3Combine técnicas avançadas

Construa prompts com Few-shot + Chain of Thought + saída estruturada ao mesmo tempo. Teste e refine até obter o comportamento esperado do modelo.

4Explore a API diretamente

Acesse /docs para ver a documentação interativa da API REST. Você pode criar entrevistas, consultar módulos e enviar respostas programaticamente.

5Configure um LLM real

Edite backend/.env e adicione a chave do provider escolhido (ANTHROPIC_API_KEY, OPENAI_API_KEY, GEMINI_API_KEY ou OPENROUTER_API_KEY). Mude DEFAULT_LLM_PROVIDER para anthropic, openai, gemini ou openrouter e reinicie o backend.

6Crie novos módulos de conteúdo

Adicione pastas em content/modules/ seguindo a estrutura YAML/JSON existente. Defina lesson.md, examples.json, rubric.json e interview_seed.json.

7Contribua com o repositório

Crie uma branch, implemente sua melhoria e abra um Pull Request no GitHub. Siga os padrões do projeto e descreva bem as mudanças.

Dica rápida

Não pule etapas. A progressão por módulos é intencional — cada conceito depende do anterior. Se travar em algum exercício, volte aos exemplos do módulo e compare com o seu prompt antes de tentar novamente.

Referência

Exemplo de Prompt Completo — 14 Elementos

O prompt abaixo cobre todos os 14 elementos estruturais reconhecidos pela Área de Trabalho. Use-o como referência ao construir seus próprios prompts ou cole-o diretamente na Área de Trabalho para ver a análise estrutural ao vivo. Cole na Área de Trabalho para ver o indicador atingir 14 / 14 — Completo.

Prompt — Cold Outreach SaaS B2B (14 elementos)

# Contexto
Nossa empresa lança um novo produto SaaS de gestão financeira para PMEs.
Estamos na fase de pré-lançamento e precisamos de material de divulgação.

# Persona
Você é um copywriter especialista em SaaS B2B com 10 anos de experiência
em campanhas para o mercado brasileiro.

# Tarefa
Escreva um e-mail de cold outreach para potenciais clientes corporativos,
apresentando o produto e gerando interesse em uma demo gratuita.

# Audiência
Diretores financeiros (CFOs) de empresas com 50-200 funcionários no Brasil,
familiarizados com ferramentas digitais mas céticos quanto a novos sistemas.

# Tom
Profissional, direto e consultivo. Sem jargões de marketing. Não use
exclamações ou linguagem excessivamente entusiasta.

# Restrições
- Máximo 200 palavras no corpo do e-mail
- Não mencionar concorrentes pelo nome
- Não fazer promessas de ROI específico sem dados

# Formato de Saída
Retorne apenas o e-mail completo em markdown, com: Assunto, Saudação,
Corpo (3 parágrafos), CTA e Assinatura. Nenhum comentário adicional.

# Exemplos
Assunto ruim: "Revolucione suas finanças agora!!!"
Assunto bom: "Como empresas como a [Nome] reduziram o fechamento contábil em 3 dias"

# Dados de Entrada
Nome do produto: FinanceOS
Benefício principal: fechamento contábil 60% mais rápido
Diferencial: integração nativa com sistemas ERP já usados no Brasil (TOTVS, SAP)

# Passos
1. Abra com uma dor específica do CFO moderno
2. Conecte a dor ao benefício principal do produto
3. Prove credibilidade com dado concreto ou social proof
4. Finalize com um CTA de baixo comprometimento (demo de 20 min)

# Critérios
- A dor do parágrafo 1 deve ser reconhecível por um CFO real
- O CTA deve reduzir fricção, não aumentar
- Tom deve ser percebido como par, não como vendedor

# Verificação
Antes de retornar, releia o e-mail como se fosse o CFO receptor e verifique:
ele responderia ou deletaria? Se deletaria, reescreva.

# Fallback
Se não conseguir atingir os critérios dentro de 200 palavras, priorize
clareza sobre completude e sinalize quais seções foram encurtadas.

# Meta de Sucesso
Um CFO que recebe esse e-mail deve querer encaminhar para seu assistente
agendar a demo — sem precisar de follow-up manual.

Por Técnica

Exemplos por Técnica de Prompt

Cada técnica tem um momento certo de uso. Escolha uma abaixo para ver um exemplo focado nela, e abra na Área de Trabalho para experimentar.

Escolha a técnica:

Peça a tarefa direto, sem exemplos. Funciona quando o modelo já conhece bem o domínio e a tarefa é clara o bastante.

Prompt — Resumo de Reunião (Zero-Shot)

# Tarefa
Resuma a transcrição de reunião abaixo em até 5 bullet points, destacando
decisões tomadas, responsáveis e prazos. Não inclua introdução nem
conclusão — apenas os bullets.

# Dados de Entrada
[COLE_AQUI_A_TRANSCRICAO]

# Formato de Saída
- Decisão / responsável / prazo (um bullet por item)