@pixeleducacao/curso-openclaw 2026.5.8

package/assets/skills/starter/onboarding-checklist/evals/evals.json

@@ -0,0 +1,245 @@
+{
+  "skill": "onboarding-checklist",
+  "version": "1.0",
+  "description": "4 cenários de teste end-to-end pra validar fluxos críticos da skill mestre",
+  "scenarios": [
+    {
+      "id": "linear-novo",
+      "name": "Aluno linear (caminho feliz)",
+      "description": "Aluno novo, workspace vazio, faz tudo na ordem sem pular nem cancelar. Caso mais comum.",
+      "setup": {
+        "workspace_state": "vazio",
+        "memory_flags": {},
+        "canal": "telegram"
+      },
+      "interaction_flow": [
+        {
+          "user": "oi",
+          "expected_agent_behavior": [
+            "executa fase zero de detecção (workspace vazio = Cenário A)",
+            "verifica canal = Telegram (ok, sem aviso)",
+            "apresenta manifesto curto (carrega de manifesto-abertura.md)",
+            "marca kit_intro_done=true em MEMORY.md",
+            "renderiza checklist completa com ETA total ~37min",
+            "termina perguntando 'Bora começar pelo passo 0?'"
+          ],
+          "must_not": [
+            "começar wizard sem confirmação do aluno",
+            "pular o manifesto",
+            "renderizar checklist sem ETA total"
+          ]
+        },
+        {
+          "user": "começar",
+          "expected_agent_behavior": [
+            "despacha wizard-whisper-quick (passo 0)"
+          ]
+        },
+        {
+          "user": "[completou wizard-whisper-quick com sucesso]",
+          "expected_agent_behavior": [
+            "marca whisper_configured=true",
+            "roda pergunta-âncora do passo 0 (smoke test áudio)",
+            "renderiza checklist com [x] no passo 0",
+            "pergunta 'Bora pro passo 1?'"
+          ]
+        },
+        {
+          "user": "vai",
+          "expected_agent_behavior": [
+            "despacha wizard-agente (passo 1)"
+          ]
+        },
+        {
+          "user": "[completa todos os passos 1-6 em sequência similar]",
+          "expected_agent_behavior": [
+            "ao final do passo 6, renderiza checklist COMPLETA com 🎉",
+            "oferece 4 próximos passos opcionais",
+            "marca first_win_completed=true e onboarding_complete=true em MEMORY.md"
+          ]
+        }
+      ],
+      "success_criteria": [
+        "kit_intro_done=true",
+        "todas as flags de passo (whisper_configured, agente_configured, ..., first_win_completed) = true",
+        "MEMORY.md tem registro de cada decisão tomada",
+        "aluno respondeu ao menos 1 pergunta-âncora",
+        "tempo total na faixa de 30-50min (margem aceitável)"
+      ]
+    },
+    {
+      "id": "aluno-pula-passos",
+      "name": "Aluno pula passo com dependência",
+      "description": "Aluno pula passo 3 (autonomia) e tenta seguir pro 4 (workspace). Agente deve avisar sobre fricção.",
+      "setup": {
+        "workspace_state": "passos 0, 1, 2 completos",
+        "memory_flags": {
+          "kit_intro_done": true,
+          "whisper_configured": true,
+          "agente_configured": true,
+          "aluno_configured": true,
+          "onboarding_current_step": 3
+        },
+        "canal": "telegram"
+      },
+      "interaction_flow": [
+        {
+          "user": "pulo",
+          "expected_agent_behavior": [
+            "marca passo 3 como skipped em MEMORY.md (NÃO done)",
+            "renderiza checklist com [→] no passo 3",
+            "consulta dependencias.md → passo 4 depende de 3",
+            "aviso: 'Antes de seguir, aviso: o passo 4 depende do passo 3...'",
+            "oferece 2 opções: voltar pro 3 ou seguir com fricção"
+          ],
+          "must_not": [
+            "pular silencioso sem avisar sobre dependência",
+            "marcar como done em vez de skipped"
+          ]
+        },
+        {
+          "user": "seguir mesmo",
+          "expected_agent_behavior": [
+            "despacha wizard-workspace (passo 4)",
+            "wizard-workspace, ao executar, vai pedir aprovação a cada criação de pasta/arquivo (efeito de não ter exec-policy yolo)"
+          ]
+        }
+      ],
+      "success_criteria": [
+        "passo 3 marcado como skipped, não done",
+        "aluno foi informado da fricção antes de aceitar",
+        "decisão de pular foi registrada em MEMORY.md"
+      ]
+    },
+    {
+      "id": "cancela-volta",
+      "name": "Aluno cancela e volta dias depois",
+      "description": "Aluno cancela no passo 2, volta 2 dias depois, retoma corretamente.",
+      "setup": {
+        "workspace_state": "passos 0 e 1 completos, passo 2 em progresso",
+        "memory_flags": {
+          "kit_intro_done": true,
+          "whisper_configured": true,
+          "agente_configured": true,
+          "onboarding_current_step": 2
+        },
+        "canal": "telegram"
+      },
+      "interaction_flow": [
+        {
+          "user": "deixa quieto, depois eu volto",
+          "expected_agent_behavior": [
+            "salva onboarding_paused_at_step=2 em MEMORY.md",
+            "NÃO marca onboarding_dismissed=true",
+            "mensagem de despedida: 'Beleza, parei aqui. Você fez até o passo 1...'",
+            "informa comandos pra reativar ('reativa jornada') ou apagar de vez ('nunca mais')"
+          ]
+        },
+        {
+          "user": "[2 dias depois] reativa jornada",
+          "expected_agent_behavior": [
+            "lê onboarding_paused_at_step=2 de MEMORY.md",
+            "renderiza checklist com [x] nos passos 0 e 1, [⏸️] no passo 2",
+            "mensagem: 'Bem-vindo de volta. Você parou no passo 2.'",
+            "pergunta: 'Continuar daí ou prefere recapitular o que já fizemos?'"
+          ]
+        }
+      ],
+      "success_criteria": [
+        "estado de pausa preservado entre sessões",
+        "checklist visual mostra histórico correto ao retomar",
+        "aluno consegue continuar exatamente do ponto onde parou"
+      ]
+    },
+    {
+      "id": "workspace-populado",
+      "name": "Aluno antigo (workspace populado)",
+      "description": "Aluno antigo do curso v1 baixou Kit Novos por engano. Agente deve recusar e entregar prompt agentic de upgrade.",
+      "setup": {
+        "workspace_state": "populado",
+        "files_present": [
+          "USER.md (preenchido, edit há 60 dias)",
+          "IDENTITY.md (preenchido)",
+          "AGENTS.md (preenchido)",
+          "MEMORY.md (47 entradas)",
+          "skills/operacional/captura-ideias/ (skill existente)",
+          "skills/conteudo/post-linkedin/ (skill customizada)"
+        ],
+        "memory_flags": {},
+        "canal": "telegram"
+      },
+      "interaction_flow": [
+        {
+          "user": "oi",
+          "expected_agent_behavior": [
+            "executa fase zero de detecção (workspace populado = Cenário B)",
+            "NÃO apresenta manifesto",
+            "NÃO renderiza checklist normal",
+            "mensagem: 'Detectei que você já tem um OpenClaw configurado:'",
+            "lista o que detectou (USER.md preenchido, X skills, etc)",
+            "explica por que kit não pode rodar aqui",
+            "oferece prompt agentic de upgrade",
+            "pergunta: 'Quer o prompt?'"
+          ],
+          "must_not": [
+            "tentar instalar kit por cima do trabalho existente",
+            "apresentar checklist normal",
+            "ignorar arquivos pré-existentes"
+          ]
+        },
+        {
+          "user": "sim",
+          "expected_agent_behavior": [
+            "carrega prompt-upgrade-para-aluno-antigo.md",
+            "substitui placeholders (paths reais)",
+            "entrega texto inteiro do prompt em mensagem",
+            "marca onboarding_dismissed=true (essa instalação não vai usar checklist)",
+            "aviso final: 'Cola tudo de uma vez no seu agente atual'"
+          ]
+        }
+      ],
+      "success_criteria": [
+        "trabalho do aluno antigo preservado intacto",
+        "prompt agentic entregue completo",
+        "onboarding_dismissed=true em MEMORY.md (essa instalação não usa checklist)",
+        "instruções claras pro aluno colar prompt no agente dele"
+      ]
+    }
+  ],
+  "edge_cases_to_handle": [
+    {
+      "case": "Aluno tenta rodar em WhatsApp",
+      "expected": "Aviso de degradação + 2 opções: aceitar perda ou pausar pra mudar pra Telegram"
+    },
+    {
+      "case": "Aluno manda 'sobre' antes de começar jornada",
+      "expected": "Carrega sobre-o-kit.md, ao final pergunta 'Bora começar pelo passo 0 ou pular pro 1?'"
+    },
+    {
+      "case": "Aluno manda 'ajuda' (não previsto explicitamente)",
+      "expected": "Lista os 5 comandos canônicos + link grupo + email Bruno"
+    },
+    {
+      "case": "Aluno pula TODOS os passos exceto o 6 (vitória)",
+      "expected": "Aviso forte sobre experiência degradada, oferece 'volta no 1' como recomendação, espera confirmação 'vai mesmo'"
+    },
+    {
+      "case": "Wizard filho falha no meio (ex: erro de permissão)",
+      "expected": "PARA imediatamente, reporta estado, oferece 3 opções: debug / verificar manual / pular"
+    },
+    {
+      "case": "MEMORY.md corrompido ao reativar",
+      "expected": "Mostra checklist desmarcada, pergunta 'Bora começar de novo?'"
+    }
+  ],
+  "anti_patterns_to_test": [
+    "Não pode renderizar checklist sem ETA total na primeira vez",
+    "Não pode marcar passo como done sem o wizard correspondente ter completado",
+    "Não pode pular fase zero de detecção de ambiente",
+    "Não pode despachar wizard sem confirmação explícita do aluno",
+    "Não pode esquecer de rodar pergunta-âncora ao final de cada passo",
+    "Não pode escrever em arquivo raiz sem backup + confirmação dupla",
+    "Não pode ignorar comando 'cancelar' (sempre obedece)",
+    "Não pode tratar workspace populado como vazio"
+  ]
+}

