auroq-os 2.2.3 → 2.3.1

package/agents/squad-forge/tasks/extract-process.md

@@ -1,378 +0,0 @@
----
-task: "Extract Process"
-responsavel: "@process-archaeologist"
-responsavel_type: "agent"
-atomic_layer: "task"
-Entrada: "process_slug, process_name, scope (do start.md)"
-Saida: "01-extraction/process-units.yaml, extraction-metrics.yaml, round-*.md"
-Checklist:
-  - ">=15 PUs extraidos"
-  - ">=5 PU-STEPs"
-  - ">=2 PU-DECISIONs"
-  - ">=1 PU-QUALITY_GATE"
-  - ">=1 PU-DEPENDENCY"
-  - "6/8 lentes cobertas"
-  - "Confianca media >=0.7"
-  - "<30% PUs inferred"
-execution_type: "interactive"
----
-
-# Task: Extract Process — Extracao Iterativa de Processo
-
-**Task ID:** squad-forge/extract-process
-**Version:** 1.0.0
-**Status:** Production Ready
-**Created:** 2026-03-03
-**Category:** Knowledge Extraction
-**Execution Type:** Interactive
-
----
-
-## Executive Summary
-
-Fase 1 do pipeline Squad Forge. O @process-archaeologist conduz entrevista iterativa em N rounds usando 8 lentes de extracao. Cada round explora angulos diferentes do processo. Entre rounds, analisa gaps e gera perguntas cirurgicas. Output: banco de Process Units (PUs) estruturado.
-
-**Posicao no Workflow:** Fase 1 — Apos Setup (Fase 0), antes de Playback (Fase 2)
-**Definicao de Sucesso:** >=15 PUs, 6/8 lentes cobertas, confianca media >=0.7
-**Gate:** QG-SF-001 — Extraction Completeness
-
----
-
-## Purpose
-
-Processos complexos nao saem da cabeca de ninguem com meia duzia de perguntas. Esta task conduz uma extracao profunda e iterativa — cada round vai mais fundo, cada gap gera perguntas novas, cada PU e validado contra regras de qualidade.
-
-A extracao NAO e um formulario. E uma CONVERSA guiada por 8 lentes que garantem cobertura completa: visao geral, passos, decisoes, excecoes, I/O, qualidade, dependencias e tacito.
-
----
-
-## Pipeline Visual
-
-```
-extract-process
-  |
-  v
-ROUND 1: EXPLORACAO (L1 + L2)
-  Visao geral + sequencia de passos
-  15-30 min | Output: ~50% completo
-  |
-  v
-GAP ANALYSIS
-  Identificar lacunas, gerar perguntas
-  |
-  v
-ROUND 2: PROFUNDIDADE (L3 + L4 + L5)
-  Decisoes + excecoes + inputs/outputs
-  15-30 min | Output: ~75% completo
-  |
-  v
-GAP ANALYSIS
-  |
-  v
-ROUND 3: PRECISAO (L6 + L7 + L8)
-  Qualidade + dependencias + tacito
-  10-20 min | Output: ~90% completo
-  |
-  v
-GAP ANALYSIS
-  |
-  v
-ROUND N: CIRURGICO (gap-driven)
-  Perguntas cirurgicas nos gaps
-  5-15 min | Output: >=95%
-  Repete ate completude >= 0.95
-  |
-  v
-QUALITY GATE: QG-SF-001
-  >=15 PUs, 6/8 lentes, confianca >=0.7
-  |
-  v
-HANDOFF -> playback-validate
-```
-
----
-
-## Step-by-Step Execution
-
-### Step 1: Round 1 — Exploracao (L1 + L2)
-
-**Agente:** @process-archaeologist
-**Lentes:** L1 (Visao Geral) + L2 (Sequencia)
-**Duracao:** 15-30 min
-**Referencia:** `data/extraction-lenses.yaml`
-
-```yaml
-elicit: true
-prompt: |
-  === ROUND 1: EXPLORACAO ===
-
-  Vou comecar entendendo o macro do seu processo e depois os passos.
-
-  Me descreve esse processo como se eu fosse alguem que nunca viu.
-  Comeca com: o que dispara ele? O que acontece primeiro?
-type: "conversation"
-rounds: "2-5 trocas de mensagens"
-```
-
-**O Archaeologist neste round:**
-
-1. Explorar L1 (visao geral): trigger, endpoint, frequencia, contexto, participantes
-2. Explorar L2 (sequencia): passo a passo, duracao, ferramentas
-3. Numerar passos conforme usuario descreve
-4. Registrar vocabulario do usuario
-5. Marcar pontos que precisam de L3+ (decisoes, excecoes)
-
-**Salvar em:** `01-extraction/round-1-exploration.md`
-
-**PUs gerados neste round:**
-- PU-STEP para cada passo identificado
-- PU-INPUT/OUTPUT quando mencionados
-- Confidence: 0.7-0.9 (confirmacao direta do usuario)
-
-### Step 2: Gap Analysis 1
-
-**Agente:** @process-archaeologist (automatico)
-
-Analisar PUs do Round 1:
-
-```yaml
-gap_analysis:
-  steps_found: N
-  steps_without_decisions: [list]
-  steps_without_exceptions: [list]
-  steps_without_io: [list]
-  lens_coverage: "2/8"
-  completeness: "~0.50"
-  next_round_focus: "L3 (decisoes nos passos {list}) + L4 (excecoes) + L5 (I/O)"
-```
-
-Mostrar ao usuario:
-
-```
-=== FIM DO ROUND 1 ===
-
-Capturei {N} passos do seu processo.
-Sequencia basica mapeada.
-
-Agora vou aprofundar: decisoes, excecoes e materiais.
-```
-
-### Step 3: Round 2 — Profundidade (L3 + L4 + L5)
-
-**Agente:** @process-archaeologist
-**Lentes:** L3 (Decisoes) + L4 (Excecoes) + L5 (Inputs/Outputs)
-**Duracao:** 15-30 min
-
-```yaml
-elicit: true
-prompt: |
-  === ROUND 2: PROFUNDIDADE ===
-
-  Agora vou investigar as decisoes, problemas e materiais do seu processo.
-
-  Comecando pelo passo {N mais critico}:
-  {pergunta especifica de L3, L4 ou L5 baseada nos gaps}
-type: "conversation"
-rounds: "3-5 trocas de mensagens"
-```
-
-**O Archaeologist neste round:**
-
-1. Para cada passo com decisao pendente: aplicar L3
-2. Para passos criticos: aplicar L4 (o que da errado?)
-3. Para todos os passos: aplicar L5 (o que entra, o que sai?)
-4. Usar tecnica "5 Whys" quando usuario diz "depende"
-5. Usar tecnica "O Cenario" quando usuario e abstrato
-6. Usar tecnica "O Gemba" quando passo envolve ferramenta/tela — pedir pra MOSTRAR
-
-**PUs gerados neste round:**
-- PU-DECISION para cada bifurcacao
-- PU-EXCEPTION para cada falha/plano B
-- PU-INPUT e PU-OUTPUT para cada passo
-
-### Step 4: Gap Analysis 2
-
-Repetir analise. Mostrar progresso:
-
-```
-=== FIM DO ROUND 2 ===
-
-Capturei:
-- {X} passos
-- {Y} decisoes
-- {Z} excecoes
-- {W} inputs/outputs
-
-Lentes cobertas: {N}/8
-Completude estimada: ~75%
-
-Proximo round: criterios de qualidade, dependencias e conhecimento tacito.
-```
-
-### Step 5: Round 3 — Precisao (L6 + L7 + L8)
-
-**Agente:** @process-archaeologist
-**Lentes:** L6 (Qualidade) + L7 (Dependencias) + L8 (Tacito)
-**Duracao:** 10-20 min
-
-```yaml
-elicit: true
-prompt: |
-  === ROUND 3: PRECISAO ===
-
-  Ultimo round principal. Vou investigar qualidade, dependencias e conhecimento tacito.
-
-  {pergunta de L6, L7 ou L8 baseada nos gaps}
-type: "conversation"
-rounds: "2-4 trocas de mensagens"
-```
-
-**O Archaeologist neste round:**
-
-1. L6: criterios de qualidade pra cada passo critico
-2. L7: dependencias, gargalo, paralelismo
-3. L8: conhecimento tacito, intuicao, regras informais
-4. Usar tecnica "O Observador" pra tacito
-5. Usar tecnica "O Gargalo" pra dependencias
-
-**PUs gerados neste round:**
-- PU-QUALITY_GATE para cada criterio
-- PU-DEPENDENCY para cada relacao
-- PU-TACIT para cada conhecimento nao-articulado
-
-### Step 6: Gap Analysis 3 + Decisao
-
-```yaml
-gap_analysis:
-  total_pus: N
-  lens_coverage: "X/8"
-  completeness: "~0.90"
-  remaining_gaps: [list]
-  recommendation: "Round cirurgico focado em {gaps}" | "Extracao completa"
-```
-
-**Se completude >= 0.95:**
-- Prosseguir para QG-SF-001
-
-**Se completude < 0.95:**
-- Perguntar ao usuario:
-
-```yaml
-elicit: true
-prompt: |
-  Processo ta {X}% mapeado. Ainda tem {N} gaps:
-  {lista de gaps}
-
-  Quer que eu faca mais 1 round cirurgico (~5-10 min) pra fechar?
-  Ou o que temos ja e suficiente?
-type: "choice"
-options: ["Sim, mais 1 round", "Suficiente, vamos em frente"]
-```
-
-### Step 7: Round N — Cirurgico (se necessario)
-
-Perguntas especificas geradas pela gap analysis. So os gaps. 5-15 min.
-
-### Step 8: Quality Gate — QG-SF-001
-
-**Criterios:**
-
-| Criterio | Minimo | Ideal |
-|----------|--------|-------|
-| Total PUs | >=15 | >=25 |
-| Lentes cobertas | 6/8 | 8/8 |
-| Confianca media | >=0.7 | >=0.85 |
-| PU-STEPs | >=5 | >=10 |
-| PU-DECISIONs | >=2 | >=5 |
-| PU-QUALITY_GATEs | >=1 | >=3 |
-| PU-DEPENDENCYs | >=1 | >=3 |
-| PUs inferred | <30% | <10% |
-| Passos sem decisao explorada | <3 | 0 |
-
-**Veto conditions (BLOQUEANTE):**
-- PUs total < 5
-- Zero PU-DECISIONs
-- Zero PU-QUALITY_GATEs (processo sem criterio de qualidade = incompleto)
-- Zero PU-DEPENDENCYs (processo sem dependencia = suspeito)
-- >50% dos PUs sao inferred
-
-**Se QG-SF-001 nao passou:**
-- Informar o que falta
-- Oferecer round cirurgico adicional
-- Se usuario recusar, registrar warning e prosseguir (non-blocking override)
-
-### Step 9: Consolidar e Handoff
-
-Gerar arquivos finais:
-
-```yaml
-# 01-extraction/process-units.yaml
-metadata:
-  process_slug: "{slug}"
-  total_pus: N
-  rounds_completed: N
-  lens_coverage: "X/8"
-  average_confidence: 0.XX
-  completeness: 0.XX
-  extracted_at: "{timestamp}"
-
-units:
-  - pu_id: "PU-{slug}-001"
-    type: STEP
-    content: "..."
-    # ... todos os PUs
-```
-
-```yaml
-# 01-extraction/extraction-metrics.yaml
-rounds: N
-duration_minutes: N
-pus_by_type: {STEP: N, DECISION: N, ...}
-pus_by_round: {R1: N, R2: N, ...}
-lens_coverage: {L1: true, L2: true, ...}
-gaps_remaining: [list]
-qg_pf_001: "PASS|FAIL"
-```
-
-Handoff para @forge-chief com mensagem:
-
-```
-Extracao completa.
-
-{N} PUs extraidos em {N} rounds.
-{X}/8 lentes cobertas.
-Confianca media: {0.XX}
-
-Quality Gate QG-SF-001: {PASS/FAIL}
-
-Proximo passo: Playback Validation — apresentar processo pro usuario confirmar.
-```
-
----
-
-## Outputs
-
-| Arquivo | Conteudo |
-|---------|----------|
-| `01-extraction/round-1-exploration.md` | Transcricao Round 1 |
-| `01-extraction/round-2-depth.md` | Transcricao Round 2 |
-| `01-extraction/round-3-precision.md` | Transcricao Round 3 |
-| `01-extraction/round-N-surgical.md` | Rounds cirurgicos |
-| `01-extraction/process-units.yaml` | Banco de PUs estruturado |
-| `01-extraction/gap-report.yaml` | Gaps detectados |
-| `01-extraction/extraction-metrics.yaml` | Metricas gerais |
-
----
-
-## Error Handling
-
-| Cenario | Acao |
-|---------|------|
-| Usuario cansa | Pausar. "Retomamos na proxima." State salvo. |
-| Respostas vagas | Pedir exemplo: "Me conta da ultima vez..." |
-| Processo muda durante extracao | Registrar ambas versoes. Perguntar qual e a atual. |
-| Muitos gaps apos 4 rounds | Aceitar como esta. Registrar gaps. Playback mostrara. |
-
----
-
-**Task Status:** Ready for Production

