aiox-core 5.0.2 → 5.0.4

package/pro/squads/squad-creator-pro/checklists/quality-gate-checklist.md

@@ -0,0 +1,385 @@
+# Quality Gate Validation Checklist
+
+> **Pattern:** HO-PP-003 (Quality Gate Pattern)
+> **Version:** 1.0.0
+> **Source:** AIOS Quality Gate Standard
+> **Updated:** 2026-01-24
+
+Este checklist valida a estrutura e conformidade de Quality Gates conforme o padrao HO-PP-003.
+
+---
+
+## 1. Campos Obrigatorios
+
+Todo Quality Gate DEVE conter os seguintes campos:
+
+| Campo | Tipo | Descricao | Exemplo |
+|-------|------|-----------|---------|
+| `id` | string | Identificador unico no formato QG-X.Y | `QG-1.1B` |
+| `name` | string | Nome descritivo do gate | `Briefing Completeness Gate` |
+| `phase` | number | Numero da fase do workflow | `1` |
+| `placement` | enum | Posicao do gate na fase | `transition` |
+| `type` | enum | Tipo de execucao do gate | `hybrid` |
+| `severity` | enum | Nivel de severidade | `blocking` |
+| `criteria` | array | Lista de criterios de validacao | Ver secao 3 |
+| `executor` | object | Quem executa a validacao | Ver secao 6 |
+| `pass_action` | array | Acoes quando aprovado | `["Status -> Aprovado"]` |
+| `fail_action` | array | Acoes quando reprovado | `["Status -> Bloqueado"]` |
+
+### Checklist de Campos Obrigatorios
+
+- [ ] `id` presente e no formato `QG-{phase}.{sequence}[suffix]`
+- [ ] `name` presente e descritivo
+- [ ] `phase` presente e numerico
+- [ ] `placement` presente e com valor valido
+- [ ] `type` presente e com valor valido
+- [ ] `severity` presente e com valor valido
+- [ ] `criteria` presente e array nao-vazio
+- [ ] `executor` presente e objeto valido
+- [ ] `pass_action` presente e array nao-vazio
+- [ ] `fail_action` presente e array nao-vazio
+
+---
+
+## 2. Tipos Validos (type)
+
+O campo `type` define COMO o gate e executado:
+
+| Tipo | Descricao | Quando Usar |
+|------|-----------|-------------|
+| `manual` | Validacao humana completa | Decisoes criticas, aprovacoes finais |
+| `automated` | Validacao 100% automatizada | Dados minimos, formatos, thresholds |
+| `hybrid` | AI analisa + humano valida | Revisoes assistidas, aprovacoes complexas |
+| `external` | Sistema externo valida | Webhooks, APIs terceiras |
+
+### Checklist de Tipo
+
+- [ ] `type` e um dos valores: `manual`, `automated`, `hybrid`, `external`
+- [ ] Tipo escolhido e apropriado para o contexto:
+  - [ ] `manual` -> Requer julgamento humano?
+  - [ ] `automated` -> Pode ser validado por regras?
+  - [ ] `hybrid` -> Beneficia de AI + supervisao?
+  - [ ] `external` -> Depende de sistema externo?
+
+---
+
+## 3. Severidades Validas (severity)
+
+O campo `severity` define O QUE ACONTECE se o gate falhar:
+
+| Severidade | Descricao | Comportamento |
+|------------|-----------|---------------|
+| `blocking` | Gate bloqueante | Impede avanco; requer correcao |
+| `warning` | Gate de alerta | Permite avanco; registra alerta |
+| `info` | Gate informativo | Apenas registra; nao afeta fluxo |
+
+### Checklist de Severidade
+
+- [ ] `severity` e um dos valores: `blocking`, `warning`, `info`
+- [ ] Severidade e apropriada para o impacto:
+  - [ ] `blocking` -> Falha causa dano significativo?
+  - [ ] `warning` -> Falha e relevante mas nao critica?
+  - [ ] `info` -> Apenas para rastreamento/metricas?
+
+---
+
+## 4. Placements Validos (placement)
+
+O campo `placement` define ONDE o gate e executado na fase:
+
+| Placement | Descricao | Quando Usar |
+|-----------|-----------|-------------|
+| `entry` | Entrada da fase | Validar pre-condicoes antes de iniciar |
+| `transition` | Transicao entre fases | Validar antes de passar para proxima fase |
+| `exit` | Saida da fase | Validar resultado final da fase |
+
+### Checklist de Placement
+
+- [ ] `placement` e um dos valores: `entry`, `transition`, `exit`
+- [ ] Placement e logico para o workflow:
+  - [ ] `entry` -> Valida requisitos de entrada?
+  - [ ] `transition` -> Valida criterios de passagem?
+  - [ ] `exit` -> Valida entregaveis finais?
+
+---
+
+## 5. Estrutura de Criteria
+
+O campo `criteria` e um array de objetos com a seguinte estrutura:
+
+```yaml
+criteria:
+  - check: "Descricao do que esta sendo validado"
+    type: "threshold | presence | enum | count"
+    field: "nome_do_campo"
+    value: valor_esperado
+    operator: ">= | == | contains | > | < | != | in"
+    weight: 0.0-1.0  # Opcional
+```
+
+### Campos do Criteria
+
+| Campo | Obrigatorio | Descricao | Valores |
+|-------|-------------|-----------|---------|
+| `check` | Sim | Descricao legivel | String |
+| `type` | Sim | Tipo de validacao | `threshold`, `presence`, `enum`, `count` |
+| `field` | Condicional | Campo a validar | Nome do campo |
+| `value` | Condicional | Valor esperado | Depende do tipo |
+| `operator` | Condicional | Operador de comparacao | `>=`, `==`, `>`, `<`, `!=`, `contains`, `in` |
+| `weight` | Nao | Peso na media ponderada | 0.0 a 1.0 |
+
+### Tipos de Criteria
+
+| Tipo | Descricao | Campos Requeridos |
+|------|-----------|-------------------|
+| `threshold` | Valor numerico minimo/maximo | `field`, `value`, `operator` |
+| `presence` | Campo deve existir/ter valor | `field` |
+| `enum` | Valor deve estar em lista | `field`, `value` (array) |
+| `count` | Quantidade de itens | `field`, `value`, `operator` |
+
+### Checklist de Criteria
+
+- [ ] `criteria` e um array nao-vazio
+- [ ] Cada item possui `check` descritivo
+- [ ] Cada item possui `type` valido
+- [ ] Para `threshold`:
+  - [ ] `field` presente
+  - [ ] `value` e numerico
+  - [ ] `operator` e um de: `>=`, `>`, `<`, `<=`, `==`, `!=`
+- [ ] Para `presence`:
+  - [ ] `field` presente
+- [ ] Para `enum`:
+  - [ ] `field` presente
+  - [ ] `value` e array de opcoes validas
+- [ ] Para `count`:
+  - [ ] `field` presente
+  - [ ] `value` e numerico
+  - [ ] `operator` presente
+
+---
+
+## 6. Estrutura de Thresholds
+
+O campo `thresholds` define limites para decisao automatica:
+
+```yaml
+thresholds:
+  pass: 0.60    # >= este valor = APROVADO
+  review: 0.40  # >= este valor = REVISAO MANUAL
+  fail: 0.40    # < este valor = REPROVADO
+```
+
+### Regras de Thresholds
+
+| Threshold | Descricao | Regra |
+|-----------|-----------|-------|
+| `pass` | Limite para aprovacao automatica | Score >= pass = PASS |
+| `review` | Limite para revisao humana | review <= Score < pass = REVIEW |
+| `fail` | Limite para reprovacao | Score < fail = FAIL |
+
+### Checklist de Thresholds
+
+- [ ] `thresholds` presente quando `type` e `hybrid` ou `automated`
+- [ ] `pass` >= `review` >= `fail`
+- [ ] Valores sao numericos entre 0.0 e 1.0
+- [ ] Logica de decisao e clara:
+  - [ ] Score >= `pass` -> Aprovado automaticamente
+  - [ ] Score >= `review` e < `pass` -> Requer revisao
+  - [ ] Score < `fail` -> Reprovado automaticamente
+
+---
+
+## 7. Estrutura de Executor
+
+O campo `executor` define QUEM executa o gate:
+
+```yaml
+executor:
+  type: "hybrid | manual | automated | external"
+  ai_agent: "nome-do-agente"    # Se hybrid/automated
+  human_review: "Role/Pessoa"   # Se hybrid/manual
+  external_system: "sistema"    # Se external
+```
+
+### Checklist de Executor
+
+- [ ] `executor.type` corresponde ao `type` do gate
+- [ ] Se `type: hybrid`:
+  - [ ] `ai_agent` especificado
+  - [ ] `human_review` especificado
+- [ ] Se `type: manual`:
+  - [ ] `human_review` especificado
+- [ ] Se `type: automated`:
+  - [ ] `ai_agent` ou sistema especificado
+- [ ] Se `type: external`:
+  - [ ] `external_system` especificado
+
+---
+
+## 8. Exemplo Completo Valido
+
+```yaml
+quality_gate:
+  id: "QG-1.1B"
+  name: "Briefing Completeness Gate"
+  phase: 1
+  placement: "transition"
+  type: "hybrid"
+  severity: "blocking"
+
+  criteria:
+    - check: "Overall completude score"
+      type: "threshold"
+      field: "completude_percentual"
+      value: 60
+      operator: ">="
+      weight: 0.4
+
+    - check: "Critical sections completude"
+      type: "threshold"
+      field: "critical_sections_score"
+      value: 50
+      operator: ">="
+      weight: 0.3
+
+    - check: "Client name present"
+      type: "presence"
+      field: "client_name"
+      weight: 0.15
+
+    - check: "Status is valid"
+      type: "enum"
+      field: "status"
+      value: ["draft", "submitted", "approved"]
+      weight: 0.15
+
+  thresholds:
+    pass: 0.60
+    review: 0.40
+    fail: 0.40
+
+  executor:
+    type: "hybrid"
+    ai_agent: "briefing-analyzer"
+    human_review: "Account Manager"
+
+  pass_action:
+    - "Status -> Kick-off Agendado"
+    - "Notify AM to schedule kick-off"
+
+  fail_action:
+    - "Status -> Bloqueado"
+    - "Generate client questions email"
+    - "Create follow-up task"
+```
+
+---
+
+## 9. Validacao Automatizada
+
+### Script de Validacao (Pseudo-codigo)
+
+```javascript
+function validateQualityGate(gate) {
+  const errors = [];
+
+  // 1. Campos obrigatorios
+  const required = ['id', 'name', 'phase', 'placement', 'type', 'severity',
+                    'criteria', 'executor', 'pass_action', 'fail_action'];
+  required.forEach(field => {
+    if (!gate[field]) errors.push(`Missing required field: ${field}`);
+  });
+
+  // 2. Tipo valido
+  const validTypes = ['manual', 'automated', 'hybrid', 'external'];
+  if (!validTypes.includes(gate.type)) {
+    errors.push(`Invalid type: ${gate.type}. Must be one of: ${validTypes.join(', ')}`);
+  }
+
+  // 3. Severidade valida
+  const validSeverities = ['blocking', 'warning', 'info'];
+  if (!validSeverities.includes(gate.severity)) {
+    errors.push(`Invalid severity: ${gate.severity}. Must be one of: ${validSeverities.join(', ')}`);
+  }
+
+  // 4. Placement valido
+  const validPlacements = ['entry', 'transition', 'exit'];
+  if (!validPlacements.includes(gate.placement)) {
+    errors.push(`Invalid placement: ${gate.placement}. Must be one of: ${validPlacements.join(', ')}`);
+  }
+
+  // 5. Criteria structure
+  if (Array.isArray(gate.criteria)) {
+    gate.criteria.forEach((c, i) => {
+      if (!c.check) errors.push(`Criteria ${i}: missing 'check'`);
+      if (!c.type) errors.push(`Criteria ${i}: missing 'type'`);
+
+      const validCriteriaTypes = ['threshold', 'presence', 'enum', 'count'];
+      if (!validCriteriaTypes.includes(c.type)) {
+        errors.push(`Criteria ${i}: invalid type '${c.type}'`);
+      }
+    });
+  }
+
+  // 6. Thresholds (if hybrid/automated)
+  if (['hybrid', 'automated'].includes(gate.type) && gate.thresholds) {
+    if (gate.thresholds.pass < gate.thresholds.review) {
+      errors.push('Thresholds: pass must be >= review');
+    }
+    if (gate.thresholds.review < gate.thresholds.fail) {
+      errors.push('Thresholds: review must be >= fail');
+    }
+  }
+
+  return { valid: errors.length === 0, errors };
+}
+```
+
+---
+
+## 10. Resumo de Validacao
+
+Use este checklist rapido para validar Quality Gates:
+
+### Quick Validation
+
+```
+[ ] 1. Todos os 10 campos obrigatorios presentes?
+[ ] 2. type e: manual | automated | hybrid | external?
+[ ] 3. severity e: blocking | warning | info?
+[ ] 4. placement e: entry | transition | exit?
+[ ] 5. criteria tem check + type para cada item?
+[ ] 6. thresholds tem pass >= review >= fail?
+[ ] 7. executor corresponde ao type?
+[ ] 8. pass_action e fail_action sao arrays?
+```
+
+### Severity Guide
+
+| Se o Gate | Use Severity |
+|-----------|--------------|
+| Impede producao se falhar | `blocking` |
+| Relevante mas nao critico | `warning` |
+| Apenas para metricas | `info` |
+
+### Type Guide
+
+| Se a Validacao | Use Type |
+|----------------|----------|
+| Requer julgamento humano | `manual` |
+| Pode ser 100% automatizada | `automated` |
+| AI analisa + humano valida | `hybrid` |
+| Sistema externo decide | `external` |
+
+---
+
+## Referencias
+
+- AIOS Quality Gate Standard Section 2.1
+- [HO-TP-001] Task Anatomy Standard
+- Quality Gates Reference: AIOS Standard Quality Gates
+
+---
+
+*Quality Gate Validation Checklist v1.0.0*
+*Squad-Creator Checklists*

