auroq-os 2.2.2 → 2.3.0

package/agents/mind-forge/tasks/analyze-knowledge.md

@@ -1,278 +0,0 @@
-# Task: analyze-knowledge
-
-## Objetivo
-
-Executar analise profunda de todas as fontes usando 6 lentes, extrair Knowledge Facets (KFs), mapear dominios, perfilar voz dos experts, e detectar convergencias/tensoes/gaps.
-
-## Trigger
-
-- Continuacao automatica da Fase 1 (ingest-sources)
-- `*resume` quando pipeline pausado na Fase 2
-
-## Pre-condicoes
-
-- Fase 1 completa (QG-MF-001 passed)
-- source-manifest.yaml disponivel
-
-## Agente Executor
-
-@knowledge-miner
-
-## Referencia Obrigatoria
-
-- `agents/mind-forge/data/extraction-lenses.yaml` — 7 lentes de analise (6 de leitura + 1 de implicito)
-- `agents/mind-forge/data/kf-classification.yaml` — 7 tipos de KF + regras
-
-## Passos
-
-### Step 1: Passe 1 — Mapeamento (L1 + L2)
-
-Para cada fonte:
-
-**L1 — Territory Mapping:**
-- Quais dominios/topicos a fonte cobre?
-- Qual a tese central?
-- Quais termos o expert define de forma propria?
-- Extrair: PRINCIPLE, VOCABULARY
-
-**L2 — Framework Extraction:**
-- Quais metodologias nomeadas existem?
-- Quais sao os passos/componentes?
-- Extrair: FRAMEWORK
-
-Resultado parcial: ~50% dos KFs.
-
-### Step 2: Passe 2 — Extracao (L3 + L4)
-
-Para cada fonte:
-
-**L3 — Heuristic Mining:**
-- Quais regras SE/ENTAO o expert ensina?
-- Quais criterios de decisao?
-- Extrair: HEURISTIC
-
-**L4 — Voice & Personality:**
-- Quais frases de assinatura?
-- Qual tom de comunicacao?
-- O que o expert NUNCA diz?
-- Extrair: OUTPUT_FORMAT, VOCABULARY
-
-Resultado parcial: ~80% dos KFs.
-
-### Step 3: Passe 3 — Fronteiras (L5 + L6)
-
-Para cada fonte:
-
-**L5 — Cases & Illustrations:**
-- Quais exemplos concretos?
-- Quais cases de antes/depois?
-- Extrair: EXAMPLE
-
-**L6 — Boundaries & Anti-patterns:**
-- O que o expert avisa pra NAO fazer?
-- Onde a metodologia nao se aplica?
-- Extrair: ANTI_PATTERN
-
-Resultado parcial: ~95% dos KFs.
-
-### Step 3.5: Desconstrucao (condicional — fontes tipo transcript/entrevista)
-
-**Aplica-se APENAS quando** source-manifest indica fontes tipo `transcript`, `interview`, `podcast` ou `qa_session`.
-
-Para cada fonte elegivel, aplicar perguntas de desconstrucao sobre o conteudo:
-
-1. **Ponto de Decisao:** "Em que momento exato o expert mudou de abordagem/opiniao? O que causou a mudanca?"
-   - Extrair: HEURISTIC (o criterio de decisao implicito)
-
-2. **Contrafactual:** "Se o contexto fosse diferente, a recomendacao mudaria? Como?"
-   - Extrair: HEURISTIC com `exception` preenchida
-
-3. **Pior Decisao:** "Qual foi o pior erro que o expert admite? O que aprendeu?"
-   - Extrair: ANTI_PATTERN com `consequence` real
-
-4. **Framework Forcado:** "Se o expert NAO pudesse usar seu framework principal, o que faria?"
-   - Extrair: PRINCIPLE (revela hierarquia de valores)
-
-5. **Pergunta que o expert NAO respondeu:** "O que o entrevistador perguntou que o expert desviou ou simplificou?"
-   - Extrair: gap documentado ou ANTI_PATTERN implicito
-
-**Regra:** Todas as respostas devem ter `source_ref` com timestamp. Se o expert nao disse explicitamente, marcar `inferred: true`.
-
-**Output:** KFs adicionais com `source_lens: "deconstruction"` e `notes: "[extraido via desconstrucao]"`.
-
-### Step 3.7: Passe 4 — Implicito (L7)
-
-Meta-analise sobre os KFs ja extraidos nos passes 1-3:
-
-**L7 — Implicit & Tacit:**
-- Que premissas o expert assume sem declarar?
-- Que heuristicas SE/ENTAO existem nas entrelinhas mas nao foram formalizadas?
-- Que decisoes foram feitas por omissao (topicos ignorados, alternativas nao discutidas)?
-- Que contradicoes sutis existem entre diferentes partes do conteudo?
-- Extrair: HEURISTIC, PRINCIPLE, ANTI_PATTERN
-- Marcar todos com nota `[extraido de implicito]`, confidence max 0.7
-
-**Regra critica:** KFs implicitos sao hipoteses ate o playback. O usuario confirma ou descarta na Fase 3.
-
-Resultado parcial: ~98% dos KFs.
-
-### Step 4: Classificacao Pareto ao Cubo
-
-Apos extrair todos os KFs (passes 1-4), classificar cada um numa zona Pareto:
-
-**Criterios de classificacao (ver `kf-classification.yaml` secao `pareto_zone`):**
-
-| Zona | % esperado | Criterio rapido |
-|------|-----------|-----------------|
-| Crown Jewel | <5% | Define a identidade da mente. Sem ele, a mente perde sentido |
-| Excellence | ~10-15% | Pilar operacional. Framework completo ou heuristica de alta aplicacao |
-| Impact | ~20-30% | Util e aplicavel, mas nao unico |
-| Filler | ~50-60% | Generico ou de suporte. Avaliar se vale incluir |
-
-**Adicionar campo `pareto_zone` em cada KF.**
-
-**Regra:** Se >10% dos KFs estao como Crown Jewel, o miner esta sendo generoso demais. Revisar.
-
-### Step 5: Domain Mapping
-
-Organizar todos os KFs extraidos por DOMINIO (nao por fonte):
-
-**Modo sintetica:**
-- Agrupar KFs de diferentes experts pelo mesmo dominio
-- Identificar convergencias (2+ experts concordam)
-- Identificar tensoes (experts discordam)
-
-**Modo consultor:**
-- Agrupar KFs por subtopico dentro da metodologia
-- Avaliar profundidade relativa de cada subtopico
-
-Gerar `02-analysis/domain-map.yaml`.
-
-### Step 6: Voice Profiling
-
-Para cada expert (sintetica) ou para o assunto (consultor):
-
-- Tom de comunicacao
-- Frases de assinatura (exatas)
-- Vocabulario obrigatorio e proibido
-- Estrutura de entrega preferida
-- Metaforas/analogias frequentes
-
-Em modo sintetica, propor voz fundida:
-- Expert dominante como ancora
-- Blend do vocabulario dos demais
-
-Gerar `02-analysis/voice-profile.yaml`.
-
-### Step 7: Analysis Metrics
-
-Calcular e gerar `02-analysis/analysis-metrics.yaml`:
-
-```yaml
-metrics:
-  total_kfs: N
-  by_type:
-    PRINCIPLE: N
-    FRAMEWORK: N
-    HEURISTIC: N
-    EXAMPLE: N
-    ANTI_PATTERN: N
-    VOCABULARY: N
-    OUTPUT_FORMAT: N
-  by_pareto_zone:
-    crown_jewel: N
-    excellence: N
-    impact: N
-    filler: N
-  total_domains: N
-  average_confidence: 0.X
-  inferred_ratio: 0.X
-  source_ref_coverage: 0.X  # % de KFs com citacao granular
-  convergences: N       # sintetica
-  tensions: N           # sintetica
-  gaps:
-    - "{dominio sem exemplos}"
-    - "{dominio raso}"
-```
-
-### Step 8: Self-Validation (checklist antes do handoff)
-
-Antes de passar pelo QG-MF-002, o miner executa self-validation:
-
-- [ ] **Citacoes granulares:** >=60% dos KFs tem `source_ref` preenchido (localizacao exata)
-- [ ] **Voice profile:** >=5 signature phrases EXATAS verificaveis na fonte
-- [ ] **Pareto classificado:** Todos os KFs tem `pareto_zone` atribuido
-- [ ] **Crown Jewels identificados:** 1-5% dos KFs marcados como crown_jewel
-- [ ] **Trinity por dominio:** Cada dominio tem pelo menos 1 FRAMEWORK + 1 HEURISTIC + 1 EXAMPLE
-- [ ] **Zero KFs genericos:** Nenhum KF sobreviveu que "qualquer expert diria"
-- [ ] **Tensoes documentadas (sintetica):** Divergencias entre experts registradas com ambos os lados
-- [ ] **Confidence baseline aplicado:** Confidence scores seguem tabela de referencia de `kf-classification.yaml`
-
-**Se qualquer item FAIL:** Corrigir antes de prosseguir. Loop, nao handoff.
-
-**Se 3+ items FAIL:** Reportar ao forge-chief — pode indicar fontes insuficientes.
-
-### Step 9: Quality Gate QG-MF-002
-
-Validar:
-
-**Sintetica:**
-- [x] >= 20 KFs extraidos
-- [x] >= 2 KFs tipo FRAMEWORK
-- [x] >= 3 KFs tipo HEURISTIC
-- [x] >= 3 dominios identificados
-- [x] Confianca media >= 0.7
-- [x] Voice profile completo
-- [x] Ratio inferred < 0.4
-
-**Consultor:**
-- [x] >= 15 KFs extraidos
-- [x] >= 2 KFs tipo FRAMEWORK
-- [x] >= 3 KFs tipo HEURISTIC
-- [x] >= 3 subtopicos identificados
-- [x] Confianca media >= 0.7
-- [x] Voice profile completo
-
-**Veto:** < 10 KFs, ou 0 FRAMEWORKs, ou > 40% inferred.
-
-### Step 10: Salvar KFs
-
-Gerar `02-analysis/knowledge-facets.yaml` com todos os KFs estruturados.
-
-### Step 11: Atualizar State e Handoff
-
-Atualizar `.state.json`:
-```json
-{
-  "phase_status": { "phase_2": "completed" },
-  "current_phase": 3,
-  "total_kfs": N,
-  "domains_identified": N,
-  "quality_gates_passed": ["QG-MF-001", "QG-MF-002"]
-}
-```
-
-Fazer handoff de volta para @forge-chief com task `playback-validate`.
-
-## Formato de Output
-
-- `02-analysis/knowledge-facets.yaml`
-- `02-analysis/domain-map.yaml`
-- `02-analysis/voice-profile.yaml`
-- `02-analysis/analysis-metrics.yaml`
-
-## Error Handling
-
-| Cenario | Acao |
-|---------|------|
-| Fonte rasa (poucos KFs) | Registrar gap, continuar |
-| Tipo de KF ambiguo | Preferir tipo mais restritivo |
-| Experts contradizem | Registrar como tensao, nao resolver |
-| QG-MF-002 falha | Reportar ao chief com gaps especificos |
-
-## Completion Criteria
-
-- Todos os 4 arquivos de output gerados
-- QG-MF-002 passou
-- State atualizado
-- Handoff executado

