🏆 Créditos e Agradecimentos

Este projeto é construído sobre o Synkra AIOS, o framework open-source de orquestração de agentes de IA para desenvolvimento full-stack criado por Pedro Valério e mantido pela organização SynkraAI (1.850+ stars no GitHub). Sem o trabalho do Pedro e da comunidade Synkra, este projeto não existiria.

Este projeto existe graças ao trabalho incrível de diversas comunidades e criadores open-source:

| Projeto | Autor / Organização | Contribuição | |---------|---------------------|--------------| | Synkra AIOS | Pedro Valério / SynkraAI | Framework core — toda a arquitetura de agentes, constitution, workflows, tasks e templates. Instalado via npx aiox-core init | | squads.sh | gutomec | Plataforma de gerenciamento de squads para projetos AIOS | | Claude Code | Anthropic | Motor de IA que torna tudo possível — agentes, skills e MCP rodam sobre o Claude Code | | Vercel Labs Skills | Vercel | Skill find-skills — busca de skills sob demanda (instalada pelo AIOX) | | nano-banana-pro | rafarafarafa | Servidor MCP para geração de imagens com Gemini | | Context7 | Upstash | Servidor MCP para documentação de bibliotecas ao vivo | | 21st.dev Magic | 21st.dev | Servidor MCP para busca e geração de componentes UI | | Get Shit Done | Lex Christopherson | Framework GSD para gestão de projetos com Claude Code | | oh-my-claudecode | Yeachan Heo | Orquestração multi-agente para Claude Code |

[!NOTE] create-aiox-god-mode é um instalador e orquestrador — ele executa os instaladores de cada projeto listado acima e adiciona a skill God Mode. Todo o crédito pelo framework Synkra AIOS pertence a Pedro Valério e à organização SynkraAI. O crédito pelas skills, MCPs e ferramentas pertence aos respectivos autores. Se você é autor de algum projeto listado e deseja ajustes na atribuição, abra uma issue.

npx create-aiox-god-mode meu-projeto

[!NOTE] Este pacote é equivalente ao create-aios-god-mode com branding Synkra AIOX. Ambos instalam o mesmo sistema.

🎯 O Que Este CLI Faz

Este CLI é um instalador que executa 3 instalações independentes e adiciona uma skill:

O que este CLI NÃO faz:

• Não cria os agentes de IA — isso é feito pelo AIOX (aiox-core)
• Não instala squads — cria apenas o diretório squads/ vazio
• Não faz prompts interativos — os prompts vêm do aiox-core init

🚀 Início Rápido

1. Crie seu projeto

npx create-aiox-god-mode meu-projeto

2. Entre no diretório

cd meu-projeto

3. Ative o God Mode

claude
# depois digite: /aiox-god-mode

[!IMPORTANT] O Claude Code precisa estar instalado para usar o God Mode. Instale com npm install -g @anthropic-ai/claude-code.

📦 Pipeline de Instalação

O CLI executa 8 etapas sequenciais. Apenas a etapa 3 é código próprio deste CLI — as demais delegam para instaladores de terceiros:

| Etapa | O Que Faz | Quem Faz | |:-----:|-----------|----------| | 1 | 🔍 Validar ambiente — Node.js ≥ 18, nome do projeto (kebab-case), diretório vazio, rede | CLI | | 2 | 🏗️ Instalar AIOX — Executa npx aiox-core init <nome>. O AIOX faz seus próprios prompts (idioma, IDEs, tech preset) e cria toda a estrutura do framework | aiox-core | | 3 | ⚡ Adicionar God Mode — Copia a skill aiox-god-mode (1 SKILL.md + 8 referências + 1 rule + 1 settings.json) para cada IDE selecionada pelo usuário na etapa 2 | CLI | | 4 | 🔌 Configurar MCPs — Escreve configs de 3 servidores MCP (nano-banana-pro, context7, 21st-dev) para cada IDE selecionada | CLI | | 5 | 🚀 Instalar GSD — Executa npx get-shit-done-cc --local (instalação padrão) | get-shit-done-cc | | 6 | 🔧 Instalar oh-my-claudecode — Executa npx oh-my-claude-sisyphus install (instalação padrão) | oh-my-claude-sisyphus | | 7 | 🧹 Converter para IDEs — Converte skills, rules e instruções para o formato de cada IDE selecionada. Cria diretório squads/ vazio | CLI | | 8 | ✅ Finalizar — npm install, cria .env.example, git init + commit inicial | CLI |

