auroq-os 1.6.0 → 1.6.1

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

@@ -1000,39 +1000,69 @@ Qual? (1 / 2 / 3)
 4. Nao tem arquivos suspeitos? (executaveis, scripts desconhecidos)
 
 **Passo 4 — Instalar**
-1. Copiar pra `agents/{slug}/`
-2. Criar slash command em `.claude/commands/{slug}.md`:
+
+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`
+
+   `{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: "/{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:
+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} v{versao}
-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 6 — Limpar**
@@ -1203,19 +1233,42 @@ done
    done
    ```
 
-**Passo 7 — Atualizar slash command**
+**Passo 7 — Atualizar slash command(s)**
 
-Comparar `.claude/commands/{slug}.md` atual com o que o zip espera (geralmente derivado de `name`/`title`/`description` do squad.yaml).
+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"`)
 
-Se mudou (mudou descricao do squad, mudou nome do agente principal, etc): atualizar.
+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/{slug}.md` aponta pra arquivos existentes?
-4. Versao no `squad.yaml` agora bate com a do zip?
-5. Runtime preservado intacto? (`agents/{slug}/minds/` se existia, `.state.json` se existia)
+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
@@ -1229,9 +1282,14 @@ Reportar erro ao expert.
 ```
 === UPDATE COMPLETO ===
 
-Squad: {slug}
+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)
@@ -1241,8 +1299,7 @@ Backups criados:
 {SE houve modificacoes locais do expert:}
 - _backup-tuas-mods/{slug}-v{old}-{timestamp}/ (tuas modificacoes preservadas)
 
-{SE squad-forge ou similar com greeting versionado:}
-Pra confirmar que ta v{new}: ative com /{slug} e olhe o greeting.
+Pra confirmar que esta v{new}: ative com /{slash_prefix novo} e olhe o greeting.
 
 Tudo certo. Pode usar normalmente.
 ```
@@ -1318,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}
 
@@ -1328,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.6.0",
+  "version": "1.6.1",
   "description": "Auroq OS — Sistema Operacional de IA para Experts",
   "bin": {
     "auroq-os": "bin/auroq-os.js"