@eximia-ventures/claude-code-toolkit 5.0.0 → 5.1.1

package/README.md

@@ -9,7 +9,7 @@
 
 <p align="center">
   <strong>Setup completo para Claude Code em um comando.</strong><br/>
-  Statusline customizada, session continuity, usage monitor e AIOS integration.
+  Statusline customizada, session continuity, usage monitor, AIOS integration e Squad Forge.
 </p>
 
 <p align="center">
@@ -28,6 +28,7 @@ O `claude-code-toolkit` transforma sua experiência com o Claude Code instalando
 | **Session Handoff** | Continuidade de sessão entre `/clear` (7 slash commands, 2 hooks) |
 | **eximia-meter** | Monitor de consumo de tokens no menu bar do macOS |
 | **AIOS Framework** | 7 slash commands com wizards interativos: story, epic, QA, publish, bootstrap, help, integrate (opt-in) |
+| **Squad Forge** | Arsenal de squads especializados — transforma agents em plataformas visuais interativas |
 
 ---
 
@@ -83,7 +84,7 @@ O wizard guia você pelas opções:
 
 ```
   ╔══════════════════════════════════════╗
-  ║   claude-code-toolkit v5.0.0        ║
+  ║   claude-code-toolkit v5.1.0        ║
   ║   Setup completo para Claude Code   ║
   ╚══════════════════════════════════════╝
 
@@ -195,7 +196,7 @@ npx @eximia-ventures/claude-code-toolkit doctor
 ```
   ─── Diagnóstico ───
 
-  ✓ Manifest encontrado (v5.0.0)
+  ✓ Manifest encontrado (v5.1.0)
   ✓ Diretório ~/.claude/ existe
   ✓ settings.json contém statusLine
   ✓ statusline.sh existe e é executável