package/assets/skills/starter/onboarding-checklist/references/arquivamento-pos-jornada.md

@@ -0,0 +1,167 @@
+# Arquivamento Pós-Jornada
+
+> O que mover pra `~/archive/starter-kit-onboarding-{data}/` quando aluno escolhe "arquivar" depois da jornada completa.
+
+---
+
+## Fluxo do arquivamento
+
+Após aluno completar jornada (passo 6 — primeira vitória) e responder NPS, agente pergunta:
+
+> "Você quer arquivar o material de onboarding ou manter tudo onde tá?"
+
+Se aluno escolhe **arquivar**, mover os items abaixo pra `~/archive/starter-kit-onboarding-{YYYY-MM-DD}/`.
+
+---
+
+## O que ARQUIVA (jornada cumprida, não roda mais)
+
+```
+skills/starter/onboarding-checklist/    ← mestre, função cumprida
+skills/starter/wizard-whisper-quick/    ← Whisper já configurado
+skills/starter/wizard-agente/           ← identidade já criada
+skills/starter/wizard-aluno/            ← USER já criado
+skills/starter/wizard-autonomia/        ← já liberada
+skills/starter/wizard-workspace/        ← já organizado
+skills/starter/wizard-conectar/         ← já conectado
+templates/                              ← templates não usados (USER, IDENTITY, etc já preenchidos)
+exemplos/                               ← exemplos da Amora (referência só serve no aprendizado inicial)
+FAQ.md                                  ← perguntas comuns do começo (avançado já dominou)
+BUILD.md                                ← script de build do zip (irrelevante pós-uso)
+manifesto.md                            ← já lido na entrada
+README.md                               ← do starter-kit (não confundir com README do workspace)
+```
+
+---
+
+## O que PERMANECE no workspace (uso contínuo)
+
+```
+skills/starter/primeira-vitoria/        ← roda de novo pra criar mais artefatos
+skills/canais/wizard-whatsapp/          ← opt-in pós-vitória (não ativado)
+skills/planejamento/                    ← Superpowers — uso contínuo
+skills/operacional/                     ← backup-workspace-github + outras utilities
+content/                                ← criação ativa
+memory/                                 ← memória contínua
+archive/                                ← onde o material arquivado vai parar
+USER.md, IDENTITY.md, SOUL.md, AGENTS.md, MAPA.md, MEMORY.md, HEARTBEAT.md, .env
+```
+
+---
+
+## Mensagem antes do arquivamento
+
+```
+"Vou arquivar o material de onboarding agora. Resumo do que vai pra
+~/archive/starter-kit-onboarding-{data}/:
+
+- 7 wizards de onboarding (mestre + 6 passos)
+- Pasta de templates (versões em branco)
+- Pasta de exemplos da Amora
+- FAQ.md
+- README e manifesto do kit
+
+Continua no seu workspace:
+- Primeira-vitoria (você usa pra criar mais artefatos)
+- Skills de planejamento (Superpowers)
+- Wizard-whatsapp (opt-in pra adicionar canal)
+- Skills operacionais (backup, status, etc)
+- Seus arquivos raiz (USER, IDENTITY, etc)
+- Pastas content/ e memory/
+
+Tudo arquivado fica acessível em ~/archive/. Se um dia quiser revisitar
+ou compartilhar o kit com alguém, tá tudo lá.
+
+Confirma o arquivamento? (sim / não)"
+```
+
+---
+
+## Após arquivar
+
+```
+"✓ Arquivado em ~/archive/starter-kit-onboarding-{data}/
+
+Tamanho: {X}MB
+Itens: {Y}
+
+Workspace limpo. Próximos superpoderes opcionais (ative quando quiser):
+
+- 'ativa whatsapp' → canal extra
+- 'instala perplexity' → deep research
+- 'instala apify' → puxar dados de redes sociais
+- '1password' → migrar .env pro cofre
+
+Manda 'ajuda' pra ver tudo que sei fazer.
+Manda 'desarquiva kit' se um dia quiser voltar com o material."
+```
+
+---
+
+## Comando "desarquiva kit"
+
+Aluno pode reverter o arquivamento em qualquer momento:
+
+```
+Aluno: "desarquiva kit"
+
+Agente:
+"Vou mover de volta pro workspace:
+- Wizards de onboarding
+- Templates
+- Exemplos
+- FAQ
+- README + manifesto
+
+De ~/archive/starter-kit-onboarding-2026-05-02/
+
+Confirma?"
+```
+
+---
+
+## Casos especiais
+
+### Aluno escolhe NÃO arquivar
+
+```
+"Beleza, mantenho tudo no workspace.
+
+Vai ocupar mais espaço visual quando você for procurar suas skills,
+mas se preferir ter o material disponível pra revisitar — sem problema.
+
+Você sempre pode arquivar depois mandando 'arquiva kit'."
+```
+
+### Aluno arquivou e quer só o FAQ de volta
+
+```
+Aluno: "preciso do FAQ"
+
+Agente:
+"FAQ tá arquivado em ~/archive/starter-kit-onboarding-{data}/FAQ.md
+
+Quer que eu:
+a) Copie só o FAQ pra raiz do workspace
+b) Desarquive o kit inteiro
+c) Eu te respondo a dúvida específica usando o FAQ daqui mesmo (sem mover arquivo)
+
+Qual?"
+```
+
+Default sugerido: **(c)** — agente lê o FAQ on-demand sem precisar mover. Mantém workspace limpo.
+
+---
+
+## Princípio aplicado
+
+Este fluxo aplica vários princípios:
+
+- **Princípio 1 (backup):** o tar.gz do GitHub backup já cobriu o estado pré-arquivamento. Se algo der errado, dá pra restaurar do GitHub.
+- **Princípio 2 (confirmação):** arquivamento exige "sim" explícito do aluno antes de mover qualquer coisa.
+- **Princípio 12 (mapas distribuídos):** atualizar `archive/MAPA.md` listando o que foi arquivado e quando.
+- **Reversibilidade:** comando "desarquiva kit" garante que arquivamento não é destrutivo.
+
+---
+
+*Última revisão: 02/05/2026*

