---
name: Debugger Espacial (Skill de Prompt)
description: Guia de como descrever problemas de visualização de mapas para uma IA, garantindo que o "Agente Debugger" tenha o contexto para corrigir rotas e dependências.
---

# 🛰️ Skill de Prompt: Resolução de Mapas (BAE Debugger)

Para que uma IA resolva um erro de mapa no seu projeto (como arquivos não abrindo ou erros de renderização), o prompt deve seguir o padrão **"Estrutura + Rastro + Ambiente"**.

## 1. O Prompt Ideal (Estrutura Recomendada)

Para que uma IA resolva um erro de mapa no seu projeto, o prompt deve seguir o padrão **"Rastro + Teste Local + Ambiente"**.

> **"Estou com um erro na visualização do mapa. Aqui estão os detalhes:**
> 
> **1. Erro (Traceback):** [Cole aqui o erro do Streamlit]
> **2. Teste Local:** Já tentei rodar `pip install [pacote] && python -c "import [pacote]"` localmente. [Explique se funcionou ou não]
> **3. Arquitetura:** O arquivo está em `data/results/` e o app em `src/`.
> **4. Ambiente:** O erro ocorre no [Local / Cloud]."

---

## 2. Dicas da Comunidade: Regras de Ouro

### Passo Zero: Não Pular o Local
A regra #1 é: Se o erro for de importação, o Agente de IA **não deve** fazer um `git push` de correção sem antes validar a instalação no terminal local do usuário.
- **Dica:** Pergunte à IA: *"Simule a instalação deste pacote localmente e veja se ele importa corretamente antes de criarmos o commit."*

---

## 2. Dicas da Comunidade para Erros Espaciais

### A. O Erro da "Dependência Invisível"
Algumas bibliotecas como `leafmap` e `rasterio` precisam de outras ferramentas que não são óbvias (como `xarray` ou `rioxarray`).
*   **Prompt Dica:** "IA, verifique se a função `add_raster` do leafmap requer bibliotecas extras que não estão no meu `requirements.txt`."

### B. O Erro do "Caminho Relativo"
Mudar arquivos para `src/` muitas vezes quebra o caminho de onde os dados estão.
*   **Prompt Dica:** "IA, movi meu `app.py` para a pasta `src/`. Corrija os caminhos dos `.tif` para que o app continue os encontrando na pasta `data/results/` relativa à raiz."

### C. O Erro do "Tamanho do Git"
Se um arquivo no mapa não carrega, pode ser que ele não subiu para o GitHub por ser pesado (>100MB).
*   **Prompt Dica:** "IA, verifique se o arquivo `X.tif` está no repositório GitHub ou se ele foi bloqueado pelo `.gitignore` por excesso de tamanho."

---

## 🛠️ Exercicio Prático de "Auto-Cura"
Tente me perguntar o seguinte agora:
*"IA, verifique se o meu app.py no Streamlit Cloud está apontando para os endereços corretos de `data/results/`, já que ele agora roda de dentro da pasta `src/`."*

Isso ativará o **Agente Orquestrador** para validar as rotas!