📐 Arquitetura v2

Última atualização: 2026-02-15 02:11 UTC

Visão Geral

Growth Forge v2 é composto por 6 swarms especializados com 14 agentes no total.

Framework: Swarms (kyegomez) — enterprise-grade, production-ready

Código: /root/clawd/projects/growth-forge/src/swarms/

Hierarquia de Comando

                    ┌─────────────────────────┐
                    │   GROWTH ORCHESTRATOR   │
                    │       (ArcosBot)        │
                    └───────────┬─────────────┘
                                │
    ┌───────────────────────────┼───────────────────────────┐
    │           │           │           │           │       │
    ▼           ▼           ▼           ▼           ▼       ▼
 ┌──────┐  ┌──────┐  ┌──────┐  ┌──────┐  ┌──────┐  ┌──────┐
 │INTEL │  │CONTE-│  │ PAID │  │ORGA- │  │SALES │  │REVE- │
 │SWARM │  │  NT  │  │MEDIA │  │ NIC  │  │SWARM │  │ NUE  │
 │  🟢  │  │  🟡  │  │  🟢  │  │  🟢  │  │  🟡  │  │  🟢  │
 └──────┘  └──────┘  └──────┘  └──────┘  └──────┘  └──────┘
   2 ag      2 ag      1 ag      3 ag      3 ag      3 ag

Legenda: - 🟢 Operacional (código + CLI + cron ativo) - 🟡 Manual apenas (código + CLI ok, cron desativado)

Status de Integração

Swarm	Código	coordinator.py	main.py CLI	Cron
Intel	✅	✅ `run_intel_swarm()`	✅ `--swarm intel`	✅ 06:00
Content	✅	✅ `run_content_swarm()`	✅ `--swarm content`	❌ Desativado
Paid Media	✅	✅ `run_paid_media_swarm()`	✅ `--swarm paid_media`	✅ 09:00
Organic	✅	✅ `run_organic_swarm()`	✅ `--swarm organic`	✅ 18:00
Sales	✅	✅ `run_sales_swarm()`	✅ `--swarm sales`	❌ Desativado
Revenue	✅	✅ `run_revenue_swarm()`	✅ `--swarm revenue`	✅ 20:00

Todos os 6 CLIs funcionam! ✅

🐝 Os 6 Swarms

1. Intel Swarm (Inteligência de Mercado) 🟢

Status: Operacional

Agente	Função	API	Status
NewsAgent	Notícias do setor	NewsAPI	✅ Ativo
CompetitorAgent	Monitoramento concorrência	DataForSEO	✅ Ativo

Código: src/swarms/intel/

2. Content Swarm (Criação de Conteúdo) 🟡

Status: CLI funciona, cron desativado (gasta FAL.ai)

Agente	Função	API	Status
WriterAgent	Textos, posts, emails	Claude (interno)	✅ Ativo
VisualAgent	Imagens e thumbnails	FAL.ai	✅ Ativo

Código: src/swarms/content/

3. Paid Media Swarm (Mídia Paga) 🟢

Status: Operacional

Agente	Função	API	Status
MetaAgent	Campanhas FB/IG	Meta Ads	✅ Ativo

Pendente: Google Ads (aguardando Developer Token)

Código: src/swarms/paid_media/

4. Organic Swarm (Tráfego Orgânico) 🟢

Status: Operacional

Agente	Função	API	Status
SEOAgent	Keywords, rankings	DataForSEO + GSC	✅ Ativo
YouTubeAgent	Analytics do canal	YouTube API	✅ Ativo
InstagramAgent	Insights orgânicos	Instagram API	✅ Ativo

Código: src/swarms/organic/

5. Sales Swarm (Vendas) 🟡

Status: CLI funciona, cron desativado (sem API Central GTM)

Agente	Função	Ferramenta	Status
ProspectingAgent	Busca de leads	Central de GTM	⏳ Aguarda API
OutreachAgent	Sequências de contato	CRM Interno	⏳ Aguarda API
PipelineAgent	Tracking de deals	Local JSON	✅ Ativo

Código: src/swarms/sales/

6. Revenue Swarm (Receita) 🟢

Status: Operacional

Agente	Função	API	Status
HealthAgent	Saúde de clientes	Interno	✅ Ativo
ForecastAgent	Previsão de receita	Interno	✅ Ativo
SuccessAgent	Customer success	Interno	✅ Ativo

Código: src/swarms/revenue/

🧠 Self-Learning Layer

Status: ✅ Implementado e persistente

O learning.py implementa aprendizado real:

Funcionalidade	Status
Pattern Storage	✅ Persiste em JSON
Execution History	✅ Últimas 1000 execuções
Insights	✅ Armazenamento de insights
Recomendações	✅ Baseadas em padrões
Relatórios	✅ Geração automática
LanceDB	⏳ Fallback para JSON (LanceDB opcional)

Arquivos de dados:

/root/clawd/projects/growth-forge/data/learning/
├── patterns.json          # Padrões de sucesso/falha por agente
├── execution_history.json # Histórico de execuções
└── insights.json          # Insights coletados

📁 Estrutura de Código

/root/clawd/projects/growth-forge/
├── config/
│   ├── .env                  # Credenciais (chmod 600)
│   ├── competitors.json      # Lista de concorrentes
│   └── gsc_token.json        # Token GSC
├── docs/                     # MkDocs (esta documentação)
├── src/
│   ├── main.py               # Entry point (CLI)
│   ├── orchestrator/
│   │   └── coordinator.py    # HierarchicalSwarm
│   └── swarms/
│       ├── intel/            # 2 agentes
│       ├── content/          # 2 agentes
│       ├── paid_media/       # 1 agente
│       ├── organic/          # 3 agentes
│       ├── sales/            # 3 agentes
│       └── revenue/          # 3 agentes
└── data/                     # State files

🔗 Referências

Swarms Framework: github.com/kyegomez/swarms

Documentação atualizada por ArcosBot ⚡ — 2026-02-15 02:11 UTC