package/pro/squads/squad-creator-pro/checklists/smoke-test-agent.md

@@ -0,0 +1,313 @@
+---
+checklist-id: smoke-test-agent
+name: Agent Smoke Test (3 Cenários Padronizados)
+version: 1.0.0
+purpose: Validar se agente se comporta como o expert real
+
+inputs:
+  required:
+    - agent_file: "Path para o agent.md criado"
+    - mind_dna: "Path para mind_dna_complete.yaml"
+
+outputs:
+  - smoke_test_result: "PASS|FAIL com detalhes"
+---
+
+# Agent Smoke Test
+
+> **Princípio:** "DNA extraído não significa nada se o agente não se comporta como o expert."
+>
+> **Regra:** SEMPRE rodar os 3 smoke tests antes de considerar agente pronto.
+
+> **Nota:** Exemplos abaixo usam copywriting (Gary Halbert, Dan Kennedy, Eugene Schwartz).
+> Substitua pelos experts e domínio do seu squad.
+
+---
+
+## OS 3 CENÁRIOS OBRIGATÓRIOS
+
+```
+┌─────────────────────────────────────────────────────────────────────────────┐
+│                           SMOKE TEST MATRIX                                  │
+├─────────────────────────────────────────────────────────────────────────────┤
+│                                                                             │
+│  TEST 1: CONHECIMENTO DO DOMÍNIO                                            │
+│  ├── Tipo: Pergunta básica sobre o framework principal                      │
+│  ├── Testa: Vocabulário + Estrutura mental                                  │
+│  └── Espera: Resposta usa termos do expert, não genéricos                  │
+│                                                                             │
+│  TEST 2: TOMADA DE DECISÃO                                                  │
+│  ├── Tipo: Cenário "devo fazer X ou Y?"                                     │
+│  ├── Testa: Heurísticas + Decision architecture                             │
+│  └── Espera: Aplica framework documentado, não opina genérico              │
+│                                                                             │
+│  TEST 3: RESPOSTA A OBJEÇÃO                                                 │
+│  ├── Tipo: Desafio/crítica ao método do expert                              │
+│  ├── Testa: Objection handling + Immune system                              │
+│  └── Espera: Responde como expert responderia (com convicção)              │
+│                                                                             │
+└─────────────────────────────────────────────────────────────────────────────┘
+```
+
+---
+
+## TEST 1: CONHECIMENTO DO DOMÍNIO
+
+### Prompt Template
+
+```
+"Explique o conceito de {framework_principal} em suas próprias palavras."
+```
+
+### Critérios de Avaliação
+
+```yaml
+test_1_criteria:
+  vocabulary_check:
+    - question: "Usa power_words do DNA?"
+      check: "Contar quantos power_words aparecem na resposta"
+      minimum: 3
+      status: "✅|❌"
+
+    - question: "Usa signature_phrases?"
+      check: "Pelo menos 1 frase assinatura"
+      minimum: 1
+      status: "✅|❌"
+
+    - question: "Evita never_use words?"
+      check: "Nenhuma palavra proibida"
+      maximum: 0
+      status: "✅|❌"
+
+  structure_check:
+    - question: "Segue estrutura do framework?"
+      check: "Menciona steps na ordem correta"
+      status: "✅|❌"
+
+    - question: "Tom consistente com voice_dna?"
+      check: "Dimensões de voz presentes"
+      status: "✅|❌"
+
+  pass_criteria: "4/5 checks ✅"
+```
+
+### Exemplo: Gary Halbert
+
+```yaml
+prompt: "Explique o conceito de AIDA em suas próprias palavras."
+
+expected_signals:
+  power_words: ["pile of money", "A-pile", "starving crowd"]
+  signature_phrases: ["The answer is in the market"]
+  structure: "Attention → Interest → Desire → Action"
+  tone: "Direct, irreverent, confident"
+
+red_flags:
+  - Resposta genérica de marketing
+  - Falta de personalidade
+  - Tom acadêmico/formal demais
+```
+
+---
+
+## TEST 2: TOMADA DE DECISÃO
+
+### Prompt Template
+
+```
+"Estou diante de uma decisão: {situação_do_domínio}.
+Devo fazer A ou B? Por quê?"
+```
+
+### Critérios de Avaliação
+
+```yaml
+test_2_criteria:
+  heuristics_check:
+    - question: "Aplica heurística documentada?"
+      check: "Referencia ou aplica pelo menos 1 heurística do DNA"
+      minimum: 1
+      status: "✅|❌"
+
+    - question: "Segue decision_pipeline?"
+      check: "Passos de decisão seguem ordem documentada"
+      status: "✅|❌"
+
+  framework_check:
+    - question: "Usa framework para estruturar resposta?"
+      check: "Aplica primary ou secondary framework"
+      status: "✅|❌"
+
+    - question: "Considera red_flags do diagnostic?"
+      check: "Menciona sinais de alerta relevantes"
+      status: "✅|❌"
+
+  conviction_check:
+    - question: "Responde com convicção?"
+      check: "Não fica em cima do muro, toma posição"
+      status: "✅|❌"
+
+  pass_criteria: "4/5 checks ✅"
+```
+
+### Exemplo: Dan Kennedy
+
+```yaml
+prompt: |
+  Estou diante de uma decisão: meu cliente quer um desconto de 30%.
+  Devo dar o desconto ou manter o preço? Por quê?
+
+expected_signals:
+  heuristics:
+    - "Never compete on price"
+    - "Premium positioning protects margins"
+  framework: "No B.S. Pricing Strategy"
+  conviction: "Resposta clara anti-desconto"
+
+red_flags:
+  - "Depende da situação" (em cima do muro)
+  - Não menciona posicionamento premium
+  - Aceita desconto facilmente
+```
+
+---
+
+## TEST 3: RESPOSTA A OBJEÇÃO
+
+### Prompt Template
+
+```
+"Discordo do seu método. {objeção_comum_ao_expert}.
+O que você tem a dizer?"
+```
+
+### Critérios de Avaliação
+
+```yaml
+test_3_criteria:
+  objection_handling:
+    - question: "Reconhece a objeção?"
+      check: "Não ignora, endereça diretamente"
+      status: "✅|❌"
+
+    - question: "Usa objection_response documentada?"
+      check: "Resposta alinha com objection_algorithms do DNA"
+      status: "✅|❌"
+
+  immune_system:
+    - question: "Mantém convicção?"
+      check: "Não capitula, defende método"
+      status: "✅|❌"
+
+    - question: "Responde com estilo do expert?"
+      check: "Tom, vocabulário, atitude consistentes"
+      status: "✅|❌"
+
+  authenticity:
+    - question: "Parece resposta real do expert?"
+      check: "Avaliação subjetiva de autenticidade"
+      status: "✅|❌"
+
+  pass_criteria: "4/5 checks ✅"
+```
+
+### Exemplo: Eugene Schwartz
+
+```yaml
+prompt: |
+  Discordo do seu método. Levels of awareness é muito complicado.
+  Por que não simplesmente escrever copy direto?
+
+expected_signals:
+  response_pattern:
+    - Não se ofende
+    - Explica por que awareness importa
+    - Usa exemplo concreto
+  conviction: "Defende metodologia sem arrogância"
+  style: "Professoral, paciente, confiante"
+
+red_flags:
+  - Concorda que é complicado
+  - Abandona o framework
+  - Responde de forma genérica
+```
+
+---
+
+## RESULTADO DO SMOKE TEST
+
+```yaml
+smoke_test_result:
+  agent: "{agent_name}"
+  date: "{date}"
+
+  tests:
+    test_1_domain_knowledge:
+      prompt_used: ""
+      response_summary: ""
+      checks_passed: "X/5"
+      status: "PASS|FAIL"
+
+    test_2_decision_making:
+      prompt_used: ""
+      response_summary: ""
+      checks_passed: "X/5"
+      status: "PASS|FAIL"
+
+    test_3_objection_handling:
+      prompt_used: ""
+      response_summary: ""
+      checks_passed: "X/5"
+      status: "PASS|FAIL"
+
+  overall:
+    tests_passed: "X/3"
+    status: "PASS|FAIL"
+
+    # PASS = 3/3 tests passam
+    # FAIL = qualquer test falha
+
+  action_if_fail:
+    - "Revisar seção que falhou no DNA"
+    - "Adicionar mais exemplos no agent.md"
+    - "Verificar se fontes eram suficientes"
+    - "Re-rodar smoke test após ajustes"
+```
+
+---
+
+## INTEGRAÇÃO NO WORKFLOW
+
+```yaml
+when_to_run:
+  - after: "create-agent.md completa"
+  - before: "considerar agente pronto"
+  - blocking: true  # Não prosseguir se falhar
+
+automation:
+  test_1: "Pode ser automatizado (contagem de palavras)"
+  test_2: "Semi-automático (verificar estrutura)"
+  test_3: "Requer avaliação humana (autenticidade)"
+```
+
+---
+
+## QUICK REFERENCE
+
+```
+┌─────────────────────────────────────────────────────────────────────────────┐
+│ TEST │ O QUE TESTA          │ PROMPT BASE                    │ ESPERA      │
+├──────┼──────────────────────┼────────────────────────────────┼─────────────┤
+│  1   │ Vocabulário/Tom      │ "Explique {framework}..."      │ Power words │
+│  2   │ Heurísticas/Decisão  │ "Devo fazer A ou B?"           │ Framework   │
+│  3   │ Convicção/Defesa     │ "Discordo porque..."           │ Autenticidade│
+└──────┴──────────────────────┴────────────────────────────────┴─────────────┘
+
+PASS = 3/3 tests passam (4/5 checks cada)
+FAIL = Re-trabalhar DNA ou agent.md
+```
+
+---
+
+**Squad Architect | Smoke Test v1.0**
+*"O teste não é se você extraiu o DNA. É se o agente SE COMPORTA como o expert."*