@@ -227,7 +228,7 @@ npx @eximia-ventures/claude-code-toolkit update meter
 ```
   ─── Atualização ───
 
-  ℹ Instalação encontrada (v5.0.0, 4 módulos)
+  ℹ Instalação encontrada (v5.1.0, 4 módulos)
 
   ─── Statusline ───
 
@@ -338,6 +339,170 @@ flowchart LR
 
 ---
 
+## Squad Arsenal
+
+O toolkit inclui um Arsenal de squads especializados que estendem o AIOS com capacidades focadas. Squads são integrados via `/aios-integrate` e ficam disponíveis como slash commands prontos para uso.
+
+### Squad Forge 🔥
+
+> **"Making the invisible visible"** — transforma qualquer squad, agent ou clone em uma plataforma visual interativa.
+
+O **Platform Forge** é um squad que materializa agents em produtos reais. Em vez de interagir via CLI, os usuários finais ganham uma interface web polida.
+
+#### Agents
+
+| Agent | Persona | Papel |
+|-------|---------|-------|
+| `@bret-victor` 🔥 | Bret Victor (Inventing on Principle) | **Orquestrador** — detecta padrão de UI, dirige o pipeline completo |
+| `@kinneret` ✍️ | Kinneret Yifrah + Torrey Podmajersky | **Voice Architect** — microcopy, Voice Chart, narrativa da plataforma |
+| `@wes-bush` 🚀 | Wes Bush + Tod Golding + Sangeet Paul Choudary | **Growth Architect** — PLG, onboarding, multi-tenant, platform strategy |
+
+#### Padrões de UI detectáveis
+
+O Forge classifica automaticamente o squad em um dos 4 padrões visuais:
+
+| Padrão | Ideal para | Stack |
+|--------|-----------|-------|
+| **Chat** | Squads onde usuários *falam com* agents | Next.js + Vercel AI SDK + Shadcn Chat |
+| **Canvas** | Squads onde usuários *constroem* passo a passo | Next.js + React DnD/Konva + Shadcn |
+| **Wizard** | Squads com assessments, diagnósticos, scoring | Next.js + React Hook Form + Zod + Shadcn |
+| **Dashboard** | Squads com métricas, analytics, monitoring | Next.js + Tremor/Recharts + TanStack Table + Shadcn |
+
+#### Pipeline wf-forge (9 fases)
+
+```mermaid
+flowchart TD
+    START(["@bret-victor *forge {squad}"]) --> P0
+
+    P0["Phase 0\nQuick Wizard\n@bret-victor"]
+    P0 --> P1
+
+    P1["Phase 1\nAnalysis\n@bret-victor"]
+    P1 --> PAT{Padrão\ndetectado}
+    PAT --> CHAT["Chat\nVercel AI SDK"]
+    PAT --> CANVAS["Canvas\nReact DnD"]
+    PAT --> WIZARD["Wizard\nRHF + Zod"]
+    PAT --> DASH["Dashboard\nTremor"]
+
+    CHAT & CANVAS & WIZARD & DASH --> P2
+
+    P2["Phase 2\nStrategy\n@wes-bush"]
+    P2 --> P3["Phase 3\nDesign System\n@design-system"]
+    P3 --> P4["Phase 4\nUX Writing\n@kinneret"]
+    P4 --> P5["Phase 5\nSpec\n@pm + @architect"]
+    P5 --> P6["Phase 6\nBuild\n@dev"]
+    P6 --> P7["Phase 7\nQA\n@qa"]
+    P7 --> P8["Phase 8\nDeploy\n@devops"]
+    P8 --> END(["✓ Plataforma publicada"])
+
+    style START fill:#F56000,color:#fff,stroke:none
+    style END fill:#22c55e,color:#fff,stroke:none
+    style P0 fill:#F56000,color:#fff,stroke:none
+    style P1 fill:#F56000,color:#fff,stroke:none
+    style P2 fill:#3b82f6,color:#fff,stroke:none
+    style P3 fill:#8b5cf6,color:#fff,stroke:none
+    style P4 fill:#ec4899,color:#fff,stroke:none
+    style P5 fill:#5B4FE5,color:#fff,stroke:none
+    style P6 fill:#22c55e,color:#fff,stroke:none
+    style P7 fill:#f59e0b,color:#000,stroke:none
+    style P8 fill:#14b8a6,color:#fff,stroke:none
+    style PAT fill:#1e293b,color:#fff,stroke:none
+    style CHAT fill:#0ea5e9,color:#fff,stroke:none
+    style CANVAS fill:#a855f7,color:#fff,stroke:none
+    style WIZARD fill:#f97316,color:#fff,stroke:none
+    style DASH fill:#10b981,color:#fff,stroke:none
+```
+
+#### Slash commands
+
+| Comando | Descrição |
+|---------|-----------|
+| `/forge {squad}` | Pipeline completo — Phases 0 a 8 |
+| `/forge-diagnose {squad}` | Diagnóstico de padrão UI sem build (Phase 1) |
+| `/forge-map-capabilities {squad}` | Mapeia capabilities do squad → features de produto |
+| `/forge-diagnose-squad {squad}` | Executa task de diagnóstico diretamente |
+
+#### Como usar
+
+```bash
+# Forjar um squad em plataforma visual completa
+/forge aios-master
+
+# Apenas diagnosticar o padrão de UI (sem build)
+/forge-diagnose biblical
+
+# Via agent diretamente
+@bret-victor *forge {squad}
+@bret-victor *diagnose {squad}
+@bret-victor *patterns
+@bret-victor *wizard {squad}
+@bret-victor *spec {squad}
+
+# Agents especializados
+@kinneret *voice-chart {platform}
+@kinneret *microcopy {platform}
+@wes-bush *platform-canvas {squad}
+@wes-bush *bowling-alley {squad}
+@wes-bush *tenant-model {squad}
+```
+
+#### Output gerado
+
+```
+forge/{target}/
+├── wizard-config.yaml       # Phase 0 — personalização
+├── analysis.md              # Phase 1 — padrão + capability map
+├── strategy.md              # Phase 2 — PLG + onboarding + tenant model
+├── design/
+│   ├── tokens.yaml          # Phase 3 — design tokens
+│   └── component-inventory.md
+├── microcopy.md             # Phase 4 — voice chart + todos os textos
+├── spec/
+│   ├── prd.md               # Phase 5 — product requirements
+│   ├── tech-spec.md         # Phase 5 — arquitetura técnica
+│   └── api-design.md        # Phase 5 — contratos de API
+├── qa-report.md             # Phase 7 — relatório de QA
+└── deployment.md            # Phase 8 — guia de deploy
+```
+
+#### Integrar novos squads via inbox
+
+Squads externos podem ser integrados via `/aios-integrate` ou pelo sistema de inbox:
+
+```bash
+# Coloque o squad em:
+.aios-core/inbox/{squad-name}/
+  ├── squad.yaml      # Manifest AIOS obrigatório
+  ├── agents/         # Definições de agents
+  ├── tasks/          # Tasks executáveis
+  └── workflows/      # Workflows
+
+# Depois execute /aios-integrate — o inbox é detectado automaticamente
+```
+
+```mermaid
+flowchart LR
+    ZIP["squad-export.zip"] --> INBOX[".aios-core/inbox/{squad}/"]
+    INBOX --> DETECT{"/aios-integrate\ndetecta inbox"}
+    DETECT --> VAL["Validação\nschema + IDs"]
+    VAL -->|PASS| COPY["squads/{name}/\n+ .codex/agents/\n+ .antigravity/\n+ .agent/workflows/"]
+    VAL -->|FAIL| ERR["Erro reportado\n+ sugestão de fix"]
+    COPY --> CSV[".aios-core/manifests/agents.csv\natualizado"]
+    COPY --> CMD[".claude/commands/\n{prefix}-*.md criados"]
+    COPY --> PROC[".aios-core/inbox/.processed/\nartefato arquivado"]
+
+    style ZIP fill:#f59e0b,color:#000,stroke:none
+    style DETECT fill:#5B4FE5,color:#fff,stroke:none
+    style VAL fill:#1e293b,color:#fff,stroke:none
+    style COPY fill:#22c55e,color:#fff,stroke:none
+    style ERR fill:#ef4444,color:#fff,stroke:none
+    style CSV fill:#3b82f6,color:#fff,stroke:none
+    style CMD fill:#8b5cf6,color:#fff,stroke:none
+    style PROC fill:#64748b,color:#fff,stroke:none
+```
+
+---
+
 ## Arquitetura
 
 ```
