86bee38474
- Renomeia _prod_snapshot → _producao_atual (refletindo melhor o papel: snapshot do que está rodando hoje em prod, só leitura) - Renomeia _staging_current → _modelos (modelos aperfeiçoados que vão virar nova prod) - Todos os arquivos em _modelos/ agora usam o prefixo jasmine_<slug>__ (ex: jasmine_primeal.md), seguindo a mesma convenção já usada em _producao_atual/ - Atualiza README com a nova convenção e checklist de validação por unidade Isso prepara a estrutura pra adicionar modelos das outras 3 unidades (Qnn01, PrimeVL, Express). Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
91 lines
3.5 KiB
Markdown
91 lines
3.5 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)` |
|
|
|
|
| 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
|