aiox-core 5.0.4 → 5.0.5

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

@@ -1,385 +0,0 @@
-# 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

@@ -1,313 +0,0 @@
----
-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."*