convez.ai
AgenteAutomaçãoAvançado
Rica-VibeCoding

Grupo Borges — Cockpit Multi-Agente Claude

Rica-VibeCoding/grupo_borges

Cockpit de frota multi-agente com observabilidade em tempo real

Ver no GitHub
InicialPluginScore · de 0 a 100

Orquestrador visual em tempo real de 6 agentes Claude Code (Pavan, Daniel, Lucas, Vinicius, Felipe, Barsi) rodando em paralelo. Planta missões, observa handoffs, gerencia skills/docs por agente e abre múltiplas instâncias. Stack: Next.js 16 + FastAPI + SQLite WAL com SSE para atualização viva.

Instalação

$npx convez-ai Rica-VibeCoding/grupo_borges

1 comando no terminal: detecta o formato do repositório (marketplace ou plugin avulso) e instala via Claude Code. Requer Node 18+ e o Claude Code instalado.

Métricas

Estrelas
0
Forks
0
Acompanhando
0
Saúde
28%
Último commit
há 2 dias
Versão
—
Issues abertas
0
Contribuidores
1

Casos de uso

  • Orquestração centralizada de múltiplos agentes Claude Code
  • Monitoramento visual de estado e ações narrativas dos agentes
  • Distribuição de missões e handoffs entre equipes de agentes

Veredito

Sistema production-ready para coordenação de frotas multi-agente. Arquitetura sólida com separação frontend/backend, SSE para reatividade, e mapeamento claro de estados. Exige experiência em full-stack (Next.js + FastAPI) e compreensão do fluxo de agents Claude.

README

A tradução para o português deste README ainda está na fila.

grupo_borges

Cockpit multi-agente — escritório central da frota Claude Code do Rica.

O que é

Web app que orquestra 6 agentes (Pavan, Daniel, Lucas, Vinicius, Felipe, Barsi), cada um rodando em sua sessão Claude Code. Permite plantar missões, observar handoffs em tempo real, gerenciar skills/tabelas/docs por agente, e abrir múltiplas instâncias paralelas.

Estado atual — V2.5 (2026-05-13)

Cockpit operacional em produção. Card de cada agente mostra estado vivo + última ação narrativa em pt-BR.

Documentação canônica é este README. Bridges, planos de fase e auditorias intermediárias foram apagadas após cada entrega — o código no repo é a fonte da verdade. Pra entender qualquer comportamento atual: leia o código, não busque memos.

Stack

  • Front: Next.js 16 + React 19 + Tailwind 4 + shadcn/ui → Vercel
  • Backend: FastAPI Python → VPS (systemd + Tailscale Serve pra HTTPS)
  • Banco: SQLite WAL local na VPS
  • Bridge: SSE (sse-starlette)
  • Auth: Tailscale identity headers

Estrutura

grupo_borges/
├── apps/
│   ├── web/          # Next.js → Vercel
│   └── api/          # FastAPI → VPS
├── packages/
│   └── shared-types/ # tipos TS gerados do schema Pydantic
├── .claude/agents/   # subagents formalizados
├── agents.yaml       # config dos 6 agentes
└── AGENTS.md         # manual operacional dos agentes

Cockpit — modelo visual

3 estados primários + offline silencioso

EstadoCor / luzAnimaçãoQuando ocorre
Ociosocyan #00f0ffestáticaidle, done, Stop ("passou a bola"), turnos completos
Trabalhandoemerald #10b981pulse 2s suavequalquer tool ativa, thinking, responding, subagent
Aguardandoamber #f59e0bpulse 1s intensoblocked, StopFailure, PostToolUseFailure, precisa olhar
Offlineopacity 0.46sem glowsem heartbeat há >5min

Contraste semântico: estático = pode ignorar, animado = requer atenção. Quanto mais rápido pulsa, mais urgente.

Last-action narrativa

Cada card mostra o último evento pintável (com summarize não-null), com texto em pt-BR — ex: "escrevendo apps/web/page.tsx", "rodou bash …/foo.sh", "passou a bola", "erro ao parar". A linha sempre fica visível: quando não há evento mapeado, mostra placeholder "— sem atividade recente". Card não muda de altura entre estados.

Mapeamento backend → estados

Implementação canônica em:

  • apps/api/routers/hooks.py::_hook_lifecycle — hooks Claude → 4 estados
  • apps/api/db/store.py::derive_agent_status — combina lifecycle + last_seen
  • apps/web/components/agent-card.tsx — render + glow

Cobertura de eventos em summarize() em apps/web/components/activity-feed.tsx.

Scripts repro pra debug

Em ~/repos/ze_claude/daniel/scripts/:

  • v23-item2-repro-stop-hold.sh — Pre + Stop (Trabalhando → Ocioso)
  • v25-aguardando-repro.sh — Pre + StopFailure (Trabalhando → Aguardando)

Rodam contra http://127.0.0.1:8000 no card do agente lucas (offline limpo). Saída texto com checkpoints de lifecycle no banco.

Rodar local

Backend:

cd apps/api
uv sync
cp .env.example .env  # ajustar paths se não for VPS
uv run uvicorn main:app --host 127.0.0.1 --port 8000

Frontend:

cd apps/web
corepack pnpm install
corepack pnpm dev   # default: :3007 na VPS

Smoke:

curl http://127.0.0.1:8000/health
curl http://127.0.0.1:8000/api/fleet | jq '.agents[] | {slug, status, lifecycle_status, lifecycle_detail}'

License

Privado — uso pessoal do Rica.

Ver o original no GitHub

Bom para

Relacionados