Coldreach — Manual de Utilização

1O que este squad é (e o que não é)

É: um conjunto de agentes que ensinam a metodologia completa de prospecção + cold email — o mesmo fluxo que ferramentas tipo MailerFind automatizam — para você executar com as ferramentas que já tem (navegador, APIs oficiais das plataformas, seu provedor de email).

Não é: uma integração técnica. Nenhum agente aqui faz scraping, dispara email ou configura DNS sozinho. Cada agente entrega uma especificação (o que coletar, o que escrever, como configurar, quando enviar) que você executa manualmente ou com as ferramentas externas que escolher.

💡Se você esperava "cole aqui a URL do Instagram e a IA dispara a campanha sozinha", este não é esse squad — de propósito.

2Instalação no seu projeto

Copie a pasta squads/coldreach/ inteira para dentro da pasta squads/ do seu projeto AIOX.

Confirme a estrutura no seu projeto:

meu-projeto/
└── squads/
    └── coldreach/
        ├── config.yaml
        ├── agents/
        ├── tasks/
        ├── checklists/
        ├── templates/
        └── data/

Ative o agente de entrada digitando @outreach-chief na sua ferramenta de IA (Claude Code, Codex, etc.).

⚠️Não edite os arquivos dentro da cópia do squad — se precisar customizar algo, copie o arquivo específico para fora e adapte no seu projeto.

3Mapa dos agentes — quando chamar cada um

Você quer...	Chame	Tier
Não sei por onde começar	`@outreach-chief`	Orchestrator
Saber se posso coletar/enviar para uma base específica	`@compliance-guardian`	0 — obrigatório
Descobrir audiência no Instagram, X/Twitter ou Google Maps	`@prospector`	1
Limpar, validar e enriquecer uma lista	`@list-curator`	1
Escrever ou ajustar a sequência de cold email	`@copywriter`	2
Configurar sender, warmup, agendar e lançar a campanha	`@campaign-architect`	2
Triar respostas, responder e agendar follow-up	`@inbox-strategist`	3

Você pode chamar qualquer agente diretamente se já sabe o que precisa, mas o recomendado é sempre começar por @outreach-chief, que roteia e garante que nenhuma etapa seja pulada.

4Fluxo de uso ponta a ponta

Exemplo: uma agência quer prospectar donos de estúdios de pilates em São Paulo para oferecer um software de gestão de agenda.

Compliance gate (sempre primeiro)

@outreach-chief
> Quero prospectar donos de estudios de pilates em Sao Paulo via Google Maps e Instagram

O outreach-chief roteia para *compliance-check. O compliance-guardian confirma fonte, base legal e opt-out antes de liberar qualquer coisa. Sem veredito APROVADO (ou com ressalvas), não avance.

Descoberta de audiência

@prospector
*discover-maps
> Categoria: estudio de pilates | Area: zona sul de Sao Paulo

*discover-instagram
> Modo: hashtag | Ancora: #pilatessp | ICP: donos/instrutores de estudio

O prospector entrega a especificação de busca. Você executa a coleta com a ferramenta que tiver e traz os dados brutos de volta.

Montar e higienizar a lista

@list-curator
*build-list
*dedupe
*validate
*enrich

Dedupe, validação de deliverability e enriquecimento só depois de estimar custo/benefício. Resultado: lista limpa e segmentada.

Escrever a sequência de cold email

@copywriter
*draft
> Segmento: donos de estudio de pilates, SP | Dor: agenda manual/planilha
> Proposito: agendar demo | Tom: consultivo

Saída: 3 emails (inicial + 2 follow-ups) com subject lines A/B e variáveis de personalização.

Configurar deliverability e agendar

@campaign-architect
*sequence-design
*configure-sender
> Provedor: Google Workspace | Dominio: 15 dias de uso | Volume alvo: 200/dia

*schedule
> Timezone: America/Sao_Paulo | Janela: seg-sex 09h-18h | Cap diario: 20 novos leads
*launch

O agente recomenda uma rampa de warmup antes de liberar o volume alvo. *launch só libera se o checklist de lançamento passar 100%.

Triar respostas

@inbox-strategist
*triage

