Antes de começar

Você precisa do Node.js 20 ou mais recente e de uma configuração do Claude Code funcionando. O mini se apoia no Claude Code: ele mantém o estado do seu projeto e imprime o prompt certo, enquanto o Claude faz o trabalho dentro da sua sessão.

Instalação

Instale a CLI globalmente pelo npm. O comando se chama mini:

npm install -g mini-orchestrator@latest

Uma instalação global conecta os comandos de barra /mini:* ao Claude Code automaticamente. Para atualizar, rode o mesmo comando de novo. Em uma instalação local ou de CI, rode mini install-commands uma vez manualmente.

Seu primeiro projeto

Crie uma pasta de projeto e deixe o mini conduzi-la uma fase de cada vez. Rode isto dentro da pasta:

mkdir my-project && cd my-project

mini init        # 4 perguntas → cria .mini/project.md e .mini/state.json
mini next        # o Claude propõe a primeira fase
mini do          # inicia uma sessão do Claude Code na fase
mini done        # "funciona?" → faz o estado avançar

mini init Responda 4 perguntas; o mini escreve o estado do projeto em .mini/.
mini next O Claude propõe uma fase pequena e verificável.
mini discuss Opcional. Converse sobre uma fase complicada antes de planejá-la.
mini do Uma sessão do Claude Code implementa a fase.
mini done Você confirma que funciona e o estado avança.

Dentro do Claude Code: comandos de barra

Cada passo também tem uma forma de barra /mini:* nativa que você roda dentro de uma sessão do Claude Code — o mini imprime o prompt, o Claude faz o trabalho e salva o estado de volta. Os passos opcionais (discuss, verify) ficam tracejados. Clique em qualquer comando para sua documentação:

/mini:init Responda 4 perguntas; o mini escreve o estado do projeto em .mini/.
/mini:next O Claude propõe uma fase pequena e verificável.
/mini:discuss Opcional. Converse sobre uma fase complicada antes de planejá-la.
/mini:plan Divida a fase em passos concretos e verificáveis.
/mini:do Uma sessão do Claude Code implementa a fase.
/mini:verify Opcional. Uma revisão de UI/UX a fundo por uma pessoa.
/mini:done Você confirma que funciona e o estado avança.

As duas formas fazem o mesmo — escolha o comando de terminal ou a forma de barra conforme onde você está. Cada comando tem sua própria página no manual cobrindo as duas formas.

O atalho auto

Quer sem usar as mãos? O mini auto encadeia next → plan → do → done em sequência, perguntando só no final "funciona?". Também tem forma de barra — /mini:auto — para rodar o ciclo dentro de uma sessão do Claude Code:

mini auto Rode o ciclo inteiro do seu terminal.
/mini:auto Rode o ciclo dentro de uma sessão do Claude Code.

Para onde ir depois

Cada comando tem sua própria página no manual, tanto na forma de terminal quanto na forma de barra /mini:*.

Explorar o manual de comandos Ver no GitHub