Português | English
Painel visual em estilo pixel art para orquestrar e monitorar agentes de IA (AITEAM-X) em tempo real.
npx aiteam-x@latestO 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 2 temas visuais (Pixel Bots, 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.
Escritório virtual com Jarvis Office, Kitchen e workspaces individuais. Barra inferior com avatares e progresso do sprint (14/14 — 100%).
Janela de conversa com AITEAM-X Master em tempo real. Cada agente responde com streaming de texto e suporte a Markdown.
Painel de gerenciamento de memórias por agente. Categorias: decisions, lessons, tasks, projects, handoffs. Busca BM25 em tempo real.
Filtros de Status (Todos / Trabalhando) e Módulo (BMGD / BMM / CORE) para visualização segmentada dos agentes.
- 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)
- 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
- 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)
- 2 temas visuais: Pixel Bots (cyberpunk, padrão) e Teams (corporativo)
- ThemePicker: seletor visual com preview de cores e ícone por tema
- Persistência: tema selecionado salvo em
localStoragee aplicado via CSS custom properties
- 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
- 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
- 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
- Comunicação direta com o Cursor via JSON-RPC 2.0 sobre stdio (
agent acp) - Descoberta automática de modelos disponíveis via
configOptionsda 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
- 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
- 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/compactlimpa checkpoints antigos, mescla entradas duplicadas e reconstrói índices - Migração de dados:
/api/memory/migrateatualiza 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.mdinjetado em todos os agentes como contexto global
- Verificação automática:
/api/version/checkcompara 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
- 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
- Discovery dinâmico: detecta agentes automaticamente via CSV/YAML — sem hardcode
- Cross-platform: funciona em Windows, macOS e Linux
- Wizard de setup web:
/setupno browser — 3 fases animadas: scan da máquina, revisão, configuração passo a passo. Inclui seletor de modelo de IA, campo "Diretório de instalação" (nome do projeto derivado automaticamente) e configurações do usuário - Wizard de setup CLI:
npm run setup— alternativa interativa no terminal (6 passos) - Health gate: se não configurado, redireciona para
/setupautomaticamente - Config flexível:
aiteam.config.jsonlocal +AITEAM_AGENTS_ROOTouAITEAM_BMAD_ROOTpara instâncias externas/CI
- Wrapper Electron: aplicativo desktop nativo para Windows/macOS/Linux
- ProjectPathBar: barra estilo VS Code exibindo o caminho do projeto atual com ícone de pasta; atualiza o título da janela; visível apenas no modo Electron
- Menu nativo: Appearance > Theme exibe 2 opções (Pixel Bots, Teams); configurações de modelo e idioma movidas para a página de Preferências
- Dados por projeto: todos os dados do usuário (memória, conversas, docs, observabilidade) armazenados dentro da pasta do projeto escolhido
| 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 2 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 |
— |
| 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
Opção 1 — Um comando (recomendado):
npx aiteam-x@latestCria o projeto no diretório atual (deve estar vazio). Ou especifique o nome da pasta:
npx aiteam-x@latest meu-projetoO 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 devO 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 setupexecuta o wizard interativo no terminal.
| 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) |
| Script | Descrição |
|---|---|
node scripts/import-conversations.mjs |
Importa histórico de conversas para o vault |
node scripts/crop-avatars.mjs |
Recorta avatares para temas com imagens |
Todos os scripts requerem o servidor rodando em
localhost:3000.
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:rebuildO 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.
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 2 temas (Pixel Bots + Teams)
│ ├── 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
│ ├── ProjectPathBar.tsx # Barra de caminho do projeto estilo VS Code (somente Electron)
│ ├── 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 (2 temas: pixel-bots, teams)
│ ├── 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
│ └── 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| 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 |
| 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 |
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 |
|---|---|---|
| AITEAM-X Master | Orquestrador principal, custódio de conhecimento | core |
| AITEAM-X 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.
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/projetoPrioridade 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.
- Faça um fork do repositório
- Crie uma branch a partir de
develop(git checkout -b feature/minha-feature develop) - Faça suas alterações seguindo as convenções do projeto
- Certifique-se de que
npm run lintenpm run buildpassam sem erros - 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.
Este projeto é distribuído sob a licença MIT. Veja LICENSE para detalhes.
Mario Mayerle (MaMFLux) — INOSX
AITEAM-X — onde agentes de IA trabalham como um time. | v0.17.3