Files
msd-core/docs/pt-BR/how-to/set-up-cross-ai-review.md
Jakub Zych 6cfa0c55d2 refactor: drop 12 runtimes, keep Claude, Codex, OpenCode, Cursor, ZCode, Antigravity
Removes kilo, kimi, kimi-code, copilot, windsurf, augment, trae, qwen, hermes,
cline, codebuddy and pi end to end: capability descriptors, installer branches
and converters (bin/install.js 14.9k -> 11.2k lines), TypeScript converters,
hook surfaces and runtime homes, review lanes qwen/kimi-code, the two pi
migrations, Kimi payload normalization in the hook guards, dead hostBehaviors
vocabulary, launcher home probes, fixtures, runtime-specific tests and the
prose that presented them as supported.

Installer output for the six kept runtimes is byte-identical to before the
prune. The Kimi tool-vocabulary tests in workflow-guard, read-guard and
read-injection-scanner are left in place pending a decision.
2026-10-06 20:02:40 +02:00

5.8 KiB
Raw Blame History

Como configurar a revisão entre diferentes IAs

Objetivo: Configurar quais revisores de IA participam da revisão de planos, executar uma revisão de uma fase planejada e usar o feedback para convergir para um plano sem preocupações de severidade ALTA.

Pré-requisitos: A fase foi planejada (os arquivos {phase}-PLAN.md existem em .planning/phases/). Pelo menos um CLI de IA externo está instalado e autenticado.


Decidir quais revisores usar

O MSD Core pode encaminhar solicitações de revisão para qualquer combinação de: Claude (sessão separada), Codex CLI, CodeRabbit, OpenCode, Cursor, Antigravity CLI, Ollama, LM Studio e llama.cpp.

Cada revisor executa o mesmo prompt estruturado contra seus arquivos PLAN.md de forma independente. Como diferentes modelos têm diferentes pontos cegos, o consenso de múltiplos revisores detecta mais problemas do que qualquer revisor individual.

Se você ainda não tem CLIs externos instalados, instale pelo menos um:

# Antigravity CLI (gratuito com credenciais Google)
curl -fsSL https://antigravity.google/cli/install.sh | bash

# Codex CLI
npm install -g @openai/codex

Definir revisores padrão (opcional)

Por padrão, /msd-review executa todos os CLIs detectados. Para fixar um subconjunto como padrões do projeto:

/msd-config --integrations

O assistente de integrações cobre chaves de API, roteamento de CLIs para revisão de código e a lista review.default_reviewers. Defina a lista com os revisores que você deseja como padrão sem flags — por exemplo ["codex","claude"].

Como alternativa, defina diretamente com msd-tools:

msd config-set review.default_reviewers '["codex","claude"]'

Para o esquema completo de configurações de integração (chaves de API, substituições de modelo por revisor, endereços de servidor local), consulte Configuração.


Executar uma revisão

Revisão padrão (usa seus padrões configurados ou todos os CLIs detectados)

/msd-review --phase 3

O MSD invoca cada revisor em sequência, coleta feedback estruturado (Resumo, Pontos Fortes, Preocupações em ALTA/MÉDIA/BAIXA, Sugestões, Avaliação de Risco) e grava a saída combinada em .planning/phases/03-.../03-REVIEWS.md.

Selecionar um único revisor para uma execução pontual

/msd-review --phase 3 --agy
/msd-review --phase 3 --codex
/msd-review --phase 3 --cursor

Qualquer flag explícita substitui tanto o padrão --all quanto review.default_reviewers para aquela execução.

Executar todos os revisores disponíveis em paralelo

/msd-review --phase 3 --all

--all sempre substitui a configuração e executa o conjunto completo detectado, incluindo quaisquer servidores de modelos locais configurados (Ollama, LM Studio, llama.cpp).

Revisores com servidor de modelo local

Se você executa Ollama ou LM Studio localmente, eles são incluídos automaticamente com --all quando o servidor está acessível. Você também pode direcioná-los explicitamente:

/msd-review --phase 3 --ollama
/msd-review --phase 3 --lm-studio

Configure os endereços de host e a seleção de modelo nas chaves review.* via /msd-config --integrations se os padrões (localhost:11434 / localhost:1234) não se aplicarem.


Ler a saída da revisão

O arquivo {padded_phase}-REVIEWS.md contém:

  • Revisões individuais de cada revisor com preocupações classificadas por severidade
  • Uma seção de Resumo de Consenso que sintetiza preocupações levantadas por dois ou mais revisores — comece aqui para obter o sinal de maior prioridade
  • Uma seção de Visões Divergentes para áreas onde os revisores discordaram

Incorporar o feedback ao plano

Após revisar a saída, replaneje incorporando o feedback:

/msd-plan-phase 3 --reviews

O planejador lê REVIEWS.md e ajusta os planos para endereçar as preocupações antes de salvar.


Automatizar o ciclo planejar–revisar–replanejar

Para fases em que você deseja iterar até que todas as preocupações de severidade ALTA sejam resolvidas, use o ciclo de convergência:

/msd-plan-review-convergence 3

Isso executa plan-phase → review → replan → re-review por até três ciclos (padrão). O ciclo termina quando a contagem de preocupações ALTAS chega a zero.

Convergência com um revisor específico

/msd-plan-review-convergence 3 --codex
/msd-plan-review-convergence 3 --agy

Convergência com todos os revisores e um limite maior de ciclos

/msd-plan-review-convergence 3 --all --max-cycles 5

Detecção de estagnação: se a contagem de preocupações ALTAS não estiver diminuindo entre os ciclos, o MSD avisa você. Quando o limite de ciclos é atingido com preocupações ALTAS em aberto, um portão de escalação pergunta se você deseja prosseguir ou revisar manualmente.


Condicionais: quais revisores escolher

Situação Abordagem recomendada
Você já tem o Antigravity instalado --agy é sempre um bom revisor inicial
Você quer cobertura gratuita com múltiplos revisores --agy (credenciais Google) + --claude
Seu projeto é fortemente baseado em OpenAI adicione --codex para uma perspectiva de modelo OpenAI
Você quer evitar custos de API completamente configure o Ollama com um modelo local e use --ollama
Você precisa de cobertura máxima antes de um lançamento /msd-plan-review-convergence N --all
Você está iterando rapidamente e quer feedback rápido escolha um CLI: /msd-review --phase N --agy

Relacionados