AITeam Team Overview

Painel visual em estilo pixel art para orquestrar e monitorar agentes BMAD em tempo real.

npx aiteam-x@latest

Visao Geral

O AITeam Team Overview e um dashboard interativo que transforma a gestao de agentes de IA em uma experiencia visual e intuitiva. Inspirado em jogos de simulacao tipo sim manager, o painel exibe agentes BMAD como personagens pixel art em um escritorio virtual, permitindo:

• Visualizar o status e a localizacao de cada agente em tempo real
• Interagir diretamente com agentes atraves de janelas de chat integradas
• Orquestrar workflows como Party Mode e brainstorming sessions
• Monitorar metricas de uso (mensagens, tokens in/out) por agente
• Persistir contexto e memorias entre sessoes de trabalho com extracao via LLM

O projeto utiliza o BMAD Method como framework de agentes, integrando-se nativamente com o Cursor Agent CLI e o Cursor ACP (Agent Client Protocol) para comunicacao bidirecional com LLMs.

Screenshots

Dashboard Principal

Escritorio virtual com Jarvis Office, Kitchen e workspaces individuais. Barra inferior com avatares e progresso do sprint (14/14 — 100%).

Janela de Chat com Agente

Janela de conversa com BMad Master em tempo real. Cada agente responde com streaming de texto e suporte a Markdown.

Memory Vault

Painel de gerenciamento de memorias por agente. Categorias: decisions, lessons, tasks, projects, handoffs. Busca BM25 em tempo real.

Filtros de Agentes

Filtros de Status (Todos / Trabalhando) e Modulo (BMGD / BMM / CORE) para visualizacao segmentada dos agentes.

Funcionalidades Principais

Dashboard Pixel Art

• Salas compartilhadas: Jarvis Office, Kitchen — com contexto de atividade dos agentes
• Grid de workspaces individuais por agente com indicadores de modulo (BMGD / BMM / CORE)
• Avatares pixel art com status visual em tempo real
• Barra inferior com avatares compactos e timeline do sprint com progresso granular por story
• Ciclo dia/noite e efeitos de ambiente

Interacao com Agentes

• Selecao de agente (click) ou multi-selecao (Ctrl+click) para comandos em lote
• Janelas de conversa redimensionaveis com streaming SSE em tempo real
• Bubble de "pensando" animado durante processamento
• Rendering completo de Markdown nas respostas
• Botao de copiar: aparece no hover sobre respostas de agentes para copiar texto
• Menu de contexto: clique direito sobre um agente exibe comandos personalizados do MDC
• Botao de stop para cancelar processamento em andamento
• Historico de conversa persistido entre reloads
• Sistema de z-index dinamico (bring-to-front ao clicar)

Seletor de Modelo e Filtros

• Model Bar: selecao do modelo LLM aplicado a todos os agentes
• Cursor ACP: submenu dinamico que lista todos os modelos disponiveis na conta Cursor (Claude, GPT, Gemini, Grok, etc.)
• Modelos diretos: Composer 2, Claude Opus/Sonnet, GPT-5.x, Gemini, Grok, Kimi
• Filtro de Status: Todos / Trabalhando — exibe contador em tempo real (ex: 14/14)
• Filtro de Modulo: BMGD / BMM / CORE — segmenta agentes por area de atuacao

Cursor ACP (Agent Client Protocol)

• Comunicacao direta com o Cursor via JSON-RPC 2.0 sobre stdio (agent acp)
• Descoberta automatica de modelos disponiveis via configOptions da sessao ACP
• Troca de modelo por sessao via session/set_config_option
• Processo ACP persistente com sessoes de 30 min e reconexao automatica
• Fallback de erro com mensagens actionaveis para o usuario

Orquestracao BMAD

• Deteccao automatica de Party Mode e workflows ativos
• Agentes se movem dinamicamente para salas conforme o workflow
• Sessao de estado persistida em disco e sincronizada via SSE
• Metricas de mensagens e tokens por agente

Sistema de Memoria Persistente (v2.1)

• Memory Vault: painel visual completo com 5 categorias (decisions, lessons, tasks, projects, handoffs)
• Auto-extract via LLM: ao fechar uma sessao, o sistema analisa a conversa e extrai memorias estruturadas automaticamente
• Badge 🤖 llm: entradas extraidas automaticamente ficam marcadas por 10 minutos com opcao de veto
• Busca BM25: busca semantica por relevancia dentro do vault de cada agente
• Injecao de contexto: memorias relevantes injetadas automaticamente ao iniciar novas sessoes (budget de 2.000 tokens)
• Auto-save: conversas salvas a cada 30s + save on unload via sendBeacon
• Checkpoint de sessao: historico preservado mesmo em reinicios inesperados
• Memoria compartilhada: _project.md injetado em todos os agentes como contexto global

