---
name: saas-build-planner
description: Skill S16 do Ecossistema SaaS Imperatriz. Lê TODOS os arquivos .saas/ gerados pelas skills anteriores e gera um plano de construção em múltiplos terminais paralelos — contratos prontos para colar em cada terminal, sem precisar ativar /multi-terminal manualmente. Use ao final da cadeia SaaS para ir do briefing estratégico ao código.
---

# /saas-build-planner

> Skill S16 do Ecossistema SaaS Imperatriz — Plano Multi-Terminal de Construção

Esta skill é a orquestradora final da cadeia SaaS. Ela lê TODOS os arquivos `.saas/` gerados pelas skills anteriores (S0→S15 + S2B) e gera um plano de construção em múltiplos terminais paralelos — com contratos prontos para colar em cada terminal, sem precisar ativar o `/multi-terminal` manualmente.

**Posição na cadeia:** S16 — última skill do ecossistema (após /saas-compliance-br)

**Pré-requisito:** Ter rodado pelo menos S0 (/saas-context-doc) e S2 (/ai-feature-map). Quanto mais skills anteriores rodadas, mais preciso o plano.

---

## FASE 0 — Leitura Total do Contexto (OBRIGATÓRIO)

> **ANTES DE QUALQUER OUTRA AÇÃO:** leia TODOS os arquivos `.saas/` disponíveis.

Leia na seguinte ordem (cada um é opcional — use o que existir):

1. `.saas/SAAS-CONTEXT.md` → NOME, SETOR, MODELO, CANAL, TICKET, REGULAÇÃO
2. `.saas/SAAS-S1-PROBLEMA.md` → JOB-STATEMENT, PERSONA-DECISOR, PERSONA-USUARIO-FINAL
3. `.saas/SAAS-S1B-VALIDACAO.md` → RESULTADO-VALIDACAO (Verde/Amarelo/Vermelho)
4. `.saas/SAAS-S2-FEATURES.md` → FEATURE-PRINCIPAL, TABELA-FEATURES completa, TOP-3-RICE, MOMENTO-AHA-CANDIDATO
5. `.saas/SAAS-S2B-ARQUITETURA.md` → STACK completa, DIAGRAMA-ASCII, DECISOES-FUNDADORAS, SEGURANCA-TIER
6. `.saas/SAAS-S3-GATILHOS.md` → TABELA-GATILHOS, VOCABULARIO-DOMINIO, PRIVACIDADE-POR-GATILHO
7. `.saas/SAAS-S4-COMPETITIVO.md` → DIFERENCIAL-UNICO, FRASE-OCEANO-AZUL
8. `.saas/SAAS-S5-NARRATIVA.md` → HEADLINE-LP-CANDIDATA, ATO-4 (Descoberta)
9. `.saas/SAAS-S7-LP.md` → CTA-PRINCIPAL, estrutura das 12 seções
10. `.saas/SAAS-S11-CHECKOUT.md` → PLATAFORMA-PAGAMENTO, PLANOS
11. `.saas/SAAS-S13-ONBOARDING.md` → MOMENTO-AHA, EVENTO-TRACKING
12. `.saas/SAAS-S14-METRICAS.md` → NORTH-STAR-M0
13. `.saas/SAAS-S15-COMPLIANCE.md` → TEXTO-CHECKOUT, regulações setoriais

Se SAAS-CONTEXT.md não existir: pare e instrua a rodar `/saas-context-doc` primeiro.
Se SAAS-S2-FEATURES.md não existir: pare e instrua a rodar `/ai-feature-map` primeiro.

**Após a leitura:** liste os arquivos encontrados e ausentes antes de continuar.

**Campos que esta skill NÃO precisa perguntar (se os arquivos existem):**
- Nome do produto → SAAS-CONTEXT.md campo NOME
- Stack tecnológica → SAAS-S2B-ARQUITETURA.md campos STACK-*
- Features a construir → SAAS-S2-FEATURES.md TABELA-FEATURES
- Plataforma de pagamento → SAAS-S11-CHECKOUT.md PLATAFORMA-PAGAMENTO
- Momento Aha → SAAS-S13-ONBOARDING.md MOMENTO-AHA
- North Star → SAAS-S14-METRICAS.md NORTH-STAR-M0

---

## SOBRE ESTA SKILL

A `/saas-build-planner` aplica a metodologia de **múltiplos terminais paralelos** ao contexto específico do SaaS sendo construído. Cada terminal recebe um contrato completo e autocontido — o desenvolvedor (ou mentorado) não precisa saber o que os outros terminais estão fazendo.

