Does aiox-core auto-invoke its skills?

Not yet. It is indexed on Flowy as a plain plugin. Request auto-invocation on its page and Flowy will route its skills for you as you prompt.

Yes. Flowy is free and open source, with nothing gated. You can read every skill in full before you install.

Development

Plugin

aiox-core

🌐 README por idioma: EN | PT | ES | ZH 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.

FLOW.md

synkraai@synkraai

GitHub

Plugin Signal93/100Strong

maintained100

capable89

documented100

adopted74

Install

$ npx -y skills add SynkraAI/aiox-core --agent claude-code

Run the curl in your terminal, the rest in Claude Code.

Stats

Python TypeScript JavaScript Node Bash

+7 tags

Linux Git GitHub CI/CD Anthropic Gemini MCP

3,073

Stars

939

Forks

Active

Maintenance

JavaScript

Language

14h ago

Last commit

8mo ago

Created

Repo: SynkraAI/aiox-core

In this plugin

27 skills 24 commands 18 agents

See everything inside

What's inside

Skills

/aiox-masterActivate Orion (aiox-master) for AIOX Master Orchestrator & Framework Developer. Use when you need comprehensive expertise across all domains, framework component creation/modification, workflow orchestration, or running tasks that don't.../analystActivate Atlas (analyst) for Business Analyst. Use for market research, competitive analysis, user research, brainstorming session facilitation, structured ideation workshops, feasibility studies, industry trends analysis, project discov.../architectActivate Aria (architect) for Architect. Use for system architecture (fullstack, backend, frontend, infrastructure), technology stack selection (technical evaluation), API design (REST/GraphQL/tRPC/WebSocket), security architecture, perf.../data-engineerActivate Dara (data-engineer) for Database Architect & Operations Engineer. Use for database design, schema architecture, Supabase configuration, RLS policies, migrations, query optimization, data modeling, operations, and monitoring /devActivate Dex (dev) for Full Stack Developer. Use for code implementation, debugging, refactoring, and development best practices /devopsActivate Gage (devops) for GitHub Repository Manager & DevOps Specialist. Use for repository operations, version management, CI/CD, quality gates, and GitHub push operations. ONLY agent authorized to push to remote repository.

Show all 27 skills

/pmActivate Morgan (pm) for Product Manager. Use for PRD creation (greenfield and brownfield), epic creation and management, product strategy and vision, feature prioritization (MoSCoW, RICE), roadmap planning, business case development, go.../poActivate Pax (po) for Product Owner. Use for backlog management, story refinement, acceptance criteria, sprint planning, and prioritization decisions /qaActivate Quinn (qa) for Test Architect & Quality Advisor. Use for comprehensive test architecture review, quality gate decisions, and code improvement. Provides thorough analysis including requirements traceability, risk assessment, and.../smActivate River (sm) for Scrum Master. Use for user story creation from PRD, story validation and completeness checking, acceptance criteria definition, story refinement, sprint planning, backlog grooming, retrospectives, daily standup fa.../squad-creatorActivate Craft (squad-creator) for Squad Creator. Use to create, validate, publish and manage squads /ux-design-expertActivate Uma (ux-design-expert) for UX/UI Designer & Design System Architect. Complete design workflow - user research, wireframes, design systems, token extraction, component building, and quality assurance /aiox-commitCreate a local conventional commit for AIOX work. Never pushes. Use when: committing, /aiox-commit, or local git commit./apply-qa-fixesApply QA gate findings then hand back for re-review. Never self-approves or closes. Use when: apply QA fixes, remediate gate FAIL/CONCERNS, /apply-qa-fixes./architect-firstGuide for implementing the Architect-First development philosophy - perfect architecture, pragmatic execution, quality guaranteed by tests. Use this skill when starting new features, refactoring systems, or when architectural decisions are needed. Enforces non-negotiables like /checklist-runnerGeneric checklist execution engine for any .md checklist. Use this skill when an agent needs to validate work against a checklist. Supports YOLO (autonomous) and interactive modes with pass/fail/partial verdicts./close-storyFinalize bookkeeping for a story already completed by QA. Never changes lifecycle status. Use when: close story, *close-story, story Done, /close-story./coderabbit-reviewUnified CodeRabbit CLI execution via WSL with self-healing loop. Use this skill when running automated code review before commits, PRs, or QA gates. Handles WSL wrapper, severity filtering, and auto-fix iterations./develop-storyImplement a story (Ready → InProgress → ready for review). Runs the OSS develop task. Use when: develop story, *develop, /develop-story, implement ACs./full-sdcEXECUTE lean Full Story Development Cycle for one story: plan via CLI, run validate → develop → review (QG loop) → close with Sequence Lock, durable progress under .aiox/sdc/. Use when: full-sdc, full cycle, SDC, run story end-to-end./mcp-builderGuide for creating high-quality MCP (Model Context Protocol) servers that enable LLMs to interact with external services through well-designed tools. Use when building MCP servers to integrate external APIs or services, whether in Python (FastMCP) or Node/TypeScript (MCP SDK)./review-storyQA gate for a story — verdict PASS/CONCERNS/FAIL/WAIVED + lifecycle transition. Use when: review story, qa gate, *qa-gate, /review-story./skill-creatorGuide for creating effective skills. This skill should be used when users want to create a new skill (or update an existing skill) that extends Claude's capabilities with specialized knowledge, workflows, or tool integrations./synapseThis skill should be used when users want to understand the SYNAPSE context engine, manage domains, configure context rules, or troubleshoot rule injection. Use when asked about SYNAPSE architecture, domain management, star-commands, context brackets, or the 8-layer processing /tech-searchSelf-contained deep tech research. WebSearch + WebFetch + Haiku workers. Pipeline: Query > Decompose > Parallel Search (Haiku) > Evaluate > Synthesize > Document. Zero external dependencies. MCPs optional. Salva em docs/research/{YYYY-MM-DD}-{slug}/./validate-story-draftValidate a story draft (Draft → Ready on GO). Runs the OSS PO validation task. Use when: validate story, *validate-story-draft, /validate-story-draft, story readiness./wave-executeEXECUTE a lean wave — plan story DAG + file-ownership batches via CLI, dispatch full-sdc per story, fan-in check, hand off merge to @devops. Use when: wave-execute, run wave, epic wave, parallel stories SDC.

