npm package: @justmpm/flow
Description: MCP Server para entregar instruções de comandos fase por fase sob demanda
Author: Koda AI Studio
Latest version: 1.2.0

# @justmpm/flow

MCP Server para instruções faseadas. Entregue comandos em fases, não tudo de uma vez.

## Instalação

```bash
npm install -g @justmpm/flow
```

## Uso

Adicione ao seu cliente MCP:

```json
{
  "mcpServers": {
    "flow": {
      "command": "flow"
    }
  }
}
```

## Tools

| Tool   | Descrição               | Parâmetros                         |
| ------ | ----------------------- | ---------------------------------- |
| `get`  | Instruções de uma fase  | `command: string`, `phase: number` |
| `info` | Estrutura do flow       | `command: string`                  |
| `list` | Lista flows disponíveis | (sem parâmetros)                   |

## Exemplos de Uso

### Listar flows disponíveis

```
list
```

### Ver estrutura de um flow

```
info command="audit"
```

### Obter instruções de uma fase

```
get command="audit" phase=1
```

## Criando um Flow

**Diretório:** `~/.config/flow/`

```
.config/flow/
└── meu-comando/
    ├── flow.json
    ├── 1.md
    ├── 2.md
    └── ...
```

**flow.json:**

```json
{
  "name": "meu-comando",
  "description": "O que este comando faz",
  "totalPhases": 3,
  "phases": [
    { "number": 1, "title": "Preparação" },
    { "number": 2, "title": "Execução" },
    { "number": 3, "title": "Validação" }
  ]
}
```

**1.md, 2.md, 3.md:**
Conteúdo markdown de cada fase.

## Exemplo de Resposta

### Tool `get`

```
╔════════════════════════════════════════════════════════════════╗
║  FASE 1/3: Preparação                                          ║
╚════════════════════════════════════════════════════════════════╝

[conteúdo das instruções da fase 1...]

━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
PRÓXIMA FASE: get command="audit" phase=2
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
```

### Tool `info`

```
╔════════════════════════════════════════════════════════════════╗
║  audit                                                         ║
╚════════════════════════════════════════════════════════════════╝

Auditoria profissional de código

FASES (5):
  1. Setup
  2. Análise Estática
  3. Revisão Manual
  4. Relatório
  5. Correções

━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
INICIAR: get command="audit" phase=1
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
```

### Mensagem de Erro (validação)

```
╔════════════════════════════════════════════════════════════════╗
║                    ERRO DE VALIDAÇÃO                           ║
╚════════════════════════════════════════════════════════════════╝

┌─────────────────────────────────────────┐
│ PARÂMETROS ESPERADOS:                   │
│   ├── command: string (obrigatório)     │
│   │   └── ex: audit                     │
│   └── phase: number (obrigatório)       │
│       └── ex: 1                         │
└─────────────────────────────────────────┘

SEU INPUT:
  ❌ phase: Required (recebido: undefined)

EXEMPLO (formato MCP):
<function_calls>
<invoke name="get">
  <parameter name="command">audit</parameter>
  <parameter name="phase">1</parameter>
</invoke>
</function_calls>
```

## CLI

```bash
flow --help       # Ajuda completa
flow --version    # Versão
flow              # Inicia servidor MCP
```

## Configuração Avançada

Diretório personalizado:

```bash
export FLOWS_DIR="/caminho/customizado"
```

## Licença

MIT © Koda AI Studio