**Princípios do plano gerado:**
- Terminal 0 = alicerce (sequencial, bloqueante) — schema, tipos, config
- Terminais 1-N = paralelos — módulos independentes rodando ao mesmo tempo
- Terminal Final = convergência — integração, testes, deploy
- Cada contrato tem: stack exata, arquivos a criar, arquivos proibidos, checklist de entrega, ponto de integração
- Zero placeholders nos contratos — tudo preenchido com dados reais do `.saas/`
- Os 6 padrões da `/arquitetura-imperatriz` já estão embutidos via SAAS-S2B-ARQUITETURA.md — não precisa chamá-la separadamente

---

## MODOS DE USO

### MODO 1 — `/saas-build-planner` (padrão — MVP)
Gera o plano de construção do **MVP** (versão mínima viável com a feature principal e a IA no centro).

Foco: T0 alicerce → T1 core feature com IA → T2 auth + billing → T3 LP + onboarding → T_final integração.

### MODO 2 — `/saas-build-planner --completo`
Gera o plano de construção da **versão completa** (todas as features do SAAS-S2-FEATURES.md).

Inclui módulos adicionais para features secundárias, analytics, quiz, calculadora ROI, etc.

### MODO 3 — `/saas-build-planner --lp`
Gera apenas o plano de construção da **Landing Page** (separado do produto principal).

Foco: HTML/CSS estático ou Next.js, integrado ao checkout já definido no S11.

### MODO 4 — `/saas-build-planner --revisao`
Lê um plano anterior salvo em `.saas/SAAS-S16-PLANO.md` e gera versão atualizada com base em mudanças nos outros arquivos `.saas/`.

---

## WORKFLOW PADRÃO (Modo 1 — MVP)

### Fase 1 — Mapeamento de Módulos

Com base nos arquivos `.saas/` lidos, liste os módulos do MVP:

```
MÓDULO: [nome baseado no SAAS-S2-FEATURES.md]
Produz: [arquivos/lógica específicos deste SaaS]
Depende de: [nada | módulo X]
Conflito potencial: [nada | arquivo compartilhado Z]
```

Regras rígidas (herdadas da metodologia multi-terminal):
- Schema de banco → sempre Nível 0
- Tipos/interfaces compartilhados → sempre Nível 0
- Config global e variáveis de ambiente → sempre Nível 0
- Dois módulos que escrevem no mesmo arquivo → nunca paralelos
- Módulo que importa output de outro → sempre depois dele

### Fase 2 — Grafo de Dependências

Monte o DAG baseado nos módulos identificados:

- **Nível 0 (alicerce):** Schema do banco (tabelas definidas pelo JOB-STATEMENT + PLANOS do S11), tipos TypeScript/interfaces, variáveis de ambiente (credenciais das integrações do S2B), configuração do modelo IA (STACK-IA do S2B)
- **Nível 1 (paralelos):** Feature principal com IA + Auth/Multi-tenant + Frontend base
- **Nível 2 (paralelos):** Módulos secundários + integrações de terceiros + LP
- **Nível Final:** Integração, testes E2E, configuração de produção

### Fase 3 — Plano de Execução

```
SEQUÊNCIA DE EXECUÇÃO — [NOME DO SAAS do SAAS-CONTEXT.md]
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
RODADA 1 — Sequencial (bloqueante)
  Terminal 0: Alicerce — Schema + Tipos + Config

RODADA 2 — Paralela (rodam ao mesmo tempo)
  Terminal 1: [Feature Principal com IA — nome real do SAAS-S2-FEATURES.md]
  Terminal 2: Auth + Multi-tenant + Billing ([PLATAFORMA-PAGAMENTO do S11])
  Terminal 3: Frontend Base + Roteamento

RODADA 3 — Paralela (após Rodada 2)
  Terminal 4: [Features Secundárias top RICE do S2]
  Terminal 5: LP + Onboarding Flow ([CTA-PRINCIPAL do S7])

RODADA 4 — Convergência
  Terminal Principal: Integração + Testes + Deploy
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
```

### Fase 4 — Contratos dos Terminais (entrega principal)

Para CADA terminal, gere o contrato COMPLETO e preenchido com dados reais do `.saas/`:

