context agent

DOCUMENTACAO/templates/modulo.yml.template

@@ -2,7 +2,7 @@
 # Este arquivo é obrigatório na raiz de todos os projetos que utilizam .agent.
 # Ele define a identidade oficial e as configurações de rota do módulo.
 
-# Identificador único do módulo (utilizado para pacotes, wikis <modulo-wiki>/<modulo-id>/, regras de negócio e sessão isolada do agent-browser --session <modulo-id>)
+# Identificador único do módulo (utilizado para pacotes, wikis <modulo-wiki>/<modulo-id>/, regras de negócio e sessão isolada do agent-browser --session <modulo-id>_<contexto?>)
 modulo-id: nome-do-modulo.submodulo
 
 # Rota/prefixo utilizado na URL e navegação do módulo (com barras inicial e final)
@@ -14,10 +14,24 @@ modulo-descricao: Descrição detalhada do módulo para contextualização opera
 # Descrição da arquitetura, stack tecnológica e banco de dados
 modulo-tipo: aplicação web com back e front nas tecnologias bun e vue 3 com banco postgres
 
-# Credenciais padrão para autenticação em testes (agent-browser, E2E, QA)
+# Credenciais para autenticação em testes (agent-browser, E2E, QA)
+# Formato Simples (aplicação com perfil único de acesso):
 modulo-acesso:
   usuario: usuario@exemplo.com.br
   senha: "123"
 
+# Ou Formato Multi-Contexto (quando a aplicação possui acessos distintos - evita mistura de tokens):
+# modulo-acesso:
+#   interno:
+#     usuario: operador@empresa.com.br
+#     senha: "123"
+#   cliente:
+#     usuario: cliente@cliente.com.br
+#     senha: "123"
+#   externo:
+#     usuario: cidadao@gov.br
+#     senha: "123"
+#   anonimo: null # acesso público/deslogado
+
 # Caminho para a Wiki do projeto (quando omitido ou vazio, o padrão adotado é ../wiki/)
 modulo-wiki: ../wiki

DOCUMENTACAO/templates/plano.md.template

@@ -90,12 +90,12 @@ executor: null
 - Qualidade/Lint: `biome check --write <arquivos>`
 - Governança: `sh .agent/verificar-linhas.sh`
 
-### 5.2 Roteiro de Teste Manual / `agent-browser` (Sempre em Modo Visível `--headed` e com `--session <modulo-id>`)
-1. Abrir aplicação: `agent-browser --session <modulo-id> open --headed <url>`
-2. Mapear interações: `agent-browser --session <modulo-id> snapshot -i`
-3. Executar ações: `agent-browser --session <modulo-id> fill @ref "..." && agent-browser --session <modulo-id> click @ref`
-4. Capturar evidência: `agent-browser --session <modulo-id> screenshot evidencias/<slug>.png`
-5. Encerrar: `agent-browser --session <modulo-id> close`
+### 5.2 Roteiro de Teste Manual / `agent-browser` (Sempre em Modo Visível `--headed` e com `--session <modulo-id>_<contexto?>`)
+1. Abrir aplicação: `agent-browser --session <modulo-id>_<contexto?> open --headed <url>`
+2. Mapear interações: `agent-browser --session <modulo-id>_<contexto?> snapshot -i`
+3. Executar ações: `agent-browser --session <modulo-id>_<contexto?> fill @ref "..." && agent-browser --session <modulo-id>_<contexto?> click @ref`
+4. Capturar evidência: `agent-browser --session <modulo-id>_<contexto?> screenshot evidencias/<slug>.png`
+5. Encerrar: `agent-browser --session <modulo-id>_<contexto?> close`
 
 ---