# Prompt Padrão — Documentação Técnica DoncMobile

Use este prompt sempre que precisar gerar uma nova documentação técnica
seguindo o padrão visual e estrutural estabelecido.

---

## PROMPT COMPLETO (copie e cole)

```
Gere uma documentação técnica interna em HTML e DOCX seguindo exatamente
o padrão visual já estabelecido no projeto DoncMobile.

IDENTIDADE VISUAL:
- Azul escuro:  #173557 (fundo sidebar, cabeçalhos de tabela, hero)
- Azul claro:   #59c2ed (destaques, bordas, badges, links ativos)
- Amarelo:      #d3da47 (alertas de atenção, destaques secundários)
- Verde claro:  #d6e9d6 (uso pontual)
- Tipografia HTML: Space Mono (títulos/código) + DM Sans (corpo)
- Tipografia DOCX: Arial (corpo) + Courier New (blocos de código)

ESTRUTURA DO HTML:
- Sidebar fixa à esquerda (260px) com navegação por âncoras
- Hero escuro no topo com badge animado, título, subtítulo e metadados
- Conteúdo principal com max-width 900px e padding 56px 64px
- Seções numeradas (01, 02, 03...) com divider entre elas
- Scroll spy: nav item ativo acompanha a seção visível
- Header e footer no DOCX com nome do documento, versão e número de página

COMPONENTES DISPONÍVEIS (use conforme o conteúdo pedir):
1. Tabela de camadas com borda colorida lateral por responsabilidade
2. Steps numerados com linha vertical conectando os passos
3. Blocos de código com fundo #173557 e texto claro (Courier New)
4. Alertas coloridos: azul (info), amarelo (atenção), vermelho (proibido)
5. Tabela dois colunas: PROIBIDO (vermelho) vs CORRETO (verde)
6. Tabelas com cabeçalho em azul escuro e linhas zebradas
7. Checklist com checkbox visual antes de cada item
8. Árvore de pastas estilizada em fundo escuro com comentários em amarelo
9. Grid de exemplos lado a lado: errado vs correto

REGRAS DE CONTEÚDO:
- Todo texto em português
- Linguagem direta e técnica — sem enrolação
- Cada seção começa com uma frase de contexto curta
- Blocos de código devem ser reais e copiáveis, não pseudocódigo genérico
- Alertas devem explicar o PORQUÊ da regra, não apenas repetir a regra

DOCUMENTO A GERAR:
[DESCREVA AQUI O TEMA DA DOCUMENTAÇÃO]

Exemplos de temas:
- "Guia de como criar e consumir eventos de domínio no projeto"
- "Padrão de autenticação JWT — como implementar e validar"
- "Convenções de migração de banco de dados com EF Core"
- "Como integrar com APIs externas usando IHttpClientFactory"
- "Guia de testes unitários — o que testar e como mockar"

SEÇÕES SUGERIDAS (adapte ao tema):
1. Visão geral do conceito
2. Estrutura de arquivos envolvidos
3. Passo a passo para implementar
4. Regras: o que fazer e não fazer
5. Exemplos de código completos
6. Checklist de entrega

ENTREGÁVEIS:
- guia-[nome-do-tema].html (com sidebar, hero e navegação funcional)
- guia-[nome-do-tema].docx (com header/footer, cores da empresa, tabelas formatadas)
```

---

## COMO USAR

1. Copie o prompt acima
2. Substitua `[DESCREVA AQUI O TEMA DA DOCUMENTAÇÃO]` pelo tema desejado
3. Ajuste as seções sugeridas se o tema pedir uma estrutura diferente
4. Envie para o Claude

## EXEMPLOS DE TEMAS JÁ PRONTOS PARA USAR

```
Gere uma documentação técnica... sobre como criar e consumir
eventos de domínio no projeto DoncMobile.API
```

```
Gere uma documentação técnica... sobre o padrão de
autenticação JWT — como gerar, validar e renovar tokens
```

```
Gere uma documentação técnica... sobre convenções de
migração de banco com Dapper — scripts versionados,
nomenclatura e processo de deploy
```

```
Gere uma documentação técnica... sobre como integrar
com APIs externas — IHttpClientFactory, clientes nomeados,
retry policy e tratamento de falhas
```

```
Gere uma documentação técnica... sobre o padrão de
testes unitários — o que testar em cada camada,
como mockar repositórios e serviços
```

## DICAS PARA RESULTADOS MELHORES

- Quanto mais contexto sobre o tema, mais preciso o conteúdo
- Se quiser incluir código real do projeto, cole trechos relevantes junto com o prompt
- Se uma seção não se aplicar ao tema, diga explicitamente para omiti-la
- Para temas muito grandes, peça para dividir em dois documentos separados