Portabilidade e Instalacao (v1.0)

• Discovery dinamico: detecta agentes BMAD automaticamente via CSV/YAML — sem hardcode
• Cross-platform: funciona em Windows, macOS e Linux
• Wizard de setup web: /setup no browser — 3 fases animadas: scan da maquina, revisao, configuracao passo a passo
• Wizard de setup CLI: npm run setup — alternativa interativa no terminal (6 passos)
• Health gate: se nao configurado, redireciona para /setup automaticamente
• Config flexivel: aiteam.config.json local + AITEAM_BMAD_ROOT para instancias externas/CI

Stack Tecnologico

| Camada | Tecnologia | Versao | |--------|-----------|--------| | Framework | Next.js (App Router) | 15.x | | UI | React | 19.x | | Linguagem | TypeScript | 5.x | | Estilo | CSS custom (pixel art design system) | — | | Fonte | VT323 (Google Fonts) | — | | Backend | Next.js API Routes + SSE | — | | Busca | MiniSearch (BM25) | — | | Agentes | Cursor Agent CLI + ACP | latest | | Protocolo | ACP (JSON-RPC 2.0 / stdio) | v1 | | Parsing | yaml (npm) | 2.8.x | | Framework de Agentes | BMAD Method | — |

Inicio Rapido

Pre-requisitos

| Requisito | Obrigatorio | Notas | |-----------|-------------|-------| | Node.js >= 18 | Sim | node --version | | BMAD Framework | Sim | Ver Guia de Instalacao | | Cursor IDE | Sim | Gera o Cursor Agent CLI na primeira abertura | | Git | Sim | — |

Plataformas suportadas: Windows 10/11, macOS, Linux

Instalacao

Opcao 1 — Um comando (recomendado):

npx aiteam-x@latest

Cria o projeto no diretorio atual (deve estar vazio). Ou especifique o nome da pasta:

npx aiteam-x@latest meu-projeto

O comando baixa o template, instala dependencias, executa o wizard de configuracao e inicia o servidor automaticamente.

Opcao 2 — Instalacao manual:

# 1. Clonar o repositorio
git clone https://github.com/INOSX/AITeam.git
cd AITeam

# 2. Instalar dependencias
npm install

# 3. Executar wizard de configuracao
npm run setup

# 4. Iniciar o servidor de desenvolvimento
npm run dev

O painel estara disponivel em http://localhost:3000.

Se o setup nao foi concluido, o sistema redireciona automaticamente para http://localhost:3000/setup — um wizard animado que detecta o ambiente, mostra o que esta pronto e permite configurar tudo pelo browser.

Alternativa CLI: npm run setup executa o wizard interativo no terminal.

Scripts Disponiveis

| Comando | Descricao | |---------|-----------| | npm run setup | Wizard interativo de configuracao (primeira instalacao) | | npm run dev | Inicia o servidor de desenvolvimento (porta 3000) | | npm run build | Gera o build de producao | | npm run start | Inicia o servidor de producao | | npm run lint | Executa o linter (ESLint) |

Scripts Utilitarios

| Script | Descricao | |--------|-----------| | node scripts/extract-memories.mjs --all | Extrai memorias de conversas historicas via LLM | | node scripts/extract-memories.mjs --agent bmad-master | Extrai memorias de um agente especifico | | node scripts/extract-memories.mjs --all --dry-run | Simula extracao sem salvar | | node scripts/import-conversations.mjs | Importa historico de conversas para o vault |

Todos os scripts requerem o servidor rodando em localhost:3000.

Estrutura do Projeto

