From a5f16fbab9b0e2de1d72845018c4c2faf4e1a412 Mon Sep 17 00:00:00 2001
From: "Rodrigo Rodriguez (Pragmatismo)" <me@rodrigorodriguez.com>
Date: Sun, 5 Apr 2026 13:30:17 -0300
Subject: [PATCH] docs: update AGENTS.md with DETECT testing notes

---
 AGENTS.md | 27 ++++++++++++++-------------
 1 file changed, 14 insertions(+), 13 deletions(-)

diff --git a/AGENTS.md b/AGENTS.md
index 21bd1d8..5fc2ed8 100644
--- a/AGENTS.md
+++ b/AGENTS.md
@@ -32,20 +32,21 @@
 ### 📦 Data Directory Structure
 
 ```
-/opt/gbo/data/                    # Fonte original dos bots (production)
-├── system/
-│   └── work/
-│       └── {botname}.gbai/      # Código fonte .bas
-│           └── {botname}.gbdialog/
-│               └── *.bas         # Scripts BASIC originais
+# DEV LOCAL (padrão quando botserver-stack existe)
+├── ./botserver-stack/data/system/     # Fonte e Compilados
+│   └── work/{bot}.gbai/{bot}.gbdialog/
+│       ├── *.bas                     # Scripts originais
+│       └── *.ast                     # Scripts compilados (gerado automático)
 │
-./botserver-stack/data/system/work/  # Dev local (symlink ou cópia)
-├── {botname}.gbai/
-│   ├── seplagse.gbdialog/       # .bas original
-│   └── seplagse/                 # .gbkb (KB compilado)
+# PRODUCTION (com container Incus, sem botserver-stack)
+├── /opt/gbo/data/                   # Fonte dos bots
+└── /opt/gbo/work/                   # Compilados
 ```
 
-**Importante:** O botserver_compila `.bas` → `.ast` em tempo de execução. Arquivos `.ast` são gerados automaticamente.
+**IMPORTANTE:** 
+- **FONTE e COMPILE**: `./botserver-stack/data/system/work/{bot}.gbai/{bot}.gbdialog/`
+- O botserver compila `.bas` → `.ast` automaticamente
+- Se cache, deletar `.ast` para forçar recompilação
 
 ---
 
@@ -64,8 +65,8 @@ tail -f botserver.log | grep -i "error\|tool"
    ```
 
 2. **Corrigir o arquivo `.bas` na fonte:**
-   - **Production:** `/opt/gbo/data/system/work/{bot}.gbai/{bot}.gbdialog/{tool}.bas`
-   - **Dev:** `./botserver-stack/data/system/work/{bot}.gbai/{bot}.gbdialog/{tool}.bas`
+   - **Dev local:** `./botserver-stack/data/system/work/{bot}.gbai/{bot}.gbdialog/{tool}.bas`
+   - **Production:** `/opt/gbo/data/{bot}.gbai/{bot}.gbdialog/{tool}.bas`
 
 3. **Forçar recompilação (se necessário):**
    ```bash