@@ -353,7 +518,7 @@ claude-code-toolkit/
 │   │   ├── statusline.js             # ~/.claude/statusline.sh + settings.json
 │   │   ├── handoff.js                # npx claude-code-handoff
 │   │   ├── meter.js                  # npx eximia-meter
-│   │   └── aios.js                   # npx aios-core + skill
+│   │   └── aios.js                   # npx aios-core + skills
 │   ├── commands/
 │   │   ├── uninstall.js              # Remoção via manifest
 │   │   ├── update.js                 # Atualização sem wizard
@@ -362,17 +527,41 @@ claude-code-toolkit/
 │       ├── settings-merger.js        # Deep-merge seguro (com backup)
 │       ├── file-installer.js         # Cópia com hash comparison
 │       └── logger.js                 # Output estilizado (Chalk)
-└── assets/
-    ├── statusline/
-    │   └── statusline.sh             # Script bash (jq + ANSI)
-    └── skill/
-        ├── aios-integrate.md         # Gerenciar artefatos (agents/squads)
-        ├── aios-story.md             # Operações de story
-        ├── aios-epic.md              # Gestão de epics
-        ├── aios-qa.md                # QA toolkit
-        ├── aios-publish.md           # Release management
-        ├── aios-bootstrap.md         # Setup de projeto
-        └── aios-help.md              # Guia de comandos AIOS
+├── assets/
+│   ├── statusline/
+│   │   └── statusline.sh             # Script bash (jq + ANSI)
+│   └── skill/
+│       ├── aios-integrate.md         # Gerenciar artefatos (agents/squads)
+│       ├── aios-story.md             # Operações de story
+│       ├── aios-epic.md              # Gestão de epics
+│       ├── aios-qa.md                # QA toolkit
+│       ├── aios-publish.md           # Release management
+│       ├── aios-bootstrap.md         # Setup de projeto
+│       └── aios-help.md              # Guia de comandos AIOS
+└── squads/
+    └── forge/                        # Squad Forge (Platform Materializer)
+        ├── squad.yaml                # Manifest AIOS
+        ├── agents/
+        │   ├── bret-victor.md        # Forge Orchestrator
+        │   ├── kinneret.md           # Platform Voice Architect
+        │   └── wes-bush.md           # Platform Growth Architect
+        ├── tasks/
+        │   ├── diagnose-squad.md     # Detecta padrão de UI
+        │   └── map-capabilities.md   # Capability → Feature mapping
+        ├── workflows/
+        │   └── wf-forge.yaml         # Pipeline completo (9 fases)
+        ├── checklists/
+        │   ├── forge-readiness-checklist.md
+        │   └── productization-checklist.md
+        ├── templates/
+        │   ├── platform-chat-tmpl.yaml
+        │   ├── platform-canvas-tmpl.yaml
+        │   ├── platform-wizard-tmpl.yaml
+        │   ├── platform-dashboard-tmpl.yaml
+        │   └── wizard-config-tmpl.yaml
+        └── data/
+            ├── pattern-signatures.yaml   # Sinais de detecção de padrão
+            └── stack-recommendations.yaml
 ```
 
 ---
@@ -475,6 +664,26 @@ npx @eximia-ventures/claude-code-toolkit uninstall
 Isso lê o manifest e remove apenas o que foi instalado pelo toolkit.
 </details>
 
+<details>
+<summary><strong>Como integrar um squad externo?</strong></summary>
+
+Use o sistema de inbox do AIOS:
+
+1. Coloque o squad em `.aios-core/inbox/{squad-name}/` com um `squad.yaml`
+2. Execute `/aios-integrate` — o inbox é detectado automaticamente
+3. Confirme a integração — o squad vai para `squads/{squad-name}/` e os slash commands são criados
+
+Alternativamente, use `/aios-integrate` → opção 1 (Integrar artefato externo) e informe o caminho.
+</details>
+
+<details>
+<summary><strong>O que é o Squad Forge e quando usar?</strong></summary>
+
+O **Squad Forge** transforma qualquer squad ou agent em uma plataforma web interativa. Use quando quiser que usuários finais sem acesso ao Claude Code possam interagir com seus agents via interface visual.
+
+Exemplo: `/forge aios-master` → gera um app completo onde usuários gerenciam stories e epics via UI.
+</details>
+
 ---
 
 ## Dependencias

package/assets/skill/aios-integrate.md

@@ -597,15 +597,30 @@ Quando o usuario escolher exportar:
    ```
    Incluir este arquivo dentro do pacote exportado.
 
