---
name: saas-context-doc
description: >
  Gera o arquivo SAAS-CONTEXT.md que serve como briefing-mãe para todas as
  14 skills da sequência SaaS IA Central. Resolve os 5 gaps sistêmicos
  identificados nos testes: multi-stakeholder, compliance setorial, VOC ausente,
  canal não definido, e nome placeholder. Rodar ANTES de qualquer outra skill
  do ecossistema SaaS. Use quando disser "criar contexto do SaaS",
  "briefing do produto", "configurar projeto SaaS", "antes de começar o SaaS",
  "preencher o contexto", "criar o SAAS-CONTEXT".
  Integra com: todas as 14 skills da sequência SaaS IA Central.
---

# SaaS Context Document

> "Contexto não é o rei — contexto é o oxigênio. Sem ele, a copy morre, a demo não converte e o produto é construído para o problema errado."

## Por que existe

Skills sem contexto cometem os mesmos 5 erros em todos os projetos:

1. **Copy em linguagem de produto** — escrevem "automatize seus processos" em vez de usar as palavras exatas do cliente ("fico até meia-noite acertando isso")
2. **Persona única** — tratam como se houvesse 1 usuário, quando B2B tem decisor, usuário final e influenciador com expectativas completamente diferentes
3. **Compliance invisível** — ignoram que em saúde, imóveis e jurídico, conformidade é pré-requisito de compra, não FAQ
4. **Canal agnóstico** — produzem narrativa e criativos sem saber se o cliente está no LinkedIn ou no Instagram (estrutura radicalmente diferente)
5. **Nome placeholder** — geram LP com "[Nome do SaaS]" e pitch com "meu produto", tornando o output inutilizável

Este arquivo resolve todos os 5 de uma vez.

---

## MODOS DE OPERAÇÃO

- **`/saas-context-doc`** — faz as 11 perguntas e gera o SAAS-CONTEXT.md completo
- **`/saas-context-doc completo`** — versão expandida com perguntas de aprofundamento por setor
- **`/saas-context-doc revisar`** — relê o SAAS-CONTEXT.md existente e pergunta o que mudou

---

## INSTRUÇÃO PARA SKILLS QUE LEEM ESTE ARQUIVO

Toda skill da sequência SaaS deve começar com:

```
Leia o SAAS-CONTEXT.md do projeto antes de executar esta skill.
Se o arquivo não existir, rode /saas-context-doc primeiro e só então continue.
```

---

## AS 11 PERGUNTAS FUNDADORAS

Execute as perguntas em sequência. Não avance sem resposta completa.

---

### PERGUNTA 1 — NOME DO SAAS

**O nome real do produto — não "meu produto", não "o SaaS", não "a ferramenta".**

Por que importa: o nome aparece em headlines, CTAs, emails, criativos e pitch. Placeholder gera output inutilizável.

Exemplos aceitáveis: ClinIA, PropFlow, VetIA, ContaFácil, JurisPro
Exemplos inaceitáveis: "meu SaaS", "o produto", "a plataforma"

> Se o nome ainda não existe, escolha um provisório agora. Pode mudar depois.

---

### PERGUNTA 2 — SETOR

**Em qual setor o SaaS opera?**

Opções (escolher 1 principal):
- Saúde (clínicas, consultórios, hospitais, telemedicina)
- Jurídico (escritórios de advocacia, compliance, contratos)
- Imóveis (incorporadoras, imobiliárias, corretores)
- Veterinário (clínicas e redes veterinárias)
- Educação (escolas, cursos, plataformas EAD)
- Varejo (lojas físicas, e-commerce, marketplaces)
- Serviços (agências, consultorias, freelancers)
- Tecnologia (devs, SaaS para SaaS, infra)
- Geral (B2B sem setor específico)

Por que importa: define regulação obrigatória, linguagem de copy, canais de aquisição e objeções de compra.

---

### PERGUNTA 3 — REGULAÇÃO APLICÁVEL

