Maestro

Interface visual opcional para trabalhar em um repo: sessões em worktree, preview, chat com Claude ou Codex, lentes de estrutura e handoff. O Maestro não define método, agentes ou skills e não prepara o repo para outras ferramentas.

Fronteira

O repo é a fonte. O Maestro:

• descobre agentes já comitados em .claude/agents/; sem eles oferece um host neutro;
• deixa AGENTS.md, CLAUDE.md, .agents/ e .claude/ intactos durante os turnos;
• lê skills, hooks, MCP e instruções para exibir nas lentes;
• mostra os resultados de base check e opus check quando os pacotes estão instalados;
• pode executar base setup/opus setup após um gesto explícito na interface, apenas delegando aos CLIs donos.

Ele não copia artefatos, não usa skip-worktree, não publica metodologia no Multica e não é necessário para clone, instalação, CI ou desenvolvimento por outra IDE.

maestro pull foi removido. Use no próprio repo:

pnpm exec base setup
pnpm exec opus setup   # somente em projeto Opus

Instalação opcional

pnpm add -D @softize/maestro
pnpm exec maestro serve

Requer Node 22+ e ao menos um provider (claude ou codex) autenticado no usuário que roda o serviço.

Desenvolvimento

pnpm install
pnpm --filter @softize/maestro typecheck
pnpm --filter @softize/maestro test
pnpm --filter @softize/maestro dev
pnpm --filter @softize/maestro-web dev

O supervisor continua dono apenas do ciclo da interface: cria worktree, instala dependências, sobe preview, mantém sessão e publica o handoff solicitado pelo usuário.