🛒 Marketplace IPFS
O registry de plugins fica no IPFS via Pinata — distribuição descentralizada, imutável, com CID versionado em discovery.ts. Resultado: ninguém pode silenciosamente trocar conteúdo de um plugin já publicado.
🔐Por que IPFS
- •Conteúdo identificado por hash (CID) — verificável
- •Distribuído — sem ponto único de falha
- •Histórico íntegro — versão anterior sempre acessível
- •Gateway HTTPS via Pinata para acesso simples
📍Onde mora o registry
v3/@claude-flow/cli/src/plugins/store/discovery.ts
LIVE_REGISTRY_CID = "QmXbfEAaR7D2Ujm4..."
gateway: https://gateway.pinata.cloud/ipfs/{CID}🏷️ Categorias
Os 33 plugins se dividem em categorias temáticas. Saber a divisão ajuda a encontrar o que você precisa sem ter que ler descrição de tudo.
🎛️ Core
embeddings, security, claims, neural, plugins, performance
💾 Memory
rag-memory, agentdb, memory-coordinator
🧠 Intelligence
prime-radiant, cognitive-kernel, hyperbolic-reasoning, neural-coordinator, quantum-optimizer
🛠️ Code Quality
code-intelligence, test-intelligence, perf-optimizer, agentic-qe
🛡️ Security
security-audit, aidefence (PII, prompt injection)
🚀 DevOps
jujutsu, observability, federation, iot-cognitum
⭐ Top 10 plugins
Em vez de instalar tudo, comece com os 10 que entregam mais valor. Cobrem 90% dos casos de uso.
agentdb
Banco vetorial + 9 algos RL
rag-memory
RAG completo com chunking + retrieval
security-audit
CVE + dep audit + secret scan
testgen
Geração automática com gaps analysis
jujutsu
VCS quantum-resistant para agentes
docs
Auto-documentation pós-edit
federation
Mesh zero-trust mTLS+ed25519
observability
Telemetria, métricas, traces
sparc
Metodologia SPARC com agents dedicados
plugin-creator
Scaffold para seus próprios plugins
📥 Install / enable / disable
Instalar um plugin é download do CID + verificação + setup. Você pode habilitar/desabilitar sem reinstalar — útil para alternar features sem custo.
⚙️Comandos essenciais
# Listar disponíveis
npx claude-flow@v3alpha plugins list
# Instalar
npx claude-flow@v3alpha plugins install @claude-flow/rag-memory
# Habilitar/desabilitar
npx claude-flow@v3alpha plugins enable @claude-flow/rag-memory
npx claude-flow@v3alpha plugins disable @claude-flow/rag-memory
# Remover
npx claude-flow@v3alpha plugins uninstall @claude-flow/rag-memory💡Dica prática
Plugins instalados ficam em ~/.claude-flow/plugins/. Se precisar de patch local, edite ali — mas saiba que update sobrescreve. Para mudanças permanentes, fork e use install local.
🧩 RAG memory + federation + IoT
Três casos de uso que mostram o poder real do ecossistema. RAG para conhecimento, Federation para colaboração entre instalações, IoT para edge devices.
rag-memory — chat com docs
Indexar /docs e perguntar "como funciona X?"
Embeddings ONNX 384-dim + retrieval top-K + síntese. Ideal para onboarding e suporte.
federation — múltiplas instalações
Mesh zero-trust com mTLS+ed25519
Equipes em locais diferentes compartilham swarms e memória sem expor secrets.
iot-cognitum — edge devices
Bearer auth via env, ingest/query telemetria
Conecta sensores e devices ao swarm para tomada de decisão local com sync para nuvem.
🔧 Plugin management
Versão errada, conflito de deps, plugin que não carrega — todos enfrentam. Esses são os passos de troubleshooting que resolvem 90% dos casos.
✓ Boas práticas
- ✓Pin versões em produção (não use latest)
- ✓Update em staging primeiro
- ✓Teste com doctor após cada install
- ✓Mantenha changelog de plugins ativos
✗ Evite
- ✗Instalar tudo "por garantia"
- ✗Misturar versões alpha + stable
- ✗Atualizar prod sem rollback plan
- ✗Editar plugin instalado direto
🔬Troubleshooting básico
npx claude-flow@v3alpha doctor --fix— diagnostica e tenta corrigirplugins list --enabled— vê o que está ativoplugins disable X— isolar plugin suspeito- Reinstale com
--forcese cache corrompeu
📋Resumo do Módulo
Próximo Módulo:
2.6 - Background Workers em Ação: 12 workers que rodam silenciosamente