AITEAM-X

Painel visual em estilo pixel art para orquestrar e monitorar agentes de IA (AITEAM-X) em tempo real.

npx aiteam-x@latest

Visão Geral

O AITEAM-X é um dashboard interativo que transforma a gestão de agentes de IA em uma experiência visual e intuitiva. Inspirado em jogos de simulação tipo sim manager, o painel exibe agentes como personagens pixel art em um escritório virtual, permitindo:

• Visualizar o status e a localização de cada agente em tempo real no escritório virtual 2D (pixel art)
• Personalizar a experiência com 4 temas visuais (Pixel Bots, Chibi, Hybrid, Teams) — cada um com paleta e avatares distintos
• Interagir diretamente com agentes através de um chat drawer lateral redimensionável com streaming SSE
• Criar salas customizadas para agrupar agentes em contextos específicos de trabalho
• Revisar diffs de arquivos modificados por agentes com aprovação/rejeição inline antes de persistir alterações
• Orquestrar workflows como Party Mode e brainstorming sessions via painel de workflows
• Monitorar métricas de uso via Quest Log gamificado (mensagens, tokens in/out) e visualizar tool calls em tempo real
• Observar saúde da plataforma e eventos recentes na página Observabilidade (menu Ajuda → 📡): snapshot via API, log JSONL em .aiteam/, captura opcional da consola do browser (dev / localhost)
• Persistir contexto e memórias entre sessões de trabalho com extração via LLM, compactação e migração automáticas
• Atualizar a plataforma com um clique via self-update integrado (check, download, merge, restart)

O projeto carrega definições de agentes a partir do pacote em aiteam-x-agents/ no projeto, integrando-se nativamente com o Cursor Agent CLI e o Cursor ACP (Agent Client Protocol) para comunicação bidirecional com LLMs.

Screenshots

Dashboard Principal

Escritório 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 memórias por agente. Categorias: decisions, lessons, tasks, projects, handoffs. Busca BM25 em tempo real.

Filtros de Agentes

Filtros de Status (Todos / Trabalhando) e Módulo (BMGD / BMM / CORE) para visualização segmentada dos agentes.

Funcionalidades Principais

Dashboard Pixel Art (2D)

• Sidebar colapsável: navegação lateral com agentes organizados por módulo, salas customizadas e indicadores de status em tempo real
• Salas compartilhadas: Jarvis Office, Kitchen — com contexto de atividade dos agentes
• Grid de workspaces individuais por agente com indicadores de módulo (BMGD / BMM / CORE / BMB)
• Avatares pixel art ou image-based (dependendo do tema) 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 (2D)
• Starfield Canvas: animação de fundo com partículas estelares como efeito visual decorativo

Interação com Agentes

• Seleção de agente (click) ou multi-seleção (Ctrl+click) para comandos em lote
• Chat Drawer lateral: painel redimensionável fixo à direita com streaming SSE em tempo real (substituiu janelas flutuantes)
• Histórico de input por agente (↑ para navegar comandos anteriores)
• Rich Message Rendering: respostas segmentadas em Markdown, blocos de terminal, indicadores de tool call e blocos de thinking colapsáveis
• Thinking Block: visualização expansível do raciocínio interno do modelo (pensamento em cadeia)
• Tool Call Indicators: badges em tempo real mostrando ações do agente (Read, Edit, Terminal, Grep, etc.) com resumos contextuais
• Botão 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
• Botão de stop para cancelar processamento em andamento
• Histórico de conversa persistido entre reloads
• Atalho Escape para fechar o drawer

Diff Approval (Revisão de Alterações)

• Snapshot pré-comando: o sistema captura o estado dos arquivos antes de cada comando do agente e compara após a resposta, detectando alterações com precisão
• Diff inline no chat: cards de diff unificado aparecem diretamente na conversa do agente com syntax highlighting por linha (adições, remoções, contexto)
• Aprovação granular: botões Aprovar/Negar por arquivo individual, ou "Aprovar Todas" para aceitar em lote
• Revert automático: arquivos negados são revertidos ao conteúdo original via /api/files/revert
• Contadores visuais de linhas adicionadas/removidas por arquivo e badges de status (Aprovado / Revertido)