package/agents/mind-forge/tasks/forge-mind.md

@@ -1,199 +0,0 @@
-# Task: forge-mind
-
-## Objetivo
-
-Transformar o mapa de conhecimento validado em uma mente operacional completa: agent.md, KB, tasks, config.yaml e skill.md.
-
-## Trigger
-
-- Handoff automatico da Fase 3 (playback-validate)
-
-## Pre-condicoes
-
-- Fase 3 completa (QG-MF-003 passed — usuario validou)
-- knowledge-facets.yaml, domain-map.yaml, voice-profile.yaml atualizados
-
-## Agente Executor
-
-@mind-smith
-
-## Referencia Obrigatoria
-
-- `agents/mind-forge/templates/agent-tmpl.md` — template do agent
-- `agents/mind-forge/templates/kb-tmpl.md` — template da KB
-- `agents/mind-forge/templates/config-tmpl.yaml` — template do config
-- `agents/mind-forge/data/forge-kb.md` — referencia de qualidade
-- o primeiro consultor/mente bem-feita do sistema — usar como padrao-ouro
-- a KB mais completa disponivel no sistema — usar como referencia
-
-## Passos
-
-### Step 1: Gerar KB
-
-Seguir o padrao de referencia. A KB e o coracao da mente.
-
-**Estrutura obrigatoria:**
-
-1. **Visao Geral** — tabela de experts (sintetica) ou overview da metodologia (consultor)
-2. **Principios Universais** — convergencias ou fundamentos
-3-N. **Dominios** — 1 capitulo por dominio, cada um com:
-   - Frameworks (nome + passos)
-   - Heuristicas (formato SE/ENTAO)
-   - Anti-padroes (com consequencia)
-N-2. **Caixa de Ferramentas** — tabela situacao → ferramenta/acao
-N-1. **Heuristicas Mestras** — top 15-20 em formato SE/ENTAO
-N. **Output Examples** — pelo menos 1 por modo principal
-
-**Regras criticas:**
-- Organizar por DOMINIO, nunca por fonte/expert
-- Cada dominio deve ter mix de tipos
-- Heuristicas em formato SE/ENTAO (nao "e importante fazer X")
-- Output examples devem ser completos (input → output)
-- Minimo 300 linhas
-- **Priorizar por Pareto Zone:** Crown Jewels devem ter posicao de destaque (Principios Universais, Heuristicas Mestras). KFs Excellence detalhados com exemplos. KFs Impact inclusos em formato padrao. KFs Filler avaliar se vale incluir — na duvida, descartar
-- **Citacoes verificaveis:** Manter `source_ref` granular nos KFs mais importantes (Crown Jewel + Excellence) para que o usuario possa voltar na fonte se quiser
-
-**Output:** `04-forged/data/{mind-slug}-kb.md`
-
-### Step 2: Definir Modos Operacionais
-
-Analisar os KFs e propor 2-4 modos:
-
-**Sintetica (default):**
-- Juiz/Diagnostico — avaliar algo existente
-- Arquiteto/Criacao — criar algo novo
-- Otimizador/Melhoria — melhorar algo existente
-- Consultor/Q&A — perguntas genericas
-
-**Consultor (default):**
-- Professor/Ensino — explicar a metodologia
-- Aplicador/Execucao — aplicar ao caso do usuario
-- Auditor/Avaliacao — avaliar contra a metodologia
-- Consultor/Q&A — perguntas genericas
-
-Adaptar modos conforme os KFs justificam. Nem toda mente precisa de 4 modos.
-
-### Step 3: Gerar agent.md
-
-Usando o template e os dados da analise, gerar agent completo:
-
-- **IDENTIDADE:** proposito, dominio, voice DNA, frases-chave
-- **MODOS DE OPERACAO:** cada modo com trigger, protocolo, formato de output
-- **PRINCIPIOS INEGOCIAVEIS:** top 5-10 principios dos KFs
-- **IMMUNE SYSTEM:** >= 3 triggers de anti-padroes + respostas automaticas
-- **BASE COGNITIVA:** referencia a KB
-- **STRICT RULES:** >= 5 NUNCAs + >= 5 SEMPREs
-- **GREETING:** texto de ativacao
-- **COMMAND ROUTER:** comandos + mapeamento de linguagem natural
-
-**Voice Fusion (sintetica):**
-- Expert dominante como ancora (60% do tom)
-- Vocabulario dos demais incorporado naturalmente
-- Frases-chave proprias da mente fundida
-- Vocabulario proibido = uniao dos "never_use"
-
-**Output:** `04-forged/agents/{mind-slug}.md`
-
-### Step 4: Gerar Tasks
-
-**Task obrigatoria:** `start.md`
-```markdown
-# Task: start
-Ler e adotar persona de agents/{mind-slug}.md.
-Carregar KB de data/{mind-slug}-kb.md com prioridade ALTA.
-Exibir greeting. Aguardar comando do usuario.
-```
-
-**1 task por modo operacional:** cada task define:
-- Objetivo
-- Trigger (comando + linguagem natural)
-- Protocolo (passos numerados)
-- Formato de output rigido
-- Error handling
-- Completion criteria
-
-**Output:** `04-forged/tasks/start.md`, `04-forged/tasks/{modo}.md`
-
-### Step 5: Gerar config.yaml e skill.md
-
-**config.yaml** seguindo template com:
-- name, slash_prefix, version, description
-- type: single-mind
-- Lista de agents, tasks, knowledge_base
-
-**skill.md** como shim de ativacao:
-```markdown
-# {mind-slug}
-{Descricao curta.}
-CRITICAL: First, read and adopt the persona defined in `agents/{mind-slug}/agents/{mind-slug}.md`.
-Then, read and execute the task defined in `agents/{mind-slug}/tasks/start.md`.
-Follow ALL instructions exactly as written.
-```
-
-**Output:** `04-forged/config.yaml`, `04-forged/skill.md`
-
-### Step 6: Self-Check
-
-Antes de entregar, o Smith verifica:
-
-- [ ] KB organizada por dominio (nao por fonte)
-- [ ] KB >= 300 linhas
-- [ ] >= 2 frameworks completos na KB
-- [ ] >= 10 heuristicas SE/ENTAO na KB
-- [ ] Output examples presentes (>= 1 por modo principal)
-- [ ] Agent tem immune system com >= 3 triggers
-- [ ] Agent tem NUNCA (5+) + SEMPRE (5+)
-- [ ] Agent tem greeting
-- [ ] Agent tem command router
-- [ ] config.yaml valido
-- [ ] Todas as tasks tem os 8 campos
-
-Se falhar em qualquer item: corrigir e re-verificar (max 3 tentativas).
-
-### Step 7: Quality Gate QG-MF-004
-
-Validar checklist `checklists/mind-quality.md` completo.
-
-**Veto:** Agent incompleto ou KB < 100 linhas.
-
-### Step 8: Atualizar State e Handoff
-
-```json
-{
-  "phase_status": { "phase_4": "completed" },
-  "current_phase": 5,
-  "quality_gates_passed": ["QG-MF-001", "QG-MF-002", "QG-MF-003", "QG-MF-004"]
-}
-```
-
-Handoff de volta para @forge-chief com task `validate-mind`.
-
-## Formato de Output
-
-```
-04-forged/
-  config.yaml
-  skill.md
-  agents/{mind-slug}.md
-  data/{mind-slug}-kb.md
-  tasks/start.md
-  tasks/{modo-1}.md
-  tasks/{modo-2}.md
-  ...
-```
-
-## Error Handling
-
-| Cenario | Acao |
-|---------|------|
-| KFs insuficientes pra KB rica | Reportar ao chief, indicar gaps |
-| Nao consegue definir modos | Usar modos default + flag pro chief |
-| KB abaixo de 300 linhas | Enriquecer dominios com mais detalhe |
-| Self-check falha 3x | Escalar pro chief com diagnostico |
-
-## Completion Criteria
-
-- Todos os artefatos gerados em 04-forged/
-- Self-check passou
-- QG-MF-004 passou
-- Handoff executado

