{
  "markdown": "# ai-review\n\nFan-out de code/doc review para múltiplos agentes de IA via CLIs nativos, em paralelo, com um único comando.\n\n```bash\nai-review -f docs/ARCHITECTURE.md -t architecture -a balanced\n```\n\nEnvia o mesmo conteúdo para agentes configuráveis (**Gemini, Codex, Auggie, MiniMax, Qwen**; Claude é opt-in), coleta as respostas em paralelo e apresenta a saída por agente — pronta para síntese de consenso, divergências e ações.\n\n## Por que\n\nUma segunda opinião pega o que o primeiro modelo perdeu. Várias segundas opiniões, de famílias de modelos diferentes, pegam muito mais — e divergência entre elas é sinal de onde olhar com atenção.\n\n## Quick start (2 minutos)\n\n```bash\ngit clone https://github.com/pmdusso/ai-review ~/code/shared/ai-review\ncd ~/code/shared/ai-review\n./scripts/install.sh\n\n# Validar sem chamar APIs (precisa de pelo menos um CLI no PATH para runs reais)\nprintf 'teste\\n' | ai-review --dry-run -a fast -s \"Responda apenas OK.\"\n```\n\nSetup mínimo: `bash`, `jq`, `yq` (para config YAML) e **um** agente autenticado (`qwen` recomendado).  \nGuia completo (VMs headless, auth, skills): [`docs/install.md`](docs/install.md).\n\nDiretórios locais `.expect/` e `.superpowers/` são scratch de desenvolvimento e podem ser apagados.\n\n## Casos de uso\n\n| Cenário | Comando |\n|---------|---------|\n| Review de PR diff | `git diff main...HEAD \\| ai-review -a balanced -t pr-review` |\n| Review de plano | `ai-review -f plan.md -t plan-review -a full` |\n| Review de segurança | `ai-review -f app.py -t security -a balanced` |\n| Pre-commit rápido | `git diff --cached \\| ai-review -a fast --redact -s \"Bugs óbvios.\"` |\n| Diff + contexto do arquivo | `ai-review -f app.py -d -t pr-review` |\n| Validar setup | `ai-review --dry-run -f plan.md -a fast` |\n| CI / headless com secrets | `ai-review --redact -a fast -t pr-review -f app.py -o out.md` |\n\n## Presets (custo / latência)\n\n| Preset | Agentes | Quando |\n|--------|---------|--------|\n| `fast` | `qwen` | Iteração, pre-commit, baixo custo |\n| `balanced` | `qwen,gemini` | Review de PR / segunda opinião |\n| `full` / `default` | 5 agentes default | Decisões importantes |\n| `default+claude` / `all` | default + Claude | Planos críticos |\n\n```bash\nai-review -f app.py -a fast -t pr-review\nai-review -f app.py -a balanced -t pr-review\nai-review -f plan.md -a full -t plan-review\n```\n\n## Templates\n\nTemplates bundled: `security`, `architecture`, `pr-review`, `plan-review` (ver [`templates/`](templates/)).\n\n```bash\nai-review -f main.py -t security -a balanced\n./scripts/install-templates.sh          # → ~/.config/ai-review/templates/\n./scripts/install-templates.sh --project\n```\n\nOrdem de busca e schema completo: [`docs/reference.md`](docs/reference.md).\n\n## Config por projeto\n\n```bash\n# No root do repo consumidor (a partir do clone do ai-review):\n/path/to/ai-review/scripts/init-project.sh\n```\n\nIsso cria `.ai-review/config.yaml` e templates locais. Exemplo: [`templates/config.example.yaml`](templates/config.example.yaml).\n\nPrioridade: **CLI > env `AI_REVIEW_*` > config do projeto > config global > defaults**.\n\n## Integração com agentes de código\n\n`./scripts/install.sh` instala as skills automaticamente (`--no-skills` para pular).\n\n| Ecossistema | Arquivos | Instalação |\n|---|---|---|\n| Agents / Claude / Codex (skill) | `SKILL.md` | via `install.sh` → `~/.agents/skills`, `~/.claude/skills`, `~/.codex/skills` |\n| Gemini CLI (extension) | `gemini-extension.json`, `GEMINI.md`, `commands/ai-review.toml` | `gemini extensions link <repo>` |\n\nDetalhes em [`docs/install.md`](docs/install.md).\n\nPre-commit em repos consumidores:\n\n```bash\n# no root do projeto alvo (ai-review no PATH)\n/path/to/ai-review/scripts/install-pre-commit.sh\n```\n\n## Segurança\n\nO conteúdo é enviado a provedores externos. O script escaneia secrets e **aborta** se encontrar algo — em CI use `--redact` ou `--allow-secrets`. Detalhes: [`docs/reference.md`](docs/reference.md#secret-scan).\n\n## Troubleshooting\n\n| Problema | Solução |\n|----------|---------|\n| Secret scan aborta em CI (exit 3) | `--redact` ou `--allow-secrets` |\n| `yq` missing | `brew install yq` (só necessário com config YAML) |\n| Agente não encontrado | `ai-review --list-agents`; instale o CLI ou use `-a fast` |\n| Timeout | `--timeout 120` ou `AI_REVIEW_TIMEOUT_SECONDS=120` |\n| Template não encontrado | confira `templates/` ou `./scripts/install-templates.sh` |\n\n## Docs\n\n- [`docs/install.md`](docs/install.md) — instalação, auth headless, skills\n- [`docs/reference.md`](docs/reference.md) — flags, presets, config, secret scan\n- [`CONTRIBUTING.md`](CONTRIBUTING.md) — testes e contribuição\n- [`CHANGELOG.md`](CHANGELOG.md) — histórico de versões\n\n## Licença\n\n[MIT](LICENSE)\n",
  "bytes": 4680,
  "sha": "d0db1fc60d9a6d0a6ab91f3120b55322e98071348836a494db9e074628f22a2d",
  "repo_slug": "pmdusso/ai-review",
  "fonte": "repo",
  "truncated": false,
  "api": "https://agentalog.com/api/listings/plg_pmdusso_ai_review_9b79e41d/readme"
}