Agents

aiox-analystAIOX Analyst autônomo. Market research, competitive analysis, brainstorming facilitation, ROI calculations, deep research. Usa task files reais do AIOX.aiox-architectAIOX Architect autônomo. Análise de impacto, design de arquitetura, validação de PRD, research. Usa task files reais do AIOX.aiox-data-engineerAIOX Data Engineer autônomo. Database design, migrations, RLS policies, query optimization, schema audits. Usa task files reais do AIOX.aiox-devAIOX Developer autônomo. Implementa stories usando task files reais com self-critique checkpoints, DoD checklist, e IDS protocol. Default: YOLO mode (autônomo, sem interação humana).aiox-devopsAIOX DevOps autônomo. Git operations, CI/CD, PR automation, pre-push quality gates, version management, MCP management. Usa task files reais do AIOX.aiox-pmAIOX Project Manager autônomo. Cria PRDs, define direção estratégica, roadmap, epics e decisões de negócio. Usa task files reais do AIOX.

Show all 18 agents

Commands

/aiox-master  /analyst  /architect  /data-engineer  /dev  /devops

Show all 24 commands

/pm  /po  /qa  /sm  /squad-creator  /ux-design-expert  /story-6.1.4**Story ID:** 6.1.4 **Epic:** Epic-6.1 - Agent Identity System **Wave:** Wave 1 (Foundation) **Status:** 📋 Ready to Start **Priority:** 🔴 Critical **Owner:** Dev (Dex) **Created:** 2025-01-14 **Updated:** 2025-01-17 (v4 - Unified System Integration) **Duration:** 2.5 days (20 /story-7.1.1**Story ID:** 7.1.1 **Epic:** Epic-7 - Dashboard Workspace Integration **Wave:** Wave 1 (Foundation) **Status:** ⌛ In Progress **Priority:** 🔴 High **Owner:** Architect (Aria) → Dev (Dex) **Created:** 2026-05-05 **Updated:** 2026-05-05 /greetGenerate contextual agent greeting using GreetingBuilder infrastructure./managerCRUD command router for managing SYNAPSE domains, rules, and star-commands./add-ruleAdds a new rule to an existing SYNAPSE domain file./create-commandCreates a new star-command block in the SYNAPSE commands domain file./create-domainCreates a new SYNAPSE domain file and registers it in the manifest./diagnose-synapseRun a comprehensive diagnostic of the SYNAPSE context engine, comparing expected vs. actual pipeline state, including **session performance analysis** with exact timing data./edit-ruleEdits or removes a rule by index in an existing SYNAPSE domain file./suggest-domainAnalyzes a rule and suggests the ideal SYNAPSE domain for it./toggle-domainToggles a SYNAPSE domain between active and inactive in the manifest./manifest-parser-referenceReference for the KEY=VALUE format used by the SYN-1 domain-loader parser.

README

Read on GitHub

AIOX Squad: Artificial Intelligence Orchestration eXperience

🌍 English | Português

🌐 README por idioma: EN | PT | ES | ZH

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.

Novo namespace npm: @aiox-squads/core é 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/*. Os comandos de CLI, incluindo aiox-core, permanecem preservados durante a transição.

Comece Aqui (10 Min)

Se é sua primeira vez no AIOX, siga este caminho linear:

Instale em um projeto novo ou existente:

# novo projeto
npx aiox-core init meu-projeto

# projeto existente
cd seu-projeto
npx aiox-core install

Escolha sua IDE/CLI e o caminho de ativação:

Claude Code: /agent-name
Gemini CLI: /aiox-menu → /aiox-<agent>
Codex CLI: /skills → aiox-<agent-id>
Cursor/Copilot/AntiGravity: siga os limites e workarounds em docs/ide-integration.md

Ative 1 agente e confirme o greeting.
Rode 1 comando inicial (*help ou equivalente) para validar first-value.

Definição de first-value (binária): ativação de agente + greeting válido + comando inicial com output útil em <= 10 minutos.

Compatibilidade de Hooks por IDE (Realidade AIOX 4.2)

Muitos recursos avançados do AIOX dependem de eventos de ciclo de vida (hooks). A tabela abaixo mostra a paridade real entre IDEs/plataformas:

IDE/CLI	Paridade de Hooks vs Claude	Impacto Prático
Claude Code	Completa (referência)	Automação máxima de contexto, guardrails e auditoria
Gemini CLI	Alta (eventos nativos)	Cobertura forte de automações pre/post tool e sessão
Codex CLI	Parcial/limitada	Parte das automações depende de `AGENTS.md`, `/skills`, MCP e fluxo operacional
Cursor	Sem lifecycle hooks equivalentes	Menor automação de pre/post tool; foco em regras, MCP e fluxo do agente
GitHub Copilot	Sem lifecycle hooks equivalentes	Menor automação de sessão/tooling; foco em instruções de repositório + MCP no VS Code
AntiGravity	Workflow-based (não hook-based)	Integração por workflows, não por eventos de hook equivalentes ao Claude

Impactos e mitigação detalhados: docs/ide-integration.md.

Visão Geral

Premissa Arquitetural: CLI First

O AIOX segue uma hierarquia clara de prioridades:

CLI First → Observability Second → UI Third

Camada	Prioridade	Foco	Exemplos
CLI	Máxima	Onde a inteligência vive. Toda execução, decisões e automação acontecem aqui.	Agentes (`@dev`, `@qa`), workflows, comandos
Observability	Secundária	Observar e monitorar o que acontece no CLI em tempo real.	Dashboard SSE, logs, métricas, timeline
UI	Terciária	Gestão pontual e visualizações quando necessário.	Kanban, settings, story management

Princípios derivados:

A CLI é a fonte da verdade - dashboards apenas observam
Funcionalidades novas devem funcionar 100% via CLI antes de ter UI
A UI nunca deve ser requisito para operação do sistema
Observabilidade serve para entender o que o CLI está fazendo, não para controlá-lo

As Duas Inovações Chave do AIOX:

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.

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.

Esta 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ê.

📖 Veja o fluxo de trabalho completo no Guia do Usuário - Fase de planejamento, ciclo de desenvolvimento e todos os papéis dos agentes

Pré-requisitos

Node.js >=18.0.0 (v20+ recomendado)
npm >=9.0.0
GitHub CLI (opcional, necessário para colaboração em equipe)

Problemas de instalação? Consulte o Guia de Troubleshooting

Guias específicos por plataforma:

Documentação multilíngue disponível: English | Português | Español | 中文

Navegação Rápida

Entendendo o Fluxo de Trabalho AIOX

Antes de mergulhar, revise estes diagramas críticos de fluxo de trabalho que explicam como o AIOX funciona:

Fluxo de Planejamento (Interface Web) - Como criar documentos de PRD e Arquitetura
Ciclo Principal de Desenvolvimento (IDE) - Como os agentes sm, dev e qa colaboram através de arquivos de histórias

⚠️ 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/dev/qa 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!

O que você gostaria de fazer?

Instalar e Construir software com Equipe Ágil Full Stack de IA → Instruções de Início Rápido
Aprender como usar o AIOX → Guia completo do usuário e passo a passo
Ver agentes IA disponíveis → Papéis especializados para sua equipe
Explorar usos não técnicos → Escrita criativa, negócios, bem-estar, educação
Criar meus próprios agentes IA → Construir agentes para seu domínio
Navegar Squads prontos → Veja como criar e usar equipes de agentes IA
Entender a arquitetura → Mergulho técnico profundo
Reportar problemas → Bug reports e feature requests

Importante: Mantenha Sua Instalação AIOX Atualizada

Mantenha-se atualizado sem esforço! Para atualizar sua instalação AIOX existente:

npx aiox-core@latest install

Isto vai:

✅ Detectar automaticamente sua instalação existente
✅ Atualizar apenas os arquivos que mudaram
✅ Criar arquivos de backup .bak para quaisquer modificações customizadas
✅ Preservar suas configurações específicas do projeto

Isto facilita beneficiar-se das últimas melhorias, correções de bugs e novos agentes sem perder suas customizações!

Início Rápido

🚀 Instalação via NPX (Recomendado)

Instale o AIOX com um único comando:

# Criar um novo projeto com assistente interativo moderno
npx aiox-core init meu-projeto

# Ou instalar em projeto existente
cd seu-projeto
npx aiox-core install

# Ou usar uma versão específica
npx aiox-core@latest init meu-projeto

✨ Assistente de Instalação Moderno

O AIOX agora inclui uma experiência de instalação interativa de última geração, inspirada em ferramentas modernas como Vite e Next.js:

Recursos do Instalador Interativo:

🎨 Interface Moderna: Prompts coloridos e visuais com @clack/prompts
✅ Validação em Tempo Real: Feedback instantâneo sobre entradas inválidas
🔄 Indicadores de Progresso: Spinners para operações longas (cópia de arquivos, instalação de deps)
📦 Seleção Multi-Componente: Escolha quais componentes instalar com interface intuitiva
⚙️ Escolha de Gerenciador de Pacotes: Selecione entre npm, yarn ou pnpm
⌨️ Suporte a Cancelamento: Ctrl+C ou ESC para sair graciosamente a qualquer momento
📊 Resumo de Instalação: Visualize todas as configurações antes de prosseguir
⏱️ Rastreamento de Duração: Veja quanto tempo levou a instalação

O instalador oferece:

✅ Download da versão mais recente do NPM
✅ Assistente de instalação interativo moderno
✅ Configuração automática do IDE (Codex CLI, Cursor ou Claude Code)
✅ Configuração de todos os agentes e fluxos de trabalho AIOX
✅ Criação dos arquivos de configuração necessários
✅ Inicialização do sistema de meta-agentes
✅ Verificações de saúde do sistema
✅ Suporte Cross-Platform: Testado em Windows, macOS e Linux

É 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.

Pré-requisitos: Node.js v18+ necessário (v20+ recomendado) | Troubleshooting

Atualizando uma Instalação Existente

Se você já tem o AIOX instalado:

npx aiox-core@latest install
# O instalador detectará sua instalação existente e a atualizará

Configure Seu IDE para Desenvolvimento AIOX

O AIOX inclui regras pré-configuradas para IDE para melhorar sua experiência de desenvolvimento:

Para Cursor:

Abra as configurações do Cursor
Navegue até User Rules
Copie o conteúdo de .cursor/global-rules.md
Cole na seção de regras e salve

Para Claude Code:

✅ Já configurado! O arquivo .claude/CLAUDE.md é carregado automaticamente
Sync dedicado de agentes: npm run sync:ide:claude
Validacao dedicada: npm run validate:claude-sync && npm run validate:claude-integration

Para Codex CLI:

✅ Integração de primeira classe no AIOX 4.2 (pipeline de ativação e greeting compartilhado)
✅ Já configurado! O arquivo AGENTS.md na raiz é carregado automaticamente
Opcional: sincronize agentes auxiliares com npm run sync:ide:codex
Recomendado neste repositório: gerar e versionar skills locais com npm run sync:skills:codex
Use npm run sync:skills:codex:global apenas fora deste projeto (para evitar duplicidade no /skills)
Validacao dedicada: npm run validate:codex-sync && npm run validate:codex-integration
Guardrails de skills/paths: npm run validate:codex-skills && npm run validate:paths

Para Gemini CLI:

✅ Regras e agentes sincronizaveis com npm run sync:ide:gemini
Arquivos gerados em .gemini/rules.md, .gemini/rules/AIOX/agents/ e .gemini/commands/*.toml
✅ Hooks e settings locais no fluxo de instalacao (.gemini/hooks/ + .gemini/settings.json)
✅ Ativacao rapida por slash commands (/aiox-menu, /aiox-dev, /aiox-architect, etc.)
Validacao dedicada: npm run validate:gemini-sync && npm run validate:gemini-integration
Paridade multi-IDE em um comando: npm run validate:parity

Estas regras fornecem:

🤖 Reconhecimento e integração de comandos de agentes
📋 Fluxo de trabalho de desenvolvimento dirigido por histórias
✅ Rastreamento automático de checkboxes
🧪 Padrões de teste e validação
📝 Padrões de código específicos do AIOX

Início Mais Rápido com Interface Web (2 minutos)

Instale o AIOX: Execute npx aiox-core init meu-projeto
Configure seu IDE: Siga as instruções de configuração para Codex CLI, Cursor ou Claude Code
Comece a Planejar: Ative um agente como @analyst para começar a criar seu briefing
Use comandos AIOX: Digite *help para ver comandos disponíveis
Siga o fluxo: Veja o Guia do usuário para mais detalhes

Referência de Comandos CLI

O AIOX oferece uma CLI moderna e cross-platform com comandos intuitivos:

# Gerenciamento de Projeto (com assistente interativo)
npx aiox-core init <nome-projeto> [opções]
  --force              Forçar criação em diretório não vazio
  --skip-install       Pular instalação de dependências npm
  --template <nome>    Usar template específico (default, minimal, enterprise)

# Instalação e Configuração (com prompts modernos)
npx aiox-core install [opções]
  --force              Sobrescrever configuração existente
  --quiet              Saída mínima durante instalação
  --dry-run            Simular instalação sem modificar arquivos

# Comandos do Sistema
npx aiox-core --version   Exibir versão instalada
npx aiox-core --help      Exibir ajuda detalhada
npx aiox-core info        Exibir informações do sistema
npx aiox-core doctor      Executar diagnósticos do sistema
npx aiox-core doctor --fix Corrigir problemas detectados automaticamente

# Manutenção
npx aiox-core update      Atualizar para versão mais recente
npx aiox-core uninstall   Remover AIOX

Recursos da CLI:

✅ Help System Abrangente: --help em qualquer comando mostra documentação detalhada
✅ Validação de Entrada: Feedback imediato sobre parâmetros inválidos
✅ Mensagens Coloridas: Erros em vermelho, sucessos em verde, avisos em amarelo
✅ Cross-Platform: Funciona perfeitamente em Windows, macOS e Linux
✅ Suporte a Dry-Run: Teste instalações sem modificar arquivos

💡 Exemplos de Uso

Instalação Interativa Completa

$ npx aiox-core install

🚀 AIOX Installation

◆ What is your project name?
│  my-awesome-project
│
◇ Which directory should we use?
│  ./my-awesome-project
│
◆ Choose components to install:
│  ● Core Framework (Required)
│  ● Agent System (Required)
│  ● Squads (optional)
│  ○ Example Projects (optional)
│
◇ Select package manager:
│  ● npm
│  ○ yarn
│  ○ pnpm
│
◆ Initialize Git repository?
│  Yes
│
◆ Install dependencies?
│  Yes
│
▸ Creating project directory...
▸ Copying framework files...
▸ Initializing Git repository...
▸ Installing dependencies (this may take a minute)...
▸ Configuring environment...
▸ Running post-installation setup...

✔ Installation completed successfully! (34.2s)

Next steps:
  cd my-awesome-project
  aiox-core doctor     # Verify installation
  aiox-core --help     # See available commands

Instalação Silenciosa (CI/CD)

# Instalação automatizada sem prompts
$ npx aiox-core install --quiet --force
✔ AIOX installed successfully

Simulação de Instalação (Dry-Run)

# Testar instalação sem modificar arquivos
$ npx aiox-core install --dry-run

[DRY RUN] Would create: ./my-project/
[DRY RUN] Would copy: .aiox-core/ (45 files)
[DRY RUN] Would initialize: Git repository
[DRY RUN] Would install: npm dependencies
✔ Dry run completed - no files were modified

Diagnóstico do Sistema

$ npx aiox-core doctor

🏥 AIOX System Diagnostics

✔ Node.js version: v20.10.0 (meets requirement: >=18.0.0)
✔ npm version: 10.2.3
✔ Git installed: version 2.43.0
✔ GitHub CLI: gh 2.40.1
✔ AIOX: v4.2.11

Configuration:
✔ .aiox-core/ directory exists
✔ Agent files: 11 found
✔ Workflow files: 8 found
✔ Templates: 15 found

Dependencies:
✔ @clack/prompts: ^0.7.0
✔ commander: ^12.0.0
✔ execa: ^9.0.0
✔ fs-extra: ^11.0.0
✔ picocolors: ^1.0.0

✅ All checks passed! Your installation is healthy.

Obter Ajuda

$ npx aiox-core --help

Usage: aiox-core [options] [command]

AIOX: AI-Orchestrated System for Full Stack Development

Options:
  -V, --version                output the version number
  -h, --help                   display help for command

Commands:
  init <project-name>          Create new AIOX project with interactive wizard
  install [options]            Install AIOX in current directory
  info                         Display system information
  doctor [options]             Run system diagnostics and health checks
  help [command]               display help for command

Run 'aiox-core <command> --help' for detailed information about each command.

Alternativa: Clonar e Construir

Para contribuidores ou usuários avançados que queiram modificar o código fonte:

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

# Instalar dependências
npm install

# Executar o instalador
npm run install:aiox

Configuração Rápida para Equipe

Para membros da equipe ingressando no projeto:

# Instalar AIOX no projeto
npx aiox-core@latest install

# Isto vai:
# 1. Detectar instalação existente (se houver)
# 2. Instalar/atualizar framework AIOX
# 3. Configurar agentes e workflows

🌟 Além do Desenvolvimento de Software - Squads

O 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 e aprenda a criar os seus próprios!

Agentes Disponíveis

O AIOX vem com 12 agentes especializados:

Agentes Meta

aiox-master - Agente mestre de orquestração (inclui capacidades de desenvolvimento de framework)
aiox-orchestrator - Orquestrador de fluxo de trabalho e coordenação de equipe

Agentes de Planejamento (Interface Web)

analyst - Especialista em análise de negócios e criação de PRD
pm (Product Manager) - Gerente de produto e priorização
architect - Arquiteto de sistema e design técnico
ux-expert - Design de experiência do usuário e usabilidade

Agentes de Desenvolvimento (IDE)

sm (Scrum Master) - Gerenciamento de sprint e criação de histórias
dev - Desenvolvedor e implementação
qa - Garantia de qualidade e testes
po (Product Owner) - Gerenciamento de backlog e histórias
data-engineer - Design de banco de dados e modelagem de dados
devops - CI/CD, infraestrutura e operações git (autoridade exclusiva de push)

Documentação e Recursos

Guias Essenciais

📖 Guia do Usuário - Passo a passo completo desde a concepção até a conclusão do projeto
🏗️ Arquitetura Principal - Mergulho técnico profundo e design do sistema
🚀 Guia de Squads - Estenda o AIOX para qualquer domínio além do desenvolvimento de software

Documentação Adicional

🤖 Guia de Squads - Crie e publique equipes de agentes IA
📋 Primeiros Passos - Tutorial passo a passo para iniciantes
🔧 Solução de Problemas - Soluções para problemas comuns
🎯 Princípios Orientadores - Filosofia e melhores práticas do AIOX
🏛️ Visão Geral da Arquitetura - Visão detalhada da arquitetura do sistema
⚙️ Guia de Ajuste de Performance - Otimize seu fluxo de trabalho AIOX
🔒 Melhores Práticas de Segurança - Segurança e proteção de dados
🔄 Guia de Migração - Migração de versões anteriores
📦 Versionamento e Releases - Política de versões

🤖 AIOX Autonomous Development Engine (ADE)

O AIOX introduz o Autonomous Development Engine (ADE) - um sistema completo para desenvolvimento autônomo que transforma requisitos em código funcional.

🎯 O Que é o ADE?

O ADE é um conjunto de 7 Epics que habilitam execução autônoma de desenvolvimento:

Epic	Nome	Descrição
1	Worktree Manager	Isolamento de branches via Git worktrees
2	Migration V2→V3	Migração para formato autoClaude V3
3	Spec Pipeline	Transforma requisitos em specs executáveis
4	Execution Engine	Executa specs com 13 steps + self-critique
5	Recovery System	Recuperação automática de falhas
6	QA Evolution	Review estruturado em 10 fases
7	Memory Layer	Memória persistente de padrões e insights

🔄 Fluxo Principal

User Request → Spec Pipeline → Execution Engine → QA Review → Working Code
                                      ↓
                              Recovery System
                                      ↓
                               Memory Layer

⚡ Quick Start ADE

# 1. Criar spec a partir de requisito
@pm *gather-requirements
@architect *assess-complexity
@analyst *research-deps
@pm *write-spec
@qa *critique-spec

# 2. Executar spec aprovada
@architect *create-plan
@architect *create-context
@dev *execute-subtask 1.1

# 3. QA Review
@qa *review-build STORY-42

📖 Documentação ADE

Guia Completo do ADE - Tutorial passo a passo
Alterações nos Agentes - Comandos e capabilities por agente
Epic 1 - Worktree Manager
Epic 2 - Migration V2→V3
Epic 3 - Spec Pipeline
Epic 4 - Execution Engine
Epic 5 - Recovery System
Epic 6 - QA Evolution
Epic 7 - Memory Layer

🆕 Novos Comandos por Agente

@devops:

*create-worktree, *list-worktrees, *merge-worktree, *cleanup-worktrees
*inventory-assets, *analyze-paths, *migrate-agent, *migrate-batch

@pm:

*gather-requirements, *write-spec

@architect:

*assess-complexity, *create-plan, *create-context, *map-codebase

@analyst:

*research-deps, *extract-patterns

@qa:

*critique-spec, *review-build, *request-fix, *verify-fix

@dev:

*execute-subtask, *track-attempt, *rollback, *capture-insights, *list-gotchas, *apply-qa-fix

Criando Seu Próprio Squad

Squads permitem estender o AIOX para qualquer domínio. Estrutura básica:

squads/seu-squad/
├── config.yaml           # Configuração do squad
├── agents/              # Agentes especializados
├── tasks/               # Fluxos de trabalho de tarefas
├── templates/           # Templates de documentos
├── checklists/          # Checklists de validação
├── data/                # Base de conhecimento
├── README.md            # Documentação do squad
└── user-guide.md        # Guia do usuário

Veja o Guia de Squads para instruções detalhadas.

Squads Disponíveis

Squads são equipes modulares de agentes IA. Veja a Visão Geral de Squads para mais informações.

Squads Externos

hybrid-ops - Operações híbridas humano-agente (repositório separado)

AIOX Pro

O AIOX Pro é o módulo premium do AIOX, oferecendo funcionalidades avançadas para equipes e projetos de maior escala.

Disponibilidade restrita: O AIOX Pro está disponível exclusivamente para membros do AIOX Cohort Advanced. Saiba mais sobre o programa.

Para saber como acessar, ativar, recuperar conta e validar as squads Pro, consulte o Guia de Acesso ao AIOX Pro.

Instalação

npx -y -p @aiox-squads/core@latest aiox pro setup

Identificação Estável de Máquina (>= 5.0.8)

O 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/interface ativa.

Caches 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.

Features Premium

Squads Avançados - Squads especializados com capacidades expandidas
Memory Layer - Memória persistente de padrões e insights entre sessões
Métricas & Analytics - Dashboard de produtividade e métricas de desenvolvimento
Integrações Enterprise - Conectores para Jira, Linear, Notion e mais
Configuração em Camadas - Sistema de configuração L1-L4 com herança
Licenciamento - Gerenciamento de licença via aiox pro activate --key <KEY>

Para mais informações, execute npx aiox-core pro --help após a instalação.

Suporte

🐛 Rastreador de Issues - Bug reports e feature requests
💡 Processo de Features - Como propor novas funcionalidades
📋 Como Contribuir
🗺️ Roadmap - Veja o que estamos construindo
🤖 Guia de Squads - Crie equipes de agentes IA

Git Workflow e Validação

O AIOX implementa um sistema de validação de múltiplas camadas para garantir qualidade do código e consistência:

🛡️ Defense in Depth - 3 Camadas de Validação

Camada 1: Pre-commit (Local - Rápida)

✅ ESLint - Qualidade de código
✅ TypeScript - Verificação de tipos
⚡ Performance: <5s
💾 Cache habilitado

Camada 2: Pre-push (Local - Validação de Stories)

✅ Validação de checkboxes de histórias
✅ Consistência de status
✅ Seções obrigatórias

Camada 3: CI/CD (Cloud - Obrigatório para merge)

✅ Todos os testes
✅ Cobertura de testes (80% mínimo)
✅ Validações completas
✅ GitHub Actions

📖 Documentação Detalhada

📋 Guia Completo de Git Workflow - Guia detalhado do fluxo de trabalho
📋 CONTRIBUTING.md - Guia de contribuição

Comandos Disponíveis

# Validações locais
npm run lint           # ESLint
npm run typecheck      # TypeScript
npm test              # Testes
npm run test:coverage # Testes com cobertura

# Validador AIOX
node .aiox-core/utils/aiox-validator.js pre-commit   # Validação pre-commit
node .aiox-core/utils/aiox-validator.js pre-push     # Validação pre-push
node .aiox-core/utils/aiox-validator.js stories      # Validar todas stories

Branch Protection

Configure proteção da branch master com:

node scripts/setup-branch-protection.js

Requer:

GitHub CLI (gh) instalado e autenticado
Acesso de admin ao repositório

Contribuindo

Estamos empolgados com contribuições e acolhemos suas ideias, melhorias e Squads! 🎉

Para contribuir:

Fork o repositório
Crie uma branch para sua feature (git checkout -b feature/MinhaNovaFeature)
Commit suas mudanças (git commit -m 'feat: Adicionar nova feature')
Push para a branch (git push origin feature/MinhaNovaFeature)
Abra um Pull Request

Veja também:

📋 Como Contribuir com Pull Requests
📋 Guia de Git Workflow

📄 Legal

Documento	English	Português
Licença	MIT License	-
Modelo de Licença	Core vs Pro	-
Privacidade	Privacy Policy	-
Termos de Uso	Terms of Use	-
Código de Conduta	Code of Conduct	PT-BR
Contribuição	Contributing	PT-BR
Segurança	Security	PT-BR
Comunidade	Community	PT-BR
Roadmap	Roadmap	PT-BR
Changelog	Version History	-

Contribuidores

🌟 Contribuidores da Comunidade

Construído com ❤️ para a comunidade de desenvolvimento assistido por IA

⬆ Voltar ao topo

File tree

1652

SynkraAI/aiox-coreView on GitHub

.aiox/
.aiox-core/
  cli/
    commands/
      config/
        index.js
      generate/
        index.js
      manifest/
        index.js
        regenerate.js
        validate.js
      mcp/
        add.js
        index.js
        link.js
        setup.js
        status.js
      metrics/
        cleanup.js
        index.js
        record.js
        seed.js
        show.js
      migrate/
        analyze.js
        backup.js
        execute.js
        index.js
        rollback.js
        update-imports.js
        validate.js
      pro/
        buyer.js
        index.js
        seats.js
      qa/
        index.js
        run.js
        status.js
      sdc/
        index.js
      validate/
        index.js
      wave/
        index.js
      workers/
        formatters/
          info-formatter.js
          list-table.js
          list-tree.js
        index.js
        info.js
        list.js
        search-filters.js
        search-keyword.js
        search-semantic.js
        search.js
        utils/
          pagination.js
    index.js
    utils/
      output-formatter-cli.js
      score-calculator.js
  constitution.md
  core/
  core-config.yaml
    code-intel/
      code-intel-client.js
      code-intel-enricher.js
      helpers/
        creation-helper.js
        dev-helper.js
        devops-helper.js
        planning-helper.js
        qa-helper.js
        story-helper.js
      hook-runtime.js
      index.js
      providers/
        code-graph-provider.js
        provider-interface.js
        registry-provider.js
      registry-syncer.js
    config/
      config-cache.js
      config-loader.js
      config-resolver.js
      env-interpolator.js
      merge-utils.js
      migrate-config.js
      schemas/
        framework-config.schema.json
        local-config.schema.json
        project-config.schema.json
        user-config.schema.json
      template-overrides.js
      templates/
        user-config.yaml
    docs/
      component-creation-guide.md
      session-update-pattern.md
      SHARD-TRANSLATION-GUIDE.md
      template-syntax.md
      troubleshooting-guide.md
    doctor/
      checks/
        agent-memory.js
        claude-md.js
        code-intel.js
        commands-count.js
        core-config.js
        entity-registry.js
        framework-3way-diff.js
        git-hooks.js
        graph-dashboard.js
        hooks-claude-count.js
        ide-sync.js
        index.js
        node-version.js
        npm-packages.js
        port-denylist.js
        rules-files.js
        settings-json.js
        skills-count.js
        windows-npx-install.js
      fix-handler.js
      formatters/
        json.js
        text.js
      index.js
    elicitation/
      agent-elicitation.js
      elicitation-engine.js
      session-manager.js
      task-elicitation.js
      workflow-elicitation.js
    errors/
      aiox-error.js
      constants.js
      error-registry.js
      index.js
      pro-error-registry.js
      serializer.js
      utils.js
    events/
      dashboard-emitter.js
      index.js
      types.js
    execution/
      autonomous-build-loop.js
      build-orchestrator.js
      build-state-manager.js
      context-injector.js
      parallel-executor.js
      parallel-monitor.js
      rate-limit-manager.js
      result-aggregator.js
      semantic-merge-engine.js
      subagent-dispatcher.js
      wave-executor.js
    external-executors/
      delegate-cli.js
      index.js
    graph-dashboard/
      cli.js
      data-sources/
        code-intel-source.js
        metrics-source.js
        registry-source.js
      formatters/
        dot-formatter.js
        html-formatter.js
        json-formatter.js
        mermaid-formatter.js
      index.js
      renderers/
        stats-renderer.js
        status-renderer.js
        tree-renderer.js
    health-check/
      base-check.js
      check-registry.js
      checks/
        deployment/
          build-config.js
          ci-config.js
          deployment-readiness.js
          docker-config.js
          env-file.js
          index.js
        index.js
        local/
          disk-space.js
          environment-vars.js
          git-install.js
          ide-detection.js
          index.js
          memory.js
          network.js
          npm-install.js
          shell-environment.js
        project/
          agent-config.js
          aiox-directory.js
          dependencies.js
          framework-config.js
          index.js
          node-version.js
          package-json.js
          task-definitions.js
          workflow-dependencies.js
        repository/
          branch-protection.js
          commit-history.js
          conflicts.js
          git-repo.js
          git-status.js
          gitignore.js
          index.js
          large-files.js
          lockfile-integrity.js
        services/
          api-endpoints.js
          claude-code.js
          gemini-cli.js
          github-cli.js
          index.js
          mcp-integration.js
      engine.js
      healers/
        backup-manager.js
        index.js
      index.js
      reporters/
        console.js
        index.js
        json.js
        markdown.js
    ideation/
      ideation-engine.js
    ids/
      circuit-breaker.js
      framework-governor.js
      gates/
        g1-epic-creation.js
        g2-story-creation.js
        g3-story-validation.js
        g4-dev-context.js
        g5-semantic-handshake.js
      incremental-decision-engine.js
      index.js
      layer-classifier.js
      README.md
      registry-healer.js
      registry-loader.js
      registry-updater.js
      verification-gate.js
    index.esm.js
    index.js
    install/
      windows-npx-hint.js
    manifest/
      manifest-generator.js
      manifest-validator.js
    mcp/
      config-migrator.js
      global-config-manager.js
      index.js
      os-detector.js
      symlink-manager.js
    memory/
      __tests__/
        active-modules.verify.js
      gotchas-memory.js
    migration/
      migration-config.yaml
      module-mapping.yaml
    orchestration/
      agent-invoker.js
      bob-orchestrator.js
      bob-status-writer.js
      bob-surface-criteria.yaml
      brownfield-handler.js
      checklist-runner.js
      cli-commands.js
      condition-evaluator.js
      context-manager.js
      dashboard-integration.js
      data-lifecycle-manager.js
      epic-context-accumulator.js
      execution-profile-resolver.js
      executor-assignment.js
      executors/
        epic-3-executor.js
        epic-4-executor.js
        epic-5-executor.js
        epic-6-executor.js
        epic-executor.js
        index.js
      fast-path-gate.js
      gate-evaluator.js
      gemini-model-selector.js
      greenfield-handler.js
      index.js
      lock-manager.js
      master-orchestrator.js
      message-formatter.js
      parallel-executor.js
      recovery-handler.js
      session-state.js
      skill-dispatcher.js
      subagent-prompt-builder.js
      surface-checker.js
      task-complexity-classifier.js
      tech-stack-detector.js
      terminal-spawner.js
      workflow-executor.js
      workflow-orchestrator.js
    permissions/
      __tests__/
        path-guard.test.js
        permission-mode.test.js
        prompt-guard.test.js
        ssrf-guard.test.js
      dispatch-governance.js
      index.js
      operation-guard.js
      path-guard.js
      permission-mode.js
      prompt-guard.js
      ssrf-guard.js
    pro/
      pro-updater.js
    quality-gates/
      base-layer.js
      checklist-generator.js
      focus-area-recommender.js
      human-review-orchestrator.js
      layer1-precommit.js
      layer2-pr-automation.js
      layer3-human-review.js
      notification-manager.js
      quality-gate-config.yaml
      quality-gate-manager.js
    README.md
    registry/
      build-registry.js
      README.md
      registry-loader.js
      registry-schema.json
      service-registry.json
      validate-registry.js
    resilience/
      agent-immortality.js
      index.js
      README.md
    sdc/
      dispatch-adapter.js
      epic-glue.js
      index.js
      phase-verify.js
      progress.js
      story-meta.js
      wave-plan.js
      wave-run.js
    security/
      port-denylist.js
    session/
      context-detector.js
      context-loader.js
    synapse/
      context/
        context-builder.js
        context-tracker.js
        hierarchical-context-manager.js
        index.js
        README.md
        semantic-handshake-engine.js
      diagnostics/
        collectors/
          consistency-collector.js
          hook-collector.js
          manifest-collector.js
          output-analyzer.js
          pipeline-collector.js
          quality-collector.js
          relevance-matrix.js
          safe-read-json.js
          session-collector.js
          timing-collector.js
          uap-collector.js
        report-formatter.js
        synapse-diagnostics.js
      domain/
        domain-loader.js
      engine.js
      layers/
        l0-constitution.js
        l1-global.js
... 1600 more

Showing a partial view of a very large repo.

FAQ

aiox-core is a Claude Code plugin with 27 hand-picked skills for development work, indexed on Flowy. Install it with the command on its page. It includes aiox-master, analyst, architect. Its skills do not fire on their own yet. Request auto-invocation to have Flowy route them as you prompt. Free and open source.

What is aiox-core?: 🌐 README por idioma: EN | PT | ES | ZH 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.
How do I install aiox-core?: Run these in Claude Code: npx -y skills add SynkraAI/aiox-core --agent claude-code. Then prompt normally.
Does aiox-core auto-invoke its skills?: Not yet. It is indexed on Flowy as a plain plugin. Request auto-invocation on its page and Flowy will route its skills for you as you prompt.
Is aiox-core free?: Yes. Flowy is free and open source, with nothing gated. You can read every skill in full before you install.