jarvis-ai-framework 1.0.0

package/templates/engineering/qa/eng.qa.quality-gate-report-template.md

@@ -0,0 +1,249 @@
+# Template de Comentário - Quality Gate
+
+Estrutura padronizada para comentários de validação de tech spec no Jira.
+
+## Estrutura Base
+
+```markdown
+## 🎯 Quality Gate - Tech Spec
+
+**Status**: [✅ Conforme / ⚠️ Parcialmente / 🚫 Não conforme]
+**Score**: X/100
+**Tipo de Card**: [Task / Spike / Bug]
+
+### ✅ Pontos Positivos
+- Item 1
+- Item 2
+- Item 3
+
+### 🚫 Problemas Identificados
+
+#### Bloqueantes
+- [ ] **[Área]**: Descrição do problema e impacto
+- [ ] **[Área]**: Descrição do problema e impacto
+
+#### Melhorias Recomendadas
+- [ ] **[Área]**: Sugestão de melhoria
+- [ ] **[Área]**: Sugestão de melhoria
+
+### 🔧 Recomendações
+
+1. **[Área]**: Ação específica e acionável
+   - Exemplo concreto ou referência
+
+2. **[Área]**: Ação específica e acionável
+   - Exemplo concreto ou referência
+
+### 📚 Referência
+Validação baseada em: (processo de quality gate do projeto)
+
+---
+*Análise realizada pelo Quality Champion*
+```
+
+---
+
+## Variações por Status
+
+### ✅ CONFORME (Score 100%)
+
+```markdown
+## 🎯 Quality Gate - Tech Spec
+
+**Status**: ✅ Conforme
+**Score**: 100/100
+**Tipo de Card**: [Task/Spike/Bug]
+
+### ✅ Pontos Positivos
+- [Liste todos os critérios atendidos]
+- [Destaque aspectos particularmente bem feitos]
+- [Mencione completude da documentação]
+
+### 🔧 Recomendações
+
+Tech spec aprovada! Pode prosseguir para breakdown de subtarefas.
+
+**Próximos passos**:
+1. Executar `breakdown_spec_tech` para quebrar em subtarefas
+2. Revisar subtarefas geradas
+3. Iniciar implementação
+
+### 📚 Referência
+Validação baseada em: (processo de quality gate do projeto)
+
+---
+*Análise realizada pelo Quality Champion*
+```
+
+---
+
+### ⚠️ PARCIAL (Score 50-99%)
+
+```markdown
+## 🎯 Quality Gate - Tech Spec
+
+**Status**: ⚠️ Parcialmente conforme
+**Score**: X/100
+**Tipo de Card**: [Task/Spike/Bug]
+
+### ✅ Pontos Positivos
+- [Liste critérios já atendidos]
+- [Destaque o que está bem feito]
+
+### 🚫 Problemas Identificados
+
+#### Melhorias Recomendadas
+- [ ] **[Critério]**: Problema específico identificado
+  - **Como melhorar**: Ação específica
+  - **Exemplo**: [Forneça exemplo concreto]
+
+- [ ] **[Critério]**: Problema específico identificado
+  - **Como melhorar**: Ação específica
+
+### 🔧 Recomendações
+
+1. **[Área crítica]**: Priorize esta correção
+   - [Orientação detalhada]
+
+2. **[Área secundária]**: Melhoria incremental
+   - [Orientação detalhada]
+
+**Decisão**: Card pode prosseguir com ressalvas. Considere as melhorias para aumentar qualidade.
+
+### 📚 Referência
+Validação baseada em: (processo de quality gate do projeto)
+
+---
+*Análise realizada pelo Quality Champion*
+```
+
+---
+
+### 🚫 BLOQUEADO (Score < 50%)
+
+```markdown
+## 🎯 Quality Gate - Tech Spec
+
+**Status**: 🚫 Não conforme
+**Score**: X/100
+**Tipo de Card**: [Task/Spike/Bug]
+
+### 🚫 Problemas Identificados
+
+#### Bloqueantes (Obrigatório corrigir)
+- [ ] **[Critério crítico]**: AUSENTE - Descrição do gap
+  - **Impacto**: Por que isso bloqueia a implementação
+  - **Como corrigir**: [Passo a passo ou exemplo]
+
+- [ ] **[Critério crítico]**: AUSENTE - Descrição do gap
+  - **Impacto**: Por que isso bloqueia a implementação
+  - **Como corrigir**: [Passo a passo ou exemplo]
+
+#### Melhorias Recomendadas
+- [ ] **[Critério]**: Problema adicional
+  - **Como melhorar**: Sugestão específica
+
+### 🔧 Recomendações
+
+**⚠️ Card BLOQUEADO para breakdown**
+
+Antes de prosseguir, é necessário:
+
+1. **[Área crítica 1]**: [Ação obrigatória]
+   - Exemplo: [Fornecer exemplo concreto]
+   - Referência: [Link para template ou doc]
+
+2. **[Área crítica 2]**: [Ação obrigatória]
+   - Exemplo: [Fornecer exemplo concreto]
+   - Referência: [Link para template ou doc]
+
+**Após correções**:
+- Solicite nova análise executando `quality_gate_tech_spec` novamente
+- O card será reavaliado com os novos critérios
+
+### 📚 Referência
+Validação baseada em: (processo de quality gate do projeto)
+
+---
+*Análise realizada pelo Quality Champion*
+```
+
+---
+
+## Guia de Preenchimento
+
+### Seção: Pontos Positivos
+- **Quando usar**: Sempre que houver critérios atendidos
+- **Formato**: Lista com bullets
+- **Tom**: Positivo e específico
+- **Exemplo**: ❌ "Descrição boa" → ✅ "Descrição clara com contexto do problema e objetivo bem definido"
+
+### Seção: Problemas Identificados
+
+#### Bloqueantes
+- **Quando usar**: Critérios obrigatórios não atendidos
+- **Formato**: Checkbox + Área + Descrição
+- **Tom**: Objetivo e direto
+- **Sempre incluir**: Impacto + Como corrigir
+
+#### Melhorias Recomendadas
+- **Quando usar**: Critérios opcionais ou melhorias incrementais
+- **Formato**: Checkbox + Área + Sugestão
+- **Tom**: Construtivo e educativo
+
+### Seção: Recomendações
+- **Quando usar**: Sempre
+- **Formato**: Numerado com ações específicas
+- **Tom**: Acionável e prático
+- **Sempre incluir**: Exemplos concretos ou referências
+
+---
+
+## Boas Práticas
+
+### ✅ FAZER
+
+- Ser específico nos problemas identificados
+- Fornecer exemplos concretos
+- Incluir links para templates ou documentação
+- Usar checkboxes para facilitar acompanhamento
+- Focar no "como corrigir", não apenas no problema
+- Priorizar problemas bloqueantes no topo
+
+### ❌ EVITAR
+
+- Linguagem vaga ou genérica
+- Críticas sem sugestões de correção
+- Tom negativo ou desmotivador
+- Excesso de formalidade
+- Mencionar pessoas (removido do processo)
+- Listar muitos problemas sem priorização
+
+---
+
+## Emojis Padronizados
+
+| Emoji | Uso | Contexto |
+|-------|-----|----------|
+| 🎯 | Título principal | Quality Gate - Tech Spec |
+| ✅ | Conformidade | Status conforme, pontos positivos |
+| ⚠️ | Atenção | Status parcial, ressalvas |
+| 🚫 | Bloqueio | Status não conforme, problemas críticos |
+| 🔧 | Ação | Recomendações, próximos passos |
+| 📚 | Referência | Links para documentação |
+
+---
+
+## Checklist Pré-Publicação
+
+Antes de publicar o comentário, verifique:
+
+- [ ] Status correto (Conforme/Parcial/Bloqueado)
+- [ ] Score calculado está presente
+- [ ] Tipo de card identificado
+- [ ] Todos os problemas bloqueantes listados
+- [ ] Recomendações são acionáveis
+- [ ] Exemplos concretos fornecidos
+- [ ] Link de referência incluído
+- [ ] Tom objetivo e construtivo
+- [ ] Checkboxes para acompanhamento