```
╔══════════════════════════════════════════════════════════╗
║ TERMINAL [N] — [NOME EM MAIÚSCULO baseado no .saas/]   ║
╚══════════════════════════════════════════════════════════╝

PROJETO: [NOME do SAAS-CONTEXT.md]
[JOB-STATEMENT do SAAS-S1-PROBLEMA.md em 1 linha]

STACK:
[Tecnologias do SAAS-S2B-ARQUITETURA.md para este terminal específico]

O QUE JÁ EXISTE (entregue pelo Terminal anterior):
• [arquivo real do Terminal 0 ou rodada anterior]
• [tipo/interface real]

══════════════════════════
SEU ÚNICO JOB:
[Descrição específica usando dados reais do .saas/ — nome real do produto, feature real, modelo IA real]
Nada além disso.
══════════════════════════

ARQUIVOS QUE VOCÊ CRIA/EDITA:
• [caminho/arquivo.ext] — [propósito específico do SaaS]

⛔ JAMAIS TOQUE:
• [arquivo de outro terminal]

CONTEXTO DE NEGÓCIO:
- Diferencial: [DIFERENCIAL-UNICO do SAAS-S4-COMPETITIVO.md]
- North Star: [NORTH-STAR-M0 do SAAS-S14-METRICAS.md]
- Momento Aha: [MOMENTO-AHA do SAAS-S13-ONBOARDING.md]
- Segurança: [SEGURANCA-TIER do SAAS-S2B-ARQUITETURA.md]
- Regulação: [REGULAÇÃO do SAAS-CONTEXT.md]
- Vocabulário IA: [VOCABULARIO-DOMINIO do SAAS-S3-GATILHOS.md]

CHECKLIST DE ENTREGA:
□ [Item verificável e específico usando nomes reais]
□ [Item verificável]

PONTO DE INTEGRAÇÃO:
[Como este output conecta aos outros — funções/endpoints/exports reais]

━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
QUANDO TERMINAR, responda exatamente:
"TERMINAL [N] COMPLETO ✓
Entregues: [lista real]
Pendências: [nenhuma | descrição]"
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
```

### Fase 5 — Contrato de Convergência

```
╔══════════════════════════════════════════════════════════╗
║ TERMINAL PRINCIPAL — CONVERGÊNCIA E INTEGRAÇÃO          ║
╚══════════════════════════════════════════════════════════╝

Todos os terminais paralelos foram concluídos. Agora integre.

CHECKLIST DE RECEBIMENTO:
□ Terminal 0 entregou: [lista específica do SaaS]
□ Terminal 1 entregou: [lista específica]
[...]

TAREFAS DE INTEGRAÇÃO (nesta ordem):
1. [Ação real de conexão entre módulos]
2. [npm run build / tsc — corrigir erros de tipo]
3. [Teste do evento de tracking: [EVENTO-TRACKING do S13]]
4. [Teste do Momento Aha: [MOMENTO-AHA do S13]]
5. [Configurar variáveis de ambiente de produção]
6. [Deploy: [STACK-INFRA do S2B]]
7. [Configurar nginx + SSL + domínio]
8. [Smoke test: criar conta → [MOMENTO-AHA] → verificar [NORTH-STAR-M0]]

RESULTADO FINAL:
[NOME do SaaS] no ar em [domínio], com [FEATURE-PRINCIPAL] funcionando,
tracking do Momento Aha ativo ([EVENTO-TRACKING]),
pronto para os primeiros [X] clientes do plano de lançamento ([PRECO-LANCAMENTO do S11]).
```

---

## SALVAR OUTPUT (fazer ao finalizar esta skill)

Ao concluir o plano, salve como `.saas/SAAS-S16-PLANO.md`:

```markdown
# SAAS-S16-PLANO.md
> Gerado: [data] | via /saas-build-planner | Modo: [MVP/completo/lp]

PRODUTO: [NOME do SAAS-CONTEXT.md]
MODO: [MVP/completo/lp]
ARQUIVOS-SAAS-LIDOS: [lista dos arquivos .saas/ que existiam]
ARQUIVOS-SAAS-AUSENTES: [lista dos que não existiam]

RODADAS: [número de rodadas]
TERMINAIS: [número total de terminais]
TEMPO-ESTIMADO: [estimativa em horas por terminal × número de rodadas]

DECISOES-ARQUITETURAIS-INCORPORADAS:
[das DECISOES-FUNDADORAS do SAAS-S2B-ARQUITETURA.md]

[Contratos completos de todos os terminais — copiados do output acima]
```

Após salvar: confirme "`.saas/SAAS-S16-PLANO.md` salvo ✓"

---

## OUTPUT PARA PRÓXIMA SKILL

**Esta é a skill final da cadeia principal.**

**Após o plano:** cole cada contrato no terminal correspondente e execute na sequência definida.

**Quando o SaaS estiver construído, skills de expansão disponíveis:**
- `/saas-success-metrics` — revisar métricas após primeiros 10 clientes
- `/saas-checkout-blueprint` — otimizar planos após validação de preço
- `/saas-onboarding-flow` — refinar D0-D30 com dados reais de uso
- `/saas-competitive-matrix` — atualizar posicionamento após 3 meses

**Nota:** O plano gerado integra automaticamente os 6 padrões da `/arquitetura-imperatriz` via SAAS-S2B-ARQUITETURA.md — sem precisar chamá-la separadamente durante o build.
