irodion/lavish-review

O que lavish-review faz?

Habilidade de agente que transforma um diff de branch Git em um Painel de Revisão HTML interativo — para Claude Code, Cursor e Codex.

Visão Geral

Esta habilidade permite que você transforme qualquer diff entre branches Git em uma página HTML interativa, com realce de sintaxe, navegação lado a lado e capacidade de anotar o código. Perfeita para revisões de código em equipe ou auto-revisões antes do merge.

Plataformas Suportadas

• Claude Code (Anthropic)
• Cursor
• Codex (OpenAI)

Como Usar

1. Certifique-se de estar em um repositório Git com um diff disponível.
2. Invoque o agente com:

agente revise diff main...minha-feature

3. O agente irá:

   • Coletar o diff usando git diff
   • Processar cada arquivo modificado
   • Gerar um arquivo HTML com o cockpit de revisão
   • Exibir o caminho do arquivo gerado (ex.: revisao.html)

4. Abra o arquivo HTML no navegador para interagir com o painel.

Funcionalidades

• Destaque de sintaxe para as principais linguagens (Python, JavaScript, TypeScript, Go, Ruby, etc.)
• Navegação entre arquivos com abas ou lista lateral
• Visualização lado a lado (diff unificado ou dividido)
• Suporte a comentários inline (para revisão colaborativa)
• Exportação do relatório de revisão em Markdown ou PDF

Exemplo de Uso com Claude Code

claude revise -d main...feature-x

Isso irá gerar revisao-claude.html e exibir um link para acesso rápido.

Requisitos

• Git 2.x ou superior
• Node.js 16+ (para gerar o HTML dinamicamente)
• Navegador moderno para visualizar o cockpit

Configuração

Você pode personalizar o tema do cockpit definindo variáveis de ambiente:

export THEME=dark
export OUTPUT_FILE=meu-revisao.html
export INCLUDE_COMMENTS=true

Limitações

• Diffs muito grandes (mais de 500 arquivos) podem levar mais tempo para processar.
• Comentários inline são salvos localmente; não há sincronização com repositórios remotos.
• Depende de Node.js para gerar o HTML; se não estiver instalado, o agente tentará usar uma versão embutida.

Contribuição

Contribuições são bem-vindas! Sinta-se à vontade para abrir issues ou pull requests no repositório irodion/lavish-review.

Licença

MIT