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

global/skills/plano.executar/SKILL.md

@@ -56,7 +56,7 @@ O Orquestrador Líder decompõe a especificação técnica do plano e distribui
 | **`@front`** *(Frontend Specialist)* | `*-front`, `*-comuns` | Componentes Vue 3, composables, views, formulários reativos, binding de eventos, consumo de APIs e CSS co-localizado. |
 | **`@ux`** *(UX Specialist)* | `*-front` (Interface & Heurísticas) | Aplicação das Heurísticas de Nielsen: visibilidade do estado (spinners, loading, feedback imediato), clareza cognitiva, prevenção de erros e mensagens amigáveis ao usuário. |
 | **`@refatorar`** *(Clean Code Specialist)* | Todo o código alterado | Governança estrita das 12 regras de Código Limpo: garantia do **limite de 250 linhas por arquivo**, eliminação de code smells, modularidade e Dispatch Tables. |
-| **`@testes`** *(QA & Automation)* | Checagens e Validação E2E | Tipagem (`bun run typecheck` / `tsc --noEmit`), linter (`biome check --write`), governança (`sh .agent/verificar-linhas.sh`) e testes de interface visual via `agent-browser --headed`. |
+| **`@testes`** *(QA & Automation)* | Checagens e Validação E2E | Tipagem (`bun run typecheck` / `tsc --noEmit`), linter (`biome check --write`), governança (`sh .agent/verificar-linhas.sh`) e testes de interface visual via `agent-browser --session <modulo> --headed`. |
 | **`@documentacao`** *(Memory & Docs)* | `memorias-ia/`, `wiki/` | Registro de sessão no Pilar 6 (`memorias-ia/sessao-*.md`), indexação no `historico-acoes.md`, atualização de regras técnicas na Wiki de Dev (`wiki/dev/<modulo>/`). |
 
 ---
@@ -80,7 +80,7 @@ Em implementações integradas, o Orquestrador segue a ordem canônica de handof
       ↓
 4. [@refatorar]   Extrai módulos se exceder 250 linhas e aplica Código Limpo
       ↓
-5. [@testes]      Roda typecheck, biome e testes E2E com agent-browser --headed
+5. [@testes]      Roda typecheck, biome e testes E2E com agent-browser --session <modulo> --headed
       ↓ (Loop /goal de auto-correção se houver falhas)
 6. [@documentacao] Atualiza memórias-ia/, historico-acoes.md e arquiva o plano
 ```

global/skills/plano/SKILL.md

@@ -74,7 +74,7 @@ Quando invocado com uma instrução (ex.: `/plano corrigir validação do númer
   - **2. Diagnóstico Técnico & Evidências:** Comportamento observado vs esperado, repro steps e arquivos mapeados com links `[arquivo](file://...)`.
   - **3. Critérios de Aceite & Validação (DoD):** Checklist com caixas `- [ ]` contendo condições verificáveis de sucesso.
   - **4. Especificação Técnica & Passos de Implementação:** Roteiro prático para o desenvolvedor (schemas, backend, frontend, código sugerido).
-  - **5. Plano de Verificação & Testes:** Testes automatizados (`typecheck`, `biome`) e roteiro manual/E2E com `agent-browser`.
+  - **5. Plano de Verificação & Testes:** Testes automatizados (`typecheck`, `biome`) e roteiro manual/E2E com `agent-browser --session <modulo> --headed`.
   - **6. Histórico de Execução:** Cabeçalho reservado para preenchimento na conclusão pelo executor.
 - Salve o arquivo em `./PLANOS/pendente/AAAA-MM-DD-HH-mm-<slug>.md` usando `write_to_file`.
 

global/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,32 +129,52 @@ 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` |
+
+---
+
+## 🔑 Autenticação e Credenciais Canônicas (`modulo-acesso`)
+
+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 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 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.
 
 ---
 
 ## 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
 ```
 
 ---
@@ -161,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.