package/agents/squad-forge/tasks/fix-squad.md

@@ -1,334 +0,0 @@
----
-task: "Fix Squad"
-responsavel: "@forge-smith"
-responsavel_type: "agent"
-atomic_layer: "task"
-Entrada: "Nome do squad existente"
-Saida: "audit-report.md, lista de fixes aplicados, lista de fixes manuais necessarios"
-Checklist:
-  - "squad-validator.js executado"
-  - "squad-analyzer.js executado (se disponivel)"
-  - "Self-audit quantitativo executado"
-  - "Audit report categorizado: criticos / serios / menores"
-  - "Auto-fixes aplicados onde possivel"
-  - "Lista de fixes manuais apresentada"
-execution_type: "interactive"
----
-
-# Task: Fix Squad — Diagnostico e Cura de Squad Existente
-
-**Task ID:** squad-forge/fix-squad
-**Version:** 1.0.0
-**Status:** Production Ready
-**Created:** 2026-05-05
-**Category:** Maintenance
-**Execution Type:** Interactive
-
----
-
-## Executive Summary
-
-Modo `*fix {squad-name}` do forge-chief. Diagnostica problemas em squad existente (estrutura, profundidade, consistencia) e tenta corrigir automaticamente o que da pra automatizar. O que nao da, lista pro usuario com fix sugerido.
-
-E exatamente o que foi feito no diagnostico do proprio squad-forge em 05/05/2026 — agora virou capacidade operacional.
-
----
-
-## Pipeline Visual
-
-```
-fix-squad
-  |
-  v
-STEP 1: IDENTIFY SQUAD
-  |
-  v
-STEP 2: AUDIT — STRUCTURAL
-  squad-validator.js + squad-analyzer.js
-  |
-  v
-STEP 3: AUDIT — DEPTH
-  Self-audit quantitativo (>=250 linhas/agente, etc)
-  |
-  v
-STEP 4: AUDIT — CONSISTENCY
-  Promessas vs implementacao (greeting, comandos, paths, etc)
-  |
-  v
-STEP 5: GENERATE AUDIT REPORT
-  Categorias: criticos / serios / menores
-  |
-  v
-STEP 6: AUTO-FIX (optional)
-  Aplicar fixes automatizaveis
-  |
-  v
-STEP 7: PRESENT MANUAL FIXES
-  Lista do que precisa intervencao humana
-```
-
----
-
-## Step-by-Step Execution
-
-### Step 1: Identify Squad
-
-Listar squads instalados, validar nome.
-
-### Step 2: Structural Audit
-
-```bash
-# squad-validator.js
-node .auroq-core/development/scripts/squad/squad-validator.js squads/{squad-name}/ > /tmp/validator-output.txt
-
-# squad-analyzer.js (se disponivel)
-node .auroq-core/development/scripts/squad/squad-analyzer.js squads/{squad-name}/ > /tmp/analyzer-output.txt 2>/dev/null
-```
-
-Capturar:
-- Errors estruturais (squad.yaml invalido, task sem 8 campos, etc)
-- Warnings nao-bloqueantes
-- Coverage metrics
-
-### Step 3: Depth Audit
-
-Rodar checks quantitativos de profundidade (mesmo Step 8 do assemble-squad):
-
-```bash
-# Por agente
-for agent in squads/{squad-name}/agents/*.md; do
-  lines=$(wc -l < "$agent")
-  examples=$(grep -c "^### Exemplo" "$agent")
-  triggers=$(grep -A100 "IMMUNE SYSTEM" "$agent" 2>/dev/null | grep -c "^|" )
-  frases=$(grep -A20 "Frases-Chave" "$agent" 2>/dev/null | grep -c '^- "')
-
-  echo "$agent: linhas=$lines examples=$examples triggers=$triggers frases=$frases"
-done
-
-# KB
-kb_total=$(wc -l squads/{squad-name}/data/*.md 2>/dev/null | tail -1 | awk '{print $1}')
-echo "KB total lines: $kb_total"
-```
-
-### Step 4: Consistency Audit
-
-Checks de consistencia interna:
-
-| Check | Como verificar | Severidade se falha |
-|-------|----------------|--------------------|
-| **REGRA AUTOCONTIDO** — sem refs externas runtime | grep por paths proibidos (`docs/knowledge/`, `squads/etlmaker/kbs/`, `business/`, `/Users/`, `~/euriler-brain/`) em arquivos runtime | **CRITICO** (bloqueia distribuicao pra aluno) |
-| Comandos do chief batem com greeting | Comparar `start.md` Step 3 com `agents/{chief}.md` COMMANDS | Serio |
-| Paths internos existem | Cada `{path}` interno mencionado em config existe no FS | Serio |
-| Schema path correto | `.auroq-core/schemas/squad-schema.json` (nao `development/schemas/`) | Serio |
-| `data/` vs `knowledge/` | Squad usa `data/` (padrao Auroq) | Menor |
-| Squad faz o que README promete | Comparar README features com tasks reais | Serio |
-| Stories existem (Article III) | `docs/stories/squad-forge/{slug}/` ou `docs/stories/{name}/` | Serio |
-| PRD existe (Article III) | `docs/prd/squad-{name}.md` | Serio |
-| Tracker existe (Project Tracker Protocol) | `business/campanhas/{name}/tracker.md` | Menor |
-
-**Verificacao AUTOCONTIDO em detalhe (script):**
-
-```bash
-SQUAD_PATH="squads/{squad-name}/"
-
-# Patterns proibidos (de quality-thresholds.yaml > autocontido.forbidden_runtime_paths)
-forbidden=(
-  "docs/knowledge/euriler-business"
-  "docs/knowledge/euriler-mind"
-  "squads/etlmaker/kbs"
-  "business/campanhas"
-  "business/financeiro"
-  "~/euriler-brain"
-  "/Users/euriler/"
-)
-
-violations=0
-for pattern in "${forbidden[@]}"; do
-  hits=$(grep -rn "$pattern" "$SQUAD_PATH" --include="*.md" --include="*.yaml" \
-    | grep -v "<!--.*-->" | grep -v "build-time")
-  if [ -n "$hits" ]; then
-    echo "CRITICO: ref externa '$pattern' em runtime:"
-    echo "$hits"
-    ((violations++))
-  fi
-done
-
-if [ "$violations" -gt 0 ]; then
-  echo "Squad NAO e autocontido. Bloqueante."
-fi
-```
-
-**Frases proibidas (verificar tambem):**
-- "ver KB completa em ..."
-- "consultar arquivo em docs/..."
-- "ver volume em squads/etlmaker..."
-- "fonte original em business/..."
-
-### Step 5: Generate Audit Report
-
-Salvar em `squads/{name}/_audit/{ISO}-audit-report.md`:
-
-```markdown
-# Audit Report — Squad {Name}
-
-**Auditado:** {ISO}
-**Auditor:** @forge-smith via *fix
-**Squad version:** {version}
-
----
-
-## Summary
-
-- Criticos: {N} (bloqueiam funcionamento)
-- Serios: {N} (degradam qualidade)
-- Menores: {N} (cosmeticos)
-- Auto-fix aplicaveis: {N}
-- Manual fix necessarios: {N}
-
----
-
-## Criticos
-
-### CRIT-1: {nome do problema}
-
-**Detectado em:** {arquivo:linha}
-**O que e:** {descricao}
-**Impacto:** {por que e critico}
-**Origem:** {validator|analyzer|depth|consistency}
-**Auto-fixable:** {Yes|No}
-**Fix sugerido:** {como corrigir}
-
-### CRIT-2: ...
-
----
-
-## Serios
-
-(mesmo formato)
-
----
-
-## Menores
-
-(mesmo formato)
-
----
-
-## Metricas Quantitativas
-
-### Por Agente
-
-| Agente | Linhas | Output Examples | Immune Triggers | Frases-Chave | Verdict |
-|--------|--------|----------------|------------------|--------------|---------|
-| {agent-1} | 287 | 3 | 4 | 6 | PASS |
-| {agent-2} | 142 | 0 | 0 | 0 | FAIL (3 issues) |
-
-### KB
-
-- Total linhas: {N}
-- Tabelas referencia: {N}
-- Decision trees: {N}
-- Regras Cardinais: {N}
-- Verdict: {PASS|FAIL}
-
----
-
-## Recommended Action
-
-{Resumo do que fazer: pode rodar auto-fix? quais manuais sao prioridade? sugerir *rebuild se inviavel?}
-```
-
-### Step 6: Auto-Fix (com confirmacao)
-
-Apresentar fixes automatizaveis pro usuario:
-
-```yaml
-elicit: true
-prompt: |
-  Encontrei {N} fixes automatizaveis:
-
-  1. {Fix 1: descricao curta}
-  2. {Fix 2}
-  3. {Fix N}
-
-  Aplico todos? Ou um por um?
-type: "choice"
-options: ["Todos", "Um por um", "Nenhum (so manual)"]
-```
-
-**Tipos de auto-fix:**
-- Path errado em referencia (typo)
-- Comando ausente em chief que existe em greeting
-- Frontmatter de task com campo faltando
-- README desatualizado vs realidade
-- Stories ausentes (gerar a partir do squad existente — reverse engineering)
-- Tracker ausente (criar a partir do squad)
-
-**NAO sao auto-fix:**
-- **Refs externas (REGRA AUTOCONTIDO violada)** — precisa LER fonte externa, processar, sintetizar e internalizar como conteudo novo. Trabalho de criatividade, nao mecanico. Sugerir `*rebuild` ou edicao guiada.
-- Profundidade insuficiente de agente (precisa criatividade — humano + smith juntos)
-- KB incompleta (precisa decisoes de design)
-- Mudanca de arquitetura
-
-**Caso especial REGRA AUTOCONTIDO:** se squad tem refs externas, fix-squad deve apresentar:
-
-```
-CRITICO: Squad tem {N} refs externas. NAO PODE ser distribuido pra alunos como esta.
-
-Refs detectadas:
-- {arquivo}:{linha} → {path externo}
-- ...
-
-Opcoes:
-1. *rebuild — reconstruir squad com hard gate AUTOCONTIDO ativo (recomendado se sao muitas refs)
-2. Edicao guiada — eu te mostro arquivo por arquivo, voce decide se internaliza ou remove
-3. Exportar refs externas pra arquivos de KB internos (build-time process — preciso ler as fontes externas e processar)
-
-Qual?
-```
-
-### Step 7: Present Manual Fixes
-
-Lista pro usuario decidir:
-
-```
-Fixes que precisam intervencao humana:
-
-CRIT-X: {problema}
-  → Sugestao: rodar `*update {squad-name}` e expandir agente {name}
-  → Tempo estimado: {N min}
-
-CRIT-Y: {problema}
-  → Sugestao: rodar `*rebuild {squad-name}` (mudanca grande)
-  → Tempo estimado: {N min}
-
-SERIO-Z: {problema}
-  → Sugestao: editar manualmente {arquivo}
-  → Tempo estimado: {N min}
-
-Total: ~{soma} min de trabalho manual.
-```
-
----
-
-## Outputs
-
-| Arquivo | Conteudo |
-|---------|----------|
-| `squads/{name}/_audit/{ISO}-audit-report.md` | Relatorio completo |
-| `squads/{name}/{arquivos auto-fixed}` | Edicoes automaticas |
-
----
-
-## Error Handling
-
-| Cenario | Acao |
-|---------|------|
-| Squad nao existe | Listar disponiveis |
-| validator/analyzer ausentes | Usar checklist nuclear como fallback |
-| Auto-fix falha | Reverter, marcar como manual fix |
-| Tantos issues que reformar e melhor | Sugerir `*rebuild` |
-
----
-
-**Task Status:** Ready for Production