[{"data":1,"prerenderedAt":-1},["ShallowReactive",2],{"project-72714":3},{"id":4,"name":5,"fullName":6,"owner":7,"repo":5,"description":8,"homepage":9,"htmlUrl":10,"language":11,"languages":10,"totalLinesOfCode":10,"stars":12,"forks":13,"watchers":14,"openIssues":15,"contributorsCount":16,"subscribersCount":16,"size":16,"stars1d":17,"stars7d":18,"stars30d":19,"stars90d":16,"forks30d":16,"starsTrendScore":20,"compositeScore":21,"rankGlobal":10,"rankLanguage":10,"license":22,"archived":23,"fork":23,"defaultBranch":24,"hasWiki":25,"hasPages":23,"topics":26,"createdAt":10,"pushedAt":10,"updatedAt":39,"readmeContent":40,"aiSummary":41,"trendingCount":16,"starSnapshotCount":16,"syncStatus":42,"lastSyncTime":43,"discoverSource":44},72714,"aiox-core","SynkraAI\u002Faiox-core","SynkraAI","Synkra AIOS: AI-Orchestrated System for Full Stack Development - Core Framework v4.0","https:\u002F\u002Fgithub.com\u002Fallfluence\u002Faios-core",null,"JavaScript",2958,924,62,4,0,6,14,108,18,30.9,"Other",false,"main",true,[27,28,29,30,31,32,33,34,35,36,37,38],"agents","ai","ai-agents","automation","claude","cli","development","framework","fullstack","nodejs","orchestration","typescript","2026-06-12 02:03:07","# AIOX Squad: Artificial Intelligence Orchestration eXperience\n\n> 🌍 [English](README.en.md) | **[Português](README.md)**\n\n[![Versão NPM](https:\u002F\u002Fimg.shields.io\u002Fnpm\u002Fv\u002F@aiox-squads\u002Fcore.svg)](https:\u002F\u002Fwww.npmjs.com\u002Fpackage\u002F@aiox-squads\u002Fcore)\n[![Licença: MIT](https:\u002F\u002Fimg.shields.io\u002Fbadge\u002FLicense-MIT-yellow.svg)](LICENSE)\n[![Versão Node.js](https:\u002F\u002Fimg.shields.io\u002Fbadge\u002Fnode-%3E%3D18.0.0-brightgreen.svg)](https:\u002F\u002Fnodejs.org\u002F)\n[![CI](https:\u002F\u002Fgithub.com\u002FSynkraAI\u002Faiox-core\u002Factions\u002Fworkflows\u002Fci.yml\u002Fbadge.svg)](https:\u002F\u002Fgithub.com\u002FSynkraAI\u002Faiox-core\u002Factions\u002Fworkflows\u002Fci.yml)\n[![codecov](https:\u002F\u002Fcodecov.io\u002Fgh\u002FSynkraAI\u002Faiox-core\u002Fbranch\u002Fmain\u002Fgraph\u002Fbadge.svg)](https:\u002F\u002Fcodecov.io\u002Fgh\u002FSynkraAI\u002Faiox-core)\n[![Documentação](https:\u002F\u002Fimg.shields.io\u002Fbadge\u002Fdocs-disponível-orange.svg)](https:\u002F\u002Faioxsquad.ai)\n[![Open Source](https:\u002F\u002Fimg.shields.io\u002Fbadge\u002FOpen%20Source-Yes-success.svg)](LICENSE)\n[![Contributions Welcome](https:\u002F\u002Fimg.shields.io\u002Fbadge\u002Fcontributions-welcome-brightgreen.svg)](CONTRIBUTING.md)\n[![Code of Conduct](https:\u002F\u002Fimg.shields.io\u002Fbadge\u002Fcode%20of%20conduct-Contributor%20Covenant-blue.svg)](CODE_OF_CONDUCT.md)\n\n> 🌐 README por idioma: [EN](docs\u002FREADME.md) | [PT](docs\u002Fpt\u002FREADME.md) | [ES](docs\u002Fes\u002FREADME.md) | [ZH](docs\u002Fzh\u002FREADME.md)\n>\n> **Devolvendo às pessoas o poder de criar** — Framework open source de orquestração de IA que devolve o controle a quem tem coragem de construir. Agentes especializados, workflows e experiência CLI First para qualquer domínio.\n\n> **Novo namespace npm:** `@aiox-squads\u002Fcore` é o sucessor de `aiox-core` sem scope. O conteúdo é o mesmo framework AIOX; o novo namespace reflete a consolidação dos squads sob `@aiox-squads\u002F*`. Os comandos de CLI, incluindo `aiox-core`, permanecem preservados durante a transição.\n\n## Comece Aqui (10 Min)\n\nSe é sua primeira vez no AIOX, siga este caminho linear:\n\n1. Instale em um projeto novo ou existente:\n\n```bash\n# novo projeto\nnpx aiox-core init meu-projeto\n\n# projeto existente\ncd seu-projeto\nnpx aiox-core install\n```\n\n2. Escolha sua IDE\u002FCLI e o caminho de ativação:\n\n- Claude Code: `\u002Fagent-name`\n- Gemini CLI: `\u002Faiox-menu` → `\u002Faiox-\u003Cagent>`\n- Codex CLI: `\u002Fskills` → `aiox-\u003Cagent-id>`\n- Cursor\u002FCopilot\u002FAntiGravity: siga os limites e workarounds em `docs\u002Fide-integration.md`\n\n3. Ative 1 agente e confirme o greeting.\n4. Rode 1 comando inicial (`*help` ou equivalente) para validar first-value.\n\nDefinição de first-value (binária): ativação de agente + greeting válido + comando inicial com output útil em \u003C= 10 minutos.\n\n## Compatibilidade de Hooks por IDE (Realidade AIOX 4.2)\n\nMuitos recursos avançados do AIOX dependem de eventos de ciclo de vida (hooks). A tabela abaixo mostra a paridade real entre IDEs\u002Fplataformas:\n\n| IDE\u002FCLI        | Paridade de Hooks vs Claude      | Impacto Prático                                                                       |\n| -------------- | -------------------------------- | ------------------------------------------------------------------------------------- |\n| Claude Code    | Completa (referência)            | Automação máxima de contexto, guardrails e auditoria                                  |\n| Gemini CLI     | Alta (eventos nativos)           | Cobertura forte de automações pre\u002Fpost tool e sessão                                  |\n| Codex CLI      | Parcial\u002Flimitada                 | Parte das automações depende de `AGENTS.md`, `\u002Fskills`, MCP e fluxo operacional       |\n| Cursor         | Sem lifecycle hooks equivalentes | Menor automação de pre\u002Fpost tool; foco em regras, MCP e fluxo do agente               |\n| GitHub Copilot | Sem lifecycle hooks equivalentes | Menor automação de sessão\u002Ftooling; foco em instruções de repositório + MCP no VS Code |\n| AntiGravity    | Workflow-based (não hook-based)  | Integração por workflows, não por eventos de hook equivalentes ao Claude              |\n\nImpactos e mitigação detalhados: `docs\u002Fide-integration.md`.\n\n## Visão Geral\n\n### Premissa Arquitetural: CLI First\n\nO AIOX segue uma hierarquia clara de prioridades:\n\n```\nCLI First → Observability Second → UI Third\n```\n\n| Camada            | Prioridade | Foco                                                                          | Exemplos                                     |\n| ----------------- | ---------- | ----------------------------------------------------------------------------- | -------------------------------------------- |\n| **CLI**           | Máxima     | Onde a inteligência vive. Toda execução, decisões e automação acontecem aqui. | Agentes (`@dev`, `@qa`), workflows, comandos |\n| **Observability** | Secundária | Observar e monitorar o que acontece no CLI em tempo real.                     | Dashboard SSE, logs, métricas, timeline      |\n| **UI**            | Terciária  | Gestão pontual e visualizações quando necessário.                             | Kanban, settings, story management           |\n\n**Princípios derivados:**\n\n- A CLI é a fonte da verdade - dashboards apenas observam\n- Funcionalidades novas devem funcionar 100% via CLI antes de ter UI\n- A UI nunca deve ser requisito para operação do sistema\n- Observabilidade serve para entender o que o CLI está fazendo, não para controlá-lo\n\n---\n\n**As Duas Inovações Chave do AIOX:**\n\n**1. Planejamento Agêntico:** Agentes dedicados (analyst, pm, architect) colaboram com você para criar documentos de PRD e Arquitetura detalhados e consistentes. Através de engenharia avançada de prompts e refinamento com human-in-the-loop, estes agentes de planejamento produzem especificações abrangentes que vão muito além da geração genérica de tarefas de IA.\n\n**2. Desenvolvimento Contextualizado por Engenharia:** O agente sm (Scrum Master) então transforma estes planos detalhados em histórias de desenvolvimento hiperdetalhadas que contêm tudo que o agente dev precisa - contexto completo, detalhes de implementação e orientação arquitetural incorporada diretamente nos arquivos de histórias.\n\nEsta abordagem de duas fases elimina tanto a **inconsistência de planejamento** quanto a **perda de contexto** - os maiores problemas no desenvolvimento assistido por IA. Seu agente dev abre um arquivo de história com compreensão completa do que construir, como construir e por quê.\n\n**📖 [Veja o fluxo de trabalho completo no Guia do Usuário](docs\u002Fguides\u002Fuser-guide.md)** - Fase de planejamento, ciclo de desenvolvimento e todos os papéis dos agentes\n\n## Pré-requisitos\n\n- Node.js >=18.0.0 (v20+ recomendado)\n- npm >=9.0.0\n- GitHub CLI (opcional, necessário para colaboração em equipe)\n\n> **Problemas de instalação?** Consulte o [Guia de Troubleshooting](docs\u002Fguides\u002Finstallation-troubleshooting.md)\n\n**Guias específicos por plataforma:**\n\n- 📖 [Guia de Instalação para macOS](docs\u002Finstallation\u002Fmacos.md)\n- 📖 [Guia de Instalação para Windows](docs\u002Finstallation\u002Fwindows.md)\n- 📖 [Guia de Instalação para Linux](docs\u002Finstallation\u002Flinux.md)\n\n**Documentação multilíngue disponível:** [English](docs\u002FREADME.md) | [Português](docs\u002Fpt\u002FREADME.md) | [Español](docs\u002Fes\u002FREADME.md) | [中文](docs\u002Fzh\u002FREADME.md)\n\n## Navegação Rápida\n\n### Entendendo o Fluxo de Trabalho AIOX\n\n**Antes de mergulhar, revise estes diagramas críticos de fluxo de trabalho que explicam como o AIOX funciona:**\n\n1. **[Fluxo de Planejamento (Interface Web)](docs\u002Fguides\u002Fuser-guide.md#the-planning-workflow-web-ui)** - Como criar documentos de PRD e Arquitetura\n2. **[Ciclo Principal de Desenvolvimento (IDE)](docs\u002Fguides\u002Fuser-guide.md#the-core-development-cycle-ide)** - Como os agentes sm, dev e qa colaboram através de arquivos de histórias\n\n> ⚠️ **Estes diagramas explicam 90% da confusão sobre o fluxo AIOX Agentic Agile** - Entender a criação de PRD+Arquitetura e o fluxo de trabalho sm\u002Fdev\u002Fqa e como os agentes passam notas através de arquivos de histórias é essencial - e também explica por que isto NÃO é taskmaster ou apenas um simples executor de tarefas!\n\n### O que você gostaria de fazer?\n\n- **[Instalar e Construir software com Equipe Ágil Full Stack de IA](#início-rápido)** → Instruções de Início Rápido\n- **[Aprender como usar o AIOX](docs\u002Fguides\u002Fuser-guide.md)** → Guia completo do usuário e passo a passo\n- **[Ver agentes IA disponíveis](#agentes-disponíveis)** → Papéis especializados para sua equipe\n- **[Explorar usos não técnicos](#-além-do-desenvolvimento-de-software---squads)** → Escrita criativa, negócios, bem-estar, educação\n- **[Criar meus próprios agentes IA](#criando-seu-próprio-squad)** → Construir agentes para seu domínio\n- **[Navegar Squads prontos](docs\u002Fguides\u002Fsquads-overview.md)** → Veja como criar e usar equipes de agentes IA\n- **[Entender a arquitetura](docs\u002Farchitecture\u002FARCHITECTURE-INDEX.md)** → Mergulho técnico profundo\n- **[Reportar problemas](https:\u002F\u002Fgithub.com\u002FSynkraAI\u002Faiox-core\u002Fissues)** → Bug reports e feature requests\n\n## Importante: Mantenha Sua Instalação AIOX Atualizada\n\n**Mantenha-se atualizado sem esforço!** Para atualizar sua instalação AIOX existente:\n\n```bash\nnpx aiox-core@latest install\n```\n\nIsto vai:\n\n- ✅ Detectar automaticamente sua instalação existente\n- ✅ Atualizar apenas os arquivos que mudaram\n- ✅ Criar arquivos de backup `.bak` para quaisquer modificações customizadas\n- ✅ Preservar suas configurações específicas do projeto\n\nIsto facilita beneficiar-se das últimas melhorias, correções de bugs e novos agentes sem perder suas customizações!\n\n## Início Rápido\n\n### 🚀 Instalação via NPX (Recomendado)\n\n**Instale o AIOX com um único comando:**\n\n```bash\n# Criar um novo projeto com assistente interativo moderno\nnpx aiox-core init meu-projeto\n\n# Ou instalar em projeto existente\ncd seu-projeto\nnpx aiox-core install\n\n# Ou usar uma versão específica\nnpx aiox-core@latest init meu-projeto\n```\n\n### ✨ Assistente de Instalação Moderno\n\nO AIOX agora inclui uma experiência de instalação interativa de última geração, inspirada em ferramentas modernas como Vite e Next.js:\n\n**Recursos do Instalador Interativo:**\n\n- 🎨 **Interface Moderna**: Prompts coloridos e visuais com @clack\u002Fprompts\n- ✅ **Validação em Tempo Real**: Feedback instantâneo sobre entradas inválidas\n- 🔄 **Indicadores de Progresso**: Spinners para operações longas (cópia de arquivos, instalação de deps)\n- 📦 **Seleção Multi-Componente**: Escolha quais componentes instalar com interface intuitiva\n- ⚙️ **Escolha de Gerenciador de Pacotes**: Selecione entre npm, yarn ou pnpm\n- ⌨️ **Suporte a Cancelamento**: Ctrl+C ou ESC para sair graciosamente a qualquer momento\n- 📊 **Resumo de Instalação**: Visualize todas as configurações antes de prosseguir\n- ⏱️ **Rastreamento de Duração**: Veja quanto tempo levou a instalação\n\n**O instalador oferece:**\n\n- ✅ Download da versão mais recente do NPM\n- ✅ Assistente de instalação interativo moderno\n- ✅ Configuração automática do IDE (Codex CLI, Cursor ou Claude Code)\n- ✅ Configuração de todos os agentes e fluxos de trabalho AIOX\n- ✅ Criação dos arquivos de configuração necessários\n- ✅ Inicialização do sistema de meta-agentes\n- ✅ Verificações de saúde do sistema\n- ✅ **Suporte Cross-Platform**: Testado em Windows, macOS e Linux\n\n> **É isso!** Sem clonar, sem configuração manual - apenas um comando e você está pronto para começar com uma experiência de instalação moderna e profissional.\n\n**Pré-requisitos**: [Node.js](https:\u002F\u002Fnodejs.org) v18+ necessário (v20+ recomendado) | [Troubleshooting](docs\u002Fguides\u002Finstallation-troubleshooting.md)\n\n### Atualizando uma Instalação Existente\n\nSe você já tem o AIOX instalado:\n\n```bash\nnpx aiox-core@latest install\n# O instalador detectará sua instalação existente e a atualizará\n```\n\n### Configure Seu IDE para Desenvolvimento AIOX\n\nO AIOX inclui regras pré-configuradas para IDE para melhorar sua experiência de desenvolvimento:\n\n#### Para Cursor:\n\n1. Abra as configurações do Cursor\n2. Navegue até **User Rules**\n3. Copie o conteúdo de `.cursor\u002Fglobal-rules.md`\n4. Cole na seção de regras e salve\n\n#### Para Claude Code:\n\n- ✅ Já configurado! O arquivo `.claude\u002FCLAUDE.md` é carregado automaticamente\n- Sync dedicado de agentes: `npm run sync:ide:claude`\n- Validacao dedicada: `npm run validate:claude-sync && npm run validate:claude-integration`\n\n#### Para Codex CLI:\n\n- ✅ Integração de primeira classe no AIOX 4.2 (pipeline de ativação e greeting compartilhado)\n- ✅ Já configurado! O arquivo `AGENTS.md` na raiz é carregado automaticamente\n- Opcional: sincronize agentes auxiliares com `npm run sync:ide:codex`\n- Recomendado neste repositório: gerar e versionar skills locais com `npm run sync:skills:codex`\n- Use `npm run sync:skills:codex:global` apenas fora deste projeto (para evitar duplicidade no `\u002Fskills`)\n- Validacao dedicada: `npm run validate:codex-sync && npm run validate:codex-integration`\n- Guardrails de skills\u002Fpaths: `npm run validate:codex-skills && npm run validate:paths`\n\n#### Para Gemini CLI:\n\n- ✅ Regras e agentes sincronizaveis com `npm run sync:ide:gemini`\n- Arquivos gerados em `.gemini\u002Frules.md`, `.gemini\u002Frules\u002FAIOX\u002Fagents\u002F` e `.gemini\u002Fcommands\u002F*.toml`\n- ✅ Hooks e settings locais no fluxo de instalacao (`.gemini\u002Fhooks\u002F` + `.gemini\u002Fsettings.json`)\n- ✅ Ativacao rapida por slash commands (`\u002Faiox-menu`, `\u002Faiox-dev`, `\u002Faiox-architect`, etc.)\n- Validacao dedicada: `npm run validate:gemini-sync && npm run validate:gemini-integration`\n- Paridade multi-IDE em um comando: `npm run validate:parity`\n\nEstas regras fornecem:\n\n- 🤖 Reconhecimento e integração de comandos de agentes\n- 📋 Fluxo de trabalho de desenvolvimento dirigido por histórias\n- ✅ Rastreamento automático de checkboxes\n- 🧪 Padrões de teste e validação\n- 📝 Padrões de código específicos do AIOX\n\n### Início Mais Rápido com Interface Web (2 minutos)\n\n1. **Instale o AIOX**: Execute `npx aiox-core init meu-projeto`\n2. **Configure seu IDE**: Siga as instruções de configuração para Codex CLI, Cursor ou Claude Code\n3. **Comece a Planejar**: Ative um agente como `@analyst` para começar a criar seu briefing\n4. **Use comandos AIOX**: Digite `*help` para ver comandos disponíveis\n5. **Siga o fluxo**: Veja o [Guia do usuário](docs\u002Fguides\u002Fuser-guide.md) para mais detalhes\n\n### Referência de Comandos CLI\n\nO AIOX oferece uma CLI moderna e cross-platform com comandos intuitivos:\n\n```bash\n# Gerenciamento de Projeto (com assistente interativo)\nnpx aiox-core init \u003Cnome-projeto> [opções]\n  --force              Forçar criação em diretório não vazio\n  --skip-install       Pular instalação de dependências npm\n  --template \u003Cnome>    Usar template específico (default, minimal, enterprise)\n\n# Instalação e Configuração (com prompts modernos)\nnpx aiox-core install [opções]\n  --force              Sobrescrever configuração existente\n  --quiet              Saída mínima durante instalação\n  --dry-run            Simular instalação sem modificar arquivos\n\n# Comandos do Sistema\nnpx aiox-core --version   Exibir versão instalada\nnpx aiox-core --help      Exibir ajuda detalhada\nnpx aiox-core info        Exibir informações do sistema\nnpx aiox-core doctor      Executar diagnósticos do sistema\nnpx aiox-core doctor --fix Corrigir problemas detectados automaticamente\n\n# Manutenção\nnpx aiox-core update      Atualizar para versão mais recente\nnpx aiox-core uninstall   Remover AIOX\n```\n\n**Recursos da CLI:**\n\n- ✅ **Help System Abrangente**: `--help` em qualquer comando mostra documentação detalhada\n- ✅ **Validação de Entrada**: Feedback imediato sobre parâmetros inválidos\n- ✅ **Mensagens Coloridas**: Erros em vermelho, sucessos em verde, avisos em amarelo\n- ✅ **Cross-Platform**: Funciona perfeitamente em Windows, macOS e Linux\n- ✅ **Suporte a Dry-Run**: Teste instalações sem modificar arquivos\n\n### 💡 Exemplos de Uso\n\n#### Instalação Interativa Completa\n\n```bash\n$ npx aiox-core install\n\n🚀 AIOX Installation\n\n◆ What is your project name?\n│  my-awesome-project\n│\n◇ Which directory should we use?\n│  .\u002Fmy-awesome-project\n│\n◆ Choose components to install:\n│  ● Core Framework (Required)\n│  ● Agent System (Required)\n│  ● Squads (optional)\n│  ○ Example Projects (optional)\n│\n◇ Select package manager:\n│  ● npm\n│  ○ yarn\n│  ○ pnpm\n│\n◆ Initialize Git repository?\n│  Yes\n│\n◆ Install dependencies?\n│  Yes\n│\n▸ Creating project directory...\n▸ Copying framework files...\n▸ Initializing Git repository...\n▸ Installing dependencies (this may take a minute)...\n▸ Configuring environment...\n▸ Running post-installation setup...\n\n✔ Installation completed successfully! (34.2s)\n\nNext steps:\n  cd my-awesome-project\n  aiox-core doctor     # Verify installation\n  aiox-core --help     # See available commands\n```\n\n#### Instalação Silenciosa (CI\u002FCD)\n\n```bash\n# Instalação automatizada sem prompts\n$ npx aiox-core install --quiet --force\n✔ AIOX installed successfully\n```\n\n#### Simulação de Instalação (Dry-Run)\n\n```bash\n# Testar instalação sem modificar arquivos\n$ npx aiox-core install --dry-run\n\n[DRY RUN] Would create: .\u002Fmy-project\u002F\n[DRY RUN] Would copy: .aiox-core\u002F (45 files)\n[DRY RUN] Would initialize: Git repository\n[DRY RUN] Would install: npm dependencies\n✔ Dry run completed - no files were modified\n```\n\n#### Diagnóstico do Sistema\n\n```bash\n$ npx aiox-core doctor\n\n🏥 AIOX System Diagnostics\n\n✔ Node.js version: v20.10.0 (meets requirement: >=18.0.0)\n✔ npm version: 10.2.3\n✔ Git installed: version 2.43.0\n✔ GitHub CLI: gh 2.40.1\n✔ AIOX: v4.2.11\n\nConfiguration:\n✔ .aiox-core\u002F directory exists\n✔ Agent files: 11 found\n✔ Workflow files: 8 found\n✔ Templates: 15 found\n\nDependencies:\n✔ @clack\u002Fprompts: ^0.7.0\n✔ commander: ^12.0.0\n✔ execa: ^9.0.0\n✔ fs-extra: ^11.0.0\n✔ picocolors: ^1.0.0\n\n✅ All checks passed! Your installation is healthy.\n```\n\n#### Obter Ajuda\n\n```bash\n$ npx aiox-core --help\n\nUsage: aiox-core [options] [command]\n\nAIOX: AI-Orchestrated System for Full Stack Development\n\nOptions:\n  -V, --version                output the version number\n  -h, --help                   display help for command\n\nCommands:\n  init \u003Cproject-name>          Create new AIOX project with interactive wizard\n  install [options]            Install AIOX in current directory\n  info                         Display system information\n  doctor [options]             Run system diagnostics and health checks\n  help [command]               display help for command\n\nRun 'aiox-core \u003Ccommand> --help' for detailed information about each command.\n```\n\n### Alternativa: Clonar e Construir\n\nPara contribuidores ou usuários avançados que queiram modificar o código fonte:\n\n```bash\n# Clonar o repositório\ngit clone https:\u002F\u002Fgithub.com\u002FSynkraAI\u002Faiox-core.git\ncd aiox-core\n\n# Instalar dependências\nnpm install\n\n# Executar o instalador\nnpm run install:aiox\n```\n\n### Configuração Rápida para Equipe\n\nPara membros da equipe ingressando no projeto:\n\n```bash\n# Instalar AIOX no projeto\nnpx aiox-core@latest install\n\n# Isto vai:\n# 1. Detectar instalação existente (se houver)\n# 2. Instalar\u002Fatualizar framework AIOX\n# 3. Configurar agentes e workflows\n```\n\n## 🌟 Além do Desenvolvimento de Software - Squads\n\nO framework de linguagem natural do AIOX funciona em QUALQUER domínio. Os Squads fornecem agentes IA especializados para escrita criativa, estratégia de negócios, saúde e bem-estar, educação e muito mais. Além disso, os Squads podem expandir o núcleo do AIOX com funcionalidade específica que não é genérica para todos os casos. [Veja o Guia de Squads](docs\u002Fguides\u002Fsquads-guide.md) e aprenda a criar os seus próprios!\n\n## Agentes Disponíveis\n\nO AIOX vem com 12 agentes especializados:\n\n### Agentes Meta\n\n- **aiox-master** - Agente mestre de orquestração (inclui capacidades de desenvolvimento de framework)\n- **aiox-orchestrator** - Orquestrador de fluxo de trabalho e coordenação de equipe\n\n### Agentes de Planejamento (Interface Web)\n\n- **analyst** - Especialista em análise de negócios e criação de PRD\n- **pm** (Product Manager) - Gerente de produto e priorização\n- **architect** - Arquiteto de sistema e design técnico\n- **ux-expert** - Design de experiência do usuário e usabilidade\n\n### Agentes de Desenvolvimento (IDE)\n\n- **sm** (Scrum Master) - Gerenciamento de sprint e criação de histórias\n- **dev** - Desenvolvedor e implementação\n- **qa** - Garantia de qualidade e testes\n- **po** (Product Owner) - Gerenciamento de backlog e histórias\n- **data-engineer** - Design de banco de dados e modelagem de dados\n- **devops** - CI\u002FCD, infraestrutura e operações git (autoridade exclusiva de push)\n\n## Documentação e Recursos\n\n### Guias Essenciais\n\n- 📖 **[Guia do Usuário](docs\u002Fguides\u002Fuser-guide.md)** - Passo a passo completo desde a concepção até a conclusão do projeto\n- 🏗️ **[Arquitetura Principal](docs\u002Farchitecture\u002FAIOX-VISUAL-OVERVIEW.md)** - Mergulho técnico profundo e design do sistema\n- 🚀 **[Guia de Squads](docs\u002Fguides\u002Fsquads-guide.md)** - Estenda o AIOX para qualquer domínio além do desenvolvimento de software\n\n### Documentação Adicional\n\n- 🤖 **[Guia de Squads](docs\u002Fguides\u002Fsquads-guide.md)** - Crie e publique equipes de agentes IA\n- 📋 **[Primeiros Passos](docs\u002Fgetting-started.md)** - Tutorial passo a passo para iniciantes\n- 🔧 **[Solução de Problemas](docs\u002Ftroubleshooting.md)** - Soluções para problemas comuns\n- 🎯 **[Princípios Orientadores](docs\u002FGUIDING-PRINCIPLES.md)** - Filosofia e melhores práticas do AIOX\n- 🏛️ **[Visão Geral da Arquitetura](docs\u002Farchitecture\u002FAIOX-VISUAL-OVERVIEW.md)** - Visão detalhada da arquitetura do sistema\n- ⚙️ **[Guia de Ajuste de Performance](docs\u002Fperformance-tuning-guide.md)** - Otimize seu fluxo de trabalho AIOX\n- 🔒 **[Melhores Práticas de Segurança](docs\u002Fsecurity-best-practices.md)** - Segurança e proteção de dados\n- 🔄 **[Guia de Migração](docs\u002Fmigration-guide.md)** - Migração de versões anteriores\n- 📦 **[Versionamento e Releases](docs\u002Fversioning-and-releases.md)** - Política de versões\n\n## 🤖 AIOX Autonomous Development Engine (ADE)\n\nO AIOX introduz o **Autonomous Development Engine (ADE)** - um sistema completo para desenvolvimento autônomo que transforma requisitos em código funcional.\n\n### 🎯 O Que é o ADE?\n\nO ADE é um conjunto de **7 Epics** que habilitam execução autônoma de desenvolvimento:\n\n| Epic  | Nome             | Descrição                                  |\n| ----- | ---------------- | ------------------------------------------ |\n| **1** | Worktree Manager | Isolamento de branches via Git worktrees   |\n| **2** | Migration V2→V3  | Migração para formato autoClaude V3        |\n| **3** | Spec Pipeline    | Transforma requisitos em specs executáveis |\n| **4** | Execution Engine | Executa specs com 13 steps + self-critique |\n| **5** | Recovery System  | Recuperação automática de falhas           |\n| **6** | QA Evolution     | Review estruturado em 10 fases             |\n| **7** | Memory Layer     | Memória persistente de padrões e insights  |\n\n### 🔄 Fluxo Principal\n\n```\nUser Request → Spec Pipeline → Execution Engine → QA Review → Working Code\n                                      ↓\n                              Recovery System\n                                      ↓\n                               Memory Layer\n```\n\n### ⚡ Quick Start ADE\n\n```bash\n# 1. Criar spec a partir de requisito\n@pm *gather-requirements\n@architect *assess-complexity\n@analyst *research-deps\n@pm *write-spec\n@qa *critique-spec\n\n# 2. Executar spec aprovada\n@architect *create-plan\n@architect *create-context\n@dev *execute-subtask 1.1\n\n# 3. QA Review\n@qa *review-build STORY-42\n```\n\n### 📖 Documentação ADE\n\n- **[Guia Completo do ADE](docs\u002Fguides\u002Fade-guide.md)** - Tutorial passo a passo\n- **[Alterações nos Agentes](docs\u002Farchitecture\u002FADE-AGENT-CHANGES.md)** - Comandos e capabilities por agente\n- **[Epic 1 - Worktree Manager](docs\u002Farchitecture\u002FADE-EPIC1-HANDOFF.md)**\n- **[Epic 2 - Migration V2→V3](docs\u002Farchitecture\u002FADE-EPIC2-HANDOFF.md)**\n- **[Epic 3 - Spec Pipeline](docs\u002Farchitecture\u002FADE-EPIC3-HANDOFF.md)**\n- **[Epic 4 - Execution Engine](docs\u002Farchitecture\u002FADE-EPIC4-HANDOFF.md)**\n- **[Epic 5 - Recovery System](docs\u002Farchitecture\u002FADE-EPIC5-HANDOFF.md)**\n- **[Epic 6 - QA Evolution](docs\u002Farchitecture\u002FADE-EPIC6-HANDOFF.md)**\n- **[Epic 7 - Memory Layer](docs\u002Farchitecture\u002FADE-EPIC7-HANDOFF.md)**\n\n### 🆕 Novos Comandos por Agente\n\n**@devops:**\n\n- `*create-worktree`, `*list-worktrees`, `*merge-worktree`, `*cleanup-worktrees`\n- `*inventory-assets`, `*analyze-paths`, `*migrate-agent`, `*migrate-batch`\n\n**@pm:**\n\n- `*gather-requirements`, `*write-spec`\n\n**@architect:**\n\n- `*assess-complexity`, `*create-plan`, `*create-context`, `*map-codebase`\n\n**@analyst:**\n\n- `*research-deps`, `*extract-patterns`\n\n**@qa:**\n\n- `*critique-spec`, `*review-build`, `*request-fix`, `*verify-fix`\n\n**@dev:**\n\n- `*execute-subtask`, `*track-attempt`, `*rollback`, `*capture-insights`, `*list-gotchas`, `*apply-qa-fix`\n\n## Criando Seu Próprio Squad\n\nSquads permitem estender o AIOX para qualquer domínio. Estrutura básica:\n\n```\nsquads\u002Fseu-squad\u002F\n├── config.yaml           # Configuração do squad\n├── agents\u002F              # Agentes especializados\n├── tasks\u002F               # Fluxos de trabalho de tarefas\n├── templates\u002F           # Templates de documentos\n├── checklists\u002F          # Checklists de validação\n├── data\u002F                # Base de conhecimento\n├── README.md            # Documentação do squad\n└── user-guide.md        # Guia do usuário\n```\n\nVeja o [Guia de Squads](docs\u002Fguides\u002Fsquads-guide.md) para instruções detalhadas.\n\n## Squads Disponíveis\n\nSquads são equipes modulares de agentes IA. Veja a [Visão Geral de Squads](docs\u002Fguides\u002Fsquads-overview.md) para mais informações.\n\n### Squads Externos\n\n- **[hybrid-ops](https:\u002F\u002Fgithub.com\u002FSynkraAI\u002Faiox-hybrid-ops-pedro-valerio)** - Operações híbridas humano-agente (repositório separado)\n\n## AIOX Pro\n\nO **AIOX Pro** é o módulo premium do AIOX, oferecendo funcionalidades avançadas para equipes e projetos de maior escala.\n\n> **Disponibilidade restrita:** O AIOX Pro está disponível exclusivamente para membros do **AIOX Cohort Advanced**. [Saiba mais sobre o programa](https:\u002F\u002Faioxsquad.ai).\n\nPara saber como acessar, ativar, recuperar conta e validar as squads Pro, consulte o [Guia de Acesso ao AIOX Pro](docs\u002Fguides\u002Faiox-pro-access.md).\n\n### Instalação\n\n```bash\nnpx -y -p @aiox-squads\u002Fcore@latest aiox pro setup\n```\n\n### Identificação Estável de Máquina (>= 5.0.8)\n\nO AIOX Pro agora usa o UUID nativo do sistema operacional para gerar `machineId`, preservando o hash SHA-256 e evitando consumo extra de assentos quando o macOS, VPNs ou redes Wi-Fi alteram o MAC\u002Finterface ativa.\n\nCaches locais de licença criados pelo algoritmo antigo são migrados automaticamente na próxima leitura. A janela de fallback legacy é de 90 dias; depois disso, instalações antigas precisam reativar online.\n\n### Features Premium\n\n- **Squads Avançados** - Squads especializados com capacidades expandidas\n- **Memory Layer** - Memória persistente de padrões e insights entre sessões\n- **Métricas & Analytics** - Dashboard de produtividade e métricas de desenvolvimento\n- **Integrações Enterprise** - Conectores para Jira, Linear, Notion e mais\n- **Configuração em Camadas** - Sistema de configuração L1-L4 com herança\n- **Licenciamento** - Gerenciamento de licença via `aiox pro activate --key \u003CKEY>`\n\nPara mais informações, execute `npx aiox-core pro --help` após a instalação.\n\n## Suporte\n\n- 🐛 [Rastreador de Issues](https:\u002F\u002Fgithub.com\u002FSynkraAI\u002Faiox-core\u002Fissues) - Bug reports e feature requests\n- 💡 [Processo de Features](docs\u002FFEATURE_PROCESS.md) - Como propor novas funcionalidades\n- 📋 [Como Contribuir](CONTRIBUTING.md)\n- 🗺️ [Roadmap](docs\u002Froadmap.md) - Veja o que estamos construindo\n- 🤖 [Guia de Squads](docs\u002Fguides\u002Fsquads-guide.md) - Crie equipes de agentes IA\n\n## Git Workflow e Validação\n\nO AIOX implementa um sistema de validação de múltiplas camadas para garantir qualidade do código e consistência:\n\n### 🛡️ Defense in Depth - 3 Camadas de Validação\n\n**Camada 1: Pre-commit (Local - Rápida)**\n\n- ✅ ESLint - Qualidade de código\n- ✅ TypeScript - Verificação de tipos\n- ⚡ Performance: \u003C5s\n- 💾 Cache habilitado\n\n**Camada 2: Pre-push (Local - Validação de Stories)**\n\n- ✅ Validação de checkboxes de histórias\n- ✅ Consistência de status\n- ✅ Seções obrigatórias\n\n**Camada 3: CI\u002FCD (Cloud - Obrigatório para merge)**\n\n- ✅ Todos os testes\n- ✅ Cobertura de testes (80% mínimo)\n- ✅ Validações completas\n- ✅ GitHub Actions\n\n### 📖 Documentação Detalhada\n\n- 📋 **[Guia Completo de Git Workflow](docs\u002Fgit-workflow-guide.md)** - Guia detalhado do fluxo de trabalho\n- 📋 **[CONTRIBUTING.md](CONTRIBUTING.md)** - Guia de contribuição\n\n### Comandos Disponíveis\n\n```bash\n# Validações locais\nnpm run lint           # ESLint\nnpm run typecheck      # TypeScript\nnpm test              # Testes\nnpm run test:coverage # Testes com cobertura\n\n# Validador AIOX\nnode .aiox-core\u002Futils\u002Faiox-validator.js pre-commit   # Validação pre-commit\nnode .aiox-core\u002Futils\u002Faiox-validator.js pre-push     # Validação pre-push\nnode .aiox-core\u002Futils\u002Faiox-validator.js stories      # Validar todas stories\n```\n\n### Branch Protection\n\nConfigure proteção da branch master com:\n\n```bash\nnode scripts\u002Fsetup-branch-protection.js\n```\n\nRequer:\n\n- GitHub CLI (gh) instalado e autenticado\n- Acesso de admin ao repositório\n\n## Contribuindo\n\n**Estamos empolgados com contribuições e acolhemos suas ideias, melhorias e Squads!** 🎉\n\nPara contribuir:\n\n1. Fork o repositório\n2. Crie uma branch para sua feature (`git checkout -b feature\u002FMinhaNovaFeature`)\n3. Commit suas mudanças (`git commit -m 'feat: Adicionar nova feature'`)\n4. Push para a branch (`git push origin feature\u002FMinhaNovaFeature`)\n5. Abra um Pull Request\n\nVeja também:\n\n- 📋 [Como Contribuir com Pull Requests](docs\u002Fhow-to-contribute-with-pull-requests.md)\n- 📋 [Guia de Git Workflow](docs\u002Fgit-workflow-guide.md)\n\n## 📄 Legal\n\n| Documento             | English                                            | Português                           |\n| --------------------- | -------------------------------------------------- | ----------------------------------- |\n| **Licença**           | [MIT License](LICENSE)                             | -                                   |\n| **Modelo de Licença** | [Core vs Pro](docs\u002Flegal\u002Flicense-clarification.md) | -                                   |\n| **Privacidade**       | [Privacy Policy](docs\u002Flegal\u002Fprivacy.md)            | -                                   |\n| **Termos de Uso**     | [Terms of Use](docs\u002Flegal\u002Fterms.md)                | -                                   |\n| **Código de Conduta** | [Code of Conduct](CODE_OF_CONDUCT.md)              | [PT-BR](docs\u002Fpt\u002Fcode-of-conduct.md) |\n| **Contribuição**      | [Contributing](CONTRIBUTING.md)                    | [PT-BR](docs\u002Fpt\u002Fcontributing.md)    |\n| **Segurança**         | [Security](docs\u002Fsecurity.md)                       | [PT-BR](docs\u002Fpt\u002Fsecurity.md)        |\n| **Comunidade**        | [Community](docs\u002Fcommunity.md)                     | [PT-BR](docs\u002Fpt\u002Fcommunity.md)       |\n| **Roadmap**           | [Roadmap](docs\u002Froadmap.md)                         | [PT-BR](docs\u002Fpt\u002Froadmap.md)         |\n| **Changelog**         | [Version History](CHANGELOG.md)                    | -                                   |\n\n## Contribuidores\n\n[![Contributors](https:\u002F\u002Fcontrib.rocks\u002Fimage?repo=SynkraAI\u002Faiox-core)](https:\u002F\u002Fgithub.com\u002FSynkraAI\u002Faiox-core\u002Fgraphs\u002Fcontributors)\n\n### 🌟 Contribuidores da Comunidade\n\n\u003C!-- prettier-ignore-start -->\n\u003C!-- Manually maintained — add new community contributors here -->\n\u003Ctable>\n  \u003Ctr>\n    \u003Ctd align=\"center\">\u003Ca href=\"https:\u002F\u002Fgithub.com\u002Fnikolasdehor\">\u003Cimg src=\"https:\u002F\u002Fgithub.com\u002Fnikolasdehor.png?size=100\" width=\"100px;\" alt=\"Nikolas de Hor\"\u002F>\u003Cbr \u002F>\u003Csub>\u003Cb>Nikolas de Hor\u003C\u002Fb>\u003C\u002Fsub>\u003C\u002Fa>\u003Cbr \u002F>💻🐛⚠️👀\u003C\u002Ftd>\n  \u003C\u002Ftr>\n\u003C\u002Ftable>\n\u003C!-- prettier-ignore-end -->\n\n\u003Csub>Construído com ❤️ para a comunidade de desenvolvimento assistido por IA\u003C\u002Fsub>\n\n---\n\n**[⬆ Voltar ao topo](#aiox-squad-artificial-intelligence-orchestration-experience)**\n","AIOX Squad 是一个用于全栈开发的AI编排系统的核心框架。它通过提供一系列专业代理、自动化工作流和以CLI为中心的体验来简化复杂项目的构建过程，支持Node.js环境，并采用TypeScript编写以增强类型安全。该框架特别适合需要高度定制化且涉及多步骤或多组件协同工作的软件开发场景，例如构建复杂的Web应用或后端服务。此外，AIOX提供了与多种IDE集成的能力，使得开发者可以根据自己的偏好选择最合适的工具进行高效开发。",2,"2026-06-11 03:43:21","high_star"]