Advisor Review

O que Advisor Review faz?

Use os scripts fornecidos neste diretório de habilidades. Uma invocação explícita é uma trava: execute o revisor na mesma tarefa pai antes de uma resposta final substantiva ou de uma ação que siga ou conflite com a revisão. A coleta de evidências somente leitura pode continuar durante a construção do pacote.

Não pesquise o catálogo global de ferramentas para um advisor. Não abra uma segunda tarefa visível ao usuário. A única execução filha é o processo codex exec isolado iniciado por scripts/run_advisor.py.

Requisitos

Requer execução de shell, um codex CLI local autenticado, acesso à rota de modelo gpt-5.6-sol solicitada e acesso à API do Codex de saída a partir do shell pai. Uma sandbox pai que bloqueie a rede de subprocessos também bloqueia o revisor aninhado. Se algum requisito estiver faltando, relate que a revisão independente está bloqueada; não enfraqueça a sandbox sem autorização do usuário ou da tarefa.

O executor não é um limite de confidencialidade. Sanitize evidências e artefatos antes de construir o pacote.

Fluxo de trabalho

1. Anuncie que o Advisor Review está sendo usado e por quê.

2. Selecione uma fase:

   • plan: desafie uma abordagem proposta.
   • stuck: diagnostique trabalho com falha ou em loop.
   • pivot: compare uma abordagem materialmente diferente.
   • final: audite o trabalho concluído e suas evidências de endpoint.

3. Leia references/context-contract.md.

4. Escolha o modo de contexto:

   • packet: fatos curtos ancorados em fonte são suficientes.
   • bundle: logs sanitizados, linhas do tempo, diffs ou outros artefatos de texto limitados afetam materialmente o diagnóstico.

5. Construa advisor-context-2.0 com scripts/build_context_packet.py.

   • Para stuck, inclua ações e resultados exatos em ordem cronológica.
   • Dê a cada fato observado uma fonte concreta.
   • Inclua resultados negativos, estado conflitante e limitações de contexto.
   • Nunca trunque silenciosamente texto crítico para a decisão. Uma falha do construtor é uma revisão bloqueada.

6. Leia references/review-rubric.md.

7. Selecione o esforço:

   1. Honre uma solicitação explícita de high, xhigh ou max.
   2. Use max apenas para uma revisão mais profunda explicitamente solicitada ou para uma decisão crítica e difícil de reverter com grande ambiguidade não resolvida.
   3. Use xhigh para falhas entre componentes, evidências verificadas conflitantes, duas ou mais abordagens falhas, pivôs importantes ou alegações de conclusão de alto impacto.
   4. Caso contrário, use high.

8. Execute exatamente uma revisão isolada por padrão e salve seu recibo:

   python3 scripts/run_advisor.py \
     --input context-packet.json \
     --effort xhigh \
     --output advisor-receipt.json
   

   Mantenha o recibo retornado na tarefa que o invocou. Um recibo produzido em outra tarefa visível ao usuário não é uma transferência.

9. Verifique o recibo:

   • request.requested_model deve ser gpt-5.6-sol.
   • request.requested_effort deve corresponder ao esforço selecionado.
   • observed_model e observed_effort podem ser null; o CLI atual não expõe autoritativamente a identidade do lado do servidor. Nunca descreva a identidade solicitada como identidade real verificada.
   • Qualquer erro do executor, falha de esquema, timeout ou incompatibilidade de hash de contexto bloqueia a revisão.
   • O filho isolado usa um CODEX_HOME temporário com apenas o arquivo de autenticação do host vinculado quando presente. Ele também desativa plugins, carregamento remoto de plugins, pesquisa de habilidades e execução multiagente para que catálogos de habilidades não relacionados não possam consumir o contexto de revisão.

10. Leia references/decision-contract.md. Resolva cada recomendação R# como adopt, reject ou defer e execute:

    python3 scripts/validate_decision.py \
      --receipt advisor-receipt.json \
      --decision advisor-decision.json
    

11. Não aja com base nas recomendações do advisor até que o registro de decisão seja validado. Uma recomendação destrutiva adicionalmente requer autorização confirmada do usuário.

12. Continue a tarefa pai usando a próxima ação validada e a condição de parada.

Regras para trabalho travado

• Diagnostique antes de alterar mais estado.
• Distinga o limite de execução: tarefa pai, processo revisor isolado e qualquer outra tarefa visível ao usuário são separados.
• Não deixe que o recibo de uma tarefa separada substitua uma transferência na mesma tarefa.
• Prefira um experimento somente leitura ou reversível que separe hipóteses concorrentes.
• Após uma correção repetida do usuário, não repita a mesma prescrição sem novas evidências.
• Não amplie o escopo de um subsistema com falha para plugins, serviços, repositórios ou pacotes, a menos que as evidências os conectem.

Orçamento de revisão

Use uma revisão por padrão. Uma segunda é permitida apenas quando novas evidências alteram materialmente a decisão ou uma nova verificação final de alto risco é justificada. Uma terceira é permitida apenas para reconciliar um conflito concreto. Nunca crie um loop de revisão aberto.

Gatilho de comportamento de alteração de habilidade

Ao modificar o próprio Advisor Review, execute os testes determinísticos e pelo menos um fixture de comportamento sanitizado:

python3 scripts/evaluate_advisor_behavior.py \
  --fixture behavior-fixture.json \
  --receipt advisor-receipt.json

Use fixtures antigos/novos pareados quando prático. Julgue detecção, vinculação de evidências, experimentos limitados e taxa de ações arriscadas — não similaridade de prosa.

Relatório

Relate:

• fase, modo de contexto, modelo Sol solicitado, esforço solicitado e status de verificação de identidade;
• veredito do advisor e diagnóstico vinculado a evidências;
• a disposição adotar/rejeitar/adiar de cada recomendação consequente;
• a próxima ação selecionada e condição de parada;
• riscos não resolvidos ou limitações de contexto.

Chame o resultado de uma revisão independente estilo advisor, não de Claude Advisor parity.