auroq-os 2.2.2 → 2.3.0

package/agents/squad-forge/data/forge-kb.md

@@ -1,248 +0,0 @@
-# Squad Forge — Knowledge Base
-
-## O que e o Squad Forge
-
-Squad especialista em extracao profunda de processos e metodologias proprietarias do usuario. Transforma conhecimento tacito (que so existe na cabeca do dono) em squads Auroq funcionais.
-
-## Quando Usar
-
-- Voce tem um processo complexo que nunca documentou
-- Voce nunca conseguiu delegar esse processo porque e minucioso demais
-- Voce quer que um time de agentes IA execute (ou ajude a executar) esse processo
-- Voce quer transformar "como eu faco X" num squad reutilizavel
-
-## Quando NAO Usar
-
-- Processo ja documentado → use Squad Creator Craft (*design-squad --docs)
-- Voce quer clonar uma pessoa famosa → use Clone Forge ou Squad Creator Premium
-- Processo e trivial (2-3 passos) → nao precisa de squad
-- Voce nao sabe o que quer extrair → comece pelo Squad Advisor primeiro
-
-## Pipeline
-
-```
-Fase 0: Setup (3-5 min)
-  → Nomear processo, criar estrutura
-
-Fase 1: Extracao (30-90 min, iterativa)
-  → 8 lentes, N rounds, Process Units
-  → Gate: QG-SF-001
-
-Fase 2: Playback (10-20 min)
-  → Apresentar processo de volta, usuario valida
-  → Gate: QG-SF-002
-
-Fase 3: Arquitetura (15-30 min)
-  → Decompor em agentes, tasks, workflow
-  → Gate: QG-SF-003
-
-Fase 4: Montagem (30-60 min)
-  → Gerar artefatos Auroq completos
-  → Gate: QG-SF-004
-
-Fase 5: Validacao (10-20 min)
-  → Smoke tests + aprovacao usuario
-  → Gate: QG-SF-005
-```
-
-## 8 Lentes de Extracao
-
-| # | Lente | O que captura |
-|---|-------|--------------|
-| L1 | Visao Geral | Inicio, fim, proposito, frequencia |
-| L2 | Sequencia | Passos em ordem |
-| L3 | Decisoes | IF/THEN, bifurcacoes, criterios |
-| L4 | Excecoes | Falhas, plano B, casos atipicos |
-| L5 | Inputs/Outputs | Materiais, entregas, ferramentas |
-| L6 | Qualidade | Criterios de "bem feito" |
-| L7 | Dependencias | Ordem obrigatoria, gargalos |
-| L8 | Tacito | Conhecimento automatico, intuicao |
-
-## Process Units (PUs)
-
-Unidades atomicas de conhecimento processual. 8 tipos:
-
-- **STEP** — passo concreto executavel
-- **DECISION** — bifurcacao com condicao
-- **EXCEPTION** — falha ou caso atipico
-- **QUALITY_GATE** — criterio de qualidade
-- **DEPENDENCY** — relacao obrigatoria
-- **INPUT** — material necessario
-- **OUTPUT** — entregavel produzido
-- **TACIT** — conhecimento nao-articulado
-
-## Tipos de Executor
-
-| Tipo | Simbolo | Quem faz |
-|------|---------|----------|
-| Agent | 🤖 | IA executa sozinha |
-| Human | 👤 | So o dono pode fazer |
-| Hybrid | 🤝 | IA prepara, dono revisa |
-| Worker | ⚙️ | Automacao deterministica |
-
-## Principios
-
-1. **Zero Inference:** Nao inventar nada. Se parece faltar, perguntar.
-2. **Vocabulario do Usuario:** Usar os termos dele, nao inventar nomenclatura.
-3. **Iterativo:** Processos complexos precisam de N rounds.
-4. **Playback Obrigatorio:** Sempre validar com usuario antes de construir.
-5. **Task-First:** Tasks sao primarias, agentes sao executores.
-6. **Unidirecional:** Pipeline nao volta. Decisoes sao upstream.
-7. **Pausavel:** Pipeline pode ser pausado e retomado entre sessoes.
-8. **Gemba (Go and See):** "Me mostra" > "Me conta". Quando o processo envolve ferramentas/telas/interfaces, pedir pro usuario MOSTRAR (screenshot, screenshare, copiar template) ao inves de apenas descrever. Captura os ~30% que o usuario esquece porque faz no automatico.
-9. **KB-First para Squads Operacionais:** A Knowledge Base e o cerebro do squad, nao um arquivo de suporte. Tasks definem O QUE fazer; KB define COMO fazer com profundidade. Squad operacional sem KB rica = squad burro que nao sabe operar.
-
-## Inspiracao Metodologica (NAO frameworks impostos)
-
-- **Goldratt (TOC):** Encontrar gargalos e dependencias
-- **Ohno (Toyota/5 Whys):** Perguntar "por que" ate chegar na raiz
-- **Gawande (Checklist Manifesto):** Decompor em passos confiaveis
-
-Esses pensadores informam O METODO de extracao. O Archaeologist extrai O PROCESSO DO USUARIO.
-
-## Mapeamento Dual: PU → Estrutura + KB
-
-Cada PU alimenta DOIS destinos no squad. O erro historico era mandar tudo so pra tasks/agents e deixar a KB rasa.
-
-| PU Type | Destino Estrutural | Destino KB |
-|---------|-------------------|------------|
-| STEP (estrutural) | Passo na task | — |
-| STEP (operacional) | Passo na task | Protocolo detalhado |
-| DECISION | Decision point / gate | Decision tree |
-| EXCEPTION | Error handling | Troubleshooting |
-| QUALITY_GATE | Checklist / gate | Criterios + benchmarks |
-| TACIT | STRICT RULES do agente | Regra Cardinal com exemplos |
-| INPUT/OUTPUT | Campos da task | Glossario (termos do dominio) |
-
-**Regra:** STEP operacional = step que contem COMO fazer algo (protocolo, tecnica, estrategia). Vai pra task E pra KB. STEP estrutural = step mecanico (abrir tela, clicar botao). So vai pra task.
-
-## Integracao com ETL Existente (build-time only — REGRA AUTOCONTIDO)
-
-> **REGRA AUTOCONTIDO ativa.** ETL e fonte externa em build-time. Squad gerado runtime NAO referencia caminhos `docs/knowledge/...` ou `squads/etlmaker/kbs/...`. Conteudo e LIDO em build-time, ADAPTADO ao contexto dos agentes do squad, e ESCRITO como conteudo proprio em `squads/{name}/data/`.
-
-Quando o dominio ja tem output do ETLmaker (volumes em paths externos do repo Euriler), o Squad Forge DEVE **internalizar** esse conhecimento na KB do squad — NAO referenciar.
-
-**Fluxo (build-time):**
-1. Na Fase 3 (architect-squad Step 5a), checar se ETL existe pro dominio (`ls docs/knowledge/...`, `ls squads/etlmaker/kbs/...` — comandos rodam na maquina do Euriler em build-time)
-2. Mapear quais volumes/secoes sao relevantes pro escopo do squad em `kb_plan.internalize_from`
-3. Na Fase 4 (assemble-squad Step 6b), LER os volumes em build-time e EXTRAIR conteudo operacional
-4. ADAPTAR ao contexto dos agentes do squad — nao copiar literal, ressintetizar
-5. ESCREVER em `squads/{name}/data/{nome-tematico}.md` como conteudo proprio
-6. Citar proveniencia opcional em comentario HTML (build-time only): `<!-- Adaptado de X em build-time -->`
-7. **NUNCA** deixar refs runtime apontando pra fonte externa
-
-**Anti-padrao detectado (Andromeda, Audience):**
-- ETL produz 3.000+ linhas de conhecimento rico
-- Squad building cria skeleton de 150 linhas que **referencia** o ETL externo
-- Aluno recebe squad — nao tem o ETL — squad nao sabe operar
-- Confronto Euriler 06/05/2026: "É a maior burrice que ja vi."
-
-A KB do squad deve PRESERVAR profundidade, exemplos, tabelas e decision trees do ETL — internalizando, nao linkando.
-
-## Classificacao de Squads por Tipo de KB
-
-| Tipo de Squad | KB esperada | Profundidade |
-|---------------|-------------|--------------|
-| Operacional (trafego, conteudo, vendas) | Rica | Protocolos, decision trees, tabelas, regras cardinais, exemplos |
-| Dev/Tecnico (CI/CD, code review) | Moderada | Padroes, convencoes, checklists |
-| Analitico (pesquisa, diagnostico) | Rica | Frameworks, criterios, benchmarks, heuristicas |
-| Criativo (roteiros, design, copy) | Rica | Templates, referencias, voice DNA, anti-padroes |
-
-## Gate de Cobertura de KB
-
-Na Fase 4 (assemble-squad, Step 6d), ANTES de prosseguir pro validator:
-
-- [ ] Cada PU-TACIT representado na KB
-- [ ] Cada PU-DECISION complexa tem decision tree
-- [ ] Cada PU-STEP operacional tem protocolo detalhado
-- [ ] Cada PU-EXCEPTION critica tem troubleshooting
-- [ ] ETL incorporado (se existir)
-- [ ] Pelo menos 1 tabela de referencia
-- [ ] Vocabulario do usuario preservado
-
-**Cobertura < 80% = HALT.** Nao avanca ate completar.
-
-## Estrutura Nuclear Auroq (do Craft)
-
-Todo squad gerado DEVE ter:
-- `squad.yaml` com name (kebab-case) + version (semver) — **NAO config.yaml** (deprecated)
-- `tasks/` com >= 1 .md seguindo TASK-FORMAT-SPEC-V1 (8 campos)
-- `agents/` com >= 1 .md com frontmatter ou heading
-- Tasks sao primarias, agentes sao executores (task-first)
-- Cada agente DEVE ter **3+ output examples** (cenarios concretos com input + output real do processo)
-- Cada agente DEVE ter **immune system** (>= 3 triggers de risco + respostas automaticas, extraidos de PU-EXCEPTIONs e conhecimento tacito)
-
-Output examples dao referencia concreta pra LLM do que produzir. Agentes sem exemplos performam pior.
-Immune system protege contra desvios do processo. Triggers vem do mundo real do usuario, nao sao inventados.
-
-## Tooling de Validacao (herdado do Craft)
-
-O Squad Forge usa a mesma infraestrutura de validacao automatizada do Squad Creator (Craft). Isso garante que squads gerados pelo Forge tem a mesma qualidade estrutural que squads criados diretamente pelo Craft.
-
-### Scripts Disponiveis
-
-| Script | Path | Quando Usar | Obrigatorio |
-|--------|------|-------------|-------------|
-| **squad-validator.js** | `.auroq-core/development/scripts/squad/squad-validator.js` | Fase 4 (Step 7) + Fase 5 (Step 1) | SIM |
-| **squad-analyzer.js** | `.auroq-core/development/scripts/squad/squad-analyzer.js` | Fase 4 (Step 8) | Recomendado |
-
-### squad-validator.js — O que valida
-
-- **Manifest:** squad.yaml contra JSON Schema (name, version, tiers, tasks, workflows)
-- **Estrutura:** Diretorios obrigatorios existem (agents/, tasks/)
-- **Tasks:** Cada .md tem TASK-FORMAT-SPEC-V1 (8 campos no frontmatter YAML)
-- **Agents:** Cada .md tem frontmatter ou heading com ID
-- **Workflows:** YAML valido com sequence, references cruzadas
-- **Integridade:** Tudo que squad.yaml referencia existe no filesystem
-
-### Como rodar
-
-```bash
-# Validar squad gerado na Fase 4
-node .auroq-core/development/scripts/squad/squad-validator.js minds/{slug}/04-squad/
-
-# Analisar cobertura (opcional)
-node .auroq-core/development/scripts/squad/squad-analyzer.js minds/{slug}/04-squad/
-```
-
-### Self-Healing Loop
-
-Se o validator retornar ERRORS:
-1. Ler cada erro reportado
-2. Corrigir o artefato correspondente
-3. Re-rodar o validator
-4. Repetir ate PASS ou maximo 3 tentativas
-5. Se 3 tentativas e FAIL → escalar pro Chief
-
-### TASK-FORMAT-SPECIFICATION-V1 (8 campos)
-
-```yaml
----
-task: "Nome da Task"
-responsavel: "@agent-id"
-responsavel_type: "agent|human|hybrid|worker"
-atomic_layer: "task"
-Entrada: "inputs"
-Saida: "outputs"
-Checklist:
-  - "criterio 1"
-  - "criterio 2"
-execution_type: "deterministic|semantic|interactive"
----
-```
-
-### Manifest (squad.yaml, NAO config.yaml)
-
-```yaml
-name: "squad-name"        # kebab-case, obrigatorio
-version: "1.0.0"          # semver, obrigatorio
-title: "Squad Title"
-description: "..."
-slash_prefix: "camelCase"
-tiers:
-  orchestrator: [chief]
-  tier_1: [agent-2]
-tasks: [start, task-1]
-workflows: [wf-squad-name]
-quality_gates: [...]
-```