-4. **Empacotar:**
-   - **Preferido:** `zip -r {artifact-name}-export.zip {files}`
-   - **Fallback:** Se `zip` nao disponivel (`which zip` falha), usar `tar -czf {artifact-name}-export.tar.gz {files}` com aviso: "Comando `zip` nao encontrado. Usando tar.gz como fallback."
+4. **Perguntar o formato de saida (wizard obrigatorio):**
 
-5. **Salvar** na pasta atual
+   Exibir sempre, independente de quais ferramentas estao disponiveis:
+
+   ```
+   Formato de exportacao:
+     1. .zip       — Compativel com /aios-integrate (recomendado)
+     2. .tar.gz    — Alternativa Unix
+     3. Pasta      — Diretorio descompactado (sem empacotamento)
+   ```
+
+   - Se o usuario escolher `.zip` mas `zip` nao estiver disponivel (`which zip` falhar) → exibir: "Comando `zip` nao encontrado. Deseja usar `.tar.gz` como alternativa? (s/n)"
+   - Se o usuario escolher `.tar.gz` mas `tar` nao estiver disponivel → exibir erro e sugerir "Pasta" como alternativa
+   - **Default:** opcao 1 (`.zip`) — highlight no menu
+
+5. **Empacotar** conforme escolha:
+   - `.zip` → `zip -r {artifact-name}-export.zip {files}`
+   - `.tar.gz` → `tar -czf {artifact-name}-export.tar.gz {files}`
+   - `Pasta` → copiar arquivos para `./{artifact-name}-export/` sem compressao
 
 6. **Relatorio:**
    ```
-   ✓ Exportado: ./{artifact-name}-export.zip
+   ✓ Exportado: ./{artifact-name}-export.{ext}
+     Formato: {zip | tar.gz | pasta}
      Conteudo: N arquivos, M KB
      Inclui: _manifest-entry.csv (para re-importacao)
      Arquivos:
@@ -613,10 +628,10 @@ Quando o usuario escolher exportar:
        - commands/{id}-cmd1.md
        - commands/{id}-cmd2.md
        - _manifest-entry.csv
-     Para importar em outro projeto: /aios-integrate → Integrar → caminho do .zip
+     Para importar em outro projeto: /aios-integrate → Integrar → caminho do arquivo
    ```
 
-**Na importacao (Integrar):** Detectar e aceitar tanto `.zip` quanto `.tar.gz`. Extrair para pasta temporaria e processar o conteudo normalmente. Se `_manifest-entry.csv` existir no pacote, usar seus dados como base para o registro no manifest.
+**Na importacao (Integrar):** Detectar e aceitar `.zip`, `.tar.gz` e pastas descompactadas. Extrair/ler para pasta temporaria e processar o conteudo normalmente. Se `_manifest-entry.csv` existir no pacote, usar seus dados como base para o registro no manifest.
 
 ---
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@eximia-ventures/claude-code-toolkit",
-  "version": "5.0.0",
+  "version": "5.1.1",
   "description": "Setup completo para Claude Code: statusline, session handoff, AIOS integration",
   "main": "src/index.js",
   "bin": {