Gerenciador de Prospectos GEO

Propósito

Gerenciar prospectos e clientes de agências GEO durante todo o ciclo de vendas. Todos os dados são armazenados em ~/.geo-prospects/prospects.json (persistente entre sessões).

Comandos

Estrutura de Dados

Cada prospecto é armazenado como um registro JSON:

{
  "id": "PRO-001",
  "company": "Electron Srl",
  "domain": "electron-srl.com",
  "contact_email": "info@electron-srl.com",
  "contact_name": "",
  "industry": "Educational Equipment Manufacturing",
  "country": "Italy",
  "status": "qualified",
  "geo_score": 32,
  "audit_date": "2026-03-12",
  "audit_file": "~/.geo-prospects/audits/electron-srl.com-2026-03-12.md",
  "proposal_file": "~/.geo-prospects/proposals/electron-srl.com-proposal.md",
  "monthly_value": 0,
  "contract_start": null,
  "contract_months": 0,
  "notes": [
    {
      "date": "2026-03-12",
      "text": "Initial GEO quick scan. Score 32/100 - Critical tier. Strong candidate for GEO services."
    }
  ],
  "created_at": "2026-03-12",
  "updated_at": "2026-03-12"
}

Instruções de Orquestração

/geo prospect new <domain>

1. Verificar se ~/.geo-prospects/prospects.json existe, criar se não existir (array vazio)
2. Detectar automaticamente o nome da empresa a partir do domínio (ex: electron-srl.com → Electron Srl)
3. Atribuir o próximo ID sequencial: PRO-001, PRO-002, etc.
4. Perguntar ao usuário:
   • Nome do contato (opcional)
   • E-mail do contato
   • Estimativa do valor mensal do contrato (opcional)
5. Definir status para lead
6. Salvar no arquivo JSON
7. Sugerir próximo passo: "Executar /geo prospect audit electron-srl.com para pontuar este prospecto"

/geo prospect list

Ler ~/.geo-prospects/prospects.json e renderizar uma tabela de resumo:

GEO Prospect Pipeline — March 2026
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

ID       Domain                  Company           Status      Score  Value
───────  ──────────────────────  ────────────────  ──────────  ─────  ──────
PRO-001  electron-srl.com        Electron Srl      Qualified   32/100  €4.5K
PRO-002  acme.com                ACME Corp         Lead        —       —
PRO-003  bigshop.it              BigShop           Won         41/100  €6.0K

━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
Pipeline: 1 lead | 1 qualified | 0 proposals | 1 won | 0 lost
Committed MRR: €6,000 | Pipeline Value: €4,500

/geo prospect audit <id-or-domain>

1. Executar /geo quick <domain> para obter a pontuação do snapshot GEO
2. Salvar a pontuação no registro do prospecto: geo_score, audit_date
3. Salvar a saída da auditoria em ~/.geo-prospects/audits/<domain>-<date>.md
4. Atualizar o caminho audit_file no registro do prospecto
5. Adicionar nota automática: "Auditoria rápida executada. Pontuação GEO: XX/100."
6. Se a pontuação for < 55: sugerir "Pontuação indica forte oportunidade de vendas. Executar /geo proposal <domain> para gerar proposta."

/geo prospect note <id-or-domain> "<text>"

1. Encontrar prospecto por ID ou domínio
2. Anexar nota com a data ISO atual
3. Salvar de volta no JSON
4. Confirmar: "Nota adicionada a Electron Srl (PRO-001)"

/geo prospect status <id-or-domain> <status>

Status válidos: lead, qualified, proposal, won, lost

1. Atualizar campo de status
2. Adicionar nota automática: "Status alterado para <status>"
3. Salvar e confirmar

/geo prospect pipeline

Resumo visual do pipeline focado em receita:

━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
RESUMO DO PIPELINE DE AGÊNCIAS GEO — Março de 2026
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

ESTÁGIO         CONT.   VALOR POTENCIAL   NOTAS
─────────────  ─────   ───────────────   ─────────────────────
Lead             2      €8.000/mês       Novas descobertas
Qualificado      1      €4.500/mês       Pronto para proposta

…