chore(agent): padronizar salvamento obrigatorio de evidencias de testes em .evidencias
This commit is contained in:
parent
51261563a4
commit
2e6db7dda6
30 changed files with 91 additions and 69 deletions
|
|
@ -42,7 +42,7 @@ Ao acionar `/plano.executar`, o agente adota estritamente o compromisso do **/go
|
|||
- O agente **NÃO desiste nem pede ajuda** imediatamente.
|
||||
- Ele analisa o stack trace / log de erro, diagnostica a causa raiz, refatora o trecho e roda a validação novamente.
|
||||
- Esse loop continua até que todos os critérios de aceite (Definition of Done) estejam 100% verdes.
|
||||
3. **Comprovação Baseada em Evidências:** Apenas testes reais e verificações executadas contam como conclusão. Não há "deve estar funcionando" sem validação com comandos concretos.
|
||||
3. **Comprovação Baseada em Evidências (`.evidencias/`):** Apenas testes reais e verificações executadas contam como conclusão, com todas as evidências geradas pelos testes automatizados salvas obrigatoriamente na pasta `.evidencias/`. Não há "deve estar funcionando" sem validação com comandos concretos.
|
||||
|
||||
---
|
||||
|
||||
|
|
@ -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, CSS co-localizado e despoluição visual (`refactoring-ui-hierarquia-despoluicao`). |
|
||||
| **`@ux`** *(UX Specialist)* | `*-front` (Interface, Heurísticas, Fluxo Funcional & *Refactoring UI*) | Aplicação das Heurísticas de Nielsen, `ux-fluxo-funcional` e `refactoring-ui-hierarquia-despoluicao` (livro no Paiol: `https://adm.paiol.idz.one/estaticos/Refactoring-UI-Steve-Schoger-Adam-Wathan.pdf`): navegação exclusiva no `MenuLateral.vue` ordenada pela jornada, pré-requisitos guiados, revelação progressiva (`12 colunas`), pirâmide de ações (1 primária sólida; destrutivas discretas fora do modal), zero *Card-ception* / menos bordas, consolidação de colunas em tabelas, contraste de tokens Vuetify (`secondary` escuro), zero jargão técnico e feedback imediato. |
|
||||
| **`@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 --session <modulo>_<contexto?> --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>_<contexto?> --headed` com evidências salvas em `.evidencias/`. |
|
||||
| **`@documentacao`** *(Memory & Docs)* | `memorias-ia/`, `<modulo-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 (`<modulo-wiki>/dev/<modulo-id>/`). |
|
||||
|
||||
---
|
||||
|
|
@ -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 --session <modulo>_<contexto?> --headed
|
||||
5. [@testes] Roda typecheck, biome e testes E2E com agent-browser --session <modulo>_<contexto?> --headed (evidências em .evidencias/)
|
||||
↓ (Loop /goal de auto-correção se houver falhas)
|
||||
6. [@documentacao] Atualiza memórias-ia/, historico-acoes.md e arquiva o plano
|
||||
```
|
||||
|
|
@ -149,7 +149,7 @@ Ao atingir 100% de conformidade com todos os critérios do plano:
|
|||
|
||||
1. **Atualizar Metadados e Histórico do Plano:**
|
||||
- Frontmatter: `status: "executado"`, `data-execucao: "AAAA-MM-DD HH:mm"`, `executor: "Orquestrador /goal + Multiagentes (@back, @front, @ux, @refatorar, @testes, @documentacao)"`.
|
||||
- Seção 6 (*Histórico de Execução*): arquivos modificados, resumo da solução e evidências de validação.
|
||||
- Seção 6 (*Histórico de Execução*): arquivos modificados, resumo da solução e evidências de validação salvas em `.evidencias/`.
|
||||
2. **Mover o Plano:**
|
||||
- Salvar em `./PLANOS/executado/<nome-original>.md` e remover de `./PLANOS/pendente/<nome-original>.md` (preservando o nome original do arquivo).
|
||||
3. **Atualizar Grafo de Conhecimento (Graphify):**
|
||||
|
|
|
|||
|
|
@ -83,10 +83,10 @@ Quando invocado com uma instrução (ex.: `/plano corrigir validação do númer
|
|||
---
|
||||
```
|
||||
- **1. Objetivo & Contexto:** Descrição concisa da demanda e impacto de negócio.
|
||||
- **2. Diagnóstico Técnico & Evidências:** Comportamento observado vs esperado, repro steps, arquivos mapeados com links `[arquivo](file://...)` e subseção **Raio de Impacto & Dependências (Graphify)** extraída via `bash .agent/scripts/graphify.sh impact`.
|
||||
- **2. Diagnóstico Técnico & Evidências:** Comportamento observado vs esperado, repro steps, evidências salvas em `.evidencias/`, arquivos mapeados com links `[arquivo](file://...)` e subseção **Raio de Impacto & Dependências (Graphify)** extraída via `bash .agent/scripts/graphify.sh impact`.
|
||||
- **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 --session <modulo>_<contexto?> --headed`.
|
||||
- **5. Plano de Verificação & Testes:** Testes automatizados (`typecheck`, `biome`) e roteiro manual/E2E com `agent-browser --session <modulo>_<contexto?> --headed` (salvando evidências obrigatoriamente em `.evidencias/`).
|
||||
- **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`.
|
||||
|
||||
|
|
|
|||
|
|
@ -2,8 +2,9 @@
|
|||
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)
|
||||
e isolamento mandatório de sessão e contexto (--session <modulo>_<contexto?>).
|
||||
no frontend utilizando a CLI agent-browser, com janela sempre visível (--headed),
|
||||
isolamento mandatório de sessão e contexto (--session <modulo>_<contexto?>) e
|
||||
salvamento obrigatório das evidências na pasta .evidencias/.
|
||||
scope: global
|
||||
---
|
||||
|
||||
|
|
@ -125,12 +126,13 @@ agent-browser --session "${MODULO}_${CONTEXTO}" console
|
|||
agent-browser --session "${MODULO}_${CONTEXTO}" network
|
||||
```
|
||||
|
||||
### 6. Registrar Evidência Visual
|
||||
Capture um screenshot para comprovação do resultado do teste:
|
||||
### 6. Registrar Evidência Visual (Pasta Obrigatória `.evidencias/`)
|
||||
Capture um screenshot na pasta `.evidencias/` para comprovação do resultado do teste (é proibido salvar evidências fora de `.evidencias/`):
|
||||
```bash
|
||||
# Screenshot padrão ou anotado com identificadores visuais
|
||||
agent-browser --session "${MODULO}_${CONTEXTO}" screenshot evidencias/resultado-sucesso.png
|
||||
# agent-browser --session "${MODULO}_${CONTEXTO}" screenshot --annotate evidencias/resultado-anotado.png
|
||||
# Garantir a pasta .evidencias/ e capturar screenshot padrão ou anotado
|
||||
mkdir -p .evidencias
|
||||
agent-browser --session "${MODULO}_${CONTEXTO}" screenshot .evidencias/resultado-sucesso.png
|
||||
# agent-browser --session "${MODULO}_${CONTEXTO}" screenshot --annotate .evidencias/resultado-anotado.png
|
||||
```
|
||||
|
||||
### 7. Encerrar Navegador daquele Contexto
|
||||
|
|
@ -156,7 +158,7 @@ agent-browser --session "${MODULO}_${CONTEXTO}" close
|
|||
| **Aguardar seletor** | `agent-browser --session <modulo>_<contexto?> wait --selector "<seletor>"` |
|
||||
| **Inspecionar console** | `agent-browser --session <modulo>_<contexto?> console` |
|
||||
| **Inspecionar rede** | `agent-browser --session <modulo>_<contexto?> network` |
|
||||
| **Screenshot** | `agent-browser --session <modulo>_<contexto?> screenshot <arquivo.png>` |
|
||||
| **Screenshot (em `.evidencias/`)** | `agent-browser --session <modulo>_<contexto?> screenshot .evidencias/<arquivo.png>` |
|
||||
| **Auditoria a11y (WCAG)** | `agent-browser --session <modulo>_<contexto?> a11y` |
|
||||
| **Fechar sessão** | `agent-browser --session <modulo>_<contexto?> close` |
|
||||
|
||||
|
|
@ -217,4 +219,4 @@ agent-browser skills get dogfood
|
|||
|
||||
1. **Campos Vuetify (`v-text-field`, `v-select`)**: O `snapshot -i` mapeia diretamente o `textbox` e o `combobox`. Utilize `agent-browser --session "${MODULO}_${CONTEXTO}" 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}_${CONTEXTO}" wait 500 && agent-browser --session "${MODULO}_${CONTEXTO}" 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.
|
||||
3. **Reporte de Teste e Evidências em `.evidencias/`**: Salve obrigatoriamente todas as evidências geradas na pasta `.evidencias/` e apresente ao operador o roteiro executado, os links das evidências em `.evidencias/` e a verificação de logs do console.
|
||||
|
|
|
|||
|
|
@ -142,7 +142,7 @@ Conforme as diretrizes de **Layout (`Panes` e `Canonical Layouts`), `Dialogs` e
|
|||
- Inserir links de navegação cruzada e *empty states* guiados entre telas dependentes.
|
||||
- Garantir que quadros Kanban sejam horizontais e responsivos.
|
||||
5. **Validar Visualmente com `agent-browser`:**
|
||||
- Inspecionar o fluxo ponta a ponta em modo visível (`agent-browser --session <modulo-id>_<contexto?> --headed`) conforme `rules/testes-interface-agent-browser.md`.
|
||||
- Inspecionar o fluxo ponta a ponta em modo visível (`agent-browser --session <modulo-id>_<contexto?> --headed`) e salvar as evidências geradas em `.evidencias/`, conforme `rules/testes-interface-agent-browser.md`.
|
||||
|
||||
---
|
||||
|
||||
|
|
|
|||
Loading…
Add table
Add a link
Reference in a new issue