IDEs suportadas

A etapa 2 (aiox-core init) pergunta ao usuário quais IDEs usar. O CLI então instala God Mode e MCPs para cada uma:

| IDE | Skills | Rules | MCPs | Instruções | |-----|:------:|:-----:|:----:|:----------:| | Claude Code | .claude/skills/ | .claude/rules/ | .mcp.json | CLAUDE.md | | Codex | .codex/skills/ | — | .codex/config.toml | AGENTS.md | | Gemini CLI | .gemini/skills/ | .gemini/rules/ | — | GEMINI.md | | Cursor | .cursor/skills/ | .cursor/rules/ | .cursor/mcp.json | AGENTS.md | | GitHub Copilot | — | — | — | .github/copilot-instructions.md | | AntiGravity | — | .antigravity/rules/ | — | AGENTS.md |

[!NOTE] MCPs per-project só são suportados por Claude Code, Codex e Cursor. Para as demais IDEs, o CLI emite um aviso.

🛠️ Comandos

init (padrão)

Cria um novo projeto com AIOX + God Mode + GSD + OMC.

npx create-aiox-god-mode meu-projeto

update

Compara a versão do God Mode instalada com a versão bundled no CLI. Se houver versão mais nova, reinstala a skill.

cd meu-projeto
npx create-aiox-god-mode update

[!TIP] Use npx create-aiox-god-mode@latest update para garantir que está usando a versão mais recente do CLI.

doctor

Executa 8 verificações de saúde no projeto:

cd meu-projeto
npx create-aiox-god-mode doctor

| # | Verificação | Crítica | |---|-------------|:-------:| | 1 | Node.js ≥ 18.0.0 | Não | | 2 | Projeto AIOX (core-config.yaml existe) | Sim | | 3 | God Mode (SKILL.md existe) | Sim | | 4 | Config do Claude (CLAUDE.md) | Não | | 5 | Settings (settings.json) | Não | | 6 | Rules (pelo menos 1 .md em rules/) | Não | | 7 | Git inicializado | Não | | 8 | Rede (GitHub API acessível) | Não |

add-squad

Adiciona um squad ao projeto via npx squads add.

cd meu-projeto
npx create-aiox-god-mode add-squad backend

O God Mode é uma skill — um arquivo markdown (SKILL.md + 8 referências) que instrui o Claude Code (ou outra IDE) a operar o framework AIOX. Não é um binário, não é um servidor — é um conjunto de instruções que a IA segue.

O que a skill faz

1. Classifica intent — qualquer pedido é classificado como OPERATE, CREATE ou CONFIGURE
2. Roteia para agentes — direciona para o agente AIOX correto (@dev, @qa, @architect, etc.)
3. Ativa workflows — SDC (Story Development Cycle), QA Loop, Spec Pipeline, Brownfield Discovery
4. Cria componentes — agentes, tasks, workflows, squads, checklists, templates, rules, data files
5. Aplica governance — enforça a Constitution do AIOX (6 artigos), lifecycle de stories, delegation matrix

Quick Commands

Criação: *create-agent · *create-task · *create-workflow · *create-squad · *create-checklist · *create-template · *create-rule · *create-data · *configure

Operação: *route · *agents · *workflows · *constitution · *lifecycle · *matrix · *navigate · *orchestrate · *diagnose · *sprint

Agentes AIOX (instalados pelo aiox-core)

| Agente | Persona | Função | |--------|---------|--------| | @dev | Dex | Desenvolvedor Full Stack | | @qa | Quinn | Arquiteto de Testes | | @architect | Aria | Arquiteto Técnico | | @pm | Morgan | Product Manager | | @po | Pax | Product Owner | | @sm | River | Scrum Master | | @analyst | Atlas | Analista de Negócios | | @data-engineer | Dara | Especialista em Banco de Dados | | @ux-design-expert | Uma | Designer UX/UI | | @devops | Gage | Gerente de Repositório | | @aios-master | Orion | Orquestrador do Framework |

Estes agentes são criados pelo aiox-core, não por este CLI. O God Mode apenas sabe como roteá-los.

Arquivos da skill

