FlowAI

Um workflow de engenharia confiável para agentes de código

Planejamento, implementação, validação e memória de projeto em um fluxo reutilizável.

O que é

FlowAI é uma biblioteca de workflow para agentes de programação. Ela adiciona ao projeto um contrato operacional, skills especializadas e uma base de conhecimento Obsidian, ajudando o agente a:

• entender o pedido antes de editar;
• preservar alterações existentes;
• planejar mudanças não triviais;
• executar validações proporcionais ao risco;
• registrar decisões e conhecimento durável;
• evitar declarações de sucesso sem evidências.

Escolha seu pacote

| Pacote | Indicado para | Integração | | --- | --- | --- | | @mvoikolesco/flowai | Projetos que utilizam OpenCode | Completa: agents, commands, skills, plugins e tools | | @mvoikolesco/flowai-portable | Qualquer agente compatível com AGENTS.md | Portátil: contrato, skills e memória Obsidian |

Instalação completa com OpenCode

Requer Node.js 20.11 ou superior e OpenCode instalado.

npm install --save-dev @mvoikolesco/flowai
npx flowai init
npx flowai doctor

O comando cria ou atualiza:

AGENTS.md
opencode.jsonc
.opencode/
obsidian/

Depois, abra o OpenCode no diretório do projeto:

opencode

Comandos disponíveis dentro do OpenCode incluem /quest, /scout, /map, /forge, /trial, /council e /mend.

Instalação portátil

Use esta versão com Codex, Claude Code, Cursor ou outro agente capaz de ler instruções em AGENTS.md:

npm install --save-dev @mvoikolesco/flowai-portable
npx flowai init

Ela instala somente os recursos compartilhados:

AGENTS.md
obsidian/

O pacote portátil não contém configuração, adapters, agents, commands, plugins ou tools específicos do OpenCode.

CLI

Na distribuição completa:

flowai init [--portable] [--force] [--dry-run]
flowai doctor
flowai analyze "<solicitação>"
flowai execute "<solicitação>" [--task=<nome>] [--dry-run]
flowai validate [--json]
flowai version

Na distribuição portátil:

flowai init [--dry-run]
flowai analyze "<solicitação>"
flowai validate [--json]
flowai version

Segurança e preservação

• Arquivos de conhecimento existentes não são sobrescritos.
• Reinstalações são idempotentes.
• Conflitos com caminhos OpenCode exigem --force e recebem backup.
• Publicação, commit, push e deploy exigem autorização explícita.
• Segredos e logs brutos não devem ser armazenados na memória do projeto.

Desenvolvimento

As instruções para desenvolvimento, testes e publicação estão em README.dev.md.

Licença

Distribuído sob a licença MIT.