package/templates/engineering/qa/qa.cypress-test-template.md

@@ -0,0 +1,172 @@
+# Template — Spec Cypress + TypeScript
+
+Template base para criação de specs `.cy.ts` seguindo os padrões definidos em
+`$RULES_FOLDER/engineering/qa/eng.qa.cypress-standards-rules.md`.
+
+---
+
+## Estrutura Base
+
+```typescript
+// e2e/{dominio}/{feature}.cy.ts
+
+import { {Dominio}Page } from '../../support/pages/{Dominio}Page'
+
+const page = new {Dominio}Page()
+
+describe('{Domínio} — {Feature}', () => {
+  beforeEach(() => {
+    // Setup comum: autenticação e navegação
+    cy.loginAs('{perfil}')
+    page.visit()
+  })
+
+  // ---------------------------------------------------------------------------
+  // Happy Path
+  // ---------------------------------------------------------------------------
+  context('quando {condição principal — estado válido}', () => {
+    beforeEach(() => {
+      cy.intercept('{MÉTODO}', '**/api/{recurso}', {
+        fixture: '{dominio}/{recurso}-{metodo}.json',
+      }).as('{verbRecurso}')
+    })
+
+    it('deve {comportamento principal esperado}', () => {
+      // Arrange
+      // (dados já preparados no beforeEach)
+
+      // Act
+      page.{acao}()
+      cy.wait('@{verbRecurso}')
+
+      // Assert
+      page.shouldShow{Resultado}()
+    })
+  })
+
+  // ---------------------------------------------------------------------------
+  // Edge Cases
+  // ---------------------------------------------------------------------------
+  context('quando {condição de borda}', () => {
+    it('deve {comportamento esperado no limite}', () => {
+      // ...
+    })
+  })
+
+  // ---------------------------------------------------------------------------
+  // Negative Tests
+  // ---------------------------------------------------------------------------
+  context('quando {condição de erro / dados inválidos}', () => {
+    it('deve exibir {mensagem de erro esperada}', () => {
+      cy.intercept('{MÉTODO}', '**/api/{recurso}', {
+        statusCode: 422,
+        body: { message: '{mensagem de erro da API}' },
+      }).as('{verbRecursoError}')
+
+      page.{acaoComDadosInvalidos}()
+      cy.wait('@{verbRecursoError}')
+
+      page.shouldShowError('{mensagem esperada}')
+    })
+  })
+})
+```
+
+---
+
+## Page Object Base
+
+```typescript
+// support/pages/{Dominio}Page.ts
+
+export class {Dominio}Page {
+  visit() {
+    cy.visit('/{rota}')
+    return this
+  }
+
+  // --- Ações ---
+
+  {acao}() {
+    cy.get('[data-testid="{btn-dominio-acao}"]').click()
+    return this
+  }
+
+  fill{Campo}(valor: string) {
+    cy.get('[data-testid="input-{dominio}-{campo}"]').clear().type(valor)
+    return this
+  }
+
+  submit() {
+    cy.get('[data-testid="btn-{dominio}-submit"]').click()
+    return this
+  }
+
+  // --- Asserções ---
+
+  shouldShow{Resultado}() {
+    cy.get('[data-testid="{el-dominio-resultado}"]').should('be.visible')
+    return this
+  }
+
+  shouldShowError(message: string) {
+    cy.get('[data-testid="alert-error-message"]').should('contain', message)
+    return this
+  }
+
+  shouldBeOnPage() {
+    cy.url().should('include', '/{rota}')
+    return this
+  }
+}
+```
+
+---
+
+## Custom Command de Autenticação (referência)
+
+```typescript
+// support/commands/auth.commands.ts
+
+Cypress.Commands.add('loginAs', (perfil: '{perfil1}' | '{perfil2}') => {
+  cy.fixture(`usuarios/${perfil}`).then((usuario) => {
+    cy.request('POST', '/api/auth/login', {
+      email: usuario.email,
+      password: Cypress.env('DEFAULT_PASSWORD'),
+    }).then(({ body }) => {
+      window.localStorage.setItem('auth_token', body.token)
+    })
+  })
+})
+```
+
+---
+
+## Fixture de Intercept (referência)
+
+```json
+// fixtures/{dominio}/{recurso}-get.json
+{
+  "data": [
+    {
+      "id": "{id-1}",
+      "{campo}": "{valor}"
+    }
+  ],
+  "total": 1,
+  "page": 1
+}
+```
+
+---
+
+## Checklist antes de fazer commit da spec
+
+- [ ] Todos os seletores usam `data-testid`
+- [ ] Nenhum `cy.wait({número})` hardcoded — apenas `cy.wait('@alias')`
+- [ ] Cada `it` testa exatamente um comportamento
+- [ ] Todas as chamadas de API estão interceptadas
+- [ ] Fixtures tipadas com `cy.fixture<Tipo>(...)`
+- [ ] Happy Path + pelo menos 1 Negative Test cobertos
+- [ ] Page Object retorna `this` em todos os métodos de ação
+- [ ] `beforeEach` garante estado limpo para cada teste

