aiox-core 5.0.2 → 5.0.3

package/pro/squads/squad-creator-pro/docs/PEDRO-VALERIO-ARCHITECTURE.md

@@ -0,0 +1,456 @@
+# Pedro Valério Clone - Arquitetura de Operação
+
+**Documento:** Como o clone do Pedro Valério funciona internamente
+**Última atualização:** 2026-02-06
+**Clone size:** 1832 linhas | ~20k tokens
+
+---
+
+## 1. Visão Geral
+
+O Pedro Valério é um **clone de mente** (mind clone) que opera como agente especializado em:
+- Auditoria de processos e workflows
+- Design de veto conditions
+- Validação de compliance com IDS (Incremental Development System)
+- Identificação de automações faltando
+
+```
+┌─────────────────────────────────────────────────────────────┐
+│                    PEDRO VALÉRIO                            │
+│                 Process Absolutist                          │
+├─────────────────────────────────────────────────────────────┤
+│  Filosofia: "Se executor CONSEGUE fazer errado,            │
+│              o processo está errado"                        │
+├─────────────────────────────────────────────────────────────┤
+│  Tier: 0 (Diagnostic/Audit specialist)                     │
+│  Arquivo: squads/squad-creator-pro/agents/pedro-valerio.md     │
+└─────────────────────────────────────────────────────────────┘
+```
+
+---
+
+## 2. Mecanismo de Carregamento
+
+### 2.1 Como é Ativado
+
+```bash
+# Opção 1: Via skill (user invoca)
+@pedro-valerio
+
+# Opção 2: Via Task tool (subagent)
+Task(
+  subagent_type="pedro-valerio",
+  prompt="Auditar workflow X"
+)
+
+# Opção 3: Via CLI diretamente
+claude -p \
+  --append-system-prompt "$(cat pedro-valerio.md)" \
+  "Sua tarefa aqui"
+```
+
+### 2.2 O Que Acontece na Ativação
+
+```
+┌─────────────────────────────────────────────────────────────┐
+│  SYSTEM PROMPT (prioridade máxima)                          │
+│  ├── CLAUDE.md (Constitution, framework rules)              │
+│  ├── .claude/rules/*.md (MCP usage, patterns)               │
+│  └── --append-system-prompt → pedro-valerio.md (SOMADO)    │
+│      └── 1832 linhas carregadas UMA VEZ                    │
+├─────────────────────────────────────────────────────────────┤
+│  USER MESSAGE (a task a executar)                           │
+│  └── "*audit wf-clone-mind.yaml"                           │
+└─────────────────────────────────────────────────────────────┘
+```
+
+**Importante:** O arquivo INTEIRO é carregado no system prompt, mas o LLM não "processa" tudo a cada resposta - ele usa como **biblioteca de referência**.
+
+---
+
+## 3. Estrutura do Clone
+
+### 3.1 Seções Principais
+
+| Seção | Propósito | Linhas Aprox |
+|-------|-----------|--------------|
+| `activation-instructions` | Como iniciar o agente | ~20 |
+| `agent` | Metadata (name, tier, whenToUse) | ~30 |
+| `persona` | Identidade e core_beliefs | ~50 |
+| `thinking_dna` | Frameworks de pensamento | ~400 |
+| `meta_axiomas` | 10 dimensões de avaliação | ~200 |
+| `heuristics` | Regras de decisão (PV001-IDS005) | ~150 |
+| `voice_dna` | Vocabulário, tom, modos | ~300 |
+| `behavioral_modes` | 5 modos de comportamento | ~80 |
+| `authenticity_markers` | 12 checklist de validação | ~100 |
+| `response_algorithm` | Pseudocódigo de resposta | ~80 |
+| `output_examples` | 9 exemplos de output | ~350 |
+| `commands` | 21 comandos disponíveis | ~50 |
+
+### 3.2 Hierarquia de Ativação
+
+```yaml
+SEMPRE ATIVO (guia toda resposta):
+  - persona.core_beliefs
+  - voice_dna.anchor_words
+  - voice_dna.fixed_vocabulary
+  - heuristics.veto[*]
+
+ATIVADO POR CONTEXTO:
+  - meta_axiomas         # quando *axioma-assessment
+  - workflow_validation  # quando *modernization-score
+  - behavioral_modes     # detectado automaticamente
+  - output_examples      # pattern matching interno
+
+REFERÊNCIA PASSIVA:
+  - AIOS Knowledge Sources
+  - handoff_to
+  - synergies
+```
+
+---
+
+## 4. Os 5 Modos Comportamentais
+
+O clone alterna entre 5 modos baseado no contexto:
+
+```
+┌──────────────────┬─────────────────────┬─────────────────────────┐
+│ MODO             │ TRIGGER             │ OUTPUT                  │
+├──────────────────┼─────────────────────┼─────────────────────────┤
+│ Arquiteto        │ Sistema ineficiente │ Blueprint + mandamentos │
+│ Professor        │ Necessidade ensinar │ Demo + vídeo + checklist│
+│ General          │ Comunicar missão    │ Manifesto épico         │
+│ Executor         │ Mentira detectada   │ Desligamento imediato   │
+│ Eremita          │ Sobrecarga sensorial│ Pausa programada        │
+└──────────────────┴─────────────────────┴─────────────────────────┘
+```
+
+### 4.1 Detecção Automática de Modo
+
+```python
+def detect_mode(context, message):
+    if contains_lie_or_masking(message):
+        return "Executor"  # Ação imediata
+
+    if is_teaching_context(context):
+        return "Professor"
+
+    if is_mission_alignment(context):
+        return "General"
+
+    if is_sensory_overload(context):
+        return "Eremita"
+
+    return "Arquiteto"  # Default
+```
+
+---
+
+## 5. Fluxos de Operação
+
+### 5.1 Fluxo: Audit de Workflow
+
+```
+User: "*audit wf-clone-mind.yaml"
+         │
+         ▼
+┌─────────────────────────────────────────────┐
+│ 1. Ativa MODO ARQUITETO                     │
+│ 2. Lê o arquivo do workflow                 │
+│ 3. Consulta diagnostic_framework.questions: │
+│    - "Se executor não ler instruções?"      │
+│    - "Se tentar pular um passo?"            │
+│    - "Sistema detecta erro automaticamente?"│
+│ 4. Aplica heuristics (PV001-PV005)          │
+│ 5. Identifica red_flags e green_flags       │
+│ 6. Gera output no formato de output_examples│
+│ 7. Usa voice_dna para tom ("Tá ligado?")    │
+└─────────────────────────────────────────────┘
+         │
+         ▼
+Output: Audit com veto conditions identificadas
+```
+
+### 5.2 Fluxo: Resposta a Dúvida Técnica
+
+```
+User: "Como configuro automação de status?"
+         │
+         ▼
+┌─────────────────────────────────────────────┐
+│ 1. Ativa MODO PROFESSOR                     │
+│ 2. Aplica response_algorithm:               │
+│    - response = "Então, " + explicação      │
+│    - response += ", tá?"                    │
+│    - if needs_example:                      │
+│        response += " Por exemplo, " + demo  │
+│    - response += " Entendeu?"               │
+│ 3. Substitui vocabulário:                   │
+│    - "configurar" → "setar"                 │
+│    - "executar" → "rodar"                   │
+│ 4. Valida authenticity_markers (min 8/12)   │
+│ 5. Finaliza com "Show!" ou "Tá ligado?"     │
+└─────────────────────────────────────────────┘
+         │
+         ▼
+Output: Explicação didática com demonstração
+```
+
+### 5.3 Fluxo: *axioma-assessment
+
+```
+User: "*axioma-assessment processo-de-onboarding"
+         │
+         ▼
+┌─────────────────────────────────────────────┐
+│ 1. Ativa seção meta_axiomas                 │
+│ 2. Avalia processo em 10 dimensões:         │
+│    [1] Verdade (weight=1.0, veto_power=true)│
+│    [2] Coerência (weight=0.9)               │
+│    [3] Alinhamento Estratégico (weight=0.9) │
+│    [4] Excelência Operacional (weight=0.8)  │
+│    [5] Capacidade de Inovação (weight=0.7)  │
+│    [6] Gestão de Riscos (weight=0.8)        │
+│    [7] Otimização de Recursos (weight=0.8)  │
+│    [8] Valor para Stakeholders (weight=0.7) │
+│    [9] Sustentabilidade (weight=0.7)        │
+│    [10] Adaptabilidade (weight=0.6)         │
+│ 3. Calcula overall_score (média ponderada)  │
+│ 4. Determina status: PASS | FAIL | REVIEW   │
+└─────────────────────────────────────────────┘
+         │
+         ▼
+Output: Assessment YAML com scores e recomendações
+```
+
+### 5.4 Fluxo: Immune System (Detecção de Violação)
+
+```
+User: "O processo permite flexibilidade..."
+         │
+         ▼
+┌─────────────────────────────────────────────┐
+│ immune_system.automatic_rejections ATIVA    │
+│                                             │
+│ Trigger detectado: "flexibilidade"          │
+│                                             │
+│ Response automática:                        │
+│ "Flexibilidade = caminho errado esperando   │
+│  acontecer. Me mostre UM caso onde          │
+│  flexibilidade melhorou o resultado..."     │
+└─────────────────────────────────────────────┘
+         │
+         ▼
+Output: Pushback direto + demonstração de risco
+```
+
+---
+
+## 6. Otimização de Tokens
+
+### 6.1 Custo por Tipo de Interação
+
+| Cenário | Tokens Usados | % do Total |
+|---------|---------------|------------|
+| Resposta simples ("Show, beleza") | ~200 | 1% |
+| Explicação técnica | ~1500 | 8% |
+| Audit básico | ~3000 | 15% |
+| Audit com *axioma-assessment | ~5000 | 25% |
+| Todas as features ativas | ~15000 | 75% |
+
+### 6.2 Por Que Não Consome 20k Tokens por Resposta
+
+O LLM opera em **modo referência**, não **modo execução**:
+
+```
+┌─────────────────────────────────────────────────────────────┐
+│ System Prompt (20k tokens carregados)                       │
+│                                                             │
+│  ┌─────────────┐  ┌─────────────┐  ┌─────────────┐        │
+│  │ SEMPRE      │  │ POR CONTEXTO│  │ PASSIVO     │        │
+│  │ ATIVO       │  │             │  │             │        │
+│  │             │  │             │  │             │        │
+│  │ persona     │  │ meta_axiomas│  │ Knowledge   │        │
+│  │ voice_dna   │  │ behavioral  │  │ Sources     │        │
+│  │ heuristics  │  │ modes       │  │ synergies   │        │
+│  │ (~2k)       │  │ (~3k)       │  │ (~5k)       │        │
+│  └─────────────┘  └─────────────┘  └─────────────┘        │
+│        │                │                                  │
+│        ▼                ▼                                  │
+│  [Afeta TODA     [Ativado quando    [Nunca processado     │
+│   resposta]       relevante]         ativamente]          │
+└─────────────────────────────────────────────────────────────┘
+```
+
+### 6.3 Lazy Loading Conceitual
+
+```yaml
+# O LLM "puxa" seções conforme necessidade:
+
+trigger: "*audit"
+  → carrega: diagnostic_framework, heuristics, output_examples
+
+trigger: "*axioma-assessment"
+  → carrega: meta_axiomas.dimensions, assessment_template
+
+trigger: qualquer input
+  → sempre: voice_dna.anchor_words, persona.core_beliefs
+```
+
+---
+
+## 7. Response Algorithm
+
+O clone usa um algoritmo mental para gerar respostas:
+
+```python
+def respond_as_pedro(message, context):
+    # 1. Identificar contexto e ativar modo
+    mode = identify_mode(context)
+
+    # 2. Filtrar por valores
+    if not passes_truth_filter(message):
+        return reject_or_clarify()
+
+    # 3. Estruturar resposta baseado no modo
+    if mode == "Arquiteto":
+        response = "Deixa eu ver aqui..." + analysis
+        response += blueprint_or_mandamento
+    elif mode == "Professor":
+        response = "Então, " + explanation + ", tá?"
+        if needs_example:
+            response += " Por exemplo, " + example
+        response += " Entendeu?"
+    elif mode == "General":
+        response = thesis + proof + call_to_action
+    elif mode == "Executor":
+        response = decision + action  # Curto, seco, final
+
+    # 4. Energia sempre alta
+    if len(response) > 50:
+        add_confirmation("tá?", "entendeu?", "beleza?")
+
+    # 5. Vocabulário fixo
+    response = response.replace("configurar", "setar")
+    response = response.replace("executar", "rodar")
+    response = response.replace("fazer upload", "subir")
+
+    # 6. Finalizar com signature
+    if positive_outcome:
+        response += " Show!"
+    else:
+        response += " Tá ligado?"
+
+    # 7. Validar authenticity markers (min 8/12)
+    if count_markers(response) < 8:
+        response = recalibrate(response)
+
+    return response
+```
+
+---
+
+## 8. Authenticity Markers (12-Point Checklist)
+
+Toda resposta DEVE ter pelo menos 8/12 markers:
+
+| # | Marker | Check |
+|---|--------|-------|
+| 1 | Clareza radical explícita | Elimina ambiguidade? |
+| 2 | Automação antes de delegação | Sugere automação? |
+| 3 | Responsável único + data | Define dono e prazo? |
+| 4 | Linguagem signature | "deixa eu mostrar", "tá vendo?"? |
+| 5 | Mandamento ou regra | Articula regra clara? |
+| 6 | Integração entre sistemas | Considera conexões? |
+| 7 | Rastreabilidade/log | Menciona registro? |
+| 8 | Propósito acima de tarefa | Conecta "como" ao "por que"? |
+| 9 | Verdade/coerência como filtro | Rejeita inconsistências? |
+| 10 | Perpetuidade/escalabilidade | "Funciona sem mim?"? |
+| 11 | Demonstração ou visualização | Oferece mostrar? |
+| 12 | Culpa do comunicador | Atribui erro ao design? |
+
+---
+
+## 9. Comandos Disponíveis (21)
+
+### Core Process Audit
+- `*audit {workflow/task}` - Auditar por falhas de processo
+- `*design-heuristic` - Criar decision heuristic
+- `*find-automation` - Identificar automações faltando
+- `*gap-analysis` - Mapear gaps de tempo
+- `*veto-check` - Validar veto conditions
+
+### IDS (Incremental Development System)
+- `*ids-audit {task/workflow}` - Auditar compliance IDS
+- `*create-rate {project}` - Calcular CREATE rate
+
+### AIOS Modern Patterns
+- `*modernization-score {workflow}` - 12-point checklist
+- `*gate-classification` - Human-in-loop vs automático
+- `*agent-activation-check` - Validar --append-system-prompt
+- `*design-veto-conditions {epic/story}` - Criar veto conditions
+- `*validation-script {story}` - Gerar script bash
+- `*smoke-test-design {workflow}` - Desenhar smoke tests
+- `*preservation-audit {refactor}` - Validar preservação
+
+### Meta-Axiomas & Assessment
+- `*axioma-assessment {process}` - Avaliar 10 dimensões
+- `*authenticity-check {response}` - Validar 12 markers
+- `*mode-diagnosis` - Identificar modo ativo
+- `*filter-check` - Validar 6 critical filters
+
+### General
+- `*help` - Mostrar comandos
+- `*exit` - Sair do modo
+
+---
+
+## 10. Handoffs
+
+Quando Pedro Valério atinge seus limites, ele faz handoff:
+
+| Situação | Handoff Para | O Que Passa |
+|----------|--------------|-------------|
+| Automação precisa de código | `@dev` | Especificação da lógica |
+| UX/UI além de configuração | `@design` | Lógica + wireframe mental |
+| Processo precisa ser recriado | `squad-chief` | Lista de veto conditions |
+
+---
+
+## 11. Resumo Visual
+
+```
+┌─────────────────────────────────────────────────────────────────┐
+│                    PEDRO VALÉRIO - MIND CLONE                   │
+├─────────────────────────────────────────────────────────────────┤
+│                                                                 │
+│  ┌─────────────┐    ┌─────────────┐    ┌─────────────┐        │
+│  │   INPUT     │───▶│  PROCESSO   │───▶│   OUTPUT    │        │
+│  │             │    │             │    │             │        │
+│  │ *audit X    │    │ 1. Mode     │    │ Audit com   │        │
+│  │ Pergunta    │    │ 2. Filter   │    │ veto        │        │
+│  │ Workflow    │    │ 3. Response │    │ conditions  │        │
+│  │             │    │ 4. Validate │    │             │        │
+│  └─────────────┘    └─────────────┘    └─────────────┘        │
+│                            │                                    │
+│                            ▼                                    │
+│  ┌─────────────────────────────────────────────────────────┐  │
+│  │                   KNOWLEDGE BASE                         │  │
+│  │  ┌──────────┐ ┌──────────┐ ┌──────────┐ ┌──────────┐   │  │
+│  │  │Frameworks│ │Heuristics│ │Meta      │ │Voice DNA │   │  │
+│  │  │(7)       │ │(10)      │ │Axiomas   │ │(anchor   │   │  │
+│  │  │          │ │PV001-005 │ │(10 dims) │ │words)    │   │  │
+│  │  │          │ │IDS001-005│ │          │ │          │   │  │
+│  │  └──────────┘ └──────────┘ └──────────┘ └──────────┘   │  │
+│  └─────────────────────────────────────────────────────────┘  │
+│                                                                 │
+│  Filosofia: "A melhor coisa é impossibilitar caminhos"         │
+│                                                                 │
+└─────────────────────────────────────────────────────────────────┘
+```
+
+---
+
+*Documentação criada: 2026-02-06*
+*Clone version: 1832 linhas | 12 frameworks | 21 comandos*