Sistema de Temas

• 4 temas visuais: Pixel Bots (cyberpunk), Chibi (anime), Hybrid (tech), Teams (corporativo)
• Avatares dinâmicos: temas Chibi e Hybrid usam avatares image-based; Pixel Bots e Teams usam SVG pixel art
• ThemePicker: seletor visual com preview de cores e ícone por tema
• Persistência: tema selecionado salvo em localStorage e aplicado via CSS custom properties

Chat Rooms (Salas Customizadas)

• Criação livre: agrupe qualquer combinação de agentes em salas temáticas via CreateRoomModal
• Sidebar integrada: salas aparecem na barra lateral com ícone e lista de membros
• RoomTransition: animação suave de transição ao alternar entre salas
• Persistência via API: salas salvas no servidor (/api/rooms) e sincronizadas entre reloads

Quest Log (Registro de Atividades)

• Painel gamificado: visualização estilo RPG das atividades de cada agente
• Status por agente: ativo (em conversa), completo (última sessão), idle (sem atividade)
• Métricas: contagem de mensagens, tokens consumidos e última mensagem enviada
• Avatar inline: cada quest exibe o avatar pixel art do agente correspondente

Seletor de Modelo e Filtros

• Model Bar: seleção do modelo LLM aplicado a todos os agentes
• Cursor ACP: submenu dinâmico que lista todos os modelos disponíveis 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 Módulo: BMGD / BMM / CORE — segmenta agentes por área de atuação

Cursor ACP (Agent Client Protocol)

• Comunicação direta com o Cursor via JSON-RPC 2.0 sobre stdio (agent acp)
• Descoberta automática de modelos disponíveis via configOptions da sessão ACP
• Troca de modelo por sessão via session/set_config_option
• Processo ACP persistente com sessões de 30 min e reconexão automática
• Streaming de tool calls com metadados ricos (tipo, título, output resumido)
• Fallback de erro com mensagens acionáveis para o usuário

Orquestração de agentes

• Detecção automática de Party Mode e workflows ativos
• Agentes se movem dinamicamente para salas conforme o workflow
• Sessão de estado persistida em disco e sincronizada via SSE
• Métricas de mensagens e tokens por agente

Sistema de Memória Persistente (v2.2)

• Memory Vault: painel visual completo com 5 categorias (decisions, lessons, tasks, projects, handoffs)
• Auto-extract via LLM: ao fechar uma sessão, o sistema analisa a conversa e extrai memórias estruturadas automaticamente
• Badge 🤖 llm: entradas extraídas automaticamente ficam marcadas por 10 minutos com opção de veto
• Busca BM25: busca semântica por relevância dentro do vault de cada agente
• Injeção de contexto: memórias relevantes injetadas automaticamente ao iniciar novas sessões (budget de 2.000 tokens)
• Compactação automática: /api/memory/compact limpa checkpoints antigos, mescla entradas duplicadas e reconstrói índices
• Migração de dados: /api/memory/migrate atualiza estruturas de dados de versões anteriores automaticamente
• Auto-save: conversas salvas a cada 30s + save on unload via sendBeacon
• Checkpoint de sessão: histórico preservado mesmo em reinícios inesperados
• Memória compartilhada: _project.md injetado em todos os agentes como contexto global

Self-Update Integrado

• Verificação automática: /api/version/check compara a versão local com o NPM registry
• UpdateModal: interface step-by-step com progresso visual (download → merge → install → restart)
• Merge inteligente: atualiza apenas arquivos do template sem sobrescrever configurações locais
• Restart automático: reinicia o servidor de desenvolvimento após a atualização

Notificações e Easter Eggs

• Event Toast: sistema de notificações visuais com 4 tipos (success, error, info, milestone) e auto-dismiss
• Easter Eggs: interações escondidas no escritório virtual (geladeira, máquina de café e outros) com raridades (common, rare, legendary)
• Sound system: efeitos sonoros opcionais para interações e descobertas

Portabilidade e Instalação (v1.0)

