# Imperatriz Bot

> Fabrica que constroi bots conversacionais Typebot-style **100% automaticos** — sem editor visual.

## Status

🟢 **v0.2 — Fabrica completa** (2026-05-05)

Aplicados todos os 12 principios da `/copy-conversacional-dm`:

- ✅ Skill como FABRICA (nao gerador avulso)
- ✅ 4 regras INEGOCIAVEIS no topo (#1 a #4)
- ✅ 5 deteccoes automaticas (temperatura, Schwartz x2, ticket, canal)
- ✅ 12 perfis-nicho calibrados
- ✅ 12 frameworks de copy mapeados por estagio/temperatura/nicho
- ✅ 11 validadores anti-AI-slop em CADA output
- ✅ 5 modos pos-construcao (iteracao + auditar + proxima-msg + calibragem-30d + otimizacao-mensal + objecao-nova)
- ✅ Roteamento por intencao (carrega so o necessario)
- ✅ Pasta-pacote DOC-FIRST com 11 arquivos numerados
- ✅ Anti-patterns explicitos (20 itens)
- ✅ 6 exemplos completos
- ✅ Benchmarks por nicho

## Decisoes fundadoras

1. Nome `/imperatriz-bot` (Lara fica como skill irma — vira arquetipo)
2. UMA VPS por mentorada (mono-tenant, SQLite)
3. Mentorada livre — roda local OU deploy VPS
4. 3 arquetipos MVP — Vendedora · Diagnostico · Qualificador
5. Release janela: privado → publico OSS MIT → fork privado `-pro`

## Estrutura

```
imperatriz-bot/
├── SKILL.md                       # entrypoint
├── README.md
├── LICENSE (MIT)
├── archetypes/                    # 3 arquetipos
├── deteccao/                      # 5 deteccoes automaticas
├── perfis-nicho/                  # 12 perfis calibrados
├── frameworks/                    # 12 frameworks de copy
├── validadores/                   # 11 validadores anti-AI-slop
├── modos-pos-construcao/          # 5 modos pos-build
├── exemplos-completos/            # 6 bots completos
├── kpis/                          # benchmarks + medicao
├── templates/
│   ├── schema-blocks.ts           # Zod (gramatica rigida)
│   ├── runtime/                   # projeto Node base
│   ├── frontend/                  # React renderer
│   ├── deploy/                    # PM2 + Nginx
│   └── docs-pacote/               # 11 templates DOC-FIRST
└── validators/
    └── flow-validator.ts          # validador estrutural CLI
```

## Stack tecnica do bot gerado

- **Runtime:** Express 5 + TypeScript + better-sqlite3
- **Renderer:** React 19 + Vite 6 + Tailwind 4 + Framer Motion + Zustand
- **AI:** Gemini 2.5 Flash (com JSON mode)
- **Schema:** Zod (12 blocos em discriminated union)
- **Deploy:** PM2 + Nginx + Certbot

## Pipeline de qualidade

Toda copy passa por:
- `/briefing-copy-360` (contexto)
- `/headline-imperatriz` (ganchos)
- `/mecanismo-unico` (posicionamento)
- `/voz-humana-br` (TODOS os textos — obrigatorio)
- `/persona-profunda` (escolha de palavras)
- `/texto-em-visual` (visuais)
- 11 validadores anti-AI-slop

## Saida da skill

DUAS pastas por bot gerado:

### A) Projeto tecnico
`~/imperatriz-bot-{slug}/` — runtime + frontend + deploy

### B) Pasta-pacote DOC-FIRST
`~/Documents/Bot-{slug}/` com 11 arquivos:
- 00-leia-primeiro.md
- 01-fluxo-visual.md
- 02-banco-respostas-ai.md
- 03-banco-objecoes.md
- 04-redirecionamentos.md
- 05-textos-todos-blocos.md
- 06-kpis-tracking.md
- 07-auditoria-checklist.md
- 08-roadmap-30dias.md
- 09-voz-da-marca.md
- 10-deploy-passo-a-passo.md

## Tamanho do repo

~115 arquivos (v0.2 vs v0.1 com 47).

## Roadmap

```
v0.2 ✅ Fabrica completa (12 principios aplicados)
v0.3 ⏳ Beta com 3 mentoradas
v0.4 ⏳ Migrar 1 Lara existente como Vendedora
v1.0 ⏳ Release publico OSS MIT
v1.x ⏳ Multi-language, A/B test auto
v2.0 ⏳ Fork privado `-pro` (SaaS hospedado, features premium)
```

## Licenca

🔒 PRIVADO ate v1.0 (beta com mentoradas)
🌐 Apos: publico em `tatagoncalvesof/imperatriz-bot` MIT
🔒 Apos referencia: fork `imperatriz-bot-pro` privado (v1 OSS continua MIT)
