# 1. Dicas de prompts

Use esta página para escrever prompts que viram **especificações boas**.\
Depois, use o Chat AI para iterar em mudanças pequenas.

{% hint style="info" %}
Quer prompts completos por domínio (CRM, ERP, Helpdesk, OKRs)? Use também [Templates de Prompt](https://docs.madrix.dev/br/tutoriais-praticos/4.-templates-de-prompt).
{% endhint %}

### Princípios (o que mais muda o resultado)

1. **Escreva requisitos testáveis.** Troque “bem feito” por critérios objetivos.
2. **Use listas e enums.** Elas reduzem interpretação e “criatividade”.
3. **Diga o que não pode.** Ex: “não permitir voltar status”.
4. **Comece pequeno.** Gere o “mínimo que funciona”. Depois evolua.
5. **Itere por bloco.** Campo + validação + ajuste de UI. Uma mudança por vez.

### Formato recomendado (prompt base)

Copie e ajuste. Ele funciona bem para geração inicial.

```
Crie um projeto chamado: {{NOME_DO_PROJETO}}

Objetivo: {{DESCREVA_EM_1_2_LINHAS}}
Idioma da UI: pt-BR.

Perfis (RBAC):
- Admin: acesso total
- Operador: cria/edita
- Leitor: somente leitura

Módulos:
- {{MODULO_1}}
    Entidades:
    - {{ENTIDADE_1}}:
      - {{campo}} (obrigatório)
      - {{campo}} (único, opcional)
      - {{campo}} (enum: A | B | C)
      - {{relacionamento}} (relacionamento: 1 {{OutraEntidade}})
    
    Regras de negócio:
    - {{regra_1}} (se/então)
    - {{regra_2}} (transições permitidas)
    
     Relatórios:
    - {{relatorio_1}}
    - {{relatorio_1}}

- {{MODULO_2}}
    Entidades:
    - {{ENTIDADE_1}}:
      - {{campo}} (obrigatório)
      - {{campo}} (único, opcional)
      - {{campo}} (enum: A | B | C)
      - {{relacionamento}} (relacionamento: 1 {{OutraEntidade}})
    
    Regras de negócio:
    - {{regra_1}} (se/então)
    - {{regra_2}} (transições permitidas)
    
    Relatórios:
    - {{relatorio_1}}
    - {{relatorio_1}}


```

### Como reduzir ambiguidade (com exemplos)

#### Troque adjetivos por regras

* Em vez de: “tela bonita e moderna”
* Escreva: “tema com cor primária #0EA5E9 e secundária #111827”

#### Declare as regras “por papel”

* “Operador cria e edita apenas registros que criou.”
* “Leitor não pode criar/editar/excluir.”
* “Admin pode reprocessar integrações com erro.”

#### Especifique transições de status

* Defina o enum.
* Defina as transições permitidas.
* Diga quem pode transicionar.
* Diga o que acontece na transição (log, notificações, etc).

### Checklist antes de enviar o prompt

* [ ] Objetivo e escopo em 1–2 linhas.
* [ ] Módulos listados.
* [ ] Entidades com campos e tipos claros (enum, data/hora, moeda).
* [ ] Relacionamentos com cardinalidade (1, 0..1, N).
* [ ] Regras de negócio em bullets “se/então”.
* [ ] RBAC explícito (quem vê o quê, quem edita o quê).

{% hint style="warning" %}
Evite pedir “tudo” num único prompt. Se o escopo crescer, quebre em 3–5 mudanças.
{% endhint %}