• Discovery dinâmico: detecta agentes 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 máquina, revisão, configuração passo a passo
• Wizard de setup CLI: npm run setup — alternativa interativa no terminal (6 passos)
• Health gate: se não configurado, redireciona para /setup automaticamente
• Config flexível: aiteam.config.json local + AITEAM_AGENTS_ROOT ou AITEAM_BMAD_ROOT para instâncias externas/CI

Stack Tecnológico

| Camada | Tecnologia | Versão | |--------|-----------|--------| | Framework | Next.js (App Router) | 15.x | | UI | React | 19.x | | Linguagem | TypeScript | 5.x | | Estilo | CSS custom (design system com 4 temas) | — | | Fonte | VT323 (Google Fonts) | — | | Backend | Next.js API Routes + SSE (23 route handlers) | — | | Diff Engine | diff (npm) | 8.x | | Busca | MiniSearch (BM25) | 7.2.x | | Agentes | Cursor Agent CLI + ACP | latest | | Protocolo | ACP (JSON-RPC 2.0 / stdio) | v1 | | Parsing | yaml (npm) | 2.8.x | | Testes | Vitest + v8 coverage | 4.x | | Pacote de agentes | aiteam-x-agents/ + manifests | — |

Início Rápido

Pré-requisitos

| Requisito | Obrigatório | Notas | |-----------|-------------|-------| | Node.js >= 18 | Sim | node --version | | Pasta aiteam-x-agents/ (pacote de agentes) | Sim | Ver Guia de Instalação | | Cursor IDE | Sim | Gera o Cursor Agent CLI na primeira abertura | | Git | Sim | — |

Plataformas suportadas: Windows 10/11, macOS, Linux

Instalação

Opção 1 — Um comando (recomendado):

npx aiteam-x@latest

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

npx aiteam-x@latest meu-projeto

O comando baixa o template, instala dependências, executa o wizard de configuração e inicia o servidor automaticamente.

Opção 2 — Instalação manual:

# 1. Clonar o repositório
git clone https://github.com/INOSX/AITeam.git
cd AITeam

# 2. Instalar dependências
npm install

# 3. Executar wizard de configuração
npm run setup

# 4. Iniciar o servidor de desenvolvimento
npm run dev

O painel estará disponível em http://localhost:3000.

Se o setup não foi concluído, o sistema redireciona automaticamente para http://localhost:3000/setup — um wizard animado que detecta o ambiente, mostra o que está pronto e permite configurar tudo pelo browser.

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

Scripts Disponíveis

| Comando | Descrição | |---------|-----------| | npm run setup | Wizard interativo de configuração (primeira instalação) | | npm run dev | Inicia o servidor de desenvolvimento (porta 3000) | | npm run dev:clean | Inicia com limpeza de cache (resolve problemas de estado) | | npm run build | Gera o build de produção (com validações pré-build) | | npm run start | Inicia o servidor de produção | | npm run lint | Executa o linter (ESLint) | | npm run test | Executa testes com Vitest | | npm run test:watch | Testes em modo watch (re-executa ao salvar) |

Scripts Utilitários

| Script | Descrição | |--------|-----------| | node scripts/import-conversations.mjs | Importa histórico de conversas para o vault | | node scripts/generate-chibi-logo.mjs | Gera assets de logo no estilo chibi | | node scripts/crop-avatars.mjs | Recorta avatares para temas com imagens |

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

Docker (Microserviços)

A aplicação pode rodar em containers Docker com 4 serviços separados:

| Serviço | Porta | Descrição | |---------|-------|-----------| | nginx | 80 | Reverse proxy / API gateway (ponto único de entrada) | | web | 3000 | Next.js UI (SSR + assets estáticos) | | agent-api | 3001 | API de agentes (Express) — Cursor CLI, ACP, terminal | | memory-api | 3002 | API de memória (Express) — conversations, vault, sprint, config |

# Subir todos os serviços
npm run docker:up

# Ver logs em tempo real
npm run docker:logs

# Parar todos os serviços
npm run docker:down

# Rebuild completo (sem cache)
npm run docker:rebuild

