Vibes Imaculadas
Você está sendo solicitado a revisar este codebase construído com "vibe coding". Você não está sendo solicitado a corrigir nenhum dos problemas que encontrar, apenas a fornecer recomendações.
Processo
O processo de alto nível é o seguinte:
- Reúna toda a documentação disponível do produto.
- Faça perguntas ao usuário para aprofundar seu entendimento da aplicação.
- Revise o código com base nos pilares de qualidade.
- Crie um relatório com suas descobertas.
Pilares de qualidade
Estes são os pilares para escrever software de alta qualidade. Listados em ordem de importância, use-os como sua lente para visualizar este projeto.
- Segurança – Autenticação, permissões, exposição de dados e comportamento inseguro do navegador.
- Confiabilidade – Fluxos críticos, saúde das rotas, asserções, erros no console e estados quebrados.
- Desempenho – Comportamento de carregamento, capacidade de resposta, recursos caros e latência visível ao usuário.
- UI/UX – Navegação, clareza, validação, expectativas de conteúdo e coesão visual.
- Acessibilidade – Acesso pelo teclado, semântica, rótulos, ARIA, contraste e sinais de tecnologia assistiva.
Processo detalhado
1. Reúna a documentação disponível do produto
Nesta fase, você procurará por qualquer documentação do produto disponível. Isso estabelecerá a base para sua revisão, portanto, encontre tudo que possa estar relacionado aos pilares de qualidade.
Locais comuns para procurar:
- PRODUCT.md
- PRD.md
- README.md
- docs/
2. Faça perguntas ao usuário
A documentação do produto pode estar incompleta ou dessincronizada com o estado atual da aplicação. Faça perguntas ao usuário que ajudem a aprofundar seu entendimento do projeto e seus requisitos. Se disponível, use a ferramenta de fazer perguntas; caso contrário, converse com o usuário.
Exemplos de perguntas:
- Quem precisa ter acesso a esta aplicação?
- Qual é o plano para manutenção contínua?
- Como você vai monitorar esta aplicação e verificar seu desempenho e confiabilidade?
- Onde esta aplicação será hospedada?
3. Revise o código
Usando as informações coletadas, inicie subagentes para revisar o código de cada pilar de qualidade. Mantenha-os separados para evitar poluição do contexto. Atribua a eles a tarefa de encontrar problemas e fornecer uma avaliação go/no-go com base em seu pilar de qualidade individual.
Cada problema:
- deve ser um problema concreto e acionável
- inclui uma avaliação de impacto do problema
- Atribua um destes níveis de impacto a cada problema: Showstopper, Crítico, Moderado ou Bom ter
- inclui uma descrição clara do problema e o nome do arquivo e números de linha relevantes (se houver)
- fornece uma recomendação de solução
4. Crie um relatório
Finalize reunindo todos os resultados dos subagentes e crie um relatório HTML detalhado, além de fornecer um resumo de alto nível no chat. Abra o relatório HTML no navegador para o usuário revisar.
Principais características do relatório:
- Uma recomendação go/no-go
- Requisitos: resumo de alto nível do produto e seus requisitos principais
- Problemas: uma lista dos problemas encontrados, ordenados por nível de impacto (do mais grave ao menos)
- Outras informações: quaisquer outras descobertas importantes que um revisor precisaria saber
Exemplo de relatório:
Recomendação: No-go
O classificador de cafés Fourgrounds é uma aplicação pública que permite que os clientes da cafeteria Fourgrounds classifiquem suas bebidas de café favoritas.
Requisitos principais:
- O usuário deve ver uma lista das bebidas atualmente disponíveis no Fourgrounds
- O usuário deve poder arrastar para reordenar as bebidas conforme sua preferência
- O usuário deve poder enviar sua classificação e ser recompensado com um item de padaria gratuito de sua escolha
- O usuário deve poder enviar sua classificação apenas uma vez
Problemas:
O usuário pode enviar múltiplas vezes às quintas-feiras
Impacto: CRÍTICO – O usuário pode acumular múltiplas recompensas gratuitas.
Devido a um erro na análise da data em date.js linha: 42, uma exceção não tratada pode fazer com que a verificação de envio anterior seja ignorada em check-reward.js linha: 16.
Recomendação: Use o analisador de data interno e envolva a análise da data em um try/catch para evitar que exceções afetem outras áreas da aplicação.
Outras informações:
- O arquivo
coffee-products.jsoné gerado diariamente; se os produtos mudarem no meio do dia, ele pode estar desatualizado. Consumidores externos das classificações devem tomar cuidado para validar a existência dos produtos.