package/agents/squad-forge/data/pu-classification.yaml

@@ -1,229 +0,0 @@
-# ═══════════════════════════════════════════════════════════════════════════════
-# PROCESS UNITS (PUs) — Classification & Validation Rules
-# ═══════════════════════════════════════════════════════════════════════════════
-# Equivalente aos MIUs do Clone Forge, mas desenhado para processos operacionais.
-# Cada PU e uma unidade atomica de conhecimento processual.
-# ═══════════════════════════════════════════════════════════════════════════════
-
-version: "1.0.0"
-
-# ─────────────────────────────────────────────────────────────────────────────
-# TIPOS DE PU
-# ─────────────────────────────────────────────────────────────────────────────
-types:
-  STEP:
-    description: "Passo concreto e executavel do processo"
-    required_fields:
-      - content        # Descricao do passo
-      - executor_hint  # human | agent | hybrid | worker
-      - estimated_time # Tempo estimado
-    optional_fields:
-      - tools_used
-      - templates_used
-    validation:
-      - "Content deve ser acao concreta (verbo + objeto)"
-      - "Nao pode ser vago: 'fazer a coisa' e invalido"
-      - "Deve ser atomico: se tem 'e' ligando duas acoes, quebrar em 2 PUs"
-    example:
-      pu_id: "PU-oferta-003"
-      type: STEP
-      content: "Escrever headline da pagina de vendas usando formula PAS (Problem-Agitate-Solution)"
-      executor_hint: agent
-      estimated_time: "15min"
-      tools_used: ["Google Docs", "template-headline.md"]
-
-  DECISION:
-    description: "Ponto de bifurcacao com condicao e branches"
-    required_fields:
-      - content     # Descricao da decisao
-      - condition   # IF {condicao}
-      - branches    # THEN A / ELSE B
-      - criteria    # O que determina a escolha
-    optional_fields:
-      - quantification  # Numeros/metricas se aplicavel
-    validation:
-      - "Condition deve ser explicita, nao vaga"
-      - "Deve ter pelo menos 2 branches"
-      - "Criteria deve vir do usuario, nao ser inventado"
-      - "'Depende' sem explicacao = invalido"
-    example:
-      pu_id: "PU-oferta-007"
-      type: DECISION
-      content: "Decidir se a oferta vai ter garantia ou nao"
-      condition: "IF ticket > R$500"
-      branches:
-        - "THEN: garantia de 30 dias com reembolso total"
-        - "ELSE: garantia de 7 dias padrao"
-      criteria: "Ticket alto = risco percebido maior = precisa garantia forte"
-
-  EXCEPTION:
-    description: "Caso atipico, falha, plano B"
-    required_fields:
-      - content   # Descricao da excecao
-      - trigger   # O que causa
-      - response  # O que o usuario faz
-      - severity  # blocker | degraded | cosmetic
-    optional_fields:
-      - frequency     # raro | ocasional | recorrente
-      - recovery_time # Tempo pra resolver
-    validation:
-      - "Trigger deve ser especifico, nao generico"
-      - "Response deve ser acao concreta"
-      - "Severity baseada no impacto no processo"
-    example:
-      pu_id: "PU-oferta-012"
-      type: EXCEPTION
-      content: "Cliente reclama que a promessa e exagerada"
-      trigger: "Headline agressiva demais gera expectativa irreal"
-      response: "Reescrever headline com proof elements, adicionar disclaimer"
-      severity: degraded
-      frequency: ocasional
-
-  QUALITY_GATE:
-    description: "Criterio de qualidade que define 'bem feito'"
-    required_fields:
-      - content      # O que e checado
-      - criteria     # Como saber se ta certo
-      - applies_to   # PU-IDs dos passos que valida
-    optional_fields:
-      - antipatterns  # O que NUNCA pode acontecer
-      - blocking      # true se para o processo, false se e warning
-    validation:
-      - "Criteria deve ser verificavel, nao subjetivo"
-      - "Deve referenciar passos especificos"
-    example:
-      pu_id: "PU-oferta-015"
-      type: QUALITY_GATE
-      content: "Validar que a oferta tem todos os 4 elementos da Value Equation"
-      criteria: "Dream Outcome + Perceived Likelihood + Time Delay + Effort/Sacrifice — todos presentes"
-      applies_to: ["PU-oferta-003", "PU-oferta-005", "PU-oferta-008"]
-      blocking: true
-
-  DEPENDENCY:
-    description: "Relacao obrigatoria entre passos"
-    required_fields:
-      - content    # Descricao da dependencia
-      - from_pu    # PU que precisa estar completo
-      - to_pu      # PU que depende
-      - type       # blocking | soft | external
-    optional_fields:
-      - reason     # Por que essa dependencia existe
-    validation:
-      - "from_pu e to_pu devem existir no banco de PUs"
-      - "Nao pode criar dependencia circular"
-    example:
-      pu_id: "PU-oferta-018"
-      type: DEPENDENCY
-      content: "Headline depende da pesquisa de dores do publico"
-      from_pu: "PU-oferta-001"
-      to_pu: "PU-oferta-003"
-      dependency_type: blocking
-      reason: "Sem pesquisa de dores, headline sera generica"
-
-  INPUT:
-    description: "Material, dado ou recurso necessario para um passo"
-    required_fields:
-      - content      # O que e o input
-      - consumed_by  # PU-ID do passo que usa
-      - source       # De onde vem (externo, passo anterior, usuario)
-    optional_fields:
-      - format       # Tipo do input (documento, dado, template, etc)
-    validation:
-      - "consumed_by deve existir como PU-STEP"
-      - "source deve ser identificavel"
-    example:
-      pu_id: "PU-oferta-020"
-      type: INPUT
-      content: "Lista de 10 maiores dores do publico-alvo"
-      consumed_by: "PU-oferta-003"
-      source: "Pesquisa de mercado (passo anterior)"
-      format: "Lista em markdown"
-
-  OUTPUT:
-    description: "Entregavel, resultado ou artefato produzido por um passo"
-    required_fields:
-      - content       # O que e o output
-      - produced_by   # PU-ID do passo que gera
-    optional_fields:
-      - consumed_by   # PU-IDs que usam esse output
-      - format        # Tipo do output
-    validation:
-      - "produced_by deve existir como PU-STEP"
-    example:
-      pu_id: "PU-oferta-022"
-      type: OUTPUT
-      content: "Pagina de vendas completa e revisada"
-      produced_by: "PU-oferta-010"
-      consumed_by: ["PU-oferta-011"]
-      format: "HTML/landing page"
-
-  TACIT:
-    description: "Conhecimento nao-articulado, intuicao, regra informal"
-    required_fields:
-      - content        # Descricao do conhecimento tacito
-      - manifestation  # Como se manifesta na pratica
-    optional_fields:
-      - related_steps  # PU-IDs dos passos onde aparece
-      - heuristic      # Regra de bolso (se possivel extrair)
-    validation:
-      - "Deve vir diretamente do usuario — nunca inventar tacit knowledge"
-      - "Se o usuario nao confirmou, marcar inferred: true"
-    example:
-      pu_id: "PU-oferta-025"
-      type: TACIT
-      content: "Quando leio a headline e nao sinto vontade de continuar lendo, sei que ta fraca"
-      manifestation: "Teste de 3 segundos: se a headline nao prende em 3 segundos, reescreve"
-      related_steps: ["PU-oferta-003"]
-      heuristic: "Se EU nao clicaria, o cliente tambem nao"
-
-# ─────────────────────────────────────────────────────────────────────────────
-# CAMPOS UNIVERSAIS (presentes em todo PU)
-# ─────────────────────────────────────────────────────────────────────────────
-universal_fields:
-  required:
-    - pu_id          # "PU-{process_slug}-{sequence:3d}" (ex: PU-oferta-003)
-    - type           # Um dos 8 tipos acima
-    - content        # Descricao atomica
-    - source_lens    # L1-L8 (qual lente extraiu)
-    - source_round   # R1, R2, R3, RN
-    - confidence     # 0.0-1.0
-    - inferred       # boolean — se true, precisa confirmacao do usuario
-
-  optional:
-    - depends_on     # Lista de PU-IDs que este PU depende
-    - related_to     # Lista de PU-IDs relacionados (cross-reference)
-    - user_confirmed # boolean — usuario validou este PU no playback
-    - notes          # Observacoes do archaeologist
-
-# ─────────────────────────────────────────────────────────────────────────────
-# REGRAS DE VALIDACAO GLOBAL
-# ─────────────────────────────────────────────────────────────────────────────
-validation_rules:
-  id_format: "^PU-[a-z0-9-]+-\\d{3}$"
-  confidence_range: [0.0, 1.0]
-  inferred_threshold: 0.3  # Se >30% dos PUs sao inferred, extracao precisa de mais rounds
-  minimum_per_process: 15
-  minimum_steps: 5             # Processo com menos de 5 STEPs e suspeito
-  minimum_decisions: 2         # Processo sem decisao e provavelmente incompleto
-  minimum_quality_gates: 1     # Processo sem criterio de qualidade = extracao superficial
-  minimum_dependencies: 1      # Processo sem dependencia = mapeamento incompleto de ordem
-
-# ─────────────────────────────────────────────────────────────────────────────
-# REGRAS DE REJEICAO
-# ─────────────────────────────────────────────────────────────────────────────
-rejection_rules:
-  - rule: "PU generico"
-    description: "Conteudo que qualquer pessoa diria (ex: 'fazer certo', 'entregar qualidade')"
-    action: "Rejeitar e pedir detalhe especifico"
-  - rule: "PU sem proveniencia"
-    description: "PU que nao veio de nenhuma lente ou round"
-    action: "Rejeitar — todo PU precisa de source_lens e source_round"
-  - rule: "PU duplicado"
-    description: "Mesmo conteudo ja existe em outro PU"
-    action: "Merge com o existente, preservar o de maior confidence"
-  - rule: "PU composto"
-    description: "PU com 'e' ou 'depois' ligando duas acoes distintas"
-    action: "Quebrar em 2+ PUs atomicos"
-  - rule: "DECISION sem criteria"
-    description: "Decisao com 'depende' mas sem explicacao do que depende"
-    action: "Marcar como incompleto, gerar pergunta cirurgica pra proximo round"