iachat/db/seed_prompts/README.md
Rodribm10 1b31e88934 chore(captain): ajustes de unit + migration + schema + seed README
Pequenos ajustes em Captain::Unit (app + enterprise), migration de seed
inicial dos prompts Jasmine/Daniela, schema regenerado, e atualização do
README de seed_prompts pra refletir o estado atual dos modelos.

Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
2026-05-01 11:21:38 -03:00

93 lines
3.7 KiB
Markdown

# Captain — prompts versionados
Todo prompt da Jasmine (orchestrator) e dos cenários (Daniela, Maria,
Disponibilidade, etc) vive em arquivos `.md` aqui. O DB é só espelho.
## Estrutura
```
db/seed_prompts/
├── README.md ← você está aqui
├── _producao_atual/ ← prompts rodando em produção HOJE (com defeitos)
│ │ extraído de iachat_production em 2026-04-22
│ ├── assistants/ (4 Jasmines: qnn01, primeal, primevl, express)
│ └── scenarios/ (12 cenários, 3 por assistente)
├── _modelos/ ← versões REVISADAS que vão virar a nova produção
│ │ (o que Rodrigo e Claude testaram no staging,
│ │ SEMPRE prefixado por unidade: jasmine_<slug>__)
│ ├── assistants/ (ex: jasmine_primeal.md — só PrimeAL validado até agora)
│ └── scenarios/ (ex: jasmine_primeal__daniela_reservas.md)
└── target/ ← APLICADO no DB pela migration de seed
├── assistants/
└── scenarios/
```
## Regra simples
- **`_producao_atual/`** = só referência do que tá em prod hoje. Não é aplicado.
- **`_modelos/`** = só referência dos modelos revisados. Não é aplicado.
- **`target/`** = source of truth. **A migration sincroniza isso no DB**.
Arquivos vazios em `target/` = a migration **não toca** aquele prompt.
Útil pra deployar mudanças seletivas (ex: subir só Daniela melhorada
sem mexer na Jasmine de cada unidade).
## Workflow de revisão (o que estamos fazendo agora)
Pra cada prompt:
1. Olhar `_producao_atual/X.md` (o que tá em prod hoje)
2. Olhar `_modelos/X.md` (se existir — versão revisada)
3. Decidir o conteúdo final: pode ser igual ao modelo, igual ao prod
ou novo. Salvar em `target/X.md`.
4. Quando todos os prompts revisados estiverem em `target/`, mergear
pra main e deployar — a migration aplica em prod.
## Convenção de nomes
Os nomes batem com `name`/`title` no banco:
| Slug do arquivo | Captain::Assistant#name |
|---|---|
| `jasmine_qnn01` | `Jasmine( Qnn01)` |
| `jasmine_primeal` | `Jasmine(PrimeAL)` |
| `jasmine_primevl` | `Jasmine(PrimeVL)` |
| `jasmine_express` | `Jasmine (Express)` |
| `jasmine_dolce_amore` | `Jasmine(DolceAmore)` |
| Slug do cenário | Captain::Scenario#title |
|---|---|
| `daniela_reservas` | `Daniela_Reservas` |
| `disponibilidade_suites` | `Disponibilidade de suites` |
| `maria_fotos` | `maria_fotos` |
| `outras_unidades` | `outras_unidades` |
| `reclamacoes_ouvidoria` | `Reclamacoes_Ouvidoria` |
## Convenção em `_modelos/` — SEMPRE prefixado por unidade
Cada arquivo em `_modelos/` representa UMA unidade específica, nunca genérico:
- `_modelos/assistants/jasmine_primeal.md` → Jasmine do PrimeAL
- `_modelos/assistants/jasmine_qnn01.md` → Jasmine do Qnn01 (quando criado)
- `_modelos/scenarios/jasmine_primeal__daniela_reservas.md` → Daniela do PrimeAL
- `_modelos/scenarios/jasmine_qnn01__daniela_reservas.md` → Daniela do Qnn01
A migration aplica qualquer arquivo sem prefixo em `target/scenarios/` como
genérico (todas as unidades); com prefixo `<assistant_slug>__` aplica só
naquela unidade, sobrescrevendo o genérico se os dois existirem.
## Estado atual da revisão
Em revisão. `target/` está vazio. Nada será aplicado em prod até
preenchermos os arquivos lá.
**Unidades com modelo validado:**
- [x] PrimeAL (testado em staging 2026-04-23)
- [ ] Qnn01
- [ ] PrimeVL
- [ ] Express
- [ ] Dolce Amore (criado 2026-04-27 — primeira unidade fora do 1001 Noites; marca distinta, motel-first em Natal/RN; não testado em staging ainda)