Human Review

O que é o Human Review

O Human Review (github.com/petergyang/human-review) é uma CLI pequena em JavaScript, licenciada sob MIT, publicada pela primeira vez no fim de julho de 2026. Você o instala como uma skill que seu agente pode invocar, ou executa direto com npx, e então aponta para um arquivo — `/human-review (seu arquivo)` — e ele abre esse arquivo no navegador como uma página editável. O problema que ele nomeia é conhecido: dar feedback a um agente no chat significa escrever um parágrafo do tipo "na terceira seção troque X por Y, corte o card que repete o primeiro, reescreva a chamada para ação", e depois reler o arquivo inteiro para conferir o que o modelo entendeu.

• Edite a saída diretamente. Altere o texto no lugar com formatação básica, faça listas com marcadores e numeradas, adicione ou edite links com um atalho de teclado, redimensione imagens arrastando um canto, mova imagens e arraste blocos inteiros para reorganizar a página.
• Comente como num documento. Selecione uma frase e deixe um comentário ancorado exatamente naquele texto, ou clique numa imagem, gráfico ou seção para comentar o elemento. Apagar algo não exige explicação no chat: você simplesmente remove.
• Envie tudo de uma vez. Um único Send entrega ao seu agente todas as edições e comentários juntos, e ele aplica no código-fonte e atualiza a página para outra passada. Clicar em links com a tecla de comando permite revisar várias páginas na mesma sessão sem perder feedback pelo caminho.
• Revise um app rodando, não só um arquivo. Apontá-lo para uma URL de localhost revisa a página ao vivo. O README é preciso sobre a diferença: em arquivos HTML, edições diretas e redimensionamentos salvam automaticamente, enquanto Markdown e localhost precisam do Send para o agente aplicá-los no código-fonte.

Onde ele entra na pilha de um fundador

Isto não é uma ferramenta de crescimento, e vale dizer com clareza. Ele fica uma camada antes, na ida e volta que todo fluxo com IA cria e que quase nenhum resolve: a lacuna entre o agente produziu algo e isto está certo. Descrever edições em prosa perde informação nos dois sentidos: você demora mais para especificar a mudança do que para fazê-la, e depois ainda precisa auditar se ela pegou. Editar o artefato diretamente elimina de vez a etapa de especificação.

O encaixe é mais nítido em páginas de marketing, que é exatamente onde a saída de um agente tem mais chance de parecer pronta e estar errada. Se você está pedindo a um modelo que construa uma landing page, a passada de revisão é toda a diferença entre um rascunho e um site — veja devo usar IA para criar meu site? para as falhas específicas que valem a caçada. O repositório é jovem e está em desenvolvimento ativo, não assentado: criado em julho de 2026, com v0.5.0 e v0.6.0 chegando com um dia de diferença no início de agosto e v0.6.1 em 2026-08-15. Espere que a interface continue mudando.

O modo de falha que uma revisão acrescenta

Colocar uma pessoa no circuito é o instinto certo, e não sai de graça: introduz um jeito novo de perder trabalho, que é a revisão que nunca acontece. Sabemos disso pela nossa própria plataforma, onde toda ação para fora que um agente propõe espera uma pessoa aprovar, e o portão é imposto em código em vez de pedido num prompt, porque uma regra no nível do prompt é um pedido e uma no nível do código não é. Das primeiras duas dúzias de solicitações de aprovação que nosso sistema produziu, exatamente metade nunca virou uma ação concluída: cinco falharam do outro lado e sete simplesmente nunca foram clicadas.

As sete são o número interessante. Ninguém as rejeitou; a fila apenas sobreviveu ao momento em que alguém se importava. Esse é o imposto que uma etapa de revisão cobra, e por isso os detalhes de projeto importam mais que o princípio: a fila precisa ser visível, o lote precisa ser pequeno o bastante para ser esvaziado de uma sentada, e a ferramenta precisa relatar o que de fato aconteceu. Essa última parte tivemos de acrescentar depois, porque um agente que não enxerga o resultado da própria aprovação vai dizer alegremente a um cliente que algo foi publicado quando não foi.

Essa fronteira é o projeto inteiro da AgentCeres — a Diretora de Crescimento com IA, em agentceres.com. Um time de especialistas redige as páginas de SEO, os posts sociais, os anúncios e a prospecção; qualquer coisa que vá para o mundo espera uma pessoa clicar em aprovar. Um editor local como o Human Review torna esse clique mais bem informado, porque revisar o artefato é melhor do que revisar uma descrição dele. O rascunho é a metade barata de qualquer jeito — veja o que um time de marketing com IA realmente consegue fazer.