Octo para testes e revisão · braço revisor

A entrega é conferida por quem não a escreveu.

O NIST SSDF pede revisão de código, análise por ferramenta e teste do executável, conforme a organização definir. Nesta etapa atua o braço revisor do Octo: confere a entrega requisito por requisito contra o pedido, testa pelo caminho real e com o menor privilégio e entrega evidência, com o comando e a saída ou a tela. Ele roda sem poder editar. A aprovação do PR e o merge são do líder técnico.

Pedir um diagnóstico Ver o que faz

BraçoRevisoratua nesta etapa, só com leitura

NIST SSDF 1.1PW.7 e PW.8revisão e teste

Fontes5listadas no fim da página

O que o Octo faz na revisão.

Quatro entregas possíveis. Quais achados corrigir e quando aprovar é decisão do líder técnico.

Requisito por requisito

O revisor confere cada requisito do pedido contra a entrega e diz, para cada um, se está atendido e qual é a prova.

Entrega: lista de requisitos com a prova de cada um

Teste pelo caminho real

Testa como o usuário usa, pela requisição ou pela tela, com o perfil de menor privilégio, e confere pelo conteúdo, não só pelo código de status.

Entrega: comando e saída, ou tela, de cada teste

Revisor independente

O revisor roda em contexto próprio, sem ter visto a conversa que produziu o código, e só com ferramentas de leitura.

Entrega: revisão que não foi levada pelo raciocínio do autor

Achados com peso

Separa o que impede a entrega do que é melhoria, para a equipe não corrigir tudo e encher o código de abstração e teste inúteis.

Entrega: achados separados por gravidade

Oito braços, uma entrega conferida.

O mesmo ciclo do Octo, aplicado a esta etapa. Cada braço tem um papel estreito; quem comanda e aprova é o líder técnico da sua empresa.

Descoberta
Relembra o sistema

O mapa da plataforma diz por onde o caminho real passa.
Dados
Confere o dado

Depois do teste, consulta o banco para ver se gravou o que devia.
Segurança
Testa o acesso

Perfil de menor privilégio, rota sem checagem, objeto de outra pessoa.
Arquitetura
Fornece o critério

Os requisitos e o critério de pronto do plano aprovado.
Desenvolvimento
Entrega a branch

O braço de desenvolvimento não revisa o próprio trabalho.
Revisão
Revisa e testa

Requisito por requisito, pelo caminho real, com evidência de cada um.
Publicação
Espera a revisão

Push e publicação só depois da revisão terminada e do ok de quem comanda.
Documentação
Registra os achados

O que foi achado, o que foi corrigido e o que ficou para depois.

O Octo revisa e mostra a prova; aprovar o PR, fazer o merge, decidir quais achados corrigir e dar o aceite final da entrega é do líder técnico.

Quem faz o quê na revisão.

O que o revisor entrega e o que continua sendo decisão da sua equipe.

Etapa	Braço do Octo	Fica com o líder técnico
Revisão de código	Revisor, só leitura	Definir se a revisão é humana, por ferramenta ou as duas
Teste do executável	Revisor	Definir o que precisa de teste além da revisão
Achados	Revisor	Decidir o que corrigir
Aprovação do PR	Nenhum braço	Aprovar e fazer o merge

Do pedido à rotina.

Três degraus. Cada um só faz sentido depois que o anterior mostrou resultado na sua equipe.

Proposta, não promessa

1 Hoje

Revisão com evidência

Toda entrega passa pelo revisor antes do PR.

Requisito por requisito
Comando e saída, ou tela

Ganho: o PR chega com a prova junto

2 Próximo

Teste com menor privilégio

O caminho real passa a ser testado com o perfil mais restrito.

Perfil de menor privilégio
Objeto de outra pessoa

Ganho: falha de acesso aparece antes de produção

3 Depois

Regra no repositório

A branch protegida passa a exigir a revisão e as verificações antes do merge.

Aprovação exigida
Verificações automáticas exigidas

Ganho: a regra vale mesmo com pressa

Confirmado em fonte.

Cada ponto abaixo tem fonte publicada pela organização responsável pela norma, pela especificação ou pela ferramenta, ou em lei federal. As fontes estão na seção seguinte.

pontos com fonte publicada, cada um com a referência indicada ao lado.

ConfirmadoRevisão e análise: A prática PW.7 do NIST SSDF pede determinar se será usada revisão de código, em que uma pessoa olha o código, e/ou análise de código, por ferramenta, conforme a organização definir.Fonte: NIST, SP 800-218 (SSDF 1.1), PW.7
ConfirmadoTeste do executável: A prática PW.8 pede determinar se o código executável deve ser testado para achar vulnerabilidades que revisões, análises ou testes anteriores não acharam.Fonte: NIST, SP 800-218 (SSDF 1.1), PW.8
ConfirmadoRevisão local que só relata: A revisão de código local do Claude Code roda num subagente com contexto próprio; sem a opção de corrigir, as instruções pedem só o relatório.Fonte: Claude Code, revisão de código local
ConfirmadoRevisor independente: Um subagente que nunca viu a conversa revisa o diff sem ser levado pelo raciocínio que produziu o código.Fonte: Claude Code, boas práticas
ConfirmadoPedir evidência: "Todos os testes passam", sozinho, diz muito pouco.Fonte: Claude Code, boas práticas
ConfirmadoSó leitura imposto: Um revisor limitado às ferramentas de leitura tem esse limite imposto pela ferramenta, e não só pedido no texto.Fonte: Claude Code, boas práticas
ConfirmadoNem todo achado: Um revisor a quem se pede problemas sempre acha algum; corrigir tudo gera abstrações e testes inúteis.Fonte: Claude Code, boas práticas
ConfirmadoAprovações antes do merge: Uma branch protegida no GitHub pode exigir que todo pull request receba um número mínimo de aprovações antes do merge.Fonte: GitHub, branches protegidas

O que o Octo faz e o que fica com vocês.

O Octo prepara tudo, mas não assina. O documento que vale continua com quem responde por ele.

O Octo prepara

Mapeia, planeja, programa na branch da atividade, revisa com evidência e prepara a publicação: planos, código, revisões, relatórios de segurança e o dossiê do sistema.

Entrega: material pronto para conferir

A sua equipe confere

Quem comanda é o líder técnico ou o desenvolvedor sênior da empresa: aprova o plano, revisa o PR e faz o merge. Nada vai para produção sem a aprovação de quem comanda.

Etapa: aprovação por quem comanda

Quem assina e responde

O Octo não assina e não responde pelo sistema. Quem aceita o risco e responde pelo sistema em produção é o líder técnico; laudo ou parecer de segurança é assinado por profissional da empresa.

Responsável: líder técnico da empresa

Fontes.

NIST, documentação do Claude Code e documentação do GitHub. Consultadas em 31/10/2026.

NIST: SP 800-218, SSDF 1.1 (fevereiro de 2022)PW.7 e PW.8
Claude Code: revisão de código localSubagente com contexto próprio; relatório sem correção
Claude Code: boas práticasRevisor independente, evidência e só leitura
GitHub: branches protegidasAprovações e verificações exigidas antes do merge
Pro Git: fluxos com branchesBranch de tópico facilita a revisão

Toda entrega com a prova junto.

O diagnóstico começa pela próxima entrega da sua equipe, sem alterar nada. Você recebe a revisão com evidência e decide com ela na mão.

Pedir um diagnóstico