3bb2f8f1c5
* chore: wire docs/agents config into AGENTS.md Agent skills section
Add the `## Agent skills` discovery block pointing the engineering
skills at the existing docs/agents/{issue-tracker,triage-labels,domain}.md
files (issue tracker, triage label mapping, single-context domain docs).
Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
* docs: rebrand to GSD Core and restructure docs with Diataxis
Reorganise the root README and docs/ around the Diataxis framework
(tutorials, how-to guides, reference, explanation), add new how-to
guides and schema references (STATE.md / CONTEXT.md / PLAN.md /
planning artifacts), and cross-link the whole set. Update the lone
legacy gsd-build reference to open-gsd; keep internal get-shit-done/
filesystem paths unchanged (directory rename tracked separately in
open-gsd/gsd-core#604). Regenerate the ja-JP, ko-KR, pt-BR and zh-CN
localised trees to mirror the new structure.
Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
* docs: backfill changeset PR number (#605)
Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
---------
Co-authored-by: Claude Opus 4.8 <noreply@anthropic.com>
160 lines
6.0 KiB
Markdown
160 lines
6.0 KiB
Markdown
# 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 GSD Core pode encaminhar solicitações de revisão para qualquer combinação de: Gemini CLI, Claude (sessão separada), Codex CLI, CodeRabbit, OpenCode, Qwen Code, 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:
|
||
|
||
```bash
|
||
# Gemini CLI (gratuito com credenciais Google)
|
||
npm install -g @google/gemini-cli
|
||
|
||
# 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, `/gsd-review` executa todos os CLIs detectados. Para fixar um subconjunto como padrões do projeto:
|
||
|
||
```bash
|
||
/gsd-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 `["gemini","codex"]`.
|
||
|
||
Como alternativa, defina diretamente com `gsd-tools`:
|
||
|
||
```bash
|
||
gsd config-set review.default_reviewers '["gemini","codex"]'
|
||
```
|
||
|
||
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](../CONFIGURATION.md).
|
||
|
||
---
|
||
|
||
## Executar uma revisão
|
||
|
||
### Revisão padrão (usa seus padrões configurados ou todos os CLIs detectados)
|
||
|
||
```bash
|
||
/gsd-review --phase 3
|
||
```
|
||
|
||
O GSD 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
|
||
|
||
```bash
|
||
/gsd-review --phase 3 --gemini
|
||
/gsd-review --phase 3 --codex
|
||
/gsd-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
|
||
|
||
```bash
|
||
/gsd-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:
|
||
|
||
```bash
|
||
/gsd-review --phase 3 --ollama
|
||
/gsd-review --phase 3 --lm-studio
|
||
```
|
||
|
||
Configure os endereços de host e a seleção de modelo nas chaves `review.*` via `/gsd-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:
|
||
|
||
```bash
|
||
/gsd-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:
|
||
|
||
```bash
|
||
/gsd-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
|
||
|
||
```bash
|
||
/gsd-plan-review-convergence 3 --codex
|
||
/gsd-plan-review-convergence 3 --gemini
|
||
```
|
||
|
||
### Convergência com todos os revisores e um limite maior de ciclos
|
||
|
||
```bash
|
||
/gsd-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 GSD 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 Gemini CLI instalado | `--gemini` é sempre um bom revisor inicial |
|
||
| Você quer cobertura gratuita com múltiplos revisores | `--gemini` + `--agy` (ambos usam credenciais Google) |
|
||
| Seu projeto é fortemente baseado em OpenAI | adicione `--codex` para uma perspectiva de modelo OpenAI |
|
||
| Você quer o modelo do GitHub Copilot | adicione `--opencode` |
|
||
| 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 | `/gsd-plan-review-convergence N --all` |
|
||
| Você está iterando rapidamente e quer feedback rápido | escolha um CLI: `/gsd-review --phase N --gemini` |
|
||
|
||
---
|
||
|
||
## Relacionados
|
||
|
||
- [Verificar e publicar](verify-and-ship.md)
|
||
- [Configuração](../CONFIGURATION.md)
|
||
- [Comandos](../COMMANDS.md)
|
||
- [Índice da documentação](../README.md)
|