Do email ao
primeiro /hypotheses.

Pré-requisitos

Antes de começar, garanta:

• Claude Code instalado — guia oficial Anthropic.
• Acesso a um warehouse — BigQuery, Postgres, Snowflake, Redshift, Databricks, MySQL, ou CSV/planilha exportada.
• Acesso de leitura aos dados — credenciais de service account (BigQuery), connection string (Postgres), etc. O Brain só lê — nunca escreve no seu warehouse.

1. Aplicação no site

Abra superfreelas.com/onboarding e preencha o wizard de 4 passos:

1. Empresa — nome, setor (10 opções), website opcional.
2. Porte — estágio (pre-seed → public), time atual, pessoas em growth.
3. Stack + Objetivos — warehouses (multi-checkbox), objetivos de growth (1-3 cards).
4. Contato — nome, email corporativo, cargo, WhatsApp opcional, interesse (Free trial 14d ou Business $39/mês).

Submit envia pra freelasuper@gmail.com via Formspree. O Juliano te chama no WhatsApp em até 24h pra agendar uma call de 30min.

2. Recebimento do scaffold

Após a call, o Juliano emite seu token e envia um zip por email com o nome <cliente>-growth-ops.zip. Conteúdo típico:

3. Instalação do plugin

Descompacte o zip e abra o diretório no Claude Code. No prompt:

/plugin marketplace add github.com/SuperFreelas/plugin-growth-brain
/plugin install superfreelas@superfreelas

O plugin instala 11 commands (9 análise + 2 operacional) e 2 skills (before-analysis, auto-learning) que rodam automaticamente.

4. Rodando /setup

O /setup é a primeira coisa que você roda. Ele faz 6 perguntas pra entender seu negócio e gera dataSpec.md adaptado:

1. Categoria do negócio — ecommerce / SaaS B2B / SaaS B2C / marketplace / fintech / outro.
2. Modelo de monetização — assinatura, transacional, freemium, ads, take-rate.
3. Granularidade da análise — usuário, conta, sessão.
4. Fonte de dados — qual warehouse e qual schema a análise vai consumir.
5. Conta-fonte — pra ads/canais (Google Ads, Meta, etc).
6. Margem bruta — pra cálculos de payback. Se não souber, pode dizer "TBD".

Saída: _initiatives/<cliente>/dataSpec.md com schema esperado de tabelas, métricas-chave, e queries de exemplo. Detalhes em Modelo de Dados.

5. Primeiros comandos

Comece pelo /hypotheses — é o comando mais comum e te dá a visão geral de prioridades:

/hypotheses

Fluxo interno (automático):

1. before-analysis chama record_command_run("/hypotheses") (gate de quota).
2. Lê get_principles() + get_skill_template("hypothesisGenerator").
3. Lê _initiatives/<cliente>/learnings.md (vazio na primeira execução).
4. Roda queries no seu warehouse (4-6 queries típicas).
5. Gera 5-8 hipóteses priorizadas por ICE score.
6. Salva em _initiatives/<cliente>/hypotheses.md.

Lista completa em Commands.

6. Onde colocar arquivos

Estrutura recomendada do projeto após primeiros comandos:

Recomendamos versionar com git — exceto .growth-brain-token. Os arquivos em _initiatives/ são memória do projeto: o before-analysis sempre lê learnings.md antes de qualquer análise nova.

7. Troubleshooting

Erro: "401 Unauthorized" ao rodar comando

Token expirado ou inválido. Verifique:

• .growth-brain-token está no diretório raiz do projeto.
• Token não passou de 14 dias (trial) ou 365 dias (Business). Rode get_quota_status() pra ver expires_at.
• Caso expirado, contate Juliano pelo WhatsApp.

Erro: "warehouse connection failed"

O Claude Code não conseguiu acessar seu warehouse. Verifique:

• Credenciais corretas no .mcp.json (BigQuery service account, Postgres URL, etc).
• Schema/dataset existe e tem permissão de leitura.
• Firewall/VPN — alguns warehouses corporativos só aceitam conexão de IPs específicos.

Erro: "trial_quota_exceeded"

Você bateu as 30 análises do trial. Soluções:

• Ative Business (análises ilimitadas) — WhatsApp.
• Comandos operacionais (/setup, /learning) continuam funcionando — não consomem quota.

Plugin instalado mas commands não aparecem

Reinicie o Claude Code (Cmd+Q + reabrir). Se persistir, rode /plugin list e verifique se superfreelas está ativo.