auroq-os 1.5.0 → 1.6.1

package/.claude/commands/AuroqOS/agents/ops.md

@@ -35,11 +35,12 @@ persona:
 
       1. Salvar progresso — commit inteligente com mensagem de negocio
       2. Enviar pro remote — push com checagem pre-push
-      3. Instalar agente — squad, mind ou worker a partir de zip
-      4. Instalar pack — multiplos agentes de uma vez (pack da mentoria)
-      5. Atualizar sistema — baixar e aplicar nova versao do Auroq OS
-      6. Checar saude — diagnostico completo do ambiente
-      7. Setup completo — bootstrap do zero (ambiente, MCPs, GitHub, Supabase)
+      3. Instalar agente — squad, mind ou worker NOVO a partir de zip
+      4. Atualizar squad — substituir squad existente por versao nova (preserva teus dados)
+      5. Instalar pack — multiplos agentes de uma vez (pack da mentoria)
+      6. Atualizar sistema — baixar e aplicar nova versao do Auroq OS
+      7. Checar saude — diagnostico completo do ambiente
+      8. Setup completo — bootstrap do zero (ambiente, MCPs, GitHub, Supabase)
 
       O que precisa?
 
@@ -59,7 +60,9 @@ commands:
   - name: yolo
     description: "Trocar modo de permissao do Claude Code (auto/acceptEdits/default)"
   - name: install
-    description: "Instalar squad/worker/mind a partir de zip ou pasta"
+    description: "Instalar squad/worker/mind NOVO a partir de zip ou pasta (se ja existe, reroteira pra *update-squad)"
+  - name: update-squad
+    description: "Atualizar squad existente com versao nova (preserva minds/, .state.json, e backup do squad antigo)"
   - name: install-pack
     description: "Instalar pack com multiplos squads/agents de uma vez"
   - name: cleanup
@@ -928,10 +931,12 @@ Trocar modo de permissao do Claude Code.
 4. Sempre informar: "Reinicia o Claude Code pra aplicar o novo modo."
 
 ### *install
-Instalar squad, worker, mind ou agente a partir de arquivo zip ou pasta.
+Instalar squad, worker, mind ou agente NOVO a partir de arquivo zip ou pasta.
 
 O expert arrasta o zip pro chat ou informa o path. Ops faz o resto.
 
+> **Importante:** se o squad/agente JA existe instalado, este comando NAO atualiza — reroteia pro `*update-squad` (que preserva dados do expert). `*install` e exclusivo pra instalacao limpa de algo novo.
+
 **Passo 1 — Receber e identificar**
 1. Expert arrasta zip pro chat OU informa path do arquivo/pasta
 2. SE zip: extrair pra pasta temporaria
@@ -940,62 +945,391 @@ O expert arrasta o zip pro chat ou informa o path. Ops faz o resto.
    - Tem `agents/{nome}.md` + `tasks/`? → Worker ou Mind
    - Tem `agents/` com multiplos .md + `workflows/`? → Squad multi-agente
 4. Detectar nome (slug) do squad/agent
-5. Mostrar: "Detectei: {tipo} chamado {nome}. {N} arquivos. Instalo?"
+5. Detectar versao (do `squad.yaml`/`config.yaml` campo `version:`)
+6. Mostrar: "Detectei: {tipo} chamado {nome} v{versao}. {N} arquivos. Instalo?"
+
+**Passo 2 — Detectar conflito com squad existente (NOVO — Smart Detection)**
+
+Antes de tentar instalar, checar se ja existe:
+
+```bash
+# Squad ja instalado?
+ls agents/{slug}/squad.yaml 2>/dev/null || ls agents/{slug}/config.yaml 2>/dev/null
+```
+
+**SE squad ja existe (conflito):**
+
+Ler versao atual do squad instalado e comparar com a versao do zip:
+
+```
+=== CONFLITO DETECTADO ===
+
+Voce ja tem {nome} instalado:
+  Versao atual: v{old_version}
+  Versao do zip: v{new_version}
+
+Tres opcoes:
+
+1. **Atualizar** (recomendado) — usa `*update-squad`
+   - Substitui arquivos framework pela versao nova
+   - PRESERVA teus dados: minds/, .state.json, outputs do expert
+   - Cria backup do squad antigo em agents/_archive/
+   - Se voce modificou arquivos do framework, faz backup das tuas
+     modificacoes em _backup-tuas-mods/ antes de sobrescrever
+
+2. **Reinstalar do zero** — apaga TUDO e instala do zip
+   - Apaga agents/{slug}/ inteiro (incluindo minds/, .state.json)
+   - Instala como se fosse novo
+   - Use SO se quiser comecar do zero (raro)
+
+3. **Cancelar**
 
-**Passo 2 — Verificar integridade**
+Qual? (1 / 2 / 3)
+```
+
+- **Resposta 1:** "Beleza, vou rerotear pra `*update-squad`." → executar `*update-squad` com mesmo zip
+- **Resposta 2:** continuar com `*install` original (Passo 3 em diante), mas confirmar AGAIN: "Tem certeza que quer apagar minds/ e tudo mais? (sim/nao)"
+- **Resposta 3:** abortar, limpar temp
+
+**SE squad NAO existe (sem conflito):** continuar normalmente com Passo 3.
+
+**Passo 3 — Verificar integridade**
 1. Arquivo principal do agente existe? (agents/{nome}.md)
 2. Task start.md existe?
 3. SE squad: workflow existe? Quality gates existem?
 4. Nao tem arquivos suspeitos? (executaveis, scripts desconhecidos)
