# Inspetor de Build e Bug Scanner

Veja o que o agente entendeu, quais arquivos criou, o que os testes encontraram e quais erros o app gerou, sem gastar créditos com perguntas.

Fonte: https://guides.adapta.org/guias/skip/recursos-do-skip/diagnostico/

**TL;DR** · Duas ferramentas do builder mostram os bastidores do projeto. O **Inspetor de Build** abre cada execução do agente em seis abas: a linha do tempo, a especificação escrita pelo PM, os arquivos criados, os testes de qualidade, as versões e os eventos. O **Bug Scanner** acompanha o app rodando no preview: erros críticos, requisições, console e navegação. As duas são consultas, não pedidos ao agente: você lê o que precisa e volta ao chat com informação melhor.

![Gravação do Skip: o Inspetor de Build abre na Visão geral, passa pelas abas PM, Dev e Q.A. e depois o Bug Scanner é aberto na aba Console.](https://guides.adapta.org/media/screenshots/skip/diagnostico-2026-09-21/skip-diagnostico-fluxo.lossless.webp)

*As duas ferramentas lado a lado: o Inspetor conta o que o agente fez, o Bug Scanner conta o que o app está fazendo agora.*

## Inspetor de Build

Na barra superior do builder, clique em **Inspetor de Build**. O painel abre com a coluna **Execuções** à esquerda, um cartão por execução do agente com a versão gerada, o estado (**Concluída**), o resultado (**Sucesso**), a data e a hora e um botão **Preview**. O botão **Esconder painel** recolhe essa coluna. À direita ficam as seis abas da execução selecionada.

Visão geral

Quatro números resumem a execução: **Status**, **Origem** (Skip), **Linhas** e **Arquivos**. Abaixo, a linha do tempo com horário de cada fase: **Planejamento inicial de tarefas**, **Especificando solução**, **Preparando projeto**, **Implementando solução**, **Testando solução**, **Versionando projeto**, **Deployando solução** e **Gerando relatório**. É aqui que você vê quanto tempo cada fase levou e em qual delas uma execução parou.

PM

**Especificação (PM)** é o seu pedido reescrito como documento de requisitos, em inglês: uma descrição geral, a pilha usada e os **Functional Requirements** numerados, tela por tela, com campos, textos, validações, rotas, esquema do banco e dados de exemplo. Leia esta aba quando o resultado não bater com o que você pediu: procure a diferença primeiro na especificação, e cite o item exato no próximo pedido.

A especificação inclui as credenciais do usuário inicial quando o agente cria login. Não compartilhe prints desta aba.

Dev

A árvore de arquivos do projeto, com a etiqueta **ADD** nos arquivos criados naquela execução, organizada em pastas (migrações do banco, componentes, contextos, hooks, páginas, serviços, tipos). Clique em um arquivo para ver o conteúdo; até lá, a área da direita pede para selecionar um arquivo na árvore.

Q.A.

**Último resultado** separa o que a verificação de qualidade encontrou em quatro grupos: **Erros de Setup**, **Erros de Análise Estática**, **Erros de Servidor** e **Erros de Cliente**. Cada grupo mostra "Sem erros." quando passou. **Resultados anteriores** guarda as rodadas anteriores, numeradas (Teste #1 em diante), útil para ver se uma correção resolveu um erro que existia antes.

Versionamento

**Gerenciar versões** lista as versões do projeto com o número (0.0.1, 0.0.2...), um código curto de identificação, o botão **Preview** e o selo **Ativa** na versão que está valendo.

Histórico de Eventos

A lista técnica dos eventos internos da execução, em ordem: especificação, definição de arquitetura, escrita de código, verificação de qualidade, versionamento e geração do relatório. Serve para quem quer conferir a sequência exata; para o dia a dia, a linha do tempo da Visão geral basta.

## Bug Scanner

O botão **Abrir Bug Scanner**, o ícone de lupa na barra superior, abre um painel sobre o preview com quatro abas que observam o app em execução:

|  Aba |  O que mostra |  Quando está vazia |
| --- | --- | --- |

|  **Erros Críticos** |  Falhas que quebram uma tela ou uma ação |  "Nenhum erro crítico detectado" |

|  **Requisições** |  Chamadas que o app fez ao backend |  "Nenhuma requisição detectada" |

|  **Console** |  Mensagens de log e erro do navegador |  "Nenhum log detectado" |

|  **Navegação** |  Trocas de rota dentro do app |  "Nenhuma navegação detectada" |

Use o preview com o Bug Scanner aberto: entre no app, repita a ação que falhou e volte às abas. O mesmo botão vira **Fechar Bug Scanner** enquanto o painel está aberto.

## Como usar as duas juntas

1. **Algo saiu diferente do pedido**

    Abra o Inspetor de Build, aba **PM**, e procure o item da especificação que descreve aquela tela. Se a especificação já estava diferente do que você queria, o próximo pedido deve corrigir o entendimento ("na página X, o campo Y deve...").

![Aba PM do Inspetor de Build do Skip, com o bloco Specification descrevendo o sistema de registro de horas, o backend e a autenticação.](https://guides.adapta.org/media/screenshots/skip/diagnostico-2026-09-21/pm-2026-09-21.png)

    *Na aba PM: **1** a aba selecionada, **2** o rótulo Especificação (PM) e **3** o texto que o agente escreveu antes de programar. É aqui que se descobre se o erro começou no entendimento.*

2. **Algo dá erro ao usar**

    Abra o Bug Scanner, reproduza o erro no preview e leia **Erros Críticos** e **Console**. Copie a mensagem de erro para o pedido de correção; ela vale mais do que descrever o sintoma.

![Bug Scanner do Skip aberto sobre o preview, com as abas Erros Críticos, Requisições, Console e Navegação e a mensagem Nenhum erro crítico detectado.](https://guides.adapta.org/media/screenshots/skip/diagnostico-2026-09-21/bug-scanner-2026-09-21.png)

    *No Bug Scanner: **1** as quatro abas, sendo Erros Críticos e Console as que interessam primeiro, e **2** o estado vazio. Sem erro registrado não quer dizer app correto: quer dizer que nada quebrou enquanto ele estava aberto.*

3. **Uma execução travou ou falhou**

    Na **Visão geral**, veja em qual fase a linha do tempo parou e confira a aba **Q.A.**: um grupo com erro aponta o tipo de problema (configuração, código, servidor ou cliente).

![Aba Visão geral do Inspetor de Build do Skip, com Status Completed, origem Skip, contagem de linhas e arquivos, e a linha do tempo da execução com horários.](https://guides.adapta.org/media/screenshots/skip/diagnostico-2026-09-21/visao-geral-2026-09-21.png)

    *Na Visão geral: **1** o resumo da execução, com estado e quantos arquivos saíram, e **2** a linha do tempo. A fase em que ela para é o que diz onde procurar.*

4. **Antes de publicar**

    Confira em **Versionamento** qual versão está **Ativa** e em **Q.A.** se o último resultado passou sem erros.

![Aba Q.A. do Inspetor de Build do Skip, com Último resultado dividido em Erros de Setup, Análise Estática, Servidor e Cliente, todos sem erros, e a seção Resultados anteriores.](https://guides.adapta.org/media/screenshots/skip/diagnostico-2026-09-21/qa-2026-09-21.png)

    *Na aba Q.A.: **1** a aba, **2** o último resultado, **3** os quatro grupos que separam o tipo de problema e **4** os resultados anteriores, que permitem comparar execuções em vez de olhar só a última.*

**Dica do curso:** em *Os 10 Mandamentos do Skip*, Romário Melo ensina a olhar cada versão pelo que o PM reinterpretou, pelos arquivos alterados e pelos testes de QA, exatamente as abas PM, Dev e Q.A. Para erros, ele recomenda primeiro limpar o cache do navegador (recarregar forçado) antes de pedir correção, e usar o modo chat com a mensagem "quando faço X aparece o erro Y; analise o código e me dê uma solução".

## O que conferir

- **Prints do Inspetor:** a aba PM expõe credenciais iniciais; recorte antes de compartilhar (veja [Cuidados com dados e chaves](https://guides.adapta.org/guias/skip/conta-e-organizacao/dados/)).

- **Erros persistentes:** se o Bug Scanner segue mostrando o mesmo erro depois de uma correção, cite a mensagem exata no pedido seguinte e uma mudança por vez ([Como pedir à IA](https://guides.adapta.org/guias/skip/comece-aqui/preparar-pedidos/)).

- **Versão publicada:** o que está no ar depende de **Publicar**; a versão **Ativa** do Inspetor é a do builder.