package/assets/skills/starter/onboarding-checklist/references/arquivos-raiz.md

@@ -0,0 +1,281 @@
+# Arquivos Raiz do Workspace
+
+> Documentação canônica dos 8 arquivos raiz que vivem no workspace do aluno após a jornada do starter-kit.
+> Cada arquivo tem função única, owner definido, e regra clara de quando atualizar.
+
+---
+
+## Visão geral
+
+```
+workspace/
+├── USER.md         ← quem é o aluno
+├── IDENTITY.md     ← quem é o agente (nome, tom, iniciativa)
+├── SOUL.md         ← personalidade do agente (anti-patterns, jeitos)
+├── AGENTS.md       ← regras de interação aluno↔agente
+├── MAPA.md         ← mapa raiz: lista pastas, aponta pros mapas locais
+├── MEMORY.md       ← decisões + flags + memória contínua
+├── HEARTBEAT.md    ← estado atual + última atividade
+└── .env            ← chaves API + segredos
+```
+
+Princípio: cada arquivo tem **uma responsabilidade clara**. Sem mistura.
+
+---
+
+## Detalhe por arquivo
+
+### `USER.md` — Identidade do aluno
+
+**Função:** quem é a pessoa que conversa com o agente. Nome, papel, área, dor principal, contexto.
+
+**Criado em:** Passo 2 (`wizard-aluno`)
+
+**Quem atualiza:**
+- Aluno (manual) — quando contexto pessoal muda (mudou de empresa, trocou foco)
+- Agente — nunca sozinho, só sugere
+
+**Frequência:** Raramente. Pode ficar meses sem mudar.
+
+**Estrutura mínima:**
+```markdown
+# USER.md
+
+## Quem sou
+- Nome: Carlos
+- Como me chame: Carlos
+
+## O que faço
+- Papel: dono de padaria
+- Setor: alimentação
+- Tamanho: padaria pequena, 4 funcionários
+
+## Contexto
+- Maior dor: atender cliente no WhatsApp (encomendas de bolo)
+- Resultado esperado em 30 dias: organizar fluxo de pedidos sem perder cliente
+```
+
+---
+
+### `IDENTITY.md` — Identidade do agente
+
+**Função:** características operacionais do agente. Nome, tom, iniciativa.
+
+**Criado em:** Passo 1 (`wizard-agente`)
+
+**Quem atualiza:**
+- Aluno (manual) — quando quer ajustar tom/iniciativa
+- Agente — nunca sozinho
+
+**Frequência:** Raro. Aluno ajusta quando descobre que tom não tá bom.
+
+**Estrutura mínima:**
+```markdown
+# IDENTITY.md
+
+## Sobre mim (este agente)
+- Nome: Léa
+- Tom: casual brasileiro, sem jargão corporativo
+- Iniciativa: sugere e pergunta (te mostro 2-3 opções, você escolhe)
+- Owner: Carlos
+```
+
+---
+
+### `SOUL.md` — Personalidade profunda
+
+**Função:** anti-patterns, jeitos de falar específicos, valores. Vai além de "tom" — define caráter.
+
+**Criado em:** Passo 1 (stub mínimo) → B1 (completo no curso)
+
+**Quem atualiza:** Aluno + agente sugere
+
+**Frequência:** Stub criado uma vez, completo evolui ao longo do tempo
+
+**Estrutura mínima (stub do passo 1):**
+```markdown
+# SOUL.md (stub)
+
+Sou Léa, agente do Carlos (dono de padaria).
+
+## Tom geral
+Casual brasileiro, sem jargão corporativo.
+
+## 1 anti-pattern fundamental
+Nunca uso linguagem motivacional/coach. Falo direto.
+```
+
+**Versão completa (após B1):** detalha múltiplos anti-patterns, situações específicas (como falar quando dá erro, quando aluno tá frustrado, etc).
+
+---
+
+### `AGENTS.md` — Regras de interação
+
+**Função:** o que aluno e agente combinaram que pode ou não pode rolar. Regras de comportamento.
+
+**Criado em:** Passo 1 (`wizard-agente`)
+
+**Quem atualiza:** Aluno (manual) — adiciona regra quando pega agente fazendo algo que não gostou
+
+**Frequência:** Raro depois do passo 1
+
+**Estrutura mínima:**
+```markdown
+# AGENTS.md — Regras entre nós
+
+## O que NUNCA faço
+- Mandar email/whats em nome do Carlos sem perguntar
+- Deletar arquivo sem confirmação dupla
+- Usar jargão de marketing
+
+## O que SEMPRE posso fazer (sem perguntar)
+- Criar arquivo dentro de content/drafts/
+- Salvar decisão em memory/decisoes/
+- Pesquisar na web pra responder pergunta
+
+## Quando perguntar antes
+- Modificar arquivo raiz (USER, IDENTITY, SOUL, AGENTS, MAPA, .env)
+- Executar comando shell
+- Conectar/desconectar integração externa
+- Criar cron novo
+```
+
+---
+
+### `MAPA.md` — Mapa raiz do workspace
+
+**Função:** lista as pastas principais e aponta pros mapas locais de cada uma.
+
+**Criado em:** Passo 4 (`wizard-workspace`)
+
+**Quem atualiza:** Agente — quando estrutura macro muda (pasta nova criada/removida)
+
+**Frequência:** Raro. Estrutura macro estabiliza após o passo 4.
+
+**Padrão e exemplo completo:** ver [`sistema-de-mapas.md`](sistema-de-mapas.md)
+
+---
+
+### `MEMORY.md` — Decisões + memória contínua
+
+**Função:** flags da jornada de onboarding + decisões importantes do aluno + memória factual de longo prazo.
+
+**Criado em:** Vários passos (cada wizard adiciona sua flag)
+
+**Quem atualiza:** **Agente — automático.** Constantemente.
+
+**Frequência:** A cada decisão tomada, flag setada, fato relevante.
+
+**Estrutura:**
+```markdown
+# MEMORY.md
+
+## Flags da jornada de onboarding
+- kit_intro_done: true (2026-05-02 14:15)
+- whisper_configured: true (2026-05-02 14:20)
+- agente_configured: true (2026-05-02 14:25) — nome: Léa
+- aluno_configured: true (2026-05-02 14:30)
+- autonomia_liberada: true (2026-05-02 14:38)
+- workspace_organizado: true (2026-05-02 14:45)
+- conectado: true (2026-05-02 15:02)
+- first_win_completed: true (2026-05-02 15:10)
+- onboarding_complete: true (2026-05-02 15:12)
+- nps_completed: true (2026-05-02 15:18)
+
+## Decisões importantes
+- 2026-05-02: Aluno escolheu manter starter-kit instalado (não arquivar)
+- 2026-05-02: Aluno pulou Apify e Perplexity no passo 5 — disse que vai instalar depois
+- ...
+
+## Fatos do aluno (descobertos ao longo do tempo)
+- Padaria fica em Curitiba
+- Funcionários: Maria (caixa), João (forno), ...
+- ...
+```
+
+---
+
+### `HEARTBEAT.md` — Estado atual
+
+**Função:** última atividade, contexto quente, o que tava sendo feito quando aluno saiu.
+
+**Criado em:** Passo 4 (`wizard-workspace`)
+
+**Quem atualiza:** **Agente — automático.** A cada sessão relevante.
+
+**Frequência:** Atualizado a cada sessão de uso.
+
+**Estrutura:**
+```markdown
+# HEARTBEAT.md
+
+## Última atividade
+- Quando: 2026-05-02 15:18
+- O que: Aluno completou jornada de onboarding e respondeu NPS
+- Próximo passo natural: aguardar aluno mandar primeira tarefa real
+
+## Estado atual
+- Modo: aguardando comando
+- Contexto quente: nenhum
+- Pendências do aluno: nenhuma
+```
+
+---
+
+### `.env` — Chaves API e segredos
+
+**Função:** todas as chaves API + tokens + secrets que o agente usa.
+
+**Criado em:** Passo 0 (Whisper) + Passo 5 (Conectar)
+
+**Quem atualiza:** Aluno (paste) ou wizard-conectar (com confirmação dupla)
+
+**Frequência:** A cada nova integração ou rotação de chave.
+
+**Estrutura:**
+```bash
+# OpenAI
+OPENAI_API_KEY=sk-proj-xxx          # Whisper + embeddings
+OPENAI_OAUTH_TOKEN=managed-by-openclaw  # ChatGPT Plus
+
+# Busca
+BRAVE_SEARCH_API_KEY=BSAk-xxx
+
+# GitHub
+GITHUB_TOKEN=ghp_xxx                # backup automático
+
+# Opcionais (não configurados)
+# PERPLEXITY_API_KEY=
+# APIFY_TOKEN=
+```
+
+**Nota de segurança:** `.env` tá no `.gitignore` por padrão. Cron de backup pra GitHub **não inclui `.env`** (chaves não vão pro repo).
+
+---
+
+## Resumo de quem atualiza o quê
+
+| Arquivo | Atualização automática (agente) | Atualização manual (aluno) |
+|---|:-:|:-:|
+| `USER.md` | nunca | sim, raro |
+| `IDENTITY.md` | nunca | sim, raro |
+| `SOUL.md` | sugere | sim, evolui com tempo |
+| `AGENTS.md` | nunca | sim, raro |
+| `MAPA.md` | sim, quando estrutura muda | sim, raro |
+| `MEMORY.md` | sim, constante | raramente edita direto |
+| `HEARTBEAT.md` | sim, cada sessão | nunca edita |
+| `.env` | só com confirmação dupla | sim, paste de chaves |
+
+---
+
+## Princípios aplicados
+
+- **Princípio 1 (backup antes):** todos os 8 arquivos têm backup antes de qualquer modificação
+- **Princípio 2 (confirmação humana):** modificação de arquivo raiz exige confirmação
+- **Princípio 6 (respeitar customização):** se aluno editou manualmente, agente detecta e não sobrescreve
+- **Princípio 11 (detectar antes de pedir):** wizard checa se arquivo existe e tá preenchido antes de pedir input
+- **Princípio 12 (mapas distribuídos):** ver [`sistema-de-mapas.md`](sistema-de-mapas.md)
+
+---
+
+*Última revisão: 02/05/2026*