AITeam/
├── app/                          # Next.js App Router
│   ├── api/                      # API Routes (backend)
│   │   ├── acp/
│   │   │   └── models/route.ts   # GET: modelos disponiveis via ACP
│   │   ├── agents/
│   │   │   ├── route.ts          # GET: lista agentes com status
│   │   │   ├── command/route.ts  # POST: envia comando via SSE (CLI ou ACP)
│   │   │   └── menus/route.ts    # GET: menus de contexto dos agentes
│   │   ├── bridge/route.ts       # GET: health check do ACP
│   │   ├── config/route.ts       # GET: configuracao BMAD
│   │   ├── memory/
│   │   │   ├── route.ts          # GET/POST: memoria e conversas (legado)
│   │   │   ├── vault/route.ts    # GET/POST/PUT/DELETE: vault estruturado
│   │   │   ├── search/route.ts   # GET: busca BM25
│   │   │   ├── checkpoint/route.ts # POST: checkpoint de sessao
│   │   │   ├── sleep/route.ts    # POST: encerra sessao + enfileira extracao LLM
│   │   │   └── extract/route.ts  # POST: trigger manual de extracao LLM
│   │   ├── session/
│   │   │   ├── route.ts          # GET/POST: sessao ativa
│   │   │   └── stream/route.ts   # GET: SSE de mudancas de sessao
│   │   ├── sprint/route.ts       # GET/POST: status do sprint
│   │   └── workflows/route.ts    # GET: workflows disponiveis
│   ├── actions/
│   │   └── setup-save.ts         # Server Action: salva aiteam.config.json
│   ├── setup/
│   │   ├── page.tsx              # Pagina de setup (health gate + Server Component)
│   │   └── SetupWizard.tsx       # Wizard animado 3 fases (Client Component)
│   ├── globals.css               # Design system pixel art (800+ linhas)
│   ├── layout.tsx                # Root layout (VT323, pt-BR)
│   ├── error.tsx                 # Error boundary
│   └── page.tsx                  # Pagina principal (health gate)
│
├── components/                   # Componentes React
│   ├── rooms/                    # Salas do escritorio virtual
│   │   ├── ConferenceRoom.tsx
│   │   ├── JarvisOffice.tsx
│   │   └── Kitchen.tsx
│   ├── AgentContextMenu.tsx      # Menu de contexto por agente
│   ├── AgentsProvider.tsx        # Context Provider global
│   ├── CommandPopup.tsx          # Popup multi-agente
│   ├── CopyButton.tsx            # Botao copiar em respostas
│   ├── FilterContext.tsx         # Context de filtros (status + modulo)
│   ├── Layout.tsx                # Shell (TopBar + ModelBar + BottomBar)
│   ├── MainContent.tsx           # Orquestrador principal (~500 linhas)
│   ├── MarkdownRenderer.tsx      # Renderer custom de Markdown
│   ├── MemoryVault.tsx           # Dashboard do Memory Vault (modal)
│   ├── ModelBar.tsx              # Barra de selecao de modelo e filtros
│   ├── PixelAvatar.tsx           # Avatar SVG pixel art
│   ├── SpeechBubbleOverlay.tsx   # Sistema de chat overlay
│   ├── ThinkingBubble.tsx        # Indicador de pensamento animado
│   ├── WorkspaceCell.tsx         # Celula de workspace individual
│   └── WorkspaceGrid.tsx         # Grid de workspaces
│
├── lib/                          # Logica de negocio e utilitarios
│   ├── acp-client.ts             # Cliente ACP (JSON-RPC 2.0 over stdio)
│   ├── acp-manager.ts            # Gerenciador de sessoes ACP
│   ├── aiteam-config.ts          # Config loader (env var > arquivo > defaults)
│   ├── health.ts                 # Health check: BMAD, Cursor CLI, config
│   ├── setup-discovery.ts        # Discovery ampliado para o wizard web
│   ├── bmad/                     # Integracao BMAD
│   │   ├── discovery.ts          # Scanner dinamico BMAD + deteccao Cursor CLI
│   │   ├── agent-mapping.ts      # Mapeamento BmadAgent -> Agent
│   │   ├── chat-sessions.ts      # Persistencia de sessoes de chat
│   │   ├── parse-agents.ts       # Parser do agent-manifest.csv
│   │   ├── parse-config.ts       # Parser do config.yaml
│   │   ├── parse-persona.ts      # Parser de persona (.mdc)
│   │   ├── parse-session.ts      # Estado de sessao + SSE
│   │   ├── parse-sprint.ts       # Parser do sprint-status.yaml
│   │   └── parse-workflows.ts    # Parser de workflows
│   ├── memory/                   # Sistema de memoria v2
│   │   ├── extract.ts            # Motor de extracao LLM
│   │   ├── inject.ts             # Injecao de contexto (BM25 + budget)
│   │   ├── session.ts            # Ciclo de vida de sessao (sleep/recover)
│   │   ├── types.ts              # Tipos do sistema de memoria
│   │   └── vault.ts              # CRUD do vault estruturado
│   ├── model-config.ts           # Opcoes de modelos LLM disponiveis
│   └── types.ts                  # Tipos TypeScript globais
│
├── .memory/                      # Memory Bank (persistente, gitignored)
│   ├── _project.md               # Contexto global — injetado em todos agentes
│   ├── {agent-id}.md             # Memory bank individual por agente
│   ├── conversations/            # Historico de conversas (JSON)
│   └── .vault/                   # Vault estruturado e fila de extracao
│
├── docs/                         # Documentacao do projeto
│   ├── screenshots/              # Screenshots da interface
│   ├── installation-guide.md     # Guia completo de instalacao
│   ├── architecture.md           # Arquitetura do sistema
│   ├── api-reference.md          # Referencia completa da API
│   ├── developer-guide.md        # Guia do desenvolvedor
│   ├── user-guide.md             # Guia do usuario final
│   ├── memory-system.md          # Arquitetura tecnica do sistema de memoria
│   ├── memory-system-guide.md    # Guia funcional do sistema de memoria
│   ├── agent-catalog.md          # Catalogo completo dos agentes BMAD
│   └── sprint-status.yaml        # Status do sprint atual
│
├── scripts/                      # Scripts utilitarios
│   ├── setup.mjs                 # Wizard de configuracao interativo (6 passos)
│   ├── extract-memories.mjs      # Extracao em lote via LLM
│   └── import-conversations.mjs  # Importacao de historico para o vault
│
├── aiteam.config.example.json    # Exemplo de configuracao (referencia)
├── .cursor/                      # Regras e skills do Cursor IDE
│   └── rules/bmad/               # Regras BMAD (.mdc): agentes e workflows
│
├── package.json
├── tsconfig.json
├── next.config.ts
└── .gitignore