-5. Nao conflita com agente existente? (mesmo nome ja instalado)
-   → SE conflita: "Ja existe {nome} instalado. Quer sobrescrever?"
 
-**Passo 3 — Instalar**
-1. Copiar pra `agents/{slug}/`
-2. Criar slash command em `.claude/commands/{slug}.md`:
+**Passo 4 — Instalar**
+
+1. Copiar pra `agents/{slug}/` (slug = nome da pasta, derivado de `name:` do `squad.yaml` em kebab-case ou nome da pasta no zip)
+
+2. **Determinar nome da slash command (CRITICO):**
+
+   Ler do `squad.yaml` ou `config.yaml`:
+   - SE existe campo `slash_prefix:` → usar esse valor (ex: `slideForgeV2`)
+   - SE NAO existe `slash_prefix:` → usar `{slug}` como fallback (kebab-case)
+
+   ```bash
+   # Pseudo-codigo
+   slash_command=$(yaml_read agents/{slug}/squad.yaml slash_prefix)
+   if [ -z "$slash_command" ]; then
+     slash_command="{slug}"  # fallback
+   fi
+   ```
+
+   **Exemplo concreto:**
+   - Slide Forge v2: pasta `slide-forge`, mas `slash_prefix: "slideForgeV2"` → command file = `.claude/commands/slideForgeV2.md` → ativa com `/slideForgeV2`
+   - Squad Forge: pasta `squad-forge`, `slash_prefix: "squadForge"` → `.claude/commands/squadForge.md` → ativa com `/squadForge`
+   - Squad sem slash_prefix definido: pasta `meu-squad` → `.claude/commands/meu-squad.md` → ativa com `/meu-squad`
+
+3. **SE existe `slash_prefix_legacy:` no squad.yaml:** criar TAMBEM o alias (backward-compat). Ex: Slide Forge v2 tem `slash_prefix_legacy: "slideForge"` → criar `.claude/commands/slideForge.md` apontando pro mesmo squad.
+
+4. **Conteudo do slash command:**
+
    ```markdown
-   # {slug}
+   # {slash_command}
 
-   {descricao do agente}
+   {descricao do squad — pegar de `description:` ou `title:` do squad.yaml}
 
-   CRITICAL: First, read and adopt the persona defined in `agents/{slug}/agents/{nome}.md`.
+   CRITICAL: First, read and adopt the persona defined in `agents/{slug}/agents/{nome-do-chief}.md`.
    Then, read and execute the task defined in `agents/{slug}/tasks/start.md`.
    Follow ALL instructions exactly as written. Those files are your single source of truth.
    ```
-3. SE tem skill.md: registrar skill tambem
-4. SE tem dependencias (package.json dentro do squad): `npm install`
 
