# Guia de Configuração: AIOX Global & Protocolo de Alinhamento com Antigravity-IDE

[gutograciose-sketch]

Este guia documenta o processo arquitetural e o passo a passo técnico realizado para configurar o framework Synkra AIOX de forma global e centralizada na IDE (Gemini CLI / AntiGravity).

Essa abordagem permite que qualquer desenvolvedor utilize os 12 agentes de IA especializados e a metodologia ágil do AIOX em absolutamente qualquer pasta ou projeto de sua máquina, sem a necessidade de duplicar arquivos ou reexecutar instalações locais pesadas.

---

🎯 Arquitetura da Solução Híbrida

A arquitetura tradicional do AIOX requer a instalação de uma pasta local .aiox-core/ de aproximadamente 500MB+ por projeto. Nossa solução centraliza toda a lógica e inteligência em um único ponto físico da máquina e utiliza a IDE para fazer o roteamento inteligente:

  [ Qualquer Diretório de Código ]
         (Sem AIOX local)
                │
                ▼ (Digita: "Ative o AIOX" ou /aiox-dev)
  ┌────────────────────────────────────────────────────────┐
  │         IDE / GEMINI CLI (Extensão Global)            │
  │  - Intercepta os comandos barra e de texto            │
  │  - Verifica se há AIOX local                          │
  │  - Caso não haja, faz FALLBACK para a pasta central   │
  └─────────────────────────┬──────────────────────────────┘
                            │ (Fallback transparente)
                            ▼
     ┌──────────────────────────────────────────────┐
     │          WORKSPACE CENTRAL AIOX              │
     │  C:\...\scratch\aiox-core                    │
     │  - Contém as diretrizes dos 12 agentes       │
     │  - Scripts de ciclo de vida e checklists      │
     │  - Utilitários da CLI do AIOX                │
     └──────────────────────────────────────────────┘

---

🛠️ Passo a Passo da Configuração

Passo 1: Workspace Central do AIOX

Clonamos o repositório principal do AIOX em um único diretório compartilhado na máquina e resolvemos suas dependências locais:

# 1. Clonar o repositório central
git clone https://github.com/SynkraAI/aiox-core.git aiox-core

# 2. Instalar dependências gerais do monorepo
cd aiox-core
npm install

# 3. Instalar dependências de runtime do núcleo (.aiox-core)
cd .aiox-core
npm install --production

---

Passo 2: Instalação Global do Plugin da IDE

Em vez de configurar o atalho da IDE por projeto, copiamos a extensão do Gemini (gemini-aiox-extension) para a pasta de plugins globais do usuário:

• Origem: aiox-core/packages/gemini-aiox-extension
• Destino Global: C:\Users\User\.gemini\config\plugins\gemini-aiox-extension

Guia de Configuração AIOX Global - Antigravity-IDE.md