package/templates/engineering/qa/qa.exploratory-session-template.md

@@ -0,0 +1,148 @@
+# Template — Sessão de Teste Exploratório
+
+Documento de registro de sessão exploratória estruturada.
+Preencher antes, durante e após a sessão conforme indicado.
+
+---
+
+## Cabeçalho
+
+```markdown
+**Sessão ID**: EXP-{YYYYMMDD}-{N}
+**Data**: {YYYY-MM-DD}
+**QA Responsável**: {nome}
+**Duração**: {30 / 60 / 90} minutos
+**Início**: {HH:MM}
+**Fim**: {HH:MM}
+**Ambiente**: {staging / homologação / produção}
+**Versão / Build**: {tag ou hash de deploy}
+```
+
+---
+
+## Charter
+
+> Preencher antes de iniciar a sessão.
+
+```
+Explorar {área/feature/fluxo}
+para descobrir {tipo de informação / riscos a validar}
+com foco em {dimensão(ões) de qualidade — máximo 2}
+```
+
+**Dimensões escolhidas:**
+- [ ] Funcionalidade
+- [ ] Robustez
+- [ ] Consistência
+- [ ] Performance percebida
+- [ ] Acessibilidade
+- [ ] Segurança superficial
+- [ ] Integração
+- [ ] Regressão
+
+---
+
+## Escopo
+
+> O que está dentro e fora desta sessão.
+
+**Incluído:**
+- {fluxo/área 1}
+- {fluxo/área 2}
+
+**Excluído (coberto em outra sessão ou fora de escopo):**
+- {item excluído e motivo}
+
+---
+
+## Roteiro de Risco (pré-sessão)
+
+> Listar as hipóteses de risco a investigar — não é um script, é um guia de atenção.
+
+| # | Hipótese de risco | Área | Prioridade |
+|---|-------------------|------|------------|
+| 1 | {o que pode falhar?} | {componente} | Alta / Média / Baixa |
+| 2 | | | |
+
+---
+
+## Log de Execução
+
+> Preencher durante a sessão — anotações livres, não precisa ser formal.
+
+```
+{HH:MM} — {o que foi feito / observado}
+{HH:MM} — {achado ou comportamento interessante}
+{HH:MM} — {dúvida para investigar}
+```
+
+---
+
+## Achados
+
+> Classificar com severidade conforme `eng.qa.exploratory-session-rules.md`.
+
+### Bugs
+
+| ID | Título | Severidade | Reprodutível? | Evidência |
+|----|--------|------------|---------------|-----------|
+| B01 | {título conciso} | S{1-4} | Sim / Às vezes / Não | {link / screenshot} |
+
+**Detalhamento por bug:**
+
+#### B01 — {título}
+
+**Severidade:** S{N}
+**Passos para reproduzir:**
+1. {passo 1}
+2. {passo 2}
+3. {passo N}
+
+**Comportamento observado:** {o que aconteceu}
+**Comportamento esperado:** {o que deveria acontecer}
+**Ambiente/dados:** {URL, dados utilizados, usuário, etc.}
+**Evidência:** {link para screenshot/vídeo}
+
+---
+
+### Melhorias (S5 — não são bugs)
+
+| ID | Sugestão | Área |
+|----|----------|------|
+| M01 | {sugestão de UX/comportamento} | {área} |
+
+---
+
+## Cobertura da Sessão
+
+| Hipótese | Investigada? | Resultado |
+|----------|-------------|-----------|
+| {hipótese 1} | ✅ Sim / ⚠️ Parcial / ❌ Não | {o que foi encontrado} |
+
+---
+
+## Status do Charter
+
+- [ ] ✅ Completo — charter totalmente coberto
+- [ ] ⚠️ Parcial — {o que ficou pendente e motivo}
+- [ ] ❌ Bloqueado — {causa do bloqueio}
+
+---
+
+## Próximos Passos
+
+- [ ] Criar cards no $TASK_MANAGER para bugs S1–S4 via `eng-qa-bug-report`
+- [ ] {ação específica derivada dos achados}
+- [ ] Agendar sessão de follow-up se necessário: {foco da próxima sessão}
+
+---
+
+## Métricas da Sessão
+
+```
+Bugs encontrados   : S1={N} · S2={N} · S3={N} · S4={N}
+Melhorias (S5)     : {N}
+Hipóteses cobertas : {N}/{total}
+Charter            : completo / parcial / bloqueado
+Tempo efetivo      : {minutos} min de {total definido} min
+```