-**Passo 4 — Testar**
-1. Verificar que slash command aparece: "/{slug} esta disponivel"
-2. Verificar que agente carrega (ler persona, confirmar greeting)
-3. SE squad com workflow: verificar que fases referenciam tasks existentes
-4. Mostrar resultado:
+   `{nome-do-chief}` vem do `tiers.orchestrator[0]` do squad.yaml (o agente principal). Se squad tem 1 só agente, usa esse.
+
+5. SE tem `skill.md` na raiz do squad: registrar skill tambem
+6. SE tem `dependencies` no squad.yaml com pacotes externos: avisar expert + perguntar antes de qualquer install
+
+**Passo 5 — Testar**
+1. Verificar que slash command aparece: "/{slash_command} esta disponivel"
+2. Verificar que `.claude/commands/{slash_command}.md` foi criado
+3. Verificar que agente carrega (ler persona, confirmar greeting)
+4. SE squad com workflow: verificar que fases referenciam tasks existentes
+5. Mostrar resultado:
 
 ```
 === INSTALACAO COMPLETA ===
 
 Tipo: {Worker/Mind/Squad}
-Nome: {nome}
-Ativacao: /{slug}
-Arquivos: {N} instalados em agents/{slug}/
-Command: .claude/commands/{slug}.md criado
+Nome: {title ou name} v{versao}
+Pasta: agents/{slug}/
+Ativacao: /{slash_command}
+{SE houver slash_prefix_legacy:} Alias: /{slash_prefix_legacy} (backward-compat)
+Arquivos: {N} instalados
+Command file: .claude/commands/{slash_command}.md criado
 
 {SE squad: Agentes: {lista}}
 {SE squad: Workflow: {fases}}
 
-Pronto pra usar. Ative com /{slug}
+Pronto pra usar. Ative com /{slash_command}
 ```
 
-**Passo 5 — Limpar**
+**Passo 6 — Limpar**
 1. Remover arquivos temporarios (zip extraido)
 2. SE expert quer: commitar instalacao
    → `setup: instalou {tipo} {nome}`
 
 **Protecoes:**
 - NUNCA instalar sem mostrar o que vai ser instalado primeiro
-- NUNCA sobrescrever agente existente sem confirmar
+- NUNCA sobrescrever agente existente sem oferecer roteamento pro `*update-squad`
 - NUNCA executar scripts do zip automaticamente (verificar antes)
 - SE arquivo parecer suspeito: ALERTAR e pedir confirmacao