aiox-god-mode/
├── SKILL.md                              # Skill principal (~245 linhas)
└── references/
    ├── agent-creation.md                 # Schema YAML para criar agentes
    ├── agent-matrix.md                   # Referência de comandos dos 11 agentes
    ├── component-templates.md            # Guias para checklists, templates, data, rules
    ├── framework-map.md                  # Mapa completo de paths e boundaries
    ├── squad-creation.md                 # Estrutura e schema de squads
    ├── task-creation.md                  # Schema YAML para tasks
    ├── workflow-creation.md              # Schema YAML para workflows
    └── workflow-playbooks.md             # Playbooks para SDC, QA Loop, Spec, Brownfield

🔌 Servidores MCP

Configurados pelo CLI para cada IDE selecionada:

| Servidor | Pacote | Propósito | |----------|--------|-----------| | nano-banana-pro | @rafarafarafa/nano-banana-pro-mcp | Geração de imagens com IA via Gemini | | context7 | @upstash/context7-mcp | Consulta de documentação de bibliotecas ao vivo | | 21st-dev | @21st-dev/magic | Busca e geração de componentes UI |

[!NOTE] O nano-banana-pro requer a variável de ambiente GEMINI_API_KEY. Adicione-a ao seu arquivo .env.

📁 Estrutura do Projeto (após instalação)

meu-projeto/
├── .claude/                              # Claude Code (criado pelo aiox-core)
│   ├── settings.json                     # Permissões + deny rules (merge do CLI)
│   ├── rules/                            # Regras de workflow (aiox-core + CLI)
│   ├── skills/
│   │   ├── aiox-god-mode/                # ⚡ Adicionado por este CLI
│   │   │   ├── SKILL.md
│   │   │   ├── .version
│   │   │   └── references/ (8 arquivos)
│   │   └── (outras skills do aiox-core)
│   └── CLAUDE.md                         # Instruções do projeto (aiox-core)
├── .aiox-core/                           # Framework AIOX (criado pelo aiox-core)
│   ├── constitution.md
│   ├── core/
│   ├── development/
│   │   ├── tasks/
│   │   ├── templates/
│   │   ├── checklists/
│   │   └── workflows/
│   └── data/
├── .mcp.json                             # Servidores MCP (configurado pelo CLI)
├── docs/                                 # (criado pelo aiox-core)
├── squads/                               # Diretório vazio (criado pelo CLI)
├── .env.example                          # Template de variáveis de ambiente (CLI)
├── package.json
└── README.md

Se outras IDEs foram selecionadas, haverá diretórios adicionais (.codex/, .gemini/, .cursor/, .antigravity/, .github/, etc.) com as skills e configs convertidas.

📋 Requisitos

| Requisito | Versão | Obrigatório | |-----------|--------|:-----------:| | Node.js | ≥ 18.0.0 | ✅ | | Git | Qualquer recente | ✅ | | GitHub CLI (gh) | Qualquer recente | Recomendado | | Claude Code | Mais recente | ✅ |

🔗 Links Relacionados

• Synkra AIOS — O framework de Sistema Orquestrado por IA, por Pedro Valério
• squads.sh — Gerenciamento de squads para projetos AIOS
• create-aios-god-mode — CLI original com branding AIOS
• aios-god-mode-template — Template AIOS (bundled no CLI desde v3.0.5)
• aiox-god-mode-template — Template AIOX (bundled no CLI desde v3.0.5)
• Get Shit Done — Framework de gestão de projetos
• oh-my-claudecode — Orquestração multi-agente

👨‍💻 Contribuidores

Obrigado a essas pessoas incríveis:

Contribuições de qualquer tipo são bem-vindas!

📄 Licença

MIT © gutomec

Licenças de Terceiros

Este CLI instala e integra projetos open-source que possuem suas próprias licenças. Todas são MIT:

| Projeto | Licença | Copyright | |---------|---------|-----------| | Synkra AIOS/AIOX | MIT + Trademark Notice | BMad Code, LLC & SynkraAI Inc. | | Get Shit Done | MIT | Lex Christopherson | | oh-my-claudecode | MIT | Yeachan Heo |

[!NOTE] O Synkra AIOS/AIOX é derivado do BMad Method por Brian Madison. Os nomes "BMad", "BMad Method" e "BMad Core" são marcas registradas da BMad Code, LLC e não são licenciados sob MIT. Veja TRADEMARK.md para detalhes.

Consulte THIRD-PARTY-LICENSES.md para os textos completos de cada licença.