Framework de Automação

Automação que realmente funciona

FASE automatiza tarefas de desenvolvimento, pesquisa, planejamento e execução com agentes de IA paralelos. Construído para Claude Code, OpenCode, Gemini e Codex.

Ver no GitHub
✓ v5.1.1 - Todos os 414 testes passando (Issue #9 Completo)
Error handling standardization • Agent documentation patterns fixed • 100% test coverage maintained
13
Agentes
34
Comandos
6
Runtimes

O que faz

Agents Paralelos
Spawn múltiplos agents de IA de forma autônoma para pesquisa, planejamento e execução em paralelo.
Spec-Driven
Desenvolvimento guiado por especificação com critérios de sucesso verificáveis para cada fase.
Arquitetura Limpa
Separação clara entre pesquisa, planejamento, execução e verificação com checkpoints persistentes.
Multi-Runtime
Funciona com Claude Code, OpenCode, Gemini e Codex com o mesmo conjunto de comandos.
Context Aware
Gerenciamento inteligente de contexto com persistência de estado para trabalho de longa duração.
Validação Automática
Verificação de fase com goal-backward analysis garante que objetivos são alcançados.

Instalar FASE

Execute o instalador interativo para escolher seu(s) runtime(s) preferido(s):

npx fase-ai

Exemplo do instalador interativo: 

$ npx fase-ai

╔════════════════════════════════════════════════════════════════╗
║ FASE - Framework de Automação Sem Enrolação                 ║
║ Instalador Interativo v5.1.0                                   ║
╚════════════════════════════════════════════════════════════════╝

? Qual runtime você deseja usar? (use ↑↓ para navegar)
❯ Claude Code         - IA avançada da Anthropic
  OpenCode            - código aberto, modelos gratuitos
  Gemini              - IA multimodal do Google
  Codex               - modelo de codificação da OpenAI
  GitHub Copilot      - copiloto de IA por GitHub
  Qwen Code           - IA da Alibaba Cloud
  Todos               - instalar todos os runtimes
  Desinstalar         - remover FASE
  Sair                - sair sem instalar

✓ Instalando dependências...
✓ Configurando comandos...
✓ Copiando agentes de IA...

╔════════════════════════════════════════════════════════════════╗
║ ✓ Instalação concluída com sucesso!                            ║
║                                                                ║
║ Próximos passos:                                               ║
║ $ /fase-ajuda        (ver comandos disponíveis)                ║
║ $ /fase-novo-projeto (iniciar novo projeto)                    ║
╚════════════════════════════════════════════════════════════════╝

Ou instale com flags (não-interativo):

npx fase-ai --claude 
$ npx fase-ai --claude

✓ Runtime: Claude Code
✓ Instalando em: ~/.claude/
✓ Configurando bash profile...
✓ Ativando comandos FASE...

╔════════════════════════════════════════════════════════════════╗
║ ✓ Pronto! Use /fase-ajuda para começar                         ║
╚════════════════════════════════════════════════════════════════╝
npx fase-ai --opencode 
$ npx fase-ai --opencode

✓ Runtime: OpenCode
✓ Instalando em: ./.opencode/
✓ Copiando comandos...
✓ Gerando configurações...

╔════════════════════════════════════════════════════════════════╗
║ ✓ Pronto! Use /fase-ajuda no terminal                          ║
╚════════════════════════════════════════════════════════════════╝
npx fase-ai --all 
$ npx fase-ai --all

✓ Instalando para todos os runtimes:
  ✓ Claude Code
  ✓ OpenCode
  ✓ Gemini
  ✓ Codex
  ✓ GitHub Copilot
  ✓ Qwen Code

╔════════════════════════════════════════════════════════════════╗
║ ✓ Todos os runtimes configurados com sucesso!                  ║
║                                                                ║
║ Comece agora:                                                  ║
║ $ /fase-novo-projeto                                           ║
║ $ /fase-novo-marco                                             ║
║ $ /fase-executar-etapa                                         ║
╚════════════════════════════════════════════════════════════════╝

Runtimes Suportados

Claude Code
Editor IA da Anthropic
~/.claude
OpenCode
Editor moderno de código
~/.config/opencode
Gemini
Studio do Google
~/.gemini
Codex
IDE Multi-Agente
~/.codex
GitHub Copilot
Copiloto de IA por GitHub
~/.github-copilot
Qwen Code
IA da Alibaba Cloud
~/.qwen

Workflow Típico

1.
/fase-novo-projeto
Inicializar projeto com contexto profundo
2.
/fase-planejar-fase
Pesquisar e planejar primeira fase
3.
/fase-executar-fase
Executar com checkpoint automático
4.
/fase-verificar-trabalho
Validar resultados contra requisitos
5.
/fase-progresso
Ver status e próximos passos

Cobertura de Testes

9/9
Testes de Instalação
• 6 providers individuais
• Instalação em lote
• Desinstalação
~97 segundos
11/11
Testes de Interação TUI
• Simulação de usuário
• Captura de comandos
• 6 providers integrados
~60 segundos
41+
Testes de Edge Cases
• Symlinks
• Caracteres especiais
• Race conditions
• Encoding issues

Executar testes localmente:

npm run test:tmux
npm run test:tmux:interaction
npm run test:all

Veja a documentação completa de testes em Guia de Testes