package/agents/mind-forge/tasks/ingest-sources.md

@@ -1,130 +0,0 @@
-# Task: ingest-sources
-
-## Objetivo
-
-Ler todas as fontes de conhecimento, criar inventario estruturado e validar que sao suficientes.
-
-## Trigger
-
-- Handoff automatico da Fase 0 (start)
-- `*resume` quando pipeline pausado na Fase 1
-
-## Pre-condicoes
-
-- Fase 0 (setup) completa
-- `.state.json` inicializado com lista de fontes
-
-## Agente Executor
-
-@knowledge-miner
-
-## Passos
-
-### Step 1: Ler Fontes
-
-Para cada fonte no `.state.json`:
-
-1. Ler o documento completo
-2. Verificar que e legivel e nao esta vazio
-3. Contar palavras
-4. Identificar estrutura (secoes, headings, listas, tabelas)
-
-### Step 2: Classificar Fontes
-
-Para cada fonte, identificar:
-
-- **Tipo:** kb (knowledge base existente), book (livro/resumo), transcript (transcricao), course (curso/aula), article (artigo/post)
-- **Expert:** Quem e o expert/autor (modo sintetica) ou qual topico cobre (modo consultor)
-- **Qualidade:** estimativa de profundidade (shallow/medium/deep)
-- **Secoes relevantes:** listar as secoes com mais conteudo extraivel
-
-### Step 2.5: Source Tier Classification
-
-Classificar cada fonte em tier com peso de confianca:
-
-| Tier | Peso | Criterio | Exemplos |
-|------|------|----------|----------|
-| **OURO** (1.0) | 0.90-1.00 | Conteudo original do expert, profundo, editado | Livro proprio, KB curada, curso completo, artigo tecnico detalhado |
-| **PRATA** (0.7) | 0.60-0.89 | Conteudo do expert mas superficial ou parcial | Transcript de palestra, podcast, posts longos, entrevistas |
-| **BRONZE** (0.4) | 0.30-0.59 | Conteudo secundario ou resumido | Resumo de terceiros, notas rapidas, conteudo antigo (5+ anos), artigos curtos |
-
-**Regra:** O peso do tier propaga para o `confidence` dos KFs extraidos daquela fonte:
-`kf.confidence = base_confidence * source_tier_weight`
-
-**Threshold de viabilidade:**
-- ouro_ratio >= 60%: GREEN — proceder
-- ouro_ratio 40-60%: YELLOW — alertar usuario que mente pode ser rasa
-- ouro_ratio < 40%: RED — alertar fortemente, recomendar fontes melhores
-
-### Step 3: Gerar Source Manifest
-
-Criar `minds/{slug}/01-ingestion/source-manifest.yaml`:
-
-```yaml
-mind_slug: "{slug}"
-mode: "synthetic|consultant"
-ingestion_date: "{timestamp}"
-total_sources: N
-total_words: N
-ouro_ratio: 0.X          # % de palavras vindas de fontes OURO
-
-sources:
-  - id: SRC-001
-    path: "{path}"
-    type: "kb|book|transcript|course|article"
-    tier: "ouro|prata|bronze"
-    tier_weight: 0.X
-    expert: "{nome}"       # sintetica
-    topic: "{topico}"      # consultor
-    word_count: N
-    sections: N
-    quality: "shallow|medium|deep"
-    key_sections:
-      - "{secao 1}"
-      - "{secao 2}"
-    notes: "{observacoes}"
-```
-
-### Step 4: Quality Gate QG-MF-001
-
-Validar:
-
-- [x] Todas as fontes legiveis e parseadas
-- [x] Total de palavras >= 500
-- [x] Cada fonte tem tipo e expert/topico identificado
-- [x] Nenhuma fonte vazia ou corrompida
-
-**Veto conditions:**
-- Qualquer fonte ilegivel → reportar, pedir alternativa
-- Total < 200 palavras → bloquear, pedir mais fontes
-
-### Step 5: Atualizar State
-
-```json
-{
-  "phase_status": { "phase_1": "completed" },
-  "current_phase": 2
-}
-```
-
-### Step 6: Continuar para Analise
-
-Prosseguir diretamente para task `analyze-knowledge` (mesmo agente).
-
-## Formato de Output
-
-`01-ingestion/source-manifest.yaml` com inventario completo.
-
-## Error Handling
-
-| Cenario | Acao |
-|---------|------|
-| Arquivo nao encontrado | Reportar path, pedir correcao ao chief |
-| Arquivo vazio | Registrar como invalido, continuar com demais |
-| Todas as fontes rasas | Alertar: "Fontes com pouco conteudo — mente resultante pode ser superficial" |
-
-## Completion Criteria
-
-- source-manifest.yaml gerado com todas as fontes
-- QG-MF-001 passou
-- State atualizado