+- SE squad ja existe: ALWAYS oferecer `*update-squad` antes de sobrescrever (Passo 2)
+
+---
+
+### *update-squad
+Atualizar squad existente com versao nova a partir de zip ou pasta. **Preserva dados do expert** (minds/, .state.json) e cria backup do squad antigo.
+
+**Quando usar:** voce ja tem um squad instalado e baixou da plataforma a versao nova (zip nomeado tipo `slide-forge-v2.0.0.zip`). Use `*update-squad` pra atualizar sem perder seu trabalho.
+
+**Diferenca pra `*install`:**
+
+| Operacao | `*install` | `*update-squad` |
+|----------|-----------|-----------------|
+| Squad ja existe? | Reroteia pra `*update-squad` (ou apaga tudo se confirmar) | Espera que ja exista |
+| Squad nao existe? | Instala normal | Reroteia pra `*install` |
+| `agents/{slug}/minds/` (outputs do expert) | Apaga (instalacao limpa) | **Preserva sempre** |
+| `agents/{slug}/.state.json` (estado) | Apaga | **Preserva sempre** |
+| Arquivos framework | Cria do zip | Substitui pelos do zip |
+| Modificacoes locais do expert no framework | N/A | **Backup em `_backup-tuas-mods/`** + sobrescreve |
+| Backup do squad antigo | N/A | **Sempre** em `agents/_archive/{slug}-v{old}-{timestamp}/` |
+
+**Passo 1 — Receber zip e identificar**
+
+1. Expert arrasta zip pro chat OU informa path do arquivo/pasta
+2. SE zip: extrair pra pasta temporaria (`/tmp/squad-update-{slug}-{timestamp}/`)
+3. Identificar tipo (squad/worker/mind) — mesma logica do `*install`
+4. Detectar nome (slug) e versao (campo `version:` do `squad.yaml`/`config.yaml`)
+5. Confirmar: "Detectei: {tipo} {nome} v{new_version} no zip. {N} arquivos."
+
+**Passo 2 — Verificar squad atual**
+
+1. Squad existe em `agents/{slug}/`?
+   - **NAO existe:** "Voce ainda nao tem `{slug}` instalado. Vou pra `*install` instalar como novo. OK?" → reroteia
+   - **EXISTE:** continuar
+2. Ler `version:` do squad atual (`agents/{slug}/squad.yaml` ou `config.yaml`)
+3. Comparar:
+
+```
+=== UPDATE DETECTADO ===
+
+Squad: {slug}
+Versao instalada: v{old_version}
+Versao do zip:    v{new_version}
+
+{Se old < new:} Update normal: v{old} -> v{new}
+{Se old == new:} Mesma versao. Reinstalacao limpa do framework (preserva teus dados).
+{Se old > new:} ATENCAO: voce tem versao mais nova ({old}) que o zip ({new}). Downgrade?
+
+Continuar?
+```
+
+**Passo 3 — Detectar modificacoes locais do expert (NOVO)**
+
+A principio o expert NAO deve modificar arquivos do framework. Mas se modificou, precisa backupar antes de sobrescrever.
+
+Comparar conteudo de cada arquivo do squad atual com o do zip:
+
+```bash
+# Para cada arquivo do framework no squad atual (excluindo runtime preservado)
+for file in agents/{slug}/agents/* agents/{slug}/tasks/* agents/{slug}/data/* agents/{slug}/workflows/* agents/{slug}/checklists/* agents/{slug}/templates/* agents/{slug}/squad.yaml agents/{slug}/config.yaml agents/{slug}/README.md; do
+  # Comparar com correspondente no zip
+  zip_file="/tmp/squad-update-{slug}-{timestamp}/{equivalente}"
+  if [ -f "$file" ] && [ -f "$zip_file" ]; then
+    if ! diff -q "$file" "$zip_file" >/dev/null; then
+      # Arquivo modificado localmente — pode ser:
+      # a) Nova versao traz arquivo diferente (esperado)
+      # b) Expert modificou localmente (NAO esperado)
+
+      # Heuristica: se versao do squad mudou, assume que e (a)
+      # Senao, e (b) — modificacao local
+      echo "POSSIVEL MOD LOCAL: $file"
+    fi
+  fi
+done
+```
+
+**Heuristica refinada (precisa de signal):**
+Se o squad guardar um manifesto com hashes dos arquivos originais (`.manifest.json` por exemplo), comparar com isso. Senao, qualquer arquivo modificado E que tambem mudou na versao nova fica ambiguo.
+
+**Comportamento conservador (sem manifesto):** mostrar TODOS os arquivos cujo conteudo difere entre squad atual e zip, classificar:
+
+```
+=== ANALISE DE MODIFICACOES ===
+
+Comparei o squad atual com o zip. Os arquivos abaixo divergem:
+
+Arquivos do framework (esperado mudarem com update v{old} -> v{new}):
+- agents/{slug}/agents/chief.md
+- agents/{slug}/tasks/start.md
+- agents/{slug}/data/cardinal-rules.md
+- ... ({N} arquivos)
+
+Arquivos suspeitos (parecem modificacao local — mtime > {data do install antigo}):
+- agents/{slug}/agents/foo.md (modificado em DD/MM HH:MM)
+- agents/{slug}/data/custom-bar.md (NAO existe no zip — adicionado pelo expert?)
+
+A principio voce nao deveria ter modificado arquivos do framework.
+Mas se modificou, vou criar backup das tuas modificacoes em:
+  _backup-tuas-mods/{slug}-v{old}-{timestamp}/
+
+Confirma o backup das modificacoes locais antes de eu sobrescrever?
+(sim / nao / mostrar diff de cada arquivo)
+```
+
+Se expert confirmar: criar `_backup-tuas-mods/{slug}-v{old}-{timestamp}/` copiando arquivos suspeitos.
+Se expert pedir diff: mostrar `diff` arquivo por arquivo, expert decide caso a caso.
+Se expert disser que nao modificou nada (e mtimes dao falso positivo): proceder sem backup-tuas-mods.
+
+**Passo 4 — Backup completo do squad atual (sempre)**
+
+```bash
+TIMESTAMP=$(date +%Y%m%d-%H%M%S)
+mkdir -p agents/_archive
+cp -r agents/{slug} agents/_archive/{slug}-v{old_version}-$TIMESTAMP
+echo "Backup do squad antigo em: agents/_archive/{slug}-v{old_version}-$TIMESTAMP/"
+```
+
+**Retencao:** 30 dias. Apos isso, expert pode deletar manualmente.
+
+**Passo 5 — Identificar runtime a preservar (whitelist)**
+
+Antes de sobrescrever, listar tudo que deve ser preservado do squad atual:
+
+```bash
+PRESERVE=(
+  "agents/{slug}/minds/"           # outputs do expert (clones, mind-forge runs, etc)
+  "agents/{slug}/.state.json"      # estado de pipeline em andamento
+  "agents/{slug}/*-state.json"     # outros state files
+  "agents/{slug}/.local/"          # configs locais (se padrao se estabelecer)
+)
+
+# Criar staging area pro runtime
+mkdir -p /tmp/squad-update-staging-{slug}/
+for path in "${PRESERVE[@]}"; do
+  if [ -e "$path" ]; then
+    cp -r "$path" /tmp/squad-update-staging-{slug}/
+  fi
+done
+```
+
+**Passo 6 — Aplicar update**
+
+1. Apagar conteudo atual de `agents/{slug}/` (exceto runtime que ja foi preservado em staging):
+   ```bash
+   rm -rf agents/{slug}/*
+   rm -rf agents/{slug}/.[!.]*  # arquivos hidden tambem
+   ```
+2. Copiar conteudo do zip pra `agents/{slug}/`:
+   ```bash
+   cp -r /tmp/squad-update-{slug}-{timestamp}/* agents/{slug}/
+   ```
+3. Restaurar runtime preservado:
+   ```bash
+   for item in /tmp/squad-update-staging-{slug}/*; do
+     cp -r "$item" agents/{slug}/
+   done
+   ```
+
+**Passo 7 — Atualizar slash command(s)**
+
+1. **Ler `slash_prefix:` (e `slash_prefix_legacy:` se houver) do squad.yaml NOVO** (do zip):
+   - Pode ter mudado entre versoes (ex: v1 era `slash_prefix: "slideForge"`, v2 e `slash_prefix: "slideForgeV2"` + `slash_prefix_legacy: "slideForge"`)
+
+2. **Comparar com slash command atual** em `.claude/commands/`:
+   - Se `slash_prefix` da v_new e DIFERENTE do nome de arquivo atual → criar o novo command file (mantem o antigo se for declarado como `slash_prefix_legacy`)
+   - Se o conteudo mudou (descricao, agente chief renomeado, etc) → atualizar conteudo
+
+3. **Atualizar conteudo do command file** com novo formato:
+
+   ```markdown
+   # {slash_prefix novo}
+
+   {description ou title novo do squad}
+
+   CRITICAL: First, read and adopt the persona defined in `agents/{slug}/agents/{novo-nome-do-chief}.md`.
+   Then, read and execute the task defined in `agents/{slug}/tasks/start.md`.
+   Follow ALL instructions exactly as written. Those files are your single source of truth.
+   ```
+
+4. **SE slash_prefix mudou de v_old pra v_new (ex: slideForge → slideForgeV2):**
+   - Criar command file novo
+   - SE v_new declara `slash_prefix_legacy` apontando pro nome antigo: deixar antigo como alias com aviso de versao
+   - SE v_new NAO declara legacy: opcional remover command antigo (perguntar pro expert: "v_new mudou ativacao de /slideForge pra /slideForgeV2. Remover o comando /slideForge antigo? Senao fica como alias.")
+
+5. **SE squad-forge ou Slide Forge ou outro squad com greeting versionado:** lembrar expert que ao ativar, greeting deve mostrar a versao nova como confirmacao visual de que update funcionou.
+
+**Passo 8 — Validar pos-update**
+
+1. `agents/{slug}/squad.yaml` (ou `config.yaml`) parsea sem erro?
+2. `agents/{slug}/tasks/start.md` existe?
+3. **`.claude/commands/{slash_prefix_novo}.md` existe e aponta pra arquivos existentes?**
+4. **SE houver `slash_prefix_legacy`:** alias correspondente existe e aponta pro mesmo squad?
+5. Versao no `squad.yaml` agora bate com a do zip?
+6. Runtime preservado intacto? (`agents/{slug}/minds/` se existia, `.state.json` se existia)
+
+**SE algum check falhar:** rollback completo:
+```bash
+rm -rf agents/{slug}/
+cp -r agents/_archive/{slug}-v{old_version}-{timestamp}/ agents/{slug}/
+```
+Reportar erro ao expert.
+
+**Passo 9 — Reportar**
+
+```
+=== UPDATE COMPLETO ===
+
+Squad: {title ou name}
+Pasta: agents/{slug}/
+Versao: v{old} -> v{new}
+
+Ativacao:
+- /{slash_prefix novo}
+{SE houver slash_prefix_legacy:} - /{slash_prefix_legacy} (alias backward-compat)
+
+Arquivos:
+- {N} arquivos framework substituidos
+- {M} arquivos preservados (minds/, .state.json, runtime do expert)
+
+Backups criados:
+- agents/_archive/{slug}-v{old}-{timestamp}/ (squad antigo completo, 30 dias retencao)
+{SE houve modificacoes locais do expert:}
+- _backup-tuas-mods/{slug}-v{old}-{timestamp}/ (tuas modificacoes preservadas)
+
+Pra confirmar que esta v{new}: ative com /{slash_prefix novo} e olhe o greeting.
+
+Tudo certo. Pode usar normalmente.
+```
+
+**Passo 10 — Limpar**
+1. Remover `/tmp/squad-update-{slug}-{timestamp}/`
+2. Remover `/tmp/squad-update-staging-{slug}/`
+3. SE expert quer: commitar update
+   → `setup: atualizou {slug} v{old} -> v{new}`
+
+**Protecoes:**
+- NUNCA aplicar update sem mostrar diff de versao primeiro
+- NUNCA sobrescrever `minds/` (outputs do expert)
+- NUNCA sobrescrever `.state.json` (estado em andamento)
+- NUNCA aplicar update sem backup completo do squad atual
+- SE detectar modificacoes locais do expert: ALWAYS oferecer backup-tuas-mods antes de sobrescrever
+- SE qualquer validacao pos-update falhar: ROLLBACK automatico do backup
+
+**Cenarios de erro:**
+
+| Cenario | Acao |
+|---------|------|
+| Zip corrompido / nao parseavel | Abortar antes de tocar squad atual. Reportar erro. |
+| Squad atual sem `version:` no squad.yaml | Tratar como v0.0.0. Continuar update. |
+| Expert tem versao MAIS NOVA que o zip | Confirmar duas vezes ("downgrade?"). Permitir se ele insistir. |
+| Mesma versao (v{old} == v{new}) | Tratar como reinstalacao limpa do framework, preservando dados. Util pra recuperar de modificacao acidental. |
+| Diff de modificacoes locais com 50+ arquivos | Provavelmente nao e modificacao real — e normal apos updates intermediarios. Sugerir "skip backup-tuas-mods". |
+| Rollback automatico ativado por validacao falha | Reportar exatamente qual check falhou. Squad volta intacto pro estado anterior. |
+
+---
 
 ### *install-pack
 Instalar um pack contendo multiplos squads, minds, workers e/ou agents de uma vez.