O Nginx roteia automaticamente por path: /api/agents/*, /api/acp/*, /api/bridge, /api/terminal/* vão para o agent-api; /api/memory/*, /api/session/*, /api/sprint, /api/config (YAML do pacote no memory-api), /api/workflows, /api/rooms/*, /api/files/* vão para o memory-api; o restante (incl. /api/aiteam-config no Next.js) fica no front. Rotas SSE (/api/agents/command, /api/session/stream) têm buffering desabilitado.

Estrutura do Projeto

AITEAM-X/
├── app/                          # Next.js App Router
│   ├── api/                      # API Routes (backend) — 23 route handlers
│   │   ├── acp/
│   │   │   └── models/route.ts   # GET: modelos disponíveis via ACP
│   │   ├── agents/
│   │   │   ├── route.ts          # GET: lista agentes com status
│   │   │   ├── command/route.ts  # POST: envia comando via SSE (CLI ou ACP) + file diffs
│   │   │   └── menus/route.ts    # GET: menus de contexto dos agentes
│   │   ├── bridge/route.ts       # GET: health check do ACP
│   │   ├── aiteam-config/route.ts # GET: flags da app (ex.: provider APIs)
│   │   ├── files/
│   │   │   └── revert/route.ts   # POST: reverte arquivo ao conteúdo original (diff denial)
│   │   ├── memory/
│   │   │   ├── route.ts          # GET/POST: memória e conversas (legado)
│   │   │   ├── vault/route.ts    # GET/POST/PUT/DELETE: vault estruturado
│   │   │   ├── search/route.ts   # GET: busca BM25
│   │   │   ├── checkpoint/route.ts # POST: checkpoint de sessão
│   │   │   ├── compact/route.ts  # POST: compactação de dados (limpeza + merge + reindex)
│   │   │   └── migrate/route.ts  # POST: migração de estruturas de versões anteriores
│   │   ├── rooms/route.ts        # GET/POST: salas customizadas de agentes
│   │   ├── session/
│   │   │   ├── route.ts          # GET/POST: sessão ativa
│   │   │   └── stream/route.ts   # GET: SSE de mudanças de sessão
│   │   ├── sprint/route.ts       # GET/POST: status do sprint
│   │   ├── terminal/
│   │   │   └── execute/route.ts  # POST: execução de comandos no terminal
│   │   ├── version/
│   │   │   ├── check/route.ts    # GET: verifica versão mais recente no NPM
│   │   │   ├── update/route.ts   # POST: SSE download + merge + install
│   │   │   └── restart/route.ts  # POST: reinicia o servidor dev
│   │   └── workflows/route.ts    # GET: workflows disponíveis
│   ├── actions/
│   │   └── setup-save.ts         # Server Action: salva aiteam.config.json
│   ├── setup/
│   │   ├── page.tsx              # Página de setup (health gate + Server Component)
│   │   └── SetupWizard.tsx       # Wizard animado 3 fases (Client Component)
│   ├── globals.css               # Design system com 4 temas (800+ linhas)
│   ├── layout.tsx                # Root layout (VT323, pt-BR)
│   ├── error.tsx                 # Error boundary
│   └── page.tsx                  # Página principal (health gate)
│
├── components/                   # Componentes React (~49 arquivos)
│   ├── rooms/                    # Salas do escritório virtual (2D)
│   │   ├── ConferenceRoom.tsx
│   │   ├── JarvisOffice.tsx
│   │   └── Kitchen.tsx
│   ├── AgentContextMenu.tsx      # Menu de contexto por agente
│   ├── AgentDetail.tsx           # Visão detalhada de um agente
│   ├── AgentListItem.tsx         # Item de lista na sidebar
│   ├── AgentsProvider.tsx        # Context Provider global
│   ├── BottomBar.tsx             # Barra inferior com avatares e sprint
│   ├── ChatDrawer.tsx            # Chat drawer lateral redimensionável + diff inline
│   ├── CommandPopup.tsx          # Popup multi-agente
│   ├── CopyButton.tsx            # Botão copiar em respostas
│   ├── CreateRoomModal.tsx       # Modal para criar salas customizadas
│   ├── DayNightCycle.tsx         # Ciclo dia/noite (2D)
│   ├── DiffViewer.tsx            # Diff viewer com aprovação/rejeição inline
│   ├── EasterEggs.tsx            # Interações escondidas no escritório
│   ├── EventToast.tsx            # Sistema de notificações toast
│   ├── FilterContext.tsx         # Context de filtros (status + módulo)
│   ├── Layout.tsx                # Shell principal
│   ├── MainContent.tsx           # Orquestrador principal
│   ├── MarkdownRenderer.tsx      # Renderer custom de Markdown
│   ├── MemoryVault.tsx           # Dashboard do Memory Vault (modal)
│   ├── MessageRenderer.tsx       # Renderer segmentado (MD, terminal, tools, thinking)
│   ├── ModelBar.tsx              # Barra de seleção de modelo e filtros
│   ├── PixelAvatar.tsx           # Avatar SVG pixel art / image-based
│   ├── QuestLog.tsx              # Painel gamificado de atividades dos agentes
│   ├── RoomTransition.tsx        # Animação de transição entre salas
│   ├── Sidebar.tsx               # Barra lateral colapsável (agentes + salas)
│   ├── SpeechBubble.tsx          # Balão de fala individual
│   ├── SpeechBubbleOverlay.tsx   # Sistema de chat overlay
│   ├── SprintPanel.tsx           # Painel dedicado do sprint
│   ├── StarfieldCanvas.tsx       # Animação de fundo com partículas estelares
│   ├── TerminalBlock.tsx         # Bloco de terminal nas respostas
│   ├── ThemePicker.tsx           # Seletor visual de temas
│   ├── ThemeProvider.tsx         # Context provider de temas
│   ├── ThinkingBlock.tsx         # Bloco colapsável de raciocínio (thinking)
│   ├── ThinkingBubble.tsx        # Indicador de pensamento animado
│   ├── ToolCallIndicator.tsx     # Badge de tool call em tempo real
│   ├── TopBar.tsx                # Barra superior com título e controles
│   ├── UpdateModal.tsx           # Modal de self-update com progresso step-by-step
│   ├── WorkflowPanel.tsx         # Painel de workflows com filtro por módulo
│   ├── WorkspaceCell.tsx         # Célula de workspace individual
│   ├── WorkspaceGrid.tsx         # Grid de workspaces
│   └── WorkspaceProps.tsx        # Props compartilhadas dos workspaces
│
├── lib/                          # Lógica de negócio e utilitários
│   ├── acp-client.ts             # Cliente ACP (JSON-RPC 2.0 over stdio)
│   ├── acp-manager.ts            # Gerenciador de sessões ACP
│   ├── aiteam-config.ts          # Config loader (env var > arquivo > defaults)
│   ├── diff.ts                   # Unified diff engine (computeUnifiedDiff)
│   ├── health.ts                 # Health check: pacote de agentes, Cursor CLI, config
│   ├── mock-agents.ts            # Dados mock para testes e preview
│   ├── model-config.ts           # Opções de modelos LLM disponíveis
│   ├── parseMultiAgentResponse.ts # Parser de respostas multi-agente
│   ├── setup-discovery.ts        # Discovery ampliado para o wizard web
│   ├── sound.ts                  # Sistema de efeitos sonoros
│   ├── synergy.ts                # Lógica de sinergia entre agentes
│   ├── theme.ts                  # Definições de temas (4 temas + metadados)
│   ├── types.ts                  # Tipos TypeScript globais
│   ├── useAgents.ts              # Hook de gerenciamento de agentes
│   ├── version.ts                # Verificação de versão (NPM registry)
│   ├── bmad/                     # Parsers TS (`lib/bmad/`); pacote em disco: `aiteam-x-agents/`
│   │   ├── discovery.ts          # Scanner do pack + detecção Cursor CLI
│   │   ├── agent-mapping.ts      # Mapeamento de manifest → Agent
│   │   ├── chat-sessions.ts      # Persistência de sessões de chat
│   │   ├── memory-bank.ts        # Integração com memory bank
│   │   ├── 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 sessão + SSE
│   │   ├── parse-sprint.ts       # Parser do sprint-status.yaml
│   │   └── parse-workflows.ts    # Parser de workflows
│   └── memory/                   # Sistema de memória v2.2
│       ├── compact.ts            # Compactação e limpeza de dados
│       ├── inject.ts             # Injeção de contexto (BM25 + budget)
│       ├── migrate.ts            # Migração de estruturas entre versões
│       ├── search.ts             # Motor de busca BM25
│       ├── session.ts            # Ciclo de vida de sessão (sleep/recover)
│       ├── types.ts              # Tipos do sistema de memória
│       ├── vault.ts              # CRUD do vault estruturado
│       └── __tests__/            # Testes unitários (Vitest)
│           ├── inject.test.ts
│           ├── session.test.ts
│           ├── vault.test.ts
│           ├── search.test.ts
│           └── migrate.test.ts
│
├── .memory/                      # Memory Bank (persistente, gitignored)
│   ├── _project.md               # Contexto global — injetado em todos agentes
│   ├── {agent-id}.md             # Memory bank individual por agente
│   ├── conversations/            # Histórico de conversas (JSON)
│   └── .vault/                   # Vault estruturado e fila de extração
│
├── docs/                         # Documentação do projeto
│   ├── index.md                  # Índice principal da documentação
│   ├── screenshots/              # Screenshots da interface
│   ├── project-overview-aiteam-x.md  # Visão geral do projeto (gerado)
│   ├── architecture-aiteam-x.md      # Arquitetura detalhada (gerado)
│   ├── api-contracts-aiteam-x.md     # Contratos de API — 23 route handlers (gerado)
│   ├── component-inventory-aiteam-x.md # Inventário de componentes (gerado)
│   ├── development-guide-aiteam-x.md  # Guia de desenvolvimento (gerado)
│   ├── source-tree-analysis.md        # Análise da árvore de código (gerado)
│   ├── installation-guide.md     # Guia completo de instalação
│   ├── architecture.md           # Atalho → architecture-aiteam-x.md
│   ├── api-reference.md          # Atalho → api-contracts-aiteam-x.md
│   ├── developer-guide.md        # Atalho → development-guide-aiteam-x.md
│   ├── user-guide.md             # Guia do usuário final
│   ├── memory-system.md          # Arquitetura técnica do sistema de memória
│   ├── memory-system-guide.md    # Guia funcional do sistema de memória
│   ├── memory-system-comparison.md # Análise comparativa de sistemas de memória
│   ├── agent-catalog.md          # Catálogo completo dos agentes
│   ├── sprint-status.yaml        # Status do sprint atual
│   └── superpowers/              # Features futuras (specs + planos)
│       ├── specs/                # Design documents
│       └── plans/                # Planos de implementação
│
├── hooks/                         # React hooks customizados
│   └── useVersionCheck.ts        # Hook de verificação de versão (NPM registry)
│
├── scripts/                      # Scripts utilitários
│   ├── setup.mjs                 # Wizard de configuração interativo (6 passos)
│   ├── cli.mjs                   # CLI para npx aiteam-x (entry point do pacote)
│   ├── safe-build.mjs            # Build seguro com validações pré-build
│   ├── clean-start.mjs           # Dev server com limpeza de cache
│   ├── import-conversations.mjs  # Importação de histórico para o vault
│   ├── generate-chibi-logo.mjs   # Geração de logo chibi (assets)
│   └── crop-avatars.mjs          # Recorte de avatares para temas image-based
│
├── aiteam.config.example.json    # Exemplo de configuração (referência)
├── .cursor/                      # Regras e skills do Cursor IDE
│   └── rules/aiteam-x/               # Regras Cursor (.mdc): agentes e workflows do pack
│
├── package.json
├── tsconfig.json
├── next.config.ts
└── .gitignore

Documentação

Documentação Gerada (workflow document-project)

| Documento | Nível | Descrição | |-----------|-------|-----------| | Índice da Documentação | Todos | Ponto de entrada principal para toda a documentação | | Visão Geral do Projeto | Executivo | Resumo executivo, stack, métricas e funcionalidades | | Arquitetura Detalhada | Arquitetural | Padrões, decisões, diagramas e camadas | | Contratos de API | Técnico | 23 route handlers com schemas de request/response | | Inventário de Componentes | Técnico | ~47 componentes .tsx, hierarquia, estado e padrões | | Guia de Desenvolvimento | Desenvolvedor | Setup, comandos, convenções e troubleshooting | | Análise do Código-fonte | Técnico | Estrutura anotada com propósito de cada diretório |

Documentação Complementar

| Documento | Nível | Descrição | |-----------|-------|-----------| | Guia de Instalação | Iniciante | Instalação passo a passo, wizard de setup, solução de problemas | | Arquitetura (atalho) | — | Aponta para architecture-aiteam-x.md | | API (atalho) | — | Aponta para api-contracts-aiteam-x.md | | Dev (atalho) | — | Aponta para development-guide-aiteam-x.md | | Guia do Usuário | Usuário Final | Como usar o painel, interagir com agentes, Memory Vault | | Sistema de Memória (técnico) | Técnico/Conceitual | Arquitetura em camadas do sistema de memória | | Guia de Memória (funcional) | Usuário Final | Como usar o Memory Vault, estudos de caso, boas práticas | | Comparação de Sistemas | Técnico | Análise comparativa de sistemas de memória | | Catálogo de Agentes | Referência | Todos os agentes, especialidades e como trabalhar com cada um |

Agentes

O sistema descobre agentes automaticamente a partir do aiteam-x-agents/_cfg/agent-manifest.csv. A instalação padrão inclui 14 agentes:

| Persona | Papel | Módulo | |---------|-------|--------| | BMad Master | Orquestrador principal, custódio de conhecimento | core | | BMad Builder | Criação de módulos, agentes e workflows no pack | core | | Mary | Business Analyst — pesquisa e requisitos de negócio | bmm | | John | Product Manager — PRD, épicos, gestão de produto | bmm | | Winston | Architect — arquitetura de sistemas e tech spec | bmm | | Sally | UX Designer — design de experiência e interface | bmm | | Bob | Scrum Master — sprint planning e revisão de código | bmm | | Amelia | Developer — implementação de stories e features | bmm | | Murat | Test Architect — estratégia e design de testes | bmm | | Paige | Tech Writer — documentação técnica 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 — implementação de jogo | bmgd | | Max | Game Scrum Master — gestão ágil para game dev | bmgd |

Consulte o Catálogo de Agentes para detalhes sobre especialidades e comandos de cada agente.

Configuração

O AITEAM-X usa um arquivo aiteam.config.json local (gitignored) gerado pelo npm run setup. Para configuração avançada, crie um .env.local:

# Raiz do projeto que contém a pasta aiteam-x-agents/ (recomendado)
# Alternativa legada: AITEAM_BMAD_ROOT (mesmo efeito)
AITEAM_AGENTS_ROOT=/caminho/para/seu/projeto

# Sobrescreve o diretório de memória (útil para testes)
MEMORY_DIR_OVERRIDE=/caminho/customizado/.memory

Prioridade para agentsRoot (raiz do pacote):

AITEAM_AGENTS_ROOT ou AITEAM_BMAD_ROOT (env)  >  aiteam.config.json (`agentsRoot` ou legado `bmadRoot`)  >  "./"

Consulte o Guia de Instalação para todos os cenários de configuração.

Contribuindo

1. Faça um fork do repositório
2. Crie uma branch a partir de develop (git checkout -b feature/minha-feature develop)
3. Faça suas alterações seguindo as convenções do projeto
4. Certifique-se de que npm run lint e npm run build passam sem erros
5. Abra um Pull Request para develop

Reportar bugs ou sugerir melhorias? Abra uma issue no GitHub.

Consulte o Guia de Desenvolvimento e a Arquitetura para convenções, fluxo de trabalho e decisões técnicas.

Licença

Este projeto é distribuído sob a licença MIT. Veja LICENSE para detalhes.

Autor

Mario Mayerle (MaMFLux) — INOSX

AITEAM-X — onde agentes de IA trabalham como um time. | v0.14.5