auroq-os 2.2.3 → 2.3.0

package/agents/squad-forge/tasks/self-test.md

@@ -1,237 +0,0 @@
----
-task: "Self Test"
-responsavel: "@forge-chief"
-responsavel_type: "agent"
-atomic_layer: "task"
-Entrada: "Nada (auto-introspeccao)"
-Saida: "minds/_self-test/{ISO}-self-test-report.md"
-Checklist:
-  - "Audit estrutural do squad-forge (mesmos checks de fix-squad)"
-  - "Self-consistency (greeting vs comandos vs tasks)"
-  - "Continuous validation thresholds"
-  - "Relatorio salvo + apresentado"
-execution_type: "interactive"
----
-
-# Task: Self Test — Auto-Diagnostico do Squad Forge
-
-**Task ID:** squad-forge/self-test
-**Version:** 1.0.0
-**Status:** Production Ready
-**Created:** 2026-05-05
-**Category:** Maintenance / Self-validation
-**Execution Type:** Interactive
-
----
-
-## Executive Summary
-
-Comando `*self-test` do forge-chief. Roda `*fix` no proprio squad-forge + checks adicionais de consistencia interna. Garante que squad-forge nunca regride pro estado superficial que motivou o plano de correcao de 05/05/2026.
-
----
-
-## Pipeline Visual
-
-```
-self-test
-  |
-  v
-STEP 1: AUDIT THE FORGE
-  Equivalente a fix-squad.md aplicado em squads/squad-forge/
-  |
-  v
-STEP 2: CONSISTENCY CHECKS
-  Greeting vs comandos, paths, schema
-  |
-  v
-STEP 3: CONTINUOUS VALIDATION
-  Thresholds de quality-thresholds.yaml
-  |
-  v
-STEP 4: GENERATE SELF-TEST REPORT
-  minds/_self-test/{ISO}-report.md
-  |
-  v
-STEP 5: PRESENT TO USER
-  Categorias + recomendacoes
-```
-
----
-
-## Step-by-Step Execution
-
-### Step 1: Audit the Forge
-
-Executar `tasks/fix-squad.md` com target=`squads/squad-forge/`.
-
-Captura:
-- squad-validator.js output
-- squad-analyzer.js output
-- Depth metrics dos 3 agentes (forge-chief, process-archaeologist, forge-smith)
-- Depth metrics da KB (data/forge-kb.md, executor-mapping-guide.yaml, etc.)
-
-### Step 2: Consistency Checks (especificos do forge)
-
-Checks que so fazem sentido pro squad-forge:
-
-| Check | Verificacao |
-|-------|-------------|
-| **REGRA AUTOCONTIDO enforcement** | assemble-squad Step 8 grep + QG-SF-004 veto + fix-squad Step 4 critico — todos com mesmo set de patterns proibidos |
-| Greeting promete N modos, chief tem N comandos | `start.md` Step 3 vs `forge-chief.md` COMMANDS |
-| Tasks listadas em squad.yaml existem | Para cada item de `tasks:`, `tasks/{nome}.md` existe |
-| Pipeline visual de cada task bate com Steps | Numeros coerentes (sem Step 9 duplicado, etc) |
-| QGs do squad.yaml batem com QGs nas tasks | `QG-SF-001..005` consistente |
-| Thresholds em quality-thresholds.yaml leitos pelas tasks | Tasks referenciam o arquivo |
-| Schema path correto em forge-smith | `.auroq-core/schemas/squad-schema.json` |
-| `data/` (nao `knowledge/`) em todos os outputs | Consistencia interna |
-
-### Step 3: Continuous Validation (forge respeita seus proprios thresholds?)
-
-Ler `data/quality-thresholds.yaml`. Aplicar nos artefatos do proprio squad-forge:
-
-```bash
-THRESHOLDS=squads/squad-forge/data/quality-thresholds.yaml
-
-# Agentes do forge
-for agent in squads/squad-forge/agents/*.md; do
-  lines=$(wc -l < "$agent")
-  examples=$(grep -c "^### Exemplo\|^## OUTPUT EXAMPLES\|## Exemplo" "$agent")
-  triggers=$(grep -A100 "IMMUNE SYSTEM" "$agent" 2>/dev/null | grep -c "^|")
-  frases=$(grep -A20 "Frases-Chave" "$agent" 2>/dev/null | grep -c '^- "')
-
-  # Check vs thresholds
-  if [ "$lines" -lt 250 ]; then echo "FORGE FAIL: $agent linhas=$lines (min 250)"; fi
-done
-
-# Tasks do forge — checagem 8 campos
-for task in squads/squad-forge/tasks/*.md; do
-  for field in task responsavel responsavel_type atomic_layer Entrada Saida Checklist execution_type; do
-    grep -q "^$field:" "$task" || echo "FORGE FAIL: $task sem campo $field"
-  done
-done
-```
-
-> **Observacao importante:** o squad-forge NAO precisa cumprir os thresholds que ele aplica em squads gerados — ele e meta-squad e tem natureza diferente. Mas DEVE ser consistente internamente.
-
-### Step 4: Generate Self-Test Report
-
-Salvar em `squads/squad-forge/minds/_self-test/{ISO}-self-test-report.md`:
-
-```markdown
-# Self-Test Report — Squad Forge
-
-**Executado:** {ISO}
-**Squad-Forge version:** 1.0.0 + Plano de Correcao v2.0
-
----
-
-## Summary
-
-- Critical issues: {N}
-- Serious issues: {N}
-- Minor issues: {N}
-- Self-consistency: {PASS|FAIL}
-- Continuous validation: {PASS|FAIL}
-
----
-
-## Audit Result (Step 1)
-
-{Output do fix-squad.md aplicado em squads/squad-forge/}
-
----
-
-## Consistency Checks (Step 2)
-
-| Check | Status |
-|-------|--------|
-| Greeting modes vs chief commands | {PASS|FAIL: detalhe} |
-| Tasks listed in squad.yaml exist | {PASS|FAIL: detalhe} |
-| Pipeline visuals match steps | {PASS|FAIL: detalhe} |
-| QG-SF-* consistency | {PASS|FAIL: detalhe} |
-| Thresholds referenced by tasks | {PASS|FAIL: detalhe} |
-| Schema path correct | {PASS|FAIL: detalhe} |
-| `data/` consistency | {PASS|FAIL: detalhe} |
-
----
-
-## Continuous Validation (Step 3)
-
-### Agents
-| Agent | Lines | Examples | Triggers | Frases | Verdict |
-|-------|-------|----------|----------|--------|---------|
-| forge-chief | {N} | {N} | {N} | {N} | {PASS|FAIL} |
-| process-archaeologist | ... | ... | ... | ... | ... |
-| forge-smith | ... | ... | ... | ... | ... |
-
-### Tasks (8 campos)
-| Task | Missing Fields | Verdict |
-|------|---------------|---------|
-| start | (nenhum) | PASS |
-| extract-process | (nenhum) | PASS |
-| ... | ... | ... |
-
----
-
-## Recommendations
-
-{Lista de acoes prioritarias se houver issues}
-
----
-
-## Verdict
-
-{PASS|NEEDS_WORK|FAIL}
-
-{Se PASS: "Squad-forge esta saudavel. Nada precisa de fix."}
-{Se NEEDS_WORK: "Issues nao-bloqueantes encontrados. Recomendado fix em {N} dias."}
-{Se FAIL: "Issues bloqueantes. Squad-forge nao deve gerar squads novos ate fix."}
-```
-
-### Step 5: Present to User
-
-```
-=== SELF-TEST REPORT — Squad Forge ===
-
-{Resumo do report}
-
-Verdict: {PASS|NEEDS_WORK|FAIL}
-
-{Se issues:}
-Quer que eu rode `*fix squad-forge` agora pra corrigir o que da?
-
-{Se PASS:}
-Tudo certo. Squad-forge ta saudavel.
-```
-
----
-
-## When to Run
-
-Recomendado:
-- **Apos qualquer mudanca** em arquivos do squad-forge (tasks, agents, KB)
-- **Antes de gerar squad novo** se faz tempo que nao roda
-- **Mensalmente** como saude check de rotina
-- **Apos atualizacao do Auroq core** que pode afetar paths/schemas
-
----
-
-## Outputs
-
-| Arquivo | Conteudo |
-|---------|----------|
-| `squads/squad-forge/minds/_self-test/{ISO}-self-test-report.md` | Relatorio |
-
----
-
-## Error Handling
-
-| Cenario | Acao |
-|---------|------|
-| Squad-forge tem issue critico bloqueante | Avisar usuario, recomendar nao gerar squads novos ate fix |
-| validator nao disponivel | Cair pro checklist nuclear |
-| Self-test demora demais (>5min) | Salvar progresso parcial, retomar depois |
-
----
-
-**Task Status:** Ready for Production

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

