O CortexCrew coloca um time de agentes IA especializados trabalhando no seu projeto — QA Engineer, Code Reviewer, Software Architect e mais. Cada agente tem um papel definido e eles colaboram compartilhando contexto entre si para elevar a qualidade do seu software de forma autônoma.

📋 Índice

• Recursos
• Instalação
• Início Rápido
• Providers Suportados
• Comandos Disponíveis
• Estrutura de Saída
• Integração Mobile (Appium)
• Agentes Disponíveis

✨ Recursos

• 🤖 Multi-Agentes: Arquitetura baseada em papéis (QA, Reviewer, Architect).
• 📱 Integração Mobile Real: Geração e execução autônoma de testes com Appium.
• 🔧 Agnóstico a Frameworks: Funciona com Angular, React, Ionic, Vue, etc.
• 🔄 Auto-Healing: Testes que quebram são corrigidos automaticamente pela IA.
• 📊 Análise Arquitetural: Avaliações profundas sobre padrões e dívida técnica.

🚀 Instalação

Pré-requisitos

• Node.js >= 20.0.0
• NPM ou Yarn

# Clone o repositório
git clone https://github.com/CortexCrewLab/CortexCrew.git
cd CortexCrew

# Instale as dependências
npm install

# Instale globalmente (recomendado para uso via CLI)
npm link

⚡ Início Rápido

1. Inicialize o CortexCrew no seu projeto alvo

Navegue até a pasta do projeto que você quer analisar e rode:

cd meu-projeto
cortexcrew init

Ou de forma parametrizada:

cortexcrew init \
  --name "Meu App" \
  --type ionic-angular \
  --stack "Angular,Ionic,TypeScript" \
  --lang pt-BR \
  --provider openai \
  --model gpt-4o-mini

Isso criará a seguinte estrutura no seu projeto:

meu-projeto/
 ├── .cortexcrew.json          ← configuração do projeto
 ├── .cortexcrew/
 │    └── elements.json        ← mapeamento de elementos (mobile)
 └── .env.cortexcrew.example   ← template de API keys

2. Configure suas Chaves de API

Copie o arquivo de exemplo e insira suas chaves no .env:

cp .env.cortexcrew.example .env

🔑 Providers Suportados

| Provider | Variável de Ambiente | Modelos Populares | |----------|---------------------|-------------------| | OpenAI | OPENAI_API_KEY | gpt-4o, gpt-4o-mini | | Anthropic | ANTHROPIC_API_KEY | claude-3-5-sonnet, claude-3-haiku | | Google Gemini | GEMINI_API_KEY | gemini-1.5-pro, gemini-1.5-flash |

💻 Comandos Disponíveis

qa — QA Engineer

Foco em cobertura de testes e geração de specs.

cortexcrew qa analyze src/services/auth.service.ts
cortexcrew qa generate src/services/auth.service.ts

review — Code Reviewer

Foco em análise estática, boas práticas e refatoração em nível de arquivo.

cortexcrew review file src/components/login.component.ts

architect — Software Architect

Visão macro, padrões de projeto e dívida técnica.

cortexcrew architect analyze src/app.module.ts
cortexcrew architect patterns src/services/data.service.ts
cortexcrew architect refactor src/components/home.component.ts

pipeline — Pipeline Completo

Dispara o fluxo colaborativo (QA → Spec → Review).

cortexcrew pipeline src/services/auth.service.ts

mobile — Pipeline Mobile (Appium)

Análise de riscos → DSL → Spec Appium → Execução → Diagnóstico.

cortexcrew mobile src/services/auth.service.ts --platform android
cortexcrew mobile src/services/auth.service.ts --platform ios

history — Histórico de Execuções

cortexcrew history              # resumo geral
cortexcrew history --flaky      # testes instáveis detectados
cortexcrew history --groups     # falhas agrupadas por rootCause

📁 Estrutura de Saída

Todos os artefatos são mantidos na pasta .cortexcrew/ do seu projeto alvo. O CortexCrew não modifica seu código-fonte automaticamente sem o seu consentimento explícito.

.cortexcrew/
 ├── generated/
 │    └── specs/           ← specs geradas pelo qa generate
 ├── specs/                ← specs Appium (mobile pipeline)
 │    ├── *.spec.ts        ← spec principal
 │    └── *.healed.spec.ts ← spec após auto-healing
 ├── history/
 │    ├── failures.json    ← histórico de falhas
 │    └── flaky-tests.json ← testes identificados instáveis
 └── elements.json         ← registry de seletores (mobile)

📱 Integração Mobile (Appium)

Pré-requisitos Appium

npm install -g appium
appium driver install uiautomator2   # Android
appium driver install xcuitest       # iOS

Mapeando Elementos

Edite .cortexcrew/elements.json e insira as chaves cross-platform, garantindo que elas existam no testID dos seus componentes (ex: Angular/React Native/Flutter).

{
  "login_button": {
    "android": "~login_button",
    "ios": "~login_button"
  }
}

Executando Testes Reais

# 1. Inicie o servidor Appium em um terminal separado
appium

# 2. Com um emulador aberto, execute o pipeline mobile
cortexcrew mobile src/app/login/login.page.ts --platform android

🤖 Agentes Disponíveis

| Agente | Status | Papel e Capacidades | |--------|--------|----------------------| | QA Engineer | ✅ Ativo | Análise de cobertura, riscos, geração de TDD/BDD, Appium auto-healing. | | Code Reviewer | ✅ Ativo | Code review detalhado, detecção de anti-patterns, complexidade ciclomática. | | Software Architect | ✅ Ativo | Score arquitetural, adequação aos padrões, macro refatorações. | | DevOps | 🔜 Planejado | Otimização de CI/CD, pipelines, Dockerfiles e performance. | | Security | 🔜 Planejado | Análise SAST/DAST autônoma, mapeamento OWASP. |

❓ Dúvidas Frequentes