feat(testes): padronizar uso obrigatorio de --session <modulo> no agent-browser

skills/testar-interface-agent-browser/SKILL.md

@@ -2,7 +2,8 @@
 name: testar-interface-agent-browser
 description: >
   Executar testes automatizados de interface (E2E), navegação e validação visual
-  no frontend utilizando a CLI agent-browser, com janela sempre visível (--headed).
+  no frontend utilizando a CLI agent-browser, com janela sempre visível (--headed)
+  e isolamento mandatório de sessão por módulo (--session <modulo>).
 scope: global
 ---
 
@@ -10,7 +11,16 @@ scope: global
 
 ## Objetivo
 
-Executar testes automatizados de ponta a ponta (E2E), simular jornadas de usuário, preencher formulários, inspecionar componentes gráficos e validar fluxos no frontend de maneira rápida, determinística e econômica em tokens, garantindo que o operador humano sempre acompanhe a execução na tela.
+Executar testes automatizados de ponta a ponta (E2E), simular jornadas de usuário, preencher formulários, inspecionar componentes gráficos e validar fluxos no frontend de maneira rápida, determinística e econômica em tokens, garantindo isolamento total entre processos e visualização em tempo real pelo operador humano.
+
+---
+
+## 🔒 Princípio de Isolamento de Sessão por Módulo (`--session <modulo>`)
+
+O daemon do `agent-browser` utiliza sockets Unix independentes por sessão. Para evitar conflitos de comandos, interferência entre módulos diferentes ou encerramento indevido de processos via `agent-browser close`:
+
+- **Todo comando DEVE ser acompanhado da flag `--session <modulo>`** (onde `<modulo>` é o `modulo-id` canônico de `memorias-ia/modulo.yml`), ou garantir no ambiente `export AGENT_BROWSER_SESSION=<modulo>`.
+- Caso múltiplos fluxos de teste concorrentes rodem no mesmo módulo, utilizar sufixo discriminador determinístico: `--session "${MODULO}-subfluxo"`.
 
 ---
 
@@ -20,7 +30,7 @@ Todo teste de interface executado pela IA **DEVE ABRIR A JANELA VISÍVEL** na á
 
 - Usar sempre a flag `--headed` na abertura:
   ```bash
-  agent-browser open --headed <url>
+  agent-browser --session "$MODULO" open --headed <url>
   ```
 - Ou exportar no ambiente:
   ```bash
@@ -46,16 +56,19 @@ Documentação oficial: **https://agent-browser.dev/**
 
 ## Fluxo Operacional Passo a Passo
 
-### 1. Iniciar Sessão Visível
-Abra a aplicação frontend mantendo a janela visível ao operador:
+### 1. Iniciar Sessão Visível e Isolada
+Abra a aplicação frontend mantendo a janela visível e isolada por módulo:
 ```bash
-agent-browser open --headed http://localhost:8080
+# Obter modulo-id canônico
+MODULO=$(grep -E "^modulo-id:" memorias-ia/modulo.yml | awk '{print $2}')
+
+agent-browser --session "$MODULO" open --headed http://localhost:8080
 ```
 
 ### 2. Obter Snapshot Interativo
 Gere a árvore de acessibilidade enxuta com referências numéricas:
 ```bash
-agent-browser snapshot -i
+agent-browser --session "$MODULO" snapshot -i
 ```
 *Saída de exemplo:*
 ```text
@@ -69,45 +82,45 @@ agent-browser snapshot -i
 Utilize as referências identificadas (`@e1`, `@e2`, etc.):
 ```bash
 # Preenchimento de campos de texto
-agent-browser fill @e2 "12.345.678/0001-90"
-agent-browser fill @e3 "Indústria Modelo LTDA"
+agent-browser --session "$MODULO" fill @e2 "12.345.678/0001-90"
+agent-browser --session "$MODULO" fill @e3 "Indústria Modelo LTDA"
 
 # Acionamento de botões e links
-agent-browser click @e4
+agent-browser --session "$MODULO" click @e4
 ```
 
 ### 4. Aguardar Transição e Validar Estado
 Se a ação disparar chamada assíncrona ou animação, aguarde a estabilização:
 ```bash
 # Aguardar 1 a 2 segundos
-agent-browser wait 1500
+agent-browser --session "$MODULO" wait 1500
 
 # Capturar novo snapshot para verificar se a lista ou mensagem apareceu
-agent-browser snapshot -i
+agent-browser --session "$MODULO" snapshot -i
 ```
 
 ### 5. Verificar Logs de Erro no Console e Rede
 Assegure que nenhum erro de script ou requisição 500 ocorreu silenciosamente:
 ```bash
 # Inspecionar mensagens do console do browser
-agent-browser console
+agent-browser --session "$MODULO" console
 
 # Verificar requisições de rede falhadas
-agent-browser network
+agent-browser --session "$MODULO" network
 ```
 
 ### 6. Registrar Evidência Visual
 Capture um screenshot para comprovação do resultado do teste:
 ```bash
 # Screenshot padrão ou anotado com identificadores visuais
-agent-browser screenshot evidencias/resultado-sucesso.png
-# agent-browser screenshot --annotate evidencias/resultado-anotado.png
+agent-browser --session "$MODULO" screenshot evidencias/resultado-sucesso.png
+# agent-browser --session "$MODULO" screenshot --annotate evidencias/resultado-anotado.png
 ```
 
 ### 7. Encerrar Navegador
-Finalize a sessão limpando os processos do daemon:
+Finalize a sessão isolada limpando apenas os processos do seu módulo:
 ```bash
-agent-browser close
+agent-browser --session "$MODULO" close
 ```
 
 ---