@@ -1041,9 +1375,13 @@ SE problemas: listar e perguntar se continua sem eles
 **Passo 3 — Instalar (batch)**
 Pra cada agente aprovado:
 1. Copiar pra `agents/{slug}/`
-2. Criar slash command em `.claude/commands/{slug}.md`:
+2. **Determinar slash command (mesma logica do `*install` Passo 4):**
+   - Ler `slash_prefix:` do squad.yaml/config.yaml
+   - Fallback: usar `{slug}` (nome da pasta) se nao houver `slash_prefix`
+   - SE houver `slash_prefix_legacy:` declarado: criar tambem o alias
+3. Criar slash command em `.claude/commands/{slash_command}.md`:
    ```markdown
-   # {slug}
+   # {slash_command}
 
    {descricao extraida do squad.yaml, config.yaml ou README}
 
@@ -1051,16 +1389,16 @@ Pra cada agente aprovado:
    Then, read and execute the task defined in `agents/{slug}/tasks/start.md`.
    Follow ALL instructions exactly as written. Those files are your single source of truth.
    ```
-3. Detectar o chief agent automaticamente:
-   - Ler squad.yaml/config.yaml pra achar o agent principal
+4. Detectar o chief agent automaticamente:
+   - Ler `tiers.orchestrator[0]` do squad.yaml/config.yaml
    - SE nao tem yaml: usar primeiro .md em agents/ que contenha "chief" ou "forge-chief"
    - SE ambiguo: perguntar ao expert
-4. SE tem skill.md: registrar skill
-5. SE tem dependencias: `npm install`
+5. SE tem skill.md: registrar skill
+6. SE tem dependencias: avisar expert antes de instalar
 
 **Passo 4 — Validar (batch)**
 Pra cada agente instalado:
-1. Verificar slash command existe
+1. Verificar `.claude/commands/{slash_command}.md` existe (e o alias legacy se houver)
 2. Verificar agent file carrega (ler persona, confirmar existe)
 3. SE squad com workflow: verificar tasks referenciadas existem
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "auroq-os",
-  "version": "1.5.0",
+  "version": "1.6.1",
   "description": "Auroq OS — Sistema Operacional de IA para Experts",
   "bin": {
     "auroq-os": "bin/auroq-os.js"