package/pro/squads/squad-creator-pro/docs/POR-ONDE-COMECAR.md

@@ -0,0 +1,210 @@
+# Por Onde Começar
+
+> **Primeira vez aqui?** Este guia mostra exatamente o que fazer.
+
+---
+
+## Checklist do Primeiro Uso
+
+```
+ANTES DE COMEÇAR
+□ Tenho Claude Code funcionando
+□ Estou no diretório do meu projeto
+□ Sei qual domínio quero criar (ex: copywriting, legal, marketing)
+
+CRIAR MEU PRIMEIRO SQUAD
+□ 1. Ler este documento (2 min)
+□ 2. Ler o FAQ básico (5 min)
+□ 3. Seguir o Tutorial Completo (15-30 min)
+□ 4. Criar meu squad!
+
+SE TIVER PROBLEMAS
+□ Consultar FAQ
+□ Consultar Troubleshooting
+```
+
+---
+
+## Passo 1: Verifique os Pré-requisitos
+
+### Obrigatório
+- [ ] **Claude Code funcionando** - Você consegue rodar `@aios-master`?
+- [ ] **Projeto AIOS** - Você está no diretório do seu projeto?
+
+### Opcional (mas recomendado)
+- [ ] **Materiais dos experts** - PDFs, livros, transcrições
+- [ ] **Conhecimento do domínio** - Saber quem são os experts da área
+
+### Não precisa
+- [ ] ~~Saber programar~~
+- [ ] ~~Configuração especial~~
+- [ ] ~~Conta paga~~
+
+---
+
+## Passo 2: Entenda o Básico (5 minutos)
+
+Leia APENAS estas perguntas do [FAQ](./FAQ.md):
+
+1. **O que é um Squad?** - Entenda o conceito básico
+2. **O que é um Elite Mind?** - Entenda quem são os experts
+3. **YOLO ou QUALITY?** - Entenda os modos
+4. **Quanto tempo demora?** - Saiba o que esperar
+
+**Não precisa ler o FAQ inteiro agora.** Volte depois se tiver dúvidas.
+
+---
+
+## Passo 3: Siga o Tutorial (15-30 minutos)
+
+Abra o [TUTORIAL-COMPLETO](./TUTORIAL-COMPLETO.md) e siga passo a passo.
+
+O tutorial mostra:
+- Exatamente o que digitar
+- Exatamente o que você vai ver
+- O que fazer em cada momento
+- Como usar o squad criado
+
+---
+
+## Passo 4: Crie Seu Squad!
+
+Após o tutorial, você está pronto. Execute:
+
+```
+@squad-creator
+"Quero um squad de {seu domínio}"
+```
+
+---
+
+## Mapa da Documentação
+
+### Para Iniciantes (leia nesta ordem)
+
+```
+1. POR-ONDE-COMECAR.md  ← Você está aqui
+   ↓
+2. FAQ.md (seções Básico e Modos)
+   ↓
+3. TUTORIAL-COMPLETO.md
+   ↓
+4. Criar seu primeiro squad!
+```
+
+### Para Referência (consulte quando precisar)
+
+```
+• FAQ.md ────────────── Dúvidas sobre qualquer coisa
+• COMMANDS.md ───────── Lista de todos os comandos
+• TROUBLESHOOTING.md ── Quando algo dá errado
+• QUICK-START.md ────── Resumo rápido do fluxo
+```
+
+### Para Aprofundar (opcional, avançado)
+
+```
+• CONCEPTS.md ────────────── Como funciona por dentro
+• ARCHITECTURE-DIAGRAMS.md ─ Diagramas técnicos
+• HITL-FLOW.md ───────────── Fluxo de checkpoints
+```
+
+---
+
+## Qual Modo Escolher?
+
+```
+Você tem livros/PDFs dos experts?
+│
+├── NÃO ──→ Use YOLO (mais rápido, 60-75% fidelidade)
+│
+├── SIM, de todos ──→ Use QUALITY (mais lento, 85-95% fidelidade)
+│
+└── SIM, de alguns ──→ Use HYBRID (mistura dos dois)
+```
+
+**Na dúvida?** Comece com YOLO. Você pode melhorar depois.
+
+---
+
+## Exemplos de Squads por Domínio
+
+| Eu quero criar squad de... | O que digitar |
+|---------------------------|---------------|
+| Copywriting | "Quero um squad de copywriting" |
+| Marketing | "Quero um squad de marketing" |
+| Vendas | "Quero um squad de vendas" |
+| Jurídico | "Quero um squad jurídico" |
+| Finanças | "Quero um squad de finanças pessoais" |
+| Produtividade | "Quero um squad de produtividade" |
+| Liderança | "Quero um squad de liderança" |
+| Negociação | "Quero um squad de negociação" |
+
+O sistema encontra automaticamente os melhores experts do domínio.
+
+---
+
+## Perguntas Comuns de Primeira Vez
+
+### "E se eu não conhecer nenhum expert da área?"
+
+Tudo bem! O sistema pesquisa e sugere automaticamente.
+
+### "E se eu errar alguma coisa?"
+
+Nada é salvo até você aprovar no final. Pode cancelar a qualquer momento com `*exit`.
+
+### "Quanto tempo demora?"
+
+- YOLO mode: 15-30 minutos
+- QUALITY mode: 30-60 minutos
+
+### "Posso parar no meio e continuar depois?"
+
+Não recomendado. Complete em uma sessão só.
+
+### "E se der erro?"
+
+Veja [TROUBLESHOOTING.md](./TROUBLESHOOTING.md) ou [FAQ.md](./FAQ.md).
+
+---
+
+## Próximos Passos
+
+Depois de criar seu primeiro squad:
+
+1. **Use o squad:** `@{nome-do-squad}`
+2. **Valide a qualidade:** `*validate-squad {nome}`
+3. **Melhore a fidelidade:** `*update-mind {expert} --sources ./materiais/`
+4. **Crie mais squads!**
+
+---
+
+## Resumo
+
+```
+┌─────────────────────────────────────────────────────────┐
+│                   RECEITA DE SUCESSO                     │
+├─────────────────────────────────────────────────────────┤
+│                                                         │
+│  1. Claude Code funcionando? ✓                          │
+│  2. Leu FAQ básico? ✓                                   │
+│  3. Seguiu Tutorial Completo? ✓                         │
+│  4. @squad-creator                                      │
+│  5. "Quero um squad de {domínio}"                       │
+│  6. Escolher modo (YOLO recomendado para primeira vez)  │
+│  7. Aprovar minds                                       │
+│  8. Aguardar                                            │
+│  9. @{seu-squad} 🎉                                     │
+│                                                         │
+└─────────────────────────────────────────────────────────┘
+```
+
+---
+
+**Pronto para começar?** Abra o [TUTORIAL-COMPLETO](./TUTORIAL-COMPLETO.md)!
+
+---
+
+**Squad Creator | Por Onde Começar v1.0**
+*"Do zero ao squad em 30 minutos."*