> For the complete documentation index, see [llms.txt](https://docs.adapta.org/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.adapta.org/skip/comece-aqui/inspetor-de-build.md).

# Inspetor de Build

O **Inspetor de Build** mostra em detalhe o que acontece em cada execução (build) do Skip. É a ferramenta ideal quando você quer entender **por que uma execução falhou**, **o que a IA planejou e revisou**, ou quando precisa **comparar versões** antes de restaurar ou reverter.

É uma ferramenta de nível profissional — pense nela como o "raio-X" do que a IA fez em cada ação.

### O que é uma execução (build)

Uma execução é o **pacote de trabalho completo da IA** para um pedido seu: planejar, alterar código, rodar verificações e associar o resultado a uma versão. Mesmo que uma execução falhe no meio do caminho, ela fica registrada no histórico para consulta.

Detalhes gerais sobre versões e checkpoints estão em **Versões, Builds e Checkpoints**.

### Como abrir o Inspetor de Build

No editor, localize a barra da **área de pré-visualização**. Há um atalho — geralmente um ícone de lupa com código — que abre:

* O inspetor da **execução atual**, ou
* A navegação por **execuções anteriores**.

{% hint style="info" %}
O ícone pode ficar **desabilitado** enquanto não houver URL de preview ou enquanto um build estiver em execução. Espere o preview estar pronto.
{% endhint %}

### Abas do Inspetor

O Inspetor organiza as informações em abas, cada uma respondendo uma pergunta diferente sobre a execução:

#### Visão Geral

Resumo da execução:

* **Status:** sucesso, falha, em andamento.
* **Versão associada** à execução.
* **Tempo decorrido** até a conclusão.
* **Pedido original** que disparou a execução (o seu prompt).

É o primeiro lugar para quando você quer entender o contexto geral de um build.

#### PM (Product Manager)

Traz a **leitura e o planejamento de produto** da IA:

* Como ela **interpretou** o seu pedido.
* O que **decidiu fazer**.
* Quais **partes do projeto** decidiu tocar.

Se o resultado final não foi o que você esperava, comece a investigar **aqui**: muitas vezes o problema não é técnico, é de interpretação do prompt.

#### Dev

Mostra o que foi efetivamente **alterado no código**:

* **Arquivos tocados** na execução.
* **Trechos criados ou modificados**.

É a visão mais próxima do que um desenvolvedor veria em um *code review* tradicional.

#### Q.A.

**Resultado das verificações automáticas** da IA. Se uma execução falhou, esta aba geralmente contém a **pista mais útil** sobre onde o erro ocorreu e por que o Skip não conseguiu concluir o pedido.

#### Versionamento

Como esta execução se relaciona com as versões anteriores e posteriores. É o **ponto de partida** para operações de **Restaurar** e **Reverter** (veja **Versões, Builds e Checkpoints** para entender a diferença crítica entre as duas ações).

#### Histórico de Eventos

**Linha do tempo completa** dos eventos da execução:

* Início da execução.
* Cada decisão do agente.
* Arquivos criados ou modificados.
* Chamadas a ferramentas externas.
* Erros encontrados.
* Conclusão.

É o log mais granular disponível. Útil quando nenhuma outra aba esclarece o que aconteceu.

### Checkpoints e "versão atual"

Dentro do Inspetor você também vê **qual versão é a "atual"** (a que o editor está usando e a que aparece no preview) e pode agir sobre os checkpoints relacionados a ela.

### Dicas práticas

* **Antes de pedir ajuda** no chat ou abrir um ticket de suporte, abra a aba **Q.A.** ou **Histórico de Eventos** — na maioria das vezes o erro está explicado ali, e você pode resolver sozinho.
* **Se uma execução falhou**, compare **PM** e **Dev**: muitas vezes o planejamento estava certo, mas houve erro ao aplicar o código. Isso ajuda a decidir se vale reverter ou apenas refazer o pedido com uma redação diferente.
* **Copie mensagens de erro** direto daqui e cole no chat em Modo Chat para pedir correção com o contexto exato.

### Quando usar o Inspetor de Build

| Situação                               | Onde olhar                              |
| -------------------------------------- | --------------------------------------- |
| Quero entender por que um build falhou | Aba **Q.A.** → **Histórico de Eventos** |
| Quero ver o que a IA mudou no código   | Aba **Dev**                             |
| A IA interpretou meu prompt diferente  | Aba **PM**                              |
| Quero voltar para uma versão anterior  | Aba **Versionamento**                   |
| Preciso de um log completo da execução | Aba **Histórico de Eventos**            |

### Links relacionados

* **Versões, Builds e Checkpoints** — conceitos gerais.
* **Bug Scanner** — erros na pré-visualização (complementar ao Inspetor).
* **Diagnóstico e Resolução de Erros** — guia completo de troubleshooting.

{% hint style="success" %}
**Próximo passo:** Conheça o [**Bug Scanner**](/skip/comece-aqui/ferramentas-de-diagnostico-bug-scanner.md), a ferramenta que acompanha o que está acontecendo *dentro* da sua pré-visualização em tempo real.
{% endhint %}