**Existe alguma regulação setorial que afeta o produto ou a compra?**

Por setor:
- Saúde → CFM (Resolução 2.299/21 prontuário), CFP (Resolução 11/18 psicologia), LGPD Art. 11 (dados sensíveis)
- Imóveis → CRECI (o corretor precisa ter, o SaaS não — mas não pode ser confundido com o serviço)
- Veterinário → CFMV (Resolução 1.306/20 prontuário), LGPD dados do tutor
- Jurídico → Estatuto OAB (sigilo profissional), LGPD dados processuais
- Educação → LGPD Art. 14 (menor de 18 anos exige consentimento dos pais)
- Geral → LGPD Art. 7º V (execução de contrato como base legal)

Se não souber: responder "não sei" → skill rodará /saas-compliance-br automaticamente

Por que importa: em setores regulados, conformidade visível é pré-requisito de compra. Sem ela, o lead não avança mesmo que o produto seja perfeito.

---

### PERGUNTA 4 — DECISOR DA COMPRA

**Quem assina o contrato / aprova o pagamento?**

Responder:
- Cargo/função: [ex: Diretora da clínica, Sócio-fundador, Gerente de TI]
- Critério de decisão: o que ele precisa VER para aprovar a compra?
  - ROI em R$ (economiza X por mês)
  - Conformidade regulatória (CFM aprovado)
  - Aprovação do time técnico
  - Referência de par (outra empresa do setor usa)
  - Sem necessidade de TI (self-serve)

Por que importa: o decisor recebe a demo, lê a LP e aprova ou veta. A narrativa (S5) e a LP (S7) são escritas para ele.

---

### PERGUNTA 5 — USUÁRIO FINAL

**Quem usa o produto no dia a dia?**

Pode ser a mesma pessoa que decide (B2C ou small business) ou diferente (B2B com equipe).

Responder:
- Cargo/função: [ex: Psicóloga da clínica, Corretor de imóveis, Recepcionista]
- O que ele espera SENTIR ao usar: [ex: "terminar meu dia no horário", "não precisar digitar nada", "confiar no dado que o sistema gerou"]
- Resistência esperada: [ex: "medo de aprender um sistema novo", "desconfiança com IA em prontuário"]

Por que importa: o onboarding (S13), o demo story (S6) e os gatilhos de IA (S3) são construídos para o usuário final, não para o decisor.

---

### PERGUNTA 6 — CANAL PRINCIPAL

**Onde os clientes ideais estão e como chegam até você?**

Opções:
- Instagram (criativo visual, reels, stories)
- LinkedIn (texto longo, artigos, mensagem direta B2B)
- WhatsApp (indicação, follow-up, comunidades)
- Email (outbound frio, nurturing, sequência pós-quiz)
- Evento de setor (congresso médico, feira imobiliária, OAB)
- Indicação direta (boca a boca, parceiros)
- Busca orgânica (SEO, blog, YouTube)
- Misto: indicar os 2 principais em ordem

Por que importa: o gancho do criativo (S8), a estrutura do post (S5 derivação WhatsApp), o formato da LP (S7 mobile-first) e o canal de retargeting (S10) mudam radicalmente por canal.

---

### PERGUNTA 7 — TICKET MÉDIO

**Qual é o preço do plano principal (o mais vendido) por mês?**

Exemplos: R$ 297/mês, R$ 497/mês, R$ 1.200/mês
Se ainda não definido, usar a estimativa mais provável agora.

Por que importa: define o tom (ticket alto = mais consultivo, mais prova social), o modelo de venda (self-serve vs. demo obrigatória) e o ROI mínimo que o produto precisa demonstrar (regra: ROI percebido ≥ 10x o ticket para venda self-serve).

---

### PERGUNTA 8 — MODELO DE COBRANÇA

**Como o cliente paga?**