Opt-outs são processados primeiro, sempre. Interessados recebem resposta em até 24h úteis. Objeções recorrentes (3+ ocorrências) geram *pattern-report de volta ao copywriter.

5Referência rápida de comandos

Agente	Comando	O que faz
outreach-chief	`*compliance-check`	Roda o gate de compliance
outreach-chief	`*status`	Resume o estado atual da operação
compliance-guardian	`*gate`	Gate completo (base legal + ToS + opt-out + rate-limits)
compliance-guardian	`*legal-basis`	Só a base legal LGPD/GDPR para um cenário
prospector	`*discover-instagram`	Query de descoberta no Instagram
prospector	`*discover-x`	Query de descoberta no X/Twitter
prospector	`*discover-maps`	Query de busca de negócios no Google Maps
list-curator	`build-list · dedupe · validate · enrich · *segment`	Pipeline de lista
copywriter	`draft · improve · tone · translate · *subject-lines`	Pipeline de copy
campaign-architect	`sequence-design · configure-sender · schedule · launch · *monitor`	Pipeline de campanha
inbox-strategist	`triage · reply · optout · schedule-followup · *pattern-report`	Pipeline de inbox

*help funciona em qualquer agente para listar os comandos daquele agente. *exit sai do modo atual.

6Por que o gate de compliance é obrigatório

Todo agente do squad — inclusive o outreach-chief — se recusa a avançar para descoberta ou envio sem o compliance-guardian ter aprovado o cenário. Isso não é burocracia: é a diferença entre uma operação de outbound legítima e uma que gera denúncia de spam, banimento de domínio ou exposição jurídica (LGPD/GDPR/CAN-SPAM).

Verificação	Pergunta que responde
Base legal	Você tem fundamento (legítimo interesse B2B, consentimento) para usar esses dados?
ToS da plataforma	O método de coleta respeita os termos do Instagram/X/Google Maps?
Minimização	Você está coletando só o necessário, ou "tudo que der"?
Opt-out	Existe um jeito fácil e honrado de sair da lista?
Rate-limiting	O volume/cadência está dentro de limites seguros de reputação?

7Onde ficam os artefatos gerados

Artefato	Formato de referência
Lista de prospects	`templates/prospect-list-schema.md`
Sequência de cold email	`templates/cold-email-sequence-template.md`
Brief de campanha	`templates/campaign-brief-template.md`

⚠️Nunca versione dados pessoais reais (nomes, emails, telefones de terceiros) dentro da pasta do squad ou de qualquer repositório.

8Boas práticas de deliverability

Nunca pule o warmup. Domínio novo (< 30 dias) precisa de 3-4 semanas de rampa antes do volume alvo.
SPF, DKIM e DMARC configurados antes do primeiro envio em volume.
stopWhen: replied sempre. Ninguém recebe follow-up depois de responder.
Open tracking desligado por padrão — pouco confiável e pode prejudicar deliverability.
Bounce acima de 2-3% ou spam-report acima de 0,1% = pausar e investigar imediatamente.

9Perguntas frequentes

Posso pular o compliance gate se eu já sei que os dados são públicos?

Não. Dado público não é sinônimo de base legal para uso comercial. O gate sempre roda, mesmo que o veredito saia rápido para cenários de baixo risco.

O squad executa o scraping/envio por mim?

Não. Ele especifica o que fazer; a execução técnica é sua, com as ferramentas que você tiver.

Posso usar uma lista que comprei de terceiros?

O compliance-guardian bloqueia isso por padrão — risco altíssimo de dados sem consentimento e de dano à reputação do domínio.

Quantos contatos por dia posso adicionar a uma campanha nova?

Depende do estágio de warmup do domínio, nunca de um número fixo.

Um lead pediu para não receber mais emails, mas não usou "unsubscribe". Conta como opt-out?

Sim. Qualquer pedido explícito ou implícito de parar é tratado como opt-out — processar imediatamente e suprimir permanentemente.

10Limitações conhecidas

Não substitui aconselhamento jurídico para operações em escala ou cenários cross-border.
Não há automação de execução: cada handoff entre agentes exige que você traga os dados/resultados da etapa anterior para a próxima conversa.
Assume que você já tem (ou vai providenciar) acesso a uma ferramenta de envio de email e, se aplicável, a APIs oficiais das plataformas de descoberta.