@@ -1,247 +0,0 @@
----
-task: "Start"
-responsavel: "@forge-chief"
-responsavel_type: "agent"
-atomic_layer: "task"
-Entrada: "Ativacao do squad pelo usuario via /squadForge"
-Saida: "Pipeline inicializado, estrutura de diretorios criada, handoff para extracao"
-Checklist:
-  - "Chief ativo e greeting exibido"
-  - "Nome e escopo do processo coletados"
-  - "Diretorio minds/{slug}/ criado com 5 subdiretorios"
-  - ".state.json inicializado"
-execution_type: "interactive"
----
-
-# Task: Start — Entry Point do Squad Forge
-
-**Task ID:** squad-forge/start
-**Version:** 1.0.0
-**Status:** Production Ready
-**Created:** 2026-03-03
-**Category:** Entry Point
-**Execution Type:** Interactive
-
----
-
-## Executive Summary
-
-Entry point unico do Squad Forge. Ativa o Chief, exibe greeting com 3 modos (criar, atualizar, diagnosticar), roteia pro fluxo correto. Criar = pipeline de extracao. Atualizar = modificar squad existente. Diagnosticar = analisar e sugerir melhorias.
-
-## Purpose
-
-O usuario chega querendo criar um squad novo, atualizar um existente ou diagnosticar problemas. Este task e o ponto de entrada — identifica o modo e roteia pro fluxo correto.
-
----
-
-## Pipeline Visual
-
-```
-/squadForge
-  |
-  v
-STEP 1: ACTIVATE CHIEF
-  Carrega forge-chief agent
-  |
-  v
-STEP 2: DISPLAY GREETING
-  Greeting breve + convite
-  |
-  v
-STEP 3: COLLECT SCOPE
-  Qual processo? Nome, descricao breve
-  |
-  v
-STEP 4: CREATE STRUCTURE
-  Diretorio minds/{slug}/
-  |
-  v
-STEP 5: HANDOFF TO EXTRACTION
-  -> extract-process task
-```
-
----
-
-## Step-by-Step Execution
-
-### Step 0: Continuous Validation (Pre-flight check)
-
-> Antes de gerar squad novo, garantir que squad-forge ele mesmo esta saudavel.
-
-Executar check rapido:
-
-```bash
-# Sanity check — arquivos chave existem
-test -f squads/squad-forge/agents/forge-chief.md \
-  && test -f squads/squad-forge/agents/process-archaeologist.md \
-  && test -f squads/squad-forge/agents/forge-smith.md \
-  && test -f squads/squad-forge/data/quality-thresholds.yaml \
-  || { echo "Squad-forge inconsistente. Rode *self-test antes."; exit 1; }
-```
-
-**Se inconsistencia detectada:** avisar usuario:
-
-```
-Squad-forge esta com arquivos faltando. Antes de gerar squad novo,
-recomendo rodar *self-test pra diagnosticar e corrigir.
-
-Continuar mesmo assim? Pode gerar squad com qualidade abaixo do esperado.
-```
-
-(Se usuario optar por continuar, prosseguir mas registrar warning no `.state.json`.)
-
-### Step 1: Activate Chief
-
-Carregar o agente `forge-chief`.
-
-### Step 2: Display Greeting
-
-```
-=== SQUAD FORGE ===
-Agente Auroq | Criado por Euriler Jube
-Usado por ele e pela Mentoria Arcane
-
-Cada processo que vive so na sua cabeca e um risco.
-Eu tiro ele de la e transformo num squad que roda sozinho.
-Extracao profunda com 8 lentes — nao meia duzia de perguntas.
-
-O que posso fazer:
-
-1. Criar squad novo — extrair processo e montar do zero
-2. Atualizar squad — mexer em agents, tasks, KB, workflow ou estrutura
-3. Consertar squad — diagnosticar problemas e corrigir
-4. Refazer squad — reconstruir do zero mantendo o que funciona
-
-Qual vai ser?
-```
-
-**Regras do Greeting:**
-- NAO listar todos os agentes
-- NAO listar todos os comandos
-- NAO explicar o pipeline
-- Ir direto ao ponto
-
-### Step 3: Collect Scope
-
-```yaml
-elicit: true
-prompt: |
-  Escolha:
-  1. Criar squad novo
-  2. Atualizar squad
-  3. Consertar squad
-  4. Refazer squad
-type: "numbered_choice"
-default: 1
-```
-
-**Roteamento real (cada opcao tem task dedicada):**
-
-**Opcao 1 — Criar squad novo:**
-- Coletar nome e descricao do processo, gerar slug
-- **Perguntar `target_audience`** (CRITICO pra REGRA AUTOCONTIDO):
-
-  ```yaml
-  elicit: true
-  prompt: |
-    Esse squad vai ser usado SO por voce (Euriler), ou tambem distribuido pra alunos/clientes?
-
-    1. Interno — so eu (pode usar refs a business/cockpit.md, business/campanhas/, etc)
-    2. Distribuido — pra alunos/clientes (REGRA AUTOCONTIDO ativa: zero refs a paths privados)
-
-    Default: 2 (mais seguro)
-  type: numbered_choice
-  default: 2
-  ```
-
-- Salvar em `.state.json` como `target_audience: "internal" | "distributed"`
-- Seguir pipeline normal (Steps 4-5 desta task → handoff `extract-process`)
-
-**Opcao 2 — Atualizar squad:**
-- Listar squads instalados (`ls -1 squads/ | grep -v '^_'`)
-- Perguntar qual squad
-- Executar `tasks/update-squad.md` (modificacao cirurgica preservando profundidade)
-- Comando equivalente: `*update {squad-name}`
-
-**Opcao 3 — Consertar squad:**
-- Listar squads instalados
-- Perguntar qual squad
-- Executar `tasks/fix-squad.md` (audit + auto-fix + lista manual)
-- Comando equivalente: `*fix {squad-name}`
-
-**Opcao 4 — Refazer squad:**
-- Listar squads instalados
-- Perguntar qual squad
-- Executar `tasks/rebuild-squad.md` (reverse-extract + reconstruir com profundidade nova)
-- Comando equivalente: `*rebuild {squad-name}`
-
-> Cada modo tem task dedicada com checklist proprio. Nao improvisar — sempre delegar pra task.
-
-### Step 4: Create Structure
-
-Criar diretorios:
-
-```
-squads/squad-forge/minds/{slug}/
-  01-extraction/
-  02-process-map/
-  03-blueprint/
-  04-squad/
-  05-validation/
-```
-
-Inicializar `.state.json` do pipeline:
-
-```json
-{
-  "process_slug": "{slug}",
-  "process_name": "{nome}",
-  "current_phase": 0,
-  "phase_status": {
-    "phase_0": "completed",
-    "phase_1": "pending",
-    "phase_2": "pending",
-    "phase_3": "pending",
-    "phase_4": "pending",
-    "phase_5": "pending"
-  },
-  "extraction_rounds": 0,
-  "total_pus": 0,
-  "quality_gates_passed": [],
-  "started_at": "{timestamp}"
-}
-```
-
-### Step 5: Handoff to Extraction
-
-```
-Beleza! Estrutura criada pra "{process_name}".
-
-Vou passar pro Archaeologist agora — ele vai te entrevistar em rounds
-pra extrair seu processo com profundidade.
-
-Primeiro round: visao geral e sequencia de passos.
-Segundo round: decisoes, excecoes, inputs/outputs.
-Terceiro round: criterios de qualidade, dependencias, conhecimento tacito.
-
-Vamos comecar.
-```
-
-Executar handoff para @process-archaeologist via extract-process task.
-
----
-
-## Veto Conditions
-
-| Condicao | Acao |
-|----------|------|
-| Usuario nao sabe qual processo | Ajudar: "Qual atividade voce faz que gostaria que um time de IA fizesse por voce?" |
-| Processo parece muito simples (2-3 passos) | Avisar: "Processos simples podem nao precisar de squad. Vamos extrair e avaliar." |
-| Processo ja tem documentacao | Oferecer UC3: "Ja tem doc? Posso pular extracao e ir direto pra construcao." |
-| Usuario quer extrair multiplos processos | Fazer 1 por vez: "Vamos comecar com o mais importante. Qual?" |
-| Usuario quer atualizar squad que nao existe | Listar squads disponiveis: "Esses sao os squads instalados: {lista}. Qual?" |
-| Usuario quer atualizar algo que nao e squad (ex: agente Auroq) | Redirecionar: "Isso e um agente core, nao squad. Posso ajudar de outra forma." |
-
----
-
-**Task Status:** Ready for Production