package/templates/engineering/qa/qa.quality-report-template.md

@@ -0,0 +1,130 @@
+---
+period: "{Sprint N / Release X.Y}"
+squad: "{SQUAD}"
+version: "1.0"
+status: Draft
+---
+
+# Template — Relatório de Qualidade por Sprint/Release
+
+Relatório consolidado de qualidade para o período. Gerado pelo skill `eng-qa-quality-report`
+a partir das sessões exploratórias, bug reports e quality gates do período.
+
+---
+
+## Cabeçalho
+
+```markdown
+**Relatório**: QA-REPORT-{SQUAD}-{PERIODO}
+**Período**: {Sprint N / Release X.Y} — {YYYY-MM-DD} a {YYYY-MM-DD}
+**Squad**: {SQUAD}
+**QA Responsável**: {nome(s)}
+**Gerado em**: {YYYY-MM-DD}
+```
+
+---
+
+## Resumo Executivo
+
+> 3–5 linhas — visão geral da saúde de qualidade do período.
+
+{Síntese do período: principais entregas validadas, riscos encontrados, tendências observadas.}
+
+---
+
+## Métricas do Período
+
+### Volume de Testes
+
+| Tipo | Qtd | vs. Período Anterior |
+|------|-----|----------------------|
+| Sessões exploratórias realizadas | {N} | {+N / -N / igual} |
+| Quality gates validados | {N} | |
+| Testes E2E adicionados/atualizados | {N} | |
+| Bugs reportados (total) | {N} | |
+
+### Distribuição de Bugs por Severidade
+
+| Severidade | Encontrados | Resolvidos | Em aberto |
+|------------|------------|------------|-----------|
+| S1 — Crítico | {N} | {N} | {N} |
+| S2 — Alto | {N} | {N} | {N} |
+| S3 — Médio | {N} | {N} | {N} |
+| S4 — Baixo | {N} | {N} | {N} |
+| **Total** | **{N}** | **{N}** | **{N}** |
+
+### Quality Gates
+
+| Status | Qtd | % do total |
+|--------|-----|------------|
+| ✅ Conforme (100%) | {N} | {%} |
+| ⚠️ Parcial (50–99%) | {N} | {%} |
+| 🚫 Bloqueado (< 50%) | {N} | {%} |
+
+---
+
+## Features Validadas
+
+| Feature / Task | QG | Sessões | Bugs S1/S2 | Status |
+|---------------|-----|---------|------------|--------|
+| {nome} | ✅/⚠️/🚫 | {N} | {N} | Aprovado / Pendente / Bloqueado |
+
+---
+
+## Bugs em Destaque
+
+### S1 — Críticos
+
+> Listar todos os S1 do período — mesmo os já resolvidos.
+
+| ID | Título | Descoberto em | Resolvido? | Tempo de resolução |
+|----|--------|--------------|------------|-------------------|
+| {ID} | {título} | {sessão / quality gate} | Sim / Não | {horas/dias} |
+
+### S2 — Altos em Aberto
+
+| ID | Título | Área | Há quanto tempo |
+|----|--------|------|----------------|
+| {ID} | {título} | {área} | {N dias} |
+
+---
+
+## Tendências
+
+### Áreas com Maior Concentração de Bugs
+
+| Área / Módulo | Bugs no período | Tendência |
+|---------------|----------------|-----------|
+| {módulo} | {N} | ↑ aumentando / → estável / ↓ melhorando |
+
+### Observações de Processo
+
+- {O que funcionou bem neste período}
+- {O que pode melhorar}
+- {Risco identificado para o próximo período}
+
+---
+
+## Cobertura de Testes E2E
+
+| Domínio | Specs ativas | Cobertura estimada | Gaps identificados |
+|---------|-------------|--------------------|--------------------|
+| {domínio} | {N} | Alta / Média / Baixa | {o que falta} |
+
+---
+
+## Recomendações para o Próximo Período
+
+| Prioridade | Ação | Responsável sugerido |
+|------------|------|----------------------|
+| Alta | {ação específica} | QA / Dev / PM |
+| Média | {ação} | |
+| Baixa | {ação} | |
+
+---
+
+## Sessões Realizadas (referência)
+
+| Sessão ID | Feature | Duração | Bugs | Charter |
+|-----------|---------|---------|------|---------|
+| EXP-{ID} | {feature} | {min} | S1={N} S2={N} | ✅/⚠️/❌ |