Documentacao

| Documento | Nivel | Descricao | |-----------|-------|-----------| | Guia de Instalacao | Iniciante | Instalacao passo a passo, wizard de setup, solucao de problemas | | Arquitetura | Tecnico/Arquitetural | Diagramas, fluxos de dados, decisoes de design | | Referencia da API | Tecnico | Endpoints, parametros, exemplos de request/response | | Guia do Desenvolvedor | Desenvolvedor | Setup, convencoes, como contribuir | | Guia do Usuario | Usuario Final | Como usar o painel, interagir com agentes, Memory Vault | | Sistema de Memoria (tecnico) | Tecnico/Conceitual | Arquitetura em camadas do sistema de memoria | | Guia de Memoria (funcional) | Usuario Final | Como usar o Memory Vault, estudos de caso, boas praticas | | Catalogo de Agentes | Referencia | Todos os agentes, especialidades e como trabalhar com cada um |

Agentes BMAD

O sistema descobre agentes automaticamente a partir do bmad/_cfg/agent-manifest.csv. A instalacao padrao inclui 14 agentes:

| Persona | Papel | Modulo | |---------|-------|--------| | BMad Master | Orquestrador principal, custodio de conhecimento | core | | BMad Builder | Criacao de modulos, agentes e workflows BMAD | core | | Mary | Business Analyst — pesquisa e requisitos de negocio | bmm | | John | Product Manager — PRD, epicos, gestao de produto | bmm | | Winston | Architect — arquitetura de sistemas e tech spec | bmm | | Sally | UX Designer — design de experiencia e interface | bmm | | Bob | Scrum Master — sprint planning e revisao de codigo | bmm | | Amelia | Developer — implementacao de stories e features | bmm | | Murat | Test Architect — estrategia e design de testes | bmm | | Paige | Tech Writer — documentacao tecnica e knowledge | bmm | | Cloud Dragonborn | Game Architect — arquitetura e sistemas de jogo | bmgd | | Samus Shepard | Game Designer — GDD, narrativa e design de jogo | bmgd | | Link Freeman | Game Developer — implementacao de jogo | bmgd | | Max | Game Scrum Master — gestao agil para game dev | bmgd |

Consulte o Catalogo de Agentes para detalhes sobre especialidades e comandos de cada agente.

Configuracao

O AITEAM-X usa um arquivo aiteam.config.json local (gitignored) gerado pelo npm run setup. Para configuracao avancada, crie um .env.local:

# Caminho alternativo para a instalacao BMAD
# Util para: BMAD em outro diretorio, CI/CD, multiplos projetos
AITEAM_BMAD_ROOT=/caminho/para/seu/projeto-bmad

# Sobrescreve o diretorio de memoria (util para testes)
MEMORY_DIR_OVERRIDE=/caminho/customizado/.memory

Prioridade de configuracao para bmadRoot:

AITEAM_BMAD_ROOT (env var)  >  aiteam.config.json  >  "./" (padrao)

Consulte o Guia de Instalacao para todos os cenarios de configuracao.

Contribuindo

1. Crie uma branch a partir de develop
2. Faca suas alteracoes seguindo as convencoes do projeto
3. Certifique-se de que npm run lint e npm run build passam
4. Abra um Pull Request para develop

Consulte o Guia do Desenvolvedor para detalhes.

Licenca

Este projeto e distribuido sob a licenca MIT. Veja LICENSE para detalhes.

Autor

Mario Mayerle (MaMFLux) — INOSX

Construido com o BMAD Method — onde agentes de IA trabalham como um time.