MÓDULO 1.1

🎯 O que é Ruflo?

O problema do single-agent, a solução do enxame coordenado e o ecossistema completo. Comece aqui se você ainda não conhece Ruflo.

6
Tópicos
30
Minutos
Básico
Nível
Teoria
Tipo
1

🎯 O Problema: Limites do Single-Agent

Um único agente IA — por mais capaz que seja — sequencia tudo. Arquitetura, código, testes e revisão acabam virando uma fila. Resultado: lento, repetitivo e sem cross-validation. Imagine fazer uma feature inteira sozinho enquanto poderia ter um time.

🔍Sintomas comuns

  • •Tarefa que envolve 5+ arquivos vira maratona linear
  • •Sem segunda opinião — bugs passam despercebidos
  • •Memória se perde entre sessões — você re-explica tudo
  • •Refatoração cross-module fica inviável

📊Dados do mundo real

  • 3-5x mais rápido com swarms paralelos vs solo (estudos internos Ruflo)
  • 40% menos bugs quando há agente reviewer dedicado
  • 0% retenção de contexto entre sessões sem memória persistente
2

💡 A Solução: Orquestração Coordenada

Ruflo coordena enxames de agentes especializados com memória compartilhada e consenso distribuído. Cada agente sabe seu papel (architect, coder, tester, reviewer) e se comunica via SendMessage. Você descreve o objetivo, o swarm executa em paralelo.

🎯Como funciona

  1. Inicializa swarm com topologia (hierarchical, mesh, hybrid)
  2. Spawna agentes named em paralelo via Task tool
  3. Coordena via SendMessage — pipeline architect → coder → tester
  4. Persiste memória — resultados ficam disponíveis para sessões futuras
  5. Aprende — SONA registra trajetórias de sucesso

💡Dica prática

Para coding diário, comece com 4 agentes (architect + coder + tester + reviewer) em topologia hierarchical. Esse é o sweet spot entre poder e foco — dificilmente dá problema.

3

⭐ Diferenciais que tornam Ruflo único

Existem outros frameworks de agentes. Mas Ruflo combina três peças que ninguém mais tem juntas: SONA learning, AgentDB+HNSW e Federation zero-trust.

✓ O que Ruflo tem

  • ✓SONA: aprende em <0.05ms
  • ✓HNSW: busca 150x-12.500x mais rápida
  • ✓Federation: zero-trust mTLS+ed25519
  • ✓EWC++: não esquece padrões antigos
  • ✓33 plugins via IPFS
  • ✓314 ferramentas MCP

✗ O que falta em alternativas

  • ✗Sem auto-learning ou requer fine-tuning
  • ✗Busca linear (10k+ items = lento)
  • ✗Sem federation segura entre instalações
  • ✗Catastrophic forgetting ao treinar novo
  • ✗Sem ecossistema de plugins maduro
  • ✗Sem integração MCP nativa
4

🎬 Quando usar (e quando NÃO usar)

Ruflo é poderoso, mas não é solução para tudo. Para edits simples ou perguntas rápidas, single-agent Claude Code resolve melhor (mais rápido, menos overhead).

✓ USE Ruflo quando

  • ✓Tarefa toca 3+ arquivos
  • ✓Feature nova com testes e review
  • ✓Refatoração cross-module
  • ✓Mudança de schema com migrações
  • ✓Audit de segurança
  • ✓Otimização de performance multi-camada

✗ EVITE Ruflo quando

  • ✗Edit de 1-2 linhas em um arquivo
  • ✗Pergunta exploratória rápida
  • ✗Atualização trivial de docs
  • ✗Mudança simples de config
  • ✗Bug fix óbvio (typo, missing import)
  • ✗Quando você só quer revisar um snippet

⚠️Atenção

Iniciar swarm para tarefa pequena custa mais tempo do que resolve. Use o bom senso — Ruflo é ferramenta, não obrigação.

5

🛠️ Ecossistema: 27 pacotes, 60+ agentes, 33 plugins

Ruflo é um monorepo enterprise. 27 pacotes @claude-flow/* dividem responsabilidades, 60+ tipos de agentes cobrem casos de uso comuns, e 33 plugins nativos no marketplace IPFS estendem o que vem na caixa.

1

Camada Interface

Como o usuário interage

@claude-flow/cli (26 comandos), @claude-flow/mcp (servidor MCP 2025-11-25)

2

Camada Orquestração

Coordena os agentes

@claude-flow/swarm (topologias), @claude-flow/hooks (27 hooks + 12 workers), @claude-flow/agents (60+ tipos)

3

Camada Inteligência

Memória e aprendizado

@claude-flow/memory (AgentDB+HNSW), @claude-flow/neural (SONA), @claude-flow/embeddings (ONNX 75x)

4

Camada Infraestrutura

Segurança e governança

@claude-flow/security (CVE, validation), @claude-flow/aidefence (PII, prompt injection), @claude-flow/guidance (policies)

6

🚀 Hello World em 5 minutos

Quer sentir Ruflo na prática? Cinco comandos e você tem swarm rodando, memória ativa e hooks instalados. Vamos ao passo a passo.

⚡Setup express

1. Adicione Ruflo ao Claude Code:

claude mcp add ruflo -- npx -y @claude-flow/cli@latest mcp start

2. Inicialize o projeto:

npx claude-flow@v3alpha init --wizard

3. Verifique saúde:

npx claude-flow@v3alpha doctor --fix

4. Inicie o daemon:

npx claude-flow@v3alpha daemon start

5. Crie seu primeiro swarm:

npx claude-flow@v3alpha swarm init --topology hierarchical --max-agents 4

💡Próximo passo

Pronto. Agora vá para o Módulo 1.2 - Arquitetura em Camadas para entender o que cada pacote faz e como tudo se conecta.

📋Resumo do Módulo

✓
O Problema — Single-agent serializa tudo, perde contexto, sem cross-validation
✓
A Solução — Enxames coordenados com memória compartilhada e consenso
✓
Diferenciais — SONA, AgentDB+HNSW, Federation zero-trust
✓
Quando usar — Tarefas de 3+ arquivos, features, refactor, security
✓
Ecossistema — 4 camadas: Interface, Orquestração, Inteligência, Infraestrutura
✓
Hello World — 5 comandos do init ao primeiro swarm

Próximo Módulo:

1.2 - Arquitetura em Camadas: 27 pacotes em detalhe

← Voltar para Trilha Próximo Módulo →