iachat/db/seed_prompts/README.md
Rodribm10 86bee38474 chore(prompts): reorganiza pastas (_prod_snapshot→_producao_atual, _staging_current→_modelos) e prefixa arquivos por unidade
- 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>
2026-04-23 09:17:33 -03:00

3.5 KiB

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:

  • PrimeAL (testado em staging 2026-04-23)
  • Qnn01
  • PrimeVL
  • Express