@@ -116,20 +129,20 @@ agent-browser close
 
 | Ação | Comando |
 |---|---|
-| **Abrir tela (visível)** | `agent-browser open --headed <url>` |
-| **Snapshot de elementos** | `agent-browser snapshot -i` |
-| **Clicar elemento** | `agent-browser click @ref` |
-| **Preencher campo** | `agent-browser fill @ref "valor"` |
-| **Selecionar dropdown** | `agent-browser select @ref "opcao"` |
-| **Pressionar tecla** | `agent-browser press Enter` |
-| **Obter texto** | `agent-browser get text @ref` |
-| **Aguardar tempo** | `agent-browser wait <ms>` |
-| **Aguardar seletor** | `agent-browser wait --selector "<seletor>"` |
-| **Inspecionar console** | `agent-browser console` |
-| **Inspecionar rede** | `agent-browser network` |
-| **Screenshot** | `agent-browser screenshot <arquivo.png>` |
-| **Auditoria a11y (WCAG)** | `agent-browser a11y` |
-| **Fechar sessão** | `agent-browser close` |
+| **Abrir tela (visível)** | `agent-browser --session <modulo> open --headed <url>` |
+| **Snapshot de elementos** | `agent-browser --session <modulo> snapshot -i` |
+| **Clicar elemento** | `agent-browser --session <modulo> click @ref` |
+| **Preencher campo** | `agent-browser --session <modulo> fill @ref "valor"` |
+| **Selecionar dropdown** | `agent-browser --session <modulo> select @ref "opcao"` |
+| **Pressionar tecla** | `agent-browser --session <modulo> press Enter` |
+| **Obter texto** | `agent-browser --session <modulo> get text @ref` |
+| **Aguardar tempo** | `agent-browser --session <modulo> wait <ms>` |
+| **Aguardar seletor** | `agent-browser --session <modulo> wait --selector "<seletor>"` |
+| **Inspecionar console** | `agent-browser --session <modulo> console` |
+| **Inspecionar rede** | `agent-browser --session <modulo> network` |
+| **Screenshot** | `agent-browser --session <modulo> screenshot <arquivo.png>` |
+| **Auditoria a11y (WCAG)** | `agent-browser --session <modulo> a11y` |
+| **Fechar sessão** | `agent-browser --session <modulo> close` |
 
 ---
 
@@ -138,14 +151,15 @@ agent-browser close
 Sempre que a aplicação exigir login, o agente DEVE consultar `memorias-ia/modulo.yml` para obter as credenciais canônicas configuradas em `modulo-acesso`:
 
 ```bash
-# Extrair credenciais canônicas de teste de memorias-ia/modulo.yml
+# Extrair identificador e credenciais canônicas de teste de memorias-ia/modulo.yml
+MODULO=$(grep -E "^modulo-id:" memorias-ia/modulo.yml | awk '{print $2}')
 USUARIO=$(grep -A2 "modulo-acesso:" memorias-ia/modulo.yml | grep "usuario:" | awk '{print $2}')
 SENHA=$(grep -A2 "modulo-acesso:" memorias-ia/modulo.yml | grep "senha:" | awk '{print $2}')
 
-# Preenchimento determinístico no formulário de login
-agent-browser fill @e1 "$USUARIO"
-agent-browser fill @e2 "$SENHA"
-agent-browser click @e3
+# Preenchimento determinístico no formulário de login na sessão isolada
+agent-browser --session "$MODULO" fill @e1 "$USUARIO"
+agent-browser --session "$MODULO" fill @e2 "$SENHA"
+agent-browser --session "$MODULO" click @e3
 ```
 
 > ⚠️ **Atenção:** Nunca utilize credenciais aleatórias ou inventadas que possam falhar no teste.
@@ -154,16 +168,15 @@ agent-browser click @e3
 
 ## Sessões Persistentes e Autenticação
 
-Para fluxos que necessitam manter login ativo entre comandos:
+Para fluxos que necessitam manter login ativo entre comandos com isolamento:
 ```bash
-# Iniciar sessão nomeada com auto-restore
-agent-browser --session auth-test --restore open --headed http://localhost:8080/login
+# Iniciar sessão nomeada com auto-restore no escopo do módulo
+agent-browser --session "$MODULO" --restore open --headed http://localhost:8080/login
 
-# Verificar status da sessão
-agent-browser session info --json
+# Verificar status da sessão isolada
+agent-browser --session "$MODULO" session info --json
 ```
 
-
 ---
 
 ## Skills Nativas do agent-browser
@@ -181,6 +194,6 @@ agent-browser skills get dogfood
 
 ## Boas Práticas no Ecossistema Azteca (Vue 3 / Vuetify)
 
-1. **Campos Vuetify (`v-text-field`, `v-select`)**: O `snapshot -i` mapeia diretamente o `textbox` e o `combobox`. Utilize `agent-browser fill @ref` ou `agent-browser click @ref`.
-2. **Modais e Diálogos**: Após clicar no botão que abre o modal (`v-dialog`), execute `agent-browser wait 500 && agent-browser snapshot -i` para interagir com o conteúdo do diálogo.
+1. **Campos Vuetify (`v-text-field`, `v-select`)**: O `snapshot -i` mapeia diretamente o `textbox` e o `combobox`. Utilize `agent-browser --session "$MODULO" fill @ref` ou `click @ref`.
+2. **Modais e Diálogos**: Após clicar no botão que abre o modal (`v-dialog`), execute `agent-browser --session "$MODULO" wait 500 && agent-browser --session "$MODULO" snapshot -i` para interagir com o conteúdo do diálogo.
 3. **Reporte de Teste**: Apresente ao operador o roteiro executado, evidências de screenshot e verificação de logs do console.