Opções:
- Mensal (cobrado todo mês, sem fidelidade)
- Anual (cobrado 1x por ano com desconto de 2 meses)
- Freemium + trial pago (grátis com limite → upgrade)
- Consumo (paga pelo uso — por usuário, por transação, por chamada de API)
- Misto: mensal com opção de anual

Por que importa: define o CTA da LP (trial grátis vs. "assine agora"), a estratégia de dunning (S11) e a métrica de NRR (S14).

---

### PERGUNTA 9 — VOC — VÍDEO DO CLIENTE (5 FRASES LITERAIS)

**Cole 5 frases EXATAS que seus clientes (ou potenciais clientes) usaram para descrever o problema.**

Regras:
- São palavras do CLIENTE, não sua descrição do problema
- Podem vir de: conversa de WhatsApp, call de vendas, mensagem de DM, comentário em post, pesquisa anterior
- Se não tiver 5 ainda, use 3 e indique que são estimadas
- NÃO reescrever para ficar mais bonito — o valor está na imperfeição da fala real

Exemplo de frase BOA: "Toda semana fico até meia-noite acertando as guias do convênio e mesmo assim sempre tem alguma que retorna"
Exemplo de frase RUIM: "Os processos manuais geram ineficiência operacional"

Por que importa: a narrativa (S5), a copy da LP (S7), os criativos (S8, S9) e as perguntas do quiz (S10) devem usar as palavras exatas do cliente — não as suas. Em A/B tests, copy com VOC literal supera copy elaborada em 40-80% dos casos.

---

### PERGUNTA 10 — CONCORRENTES CONHECIDOS

**Quais produtos/ferramentas seus clientes comparam com o seu?**

Listar nomes reais:
- Concorrentes diretos: [mesma categoria, mesmo problema]
- Concorrentes indiretos: [forma alternativa de resolver — planilha, serviço terceirizado, processo manual]
- Concorrente "status quo": o que o cliente faz HOJE se não comprar nada (sempre incluir)

Por que importa: a matriz competitiva (S4), o Ato 2 da narrativa (S5) e a seção de comparativo da LP (S7) dependem de nomes reais. Output genérico ("os outros sistemas") não converte.

---

### PERGUNTA 11 — NOME PARA COPY

**Como o SaaS aparece nos textos, criativos e pitch?**

Pode ser igual ao nome (Pergunta 1) ou uma variação para copy:
- Nome completo: "ClinIA — Gestão Inteligente para Clínicas"
- Nome curto para copy: "ClinIA"
- Nome de domínio: clinia.com.br
- Como o cliente vai chamar: "o ClinIA", "o sistema"

Por que importa: headlines, emails, pitchs e CTAs precisam do nome exato para não ficarem com "[Nome do SaaS]" no output final.

---

## TEMPLATE DO ARQUIVO GERADO

Após as 11 perguntas, gerar e salvar este arquivo na pasta do projeto:

```markdown
# SAAS-CONTEXT.md
## Contexto do Projeto: [NOME DO SAAS]
> Gerado em: [data] via /saas-context-doc
> Versão: 1.0

---

NOME: [nome do SaaS]
SETOR: [setor]
REGULAÇÃO: [regulação aplicável ou "nenhuma — LGPD geral apenas"]
DECISOR: [cargo] — critério: [o que ele precisa ver para comprar]
USUÁRIO FINAL: [cargo] — expectativa: [o que ele precisa sentir ao usar]
RESISTÊNCIA INTERNA: [de quem e por quê]
CANAL PRINCIPAL: [canal]
CANAL SECUNDÁRIO: [canal ou "nenhum"]
TICKET: R$ [X]/mês
MODELO: [modelo de cobrança]

VOC — FRASES LITERAIS DO CLIENTE:
1. "[frase exata]"
2. "[frase exata]"
3. "[frase exata]"
4. "[frase exata]"
5. "[frase exata]"

CONCORRENTES DIRETOS: [nomes]
CONCORRENTE STATUS QUO: [o que fazem hoje sem o produto]
NOME PARA COPY: [nome]
DOMÍNIO: [domínio ou "a definir"]

---
```

