auroq-os 2.2.3 → 2.3.1

package/agents/worker-forge/knowledge/autonomous-agent-architectures.md

@@ -1,275 +0,0 @@
-# Arquiteturas de Agentes Autonomos para Digital Workers
-
-> Sistemas e papers mais relevantes para construir "digital workers" — agentes de IA que executam tarefas, documentam seu trabalho e melhoram com o tempo.
-
----
-
-## 1. Voyager (NVIDIA, 2023)
-
-**O que e:** Primeiro agente "lifelong learning" baseado em LLM, no Minecraft. Wang, Xie et al.
-
-### Arquitetura — 3 Componentes
-
-1. **Automatic Curriculum** — Gera objetivos de exploracao em ordem crescente de dificuldade. O agente PROPOE o que aprender.
-2. **Skill Library** — Biblioteca de skills executaveis que cresce com uso. Indexada por embeddings. Query top-5 por relevancia.
-3. **Iterative Prompting** — Gera codigo → executa → feedback → refina. Self-verification antes de salvar.
-
-### Inovacao-Chave
-
-**Composicao de skills.** Skills complexas reusam skills simples. Efeito composto: capacidades crescem exponencialmente. Voyager obteve 3.3x mais itens, 2.3x mais distancia, 15.3x mais rapido que SOTA.
-
-### Mapeamento pro Worker
-
-| Voyager | Worker |
-|---------|--------|
-| Skill Library | Playbook (SOPs que crescem) |
-| Automatic Curriculum | Mode 2 (Research) — identifica gaps |
-| Composicao de skills | SOPs que referenciam outras SOPs |
-| Self-verification | Quality gate pos-execucao |
-
----
-
-## 2. MetaAgent (2025)
-
-**O que e:** Agente auto-evolutivo via "Tool Meta-Learning". Comeca com minimo, evolui por tarefas. Qi et al.
-
-### Arquitetura
-
-Inicializado com 2 capacidades: **Autonomous Reasoning** + **Adaptive Help-Seeking** (gera help requests em linguagem natural).
-
-```
-Tarefa → Raciocinio → Gap detectado → Help request →
-→ Ferramenta responde → Meta-reflexao → Atualiza KB → Proxima tarefa
-```
-
-### Inovacao-Chave
-
-**Meta Tool Learning** — nao so USA ferramentas, REFLETE sobre como usou. Constroi tools internas e KB persistente sem fine-tuning.
-
-### Mapeamento pro Worker
-
-| MetaAgent | Worker |
-|-----------|--------|
-| Comeca pelado | Worker comeca com Foundation + 0 SOPs |
-| Gap detection | Identifica lacuna, entra em Research |
-| Help-seeking | Mode 2 — busca info quando nao sabe |
-| Meta-reflexao | PDSA Study → gera nova SOP |
-
----
-
-## 3. Strands SOPs (AWS, 2025)
-
-**O que e:** Formato padronizado de markdown pra workflows de agentes. Strands Agents SDK.
-
-### 6 Componentes
-
-1. **Goal** — Resultado unico que MUST ser alcancado
-2. **Inputs/Parameters** — O que MAY ler ou MUST aceitar
-3. **Constraints** — Regras MUST/SHOULD/MAY
-4. **Procedure** — Passos ordenados com pontos de decisao
-5. **Validation** — Checks pre-output
-6. **Output Spec** — Formato exato
-
-### Inovacao-Chave
-
-**RFC 2119 como linguagem de controle.** MUST (obrigatorio), SHOULD (recomendado), MAY (opcional). Meio-termo: mais flexivel que codigo, mais confiavel que prompt puro.
-
-### Mapeamento pro Worker
-
-Valida diretamente o approach Auroq de tasks em markdown. A industria convergiu pro mesmo padrao.
-
----
-
-## 4. Letta / MemGPT (2024-2025)
-
-**O que e:** Framework pra agentes com estado persistente e memoria auto-gerenciada. Packer et al.
-
-### 3 Tiers de Memoria
-
-| Tier | Analogia | Caracteristica |
-|------|----------|----------------|
-| **Core Memory** | RAM | No contexto. Agente le e ESCREVE. Info essencial, limitada. |
-| **Archival Memory** | Disco | Vector DB externo. Capacidade infinita. Search/insert via tools. |
-| **Recall Memory** | Logs | Historico de conversas. Pesquisavel. |
-
-### Inovacao-Chave
-
-**Self-editing memory.** O agente DECIDE o que lembrar, esquecer, mover entre tiers. Nao e RAG passivo — e gerenciamento ativo.
-
-### Mapeamento pro Worker
-
-| MemGPT | Worker |
-|--------|--------|
-| Core Memory | Foundation KB — identidade, regras. Sempre no contexto. |
-| Archival Memory | Playbook — SOPs acumuladas, searchable. |
-| Recall Memory | Mission Log — historico de execucoes. |
-| Self-editing | Worker que atualiza proprio Playbook. |
-
----
-
-## 5. A-Mem (NeurIPS 2025)
-
-**O que e:** Memoria agente usando Zettelkasten. Xu, Liang et al.
-
-### Principios
-
-- Cada memoria e nota atomica (descricao + keywords + tags)
-- Links bidirecionais com notas relacionadas
-- Quando nota nova entra, pode ALTERAR notas antigas
-- Estrutura emerge, nao e imposta
-
-### Inovacao-Chave
-
-**Memoria agente (nao passiva).** Memorias se auto-organizam, criam conexoes, evoluem. Performance superior vs SOTA em 6 modelos.
-
-### Mapeamento pro Worker
-
-SOPs como notas atomicas interconectadas. Cada nova execucao pode atualizar SOPs existentes. Estrutura do Playbook emerge organicamente.
-
----
-
-## 6. Claude Cowork (Anthropic, 2026)
-
-**O que e:** Plataforma que transforma Claude em "colega digital persistente". CUA (Computer-Using Agent).
-
-### Modos de Execucao
-
-| Modo | Descricao |
-|------|-----------|
-| **On-demand** | Voce pede, ele faz |
-| **Scheduled** | Recorrente (diario, semanal) |
-| **Trigger-based** | Quando condicao e atendida |
-
-### Calibracao de Autonomia
-
-- Mostra plano antes de executar
-- Escala pro humano quando incerto
-- Dashboard de controle granular
-
-### Inovacao-Chave
-
-**O modelo mental "employee", nao "tool".** Recebe missoes outcome-oriented, executa autonomamente dentro de limites, reporta com transparencia, pede ajuda quando nao sabe.
-
-### Limitacao Critica
-
-**Sem memoria persistente entre sessoes** — exatamente o gap que Workers com KB resolvem.
-
----
-
-## 7. ReAct (Yao et al., 2023)
-
-**O que e:** Padrao fundamental que combina Reasoning + Acting intercalado. Base de todo agente moderno. ICLR 2023.
-
-### O Loop
-
-```
-Thought: "Preciso descobrir X..."
-Action: search("X")
-Observation: "Resultado: ..."
-Thought: "Agora preciso Y..."
-Action: lookup("Y")
-...
-```
-
-### Inovacao-Chave
-
-**Sinergia bidirecional:**
-- **Reason to Act** — raciocinio cria planos de acao
-- **Act to Reason** — acoes trazem info nova pro raciocinio
-
-### Mapeamento pro Worker
-
-Todo Worker opera em ReAct: pensa → executa → observa → ajusta → proximo passo. O "Thought" persistido no Mission Log.
-
----
-
-## 8. Reflexion (Shinn et al., 2023)
-
-**O que e:** "Verbal reinforcement learning" — agente reflete em linguagem natural sobre falhas e melhora. NeurIPS 2023.
-
-### 3 Componentes
-
-1. **Actor** — Executa a tarefa
-2. **Evaluator** — Avalia resultado (passou/falhou)
-3. **Self-Reflection** — Gera reflexao verbal sobre o que deu errado
-
-### O Loop
-
-```
-Tentativa 1: Executa → Falhou
-→ Reflexao: "Tentei X mas falhou porque Y. Proximo: Z."
-→ Salva na Episodic Memory
-
-Tentativa 2: Executa (com reflexao no contexto) → Passou
-```
-
-### Inovacao-Chave
-
-**"Gradiente semantico"** — aprendizado via TEXTO, nao numeros. Sem fine-tuning. Resultado: 91% pass@1 no HumanEval (vs 80% do GPT-4).
-
-### Mapeamento pro Worker
-
-PDSA e Reflexion sao a mesma coisa:
-- Plan → Do → Study → Act = Plan → Execute → Reflect → Improve
-- Reflexoes persistidas no Mission Log
-- Evaluator = quality gate separado do executor
-
----
-
-## Sintese: 7 Principios de Design
-
-Da sintese das 8 arquiteturas:
-
-1. **Think Before Act (ReAct)** — Nunca executar sem raciocinar. Documentar raciocinio.
-2. **Grow by Doing (Voyager + MetaAgent)** — Comecar minimo, construir capacidade organicamente.
-3. **Remember in Tiers (MemGPT)** — Memoria em 3 camadas: core, archival, recall.
-4. **Connect Knowledge (A-Mem)** — SOPs nao sao ilhas — sao notas interconectadas.
-5. **Define with Precision (Strands)** — Workflows em linguagem natural com niveis de obrigatoriedade.
-6. **Reflect to Improve (Reflexion)** — Pos-execucao: avaliar, refletir, documentar, melhorar.
-7. **Calibrate Autonomy (Cowork)** — Niveis de autonomia por tarefa. Escalar quando incerto.
-
-### Mapa de Influencia
-
-```
-┌─────────────────────────────────────────────────┐
-│           DIGITAL WORKER COMPLETO               │
-├─────────────────────────────────────────────────┤
-│  EXECUTION LOOP                                 │
-│  ├── ReAct: Think → Act → Observe               │
-│  ├── Reflexion: Reflect → Improve                │
-│  └── MetaAgent: Gap → Seek → Learn              │
-│                                                 │
-│  KNOWLEDGE                                      │
-│  ├── MemGPT: 3 tiers (Core/Archival/Recall)     │
-│  ├── A-Mem: Notas interconectadas               │
-│  └── Voyager: Skill library composicional        │
-│                                                 │
-│  WORKFLOW                                       │
-│  ├── Strands: Markdown + RFC 2119               │
-│  └── Voyager: Automatic curriculum              │
-│                                                 │
-│  AUTONOMY                                       │
-│  ├── Cowork: Employee mental model               │
-│  └── Cowork: Calibracao + escalacao              │
-└─────────────────────────────────────────────────┘
-```
-
----
-
-## Fontes
-
-### Papers
-- [Voyager](https://arxiv.org/abs/2305.16291) — Wang et al., 2023
-- [MetaAgent](https://arxiv.org/abs/2508.00271) — Qi et al., 2025
-- [MemGPT](https://arxiv.org/abs/2310.08560) — Packer et al., 2023
-- [A-MEM](https://arxiv.org/abs/2502.12110) — Xu, Liang et al., NeurIPS 2025
-- [ReAct](https://arxiv.org/abs/2210.03629) — Yao et al., ICLR 2023
-- [Reflexion](https://arxiv.org/abs/2303.11366) — Shinn et al., NeurIPS 2023
-
-### Codigo e Docs
-- [Voyager GitHub](https://github.com/MineDojo/Voyager)
-- [Strands SOPs](https://github.com/strands-agents/agent-sop)
-- [Letta GitHub](https://github.com/letta-ai/letta)
-- [A-Mem GitHub](https://github.com/agiresearch/A-mem)
-- [Reflexion GitHub](https://github.com/noahshinn/reflexion)
-- [Claude Cowork](https://support.claude.com/en/articles/13345190)

package/agents/worker-forge/knowledge/delegation-competency-performance.md

@@ -1,256 +0,0 @@
-# Delegacao, Competencia e Performance para Digital Workers
-
-> Frameworks fundamentais para construir, calibrar e medir trabalhadores digitais (AI employees).
-> Cada framework resolve uma dimensao diferente: QUANTO de autonomia dar, QUEM faz o que, QUAL o nivel de competencia, COMO medir execucao, e QUANDO considerar algo "feito".
-
----
-
-## 1. Appelo — 7 Niveis de Delegacao (Management 3.0)
-
-### O Conceito Central
-
-Jurgen Appelo parte de uma premissa simples: delegacao nao e binaria ("faco eu" ou "faz voce"). Existe um espectro de 7 niveis. O insight matador: voce nao delega TAREFAS — voce delega AREAS DE DECISAO.
-
-### Os 7 Niveis
-
-| Nivel | Nome | Quem Decide | Descricao |
-|-------|------|-------------|-----------|
-| 1 | **Tell** | Manager | Eu decido e informo. Sem discussao. |
-| 2 | **Sell** | Manager | Eu decido, mas explico o porque. |
-| 3 | **Consult** | Manager | Peco input antes, mas decisao e minha. |
-| 4 | **Agree** | Consenso | Decidimos juntos. |
-| 5 | **Advise** | Worker | Dou opiniao, mas decisao e dele. |
-| 6 | **Inquire** | Worker | Ele decide e depois me conta. |
-| 7 | **Delegate** | Worker | Ele decide. Eu nem preciso saber. |
-
-### Quando Usar Cada Nivel
-
-- **Tell (1):** Emergencia, compliance, regras inegociaveis
-- **Sell (2):** Decisoes estrategicas onde o worker precisa do PORQUE
-- **Consult (3):** Worker tem info que voce nao tem, mas risco alto
-- **Agree (4):** Impacta ambos igualmente
-- **Advise (5):** Worker competente, voce so da toque
-- **Inquire (6):** Worker competente, voce so quer saber resultado
-- **Delegate (7):** Worker expert. Total autonomia
-
-### O Delegation Board
-
-Matriz visual: eixo vertical = areas de decisao, eixo horizontal = 7 niveis.
-
-| Area de Decisao | Nivel | Significado |
-|----------------|-------|-------------|
-| Criar campanha teste | 6 (Inquire) | Worker cria, me conta depois |
-| Pausar campanha com CPA alto | 7 (Delegate) | Worker decide sozinho |
-| Escalar orcamento >R$1k/dia | 3 (Consult) | Worker sugere, eu decido |
-| Mudar publico-alvo | 4 (Agree) | Decidimos juntos |
-
-### Principios-Chave
-
-- Delegacao nao e permanente — muda conforme confianca e competencia
-- Comece conservador (1-3), va subindo conforme worker prova competencia
-- Nunca delegue TUDO nivel 7 de uma vez. Isso nao e delegacao, e abandono
-- O Board e o mapa de permissoes semanticas do worker
-
----
-
-## 2. RACI Matrix
-
-### O Conceito Central
-
-RACI define QUEM faz o que. Enquanto Appelo responde "quanto de autonomia?", RACI responde "quem esta envolvido e em qual papel?"
-
-| Papel | Significado | Regra |
-|-------|------------|-------|
-| **R** — Responsible | Quem FAZ o trabalho | Pode ter mais de 1 |
-| **A** — Accountable | Quem RESPONDE pelo resultado | SEMPRE 1 so. Nunca mais. |
-| **C** — Consulted | Quem e CONSULTADO antes | Bidirecional |
-| **I** — Informed | Quem e INFORMADO depois | Unidirecional |
-
-### Regra de Ouro
-
-**Um unico A por linha.** Se tem 2 accountable, nenhum e.
-
-### Erros Classicos
-
-- Todo mundo e R → dilucao de responsabilidade
-- Excesso de C → trava decisao
-- A sem autoridade real → papel decorativo
-- Um worker com 80% dos Rs → gargalo
-
-### Aplicacao Multi-Agent
-
-| Atividade | Strategist | Scale-Op | Test-Op | Human |
-|-----------|-----------|----------|---------|-------|
-| Definir estrategia | R, A | I | I | C |
-| Criar campanha teste | C | I | R, A | I |
-| Escalar campanha | C | R, A | I | I |
-| Aprovar orcamento >R$5k | I | R | I | A |
-
----
-
-## 3. Dreyfus — Modelo de Aquisicao de Competencia
-
-### Os 5 Niveis
-
-| Nivel | Decisao | KB necessaria | Appelo |
-|-------|---------|---------------|--------|
-| **Novice** | Nenhuma. Executa script | SOPs rigidos, checklists, zero ambiguidade | Tell/Sell (1-2) |
-| **Adv. Beginner** | Limitada, cenarios conhecidos | SOPs + exemplos + cases | Sell/Consult (2-3) |
-| **Competent** | Situacional, com analise | Principios + criterios + anti-padroes | Consult/Agree (3-4) |
-| **Proficient** | Intuitiva na leitura, deliberada na resposta | Modelos mentais + heuristicas + repertorio | Advise/Inquire (5-6) |
-| **Expert** | Intuitiva e fluida | Principios fundamentais + liberdade | Inquire/Delegate (6-7) |
-
-### A Transicao Critica: Regras → Intuicao
-
-| Aspecto | Novice | Expert |
-|---------|--------|--------|
-| Base de decisao | Regras context-free | Intuicao situacional |
-| Percepcao | Componentes isolados | Padrao holistico |
-| Comprometimento | Desapegado | Profundamente envolvido |
-| Foco | Seguir o processo | Atingir o resultado |
-
-### Principio Central
-
-A PROFUNDIDADE da KB determina o NIVEL MAXIMO de delegacao. Quer dar autonomia (Appelo 6-7)? A KB precisa ser nivel Proficient/Expert. Se a KB so tem SOPs, o worker e Novice — delegue no maximo nivel 3.
-
-A maioria dos workers digitais opera entre Competent e Proficient — essa e a zona-alvo do design.
-
----
-
-## 4. 4DX — As 4 Disciplinas da Execucao (FranklinCovey)
-
-### As 4 Disciplinas
-
-#### Disciplina 1 — WIG (Wildly Important Goal)
-- Maximo 2 WIGs por vez
-- Formato: **"De X para Y ate [data]"**
-- Se tudo e prioridade, nada e prioridade
-
-#### Disciplina 2 — Lead Measures
-| Tipo | O que Mede | Pode Influenciar? |
-|------|-----------|-------------------|
-| **Lag Measure** | Resultado final | Nao — ja era |
-| **Lead Measure** | Acao preditiva | Sim — pode ajustar |
-
-Um bom Lead Measure e **preditivo** (se mudar, o Lag muda) e **influenciavel** (o time pode agir).
-
-#### Disciplina 3 — Scoreboard
-- Simples — entendido em 5 segundos
-- Mostra Lead E Lag juntos
-- Mostra se esta GANHANDO ou PERDENDO
-- Maximo 6 metricas por WIG
-
-#### Disciplina 4 — Cadencia de Accountability
-3 perguntas semanais:
-1. O que me comprometi semana passada?
-2. Como estao os numeros?
-3. O que vou fazer esta semana?
-
-### Exemplo: Worker de Trafego Pago
-
-| Metrica | Tipo | Meta | Status |
-|---------|------|------|--------|
-| CPA medio | Lag | <=R$35 | Ganhando |
-| Novos criativos testados/semana | Lead | >=9 | Perdendo |
-| Campanhas pausadas com CPA >2x | Lead | 100% | Ganhando |
-| ROAS conta escala | Lag | >=3.0 | Perdendo |
-
----
-
-## 5. OKRs — Objectives and Key Results
-
-### Estrutura
-
-**"Eu vou [OBJETIVO] medido por [RESULTADOS-CHAVE]"**
-
-| Componente | Natureza | Exemplo |
-|-----------|----------|---------|
-| **Objective** | Qualitativo, inspiracional | "Dominar o trafego pago no nicho" |
-| **Key Results** | Quantitativo, mensuravel | "CPA medio abaixo de R$30" |
-
-### OKRs vs KPIs
-
-| Dimensao | OKR | KPI |
-|----------|-----|-----|
-| Proposito | DIRECAO (pra onde ir) | SAUDE (como esta agora) |
-| Natureza | Transformacional | Operacional |
-| Ciclo | Trimestral | Continuo |
-| Ambicao | Stretch (60-70% = sucesso) | Realista (100% = esperado) |
-
-**Na pratica:** KPIs monitoram SAUDE operacional. OKRs direcionam EVOLUCAO.
-
----
-
-## 6. Definition of Done (DoD) — Agile/Scrum
-
-### DoD Multi-Nivel
-
-| Nivel | Escopo | Exemplo Worker |
-|-------|--------|----------------|
-| **Task-level** | Item individual | "Anuncio com copy, criativo, CTA, UTM corretos" |
-| **Mission-level** | Conjunto de tasks | "Campanha configurada: 3 conjuntos, 9 criativos, tracking ativo" |
-| **Sprint-level** | Ciclo completo | "Todas campanhas rodando, relatorio gerado, otimizacoes feitas" |
-
-### DoD vs Acceptance Criteria
-
-- **Acceptance Criteria:** Especificos da TAREFA. Mudam a cada missao.
-- **DoD:** Globais e TRANSVERSAIS. Se aplicam a TUDO.
-
-### DoD e Quality Gates
-
-| Conceito | Quando | Proposito |
-|----------|--------|-----------|
-| **Definition of Ready** | ANTES de comecar | "Tenho tudo pra executar?" |
-| **Definition of Done** | DEPOIS de executar | "Completei com qualidade?" |
-| **Quality Gate** | Em CHECKPOINTS | "Posso avancar?" |
-
----
-
-## Mapa de Integracao
-
-```
-                    ESTRATEGIA (Pra Onde?)
-                    ┌─────────────┐
-                    │    OKRs     │ ← Direcao + Ambicao
-                    └──────┬──────┘
-                           │
-                    ┌──────▼──────┐
-                    │    4DX      │ ← Execucao + Foco
-                    │  WIG + Lead │
-                    └──────┬──────┘
-                           │
-              OPERACAO (Quem Faz O Que, Com Quanta Autonomia?)
-         ┌─────────────────┼─────────────────┐
-         │                 │                 │
-   ┌─────▼─────┐   ┌──────▼──────┐   ┌──────▼──────┐
-   │   RACI    │   │   Appelo    │   │  Dreyfus    │
-   │  (Quem)   │   │ (Autonomia) │   │ (Capacidade)│
-   └─────┬─────┘   └──────┬──────┘   └──────┬──────┘
-         │                │                  │
-         └────────────────┼──────────────────┘
-                          │
-                   ┌──────▼──────┐
-                   │    DoD      │ ← Qualidade + Fechamento
-                   └─────────────┘
-```
-
-| Pergunta | Framework | Resposta |
-|----------|-----------|----------|
-| Pra onde estamos indo? | OKRs | Objective + Key Results |
-| No que vamos focar? | 4DX | WIG + Lead Measures |
-| Quem faz o que? | RACI | R, A, C, I por atividade |
-| Quanta autonomia? | Appelo 7 Levels | Nivel 1-7 por area |
-| Qual a capacidade? | Dreyfus | Novice → Expert por skill |
-| Quando esta pronto? | DoD | Checklist multi-nivel |
-
----
-
-## Fontes
-
-- [Appelo — 7 Levels of Delegation](https://medium.com/@jurgenappelo/the-7-levels-of-delegation-672ec2a48103)
-- [Delegation Board — Management 3.0](https://management30.com/practice/delegation-poker/)
-- [RACI Matrix Guide](https://project-management.com/understanding-responsibility-assignment-matrix-raci-matrix/)
-- [Dreyfus Model — Wikipedia](https://en.wikipedia.org/wiki/Dreyfus_model_of_skill_acquisition)
-- [4DX — Perdoo Guide](https://www.perdoo.com/resources/online-guides/4dx)
-- [OKR Definition — WhatMatters.com](https://www.whatmatters.com/faqs/okr-meaning-definition-example)
-- [Definition of Done — Scrum.org](https://www.scrum.org/resources/what-definition-done)