---

## COMO CADA SKILL USA ESTE ARQUIVO

| Skill | O que lê do SAAS-CONTEXT |
|-------|--------------------------|
| /saas-problem-fit-canvas (S1) | SETOR, REGULAÇÃO, VOC, DECISOR |
| /ai-feature-map (S2) | SETOR, REGULAÇÃO, TICKET |
| /gatilho-preguica-canvas (S3) | USUÁRIO FINAL, SETOR |
| /saas-competitive-matrix (S4) | CONCORRENTES, SETOR, CANAL |
| /saas-narrative-framework (S5) | VOC, DECISOR, USUÁRIO FINAL, CANAL |
| /demo-story-canvas (S6) | USUÁRIO FINAL, DECISOR, TICKET |
| /saas-landing-blueprint (S7) | TODOS |
| /saas-demo-creative (S8) | CANAL, VOC, NOME PARA COPY |
| /criativo-antes-depois-ia (S9) | CANAL, VOC, SETOR |
| /quiz-diagnostico-saas (S10) | VOC, SETOR, DECISOR |
| /saas-checkout-blueprint (S11) | TICKET, MODELO, REGULAÇÃO |
| /roi-calculator-builder (S12) | TICKET, SETOR |
| /saas-onboarding-flow (S13) | USUÁRIO FINAL, DECISOR |
| /saas-success-metrics (S14) | TICKET, MODELO, SETOR |

---

## PASTA DO PROJETO — CONVENÇÃO .saas/

Ao gerar o SAAS-CONTEXT.md, instrua o usuário a criar a pasta `.saas/` na raiz do projeto e mover o arquivo:

```bash
mkdir .saas/
mv SAAS-CONTEXT.md .saas/
```

Todos os outputs das 17 skills do ecossistema SaaS são salvos nesta pasta. Isso garante que cada skill encontre os arquivos das skills anteriores sem precisar perguntar o que já foi respondido.

### Mapa completo dos arquivos do projeto:

| Arquivo | Gerado por | Lido por |
|---------|-----------|---------|
| `.saas/SAAS-CONTEXT.md` | /saas-context-doc | TODAS as 17 skills |
| `.saas/SAAS-S1-PROBLEMA.md` | /saas-problem-fit-canvas | S2, S4, S5, S10, S15 |
| `.saas/SAAS-S1B-VALIDACAO.md` | /saas-validacao-rapida | S2 |
| `.saas/SAAS-S2-FEATURES.md` | /ai-feature-map | S3, S12, S13 |
| `.saas/SAAS-S3-GATILHOS.md` | /gatilho-preguica-canvas | S6, S14 |
| `.saas/SAAS-S4-COMPETITIVO.md` | /saas-competitive-matrix | S5, S7 |
| `.saas/SAAS-S5-NARRATIVA.md` | /saas-narrative-framework | S6, S7, S8, S10 |
| `.saas/SAAS-S6-DEMO.md` | /demo-story-canvas | S7 |
| `.saas/SAAS-S7-LP.md` | /saas-landing-blueprint | S8, S11 |
| `.saas/SAAS-S8-CRIATIVOS.md` | /saas-demo-creative | S9 |
| `.saas/SAAS-S9-ANTES-DEPOIS.md` | /criativo-antes-depois-ia | — |
| `.saas/SAAS-S10-QUIZ.md` | /quiz-diagnostico-saas | S12 |
| `.saas/SAAS-S11-CHECKOUT.md` | /saas-checkout-blueprint | S13 |
| `.saas/SAAS-S12-ROI.md` | /roi-calculator-builder | — |
| `.saas/SAAS-S13-ONBOARDING.md` | /saas-onboarding-flow | S14 |
| `.saas/SAAS-S14-METRICAS.md` | /saas-success-metrics | — |
| `.saas/SAAS-S15-COMPLIANCE.md` | /saas-compliance-br | S7, S11 |

---

## COMO FUNCIONA O ENCADEAMENTO READ/WRITE

Cada skill do ecossistema segue o mesmo protocolo de duas fases:

**FASE 0 (READ):** lê `.saas/SAAS-CONTEXT.md` + arquivos específicos das skills anteriores.
→ Se o arquivo existe: usa os dados diretamente. NÃO faz a mesma pergunta de novo.
→ Se o arquivo não existe: para e instrui qual skill rodar primeiro.

**AO FINALIZAR (WRITE):** salva seu output estruturado como `.saas/SAAS-S[N]-[NOME].md`.
→ Formato padronizado com campos-chave em MAIÚSCULO
→ Confirma com "[arquivo] salvo ✓" antes de mostrar OUTPUT PARA PRÓXIMA SKILL

**Resultado:** o contexto flui sem interrupção do S0 ao S14. Nenhuma skill faz pergunta que outra já respondeu. O projeto ganha coerência total de A a Z.

---

## SALVAR OUTPUT

Ao concluir as 11 perguntas, salve o resultado em **dois lugares**:

**1. Na raiz do projeto:**
```
SAAS-CONTEXT.md
```

**2. Na pasta `.saas/`** (criar se não existir):
```
.saas/SAAS-CONTEXT.md   ← cópia idêntica para o protocolo de encadeamento
```

Formato do arquivo (campos em MAIÚSCULO para facilitar leitura das skills seguintes):

```markdown
# SAAS-CONTEXT — Contexto do Projeto

NOME: [nome do SaaS]
SETOR: [setor de atuação]
REGULAÇÃO: [CRM, LGPD, CFM, CFF, etc.]
DECISOR: [quem compra / aprova]
USUÁRIO_FINAL: [quem usa no dia a dia]
CANAL: [onde o lead está]
TICKET: R$ [X]/mês
MODELO: [B2B / B2C / híbrido]
VOC:
  1. "[frase literal do cliente 1]"
  2. "[frase literal do cliente 2]"
  3. "[frase literal do cliente 3]"
  4. "[frase literal do cliente 4]"
  5. "[frase literal do cliente 5]"
CONCORRENTES: [concorrente 1], [concorrente 2], [concorrente 3]
NOME_COPY: [nome para usar em copy e CTAs]
```

Confirme: "`SAAS-CONTEXT.md` e `.saas/SAAS-CONTEXT.md` salvos ✓ — pronto para a próxima skill."

---

## ANTI-ERROS

- **Nunca aceitar "meu produto" como nome** — exigir nome real ou provisório antes de continuar
- **VOC deve ser frase do cliente** — se o usuário descrever o problema com linguagem de produto ("ineficiência operacional"), pedir a frase como o cliente falaria
- **Se regulação desconhecida** — rodar /saas-compliance-br antes de prosseguir para S1
- **Nunca pular a pergunta de usuário final** — mesmo em produto aparentemente B2C, identificar se existe intermediário
- **SAAS-CONTEXT.md é documento vivo** — ao aprender nova VOC ou novo concorrente, atualizar o arquivo

---

## INTEGRAÇÕES

- `/saas-problem-fit-canvas` — primeira skill que lê o contexto
- `/saas-compliance-br` — complementa o campo REGULAÇÃO se desconhecido
- Todas as 14 skills da sequência SaaS IA Central

---

## OUTPUT PARA PRÓXIMA SKILL

---
**Próxima skill recomendada:** /saas-problem-fit-canvas
**Passe como input:**
- Arquivo SAAS-CONTEXT.md gerado: disponível na pasta do projeto
- Setor e regulação: informam os filtros de validação de S1
- VOC coletada: alimenta copy de S5, S7, S8, S9
- Decisor e usuário final: alimentam mapa de stakeholders de S1
---
