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

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,118 @@ 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)
+
+```
+Phase 0: Quick Wizard ───── @bret-victor   (3 perguntas, depois autônomo)
+Phase 1: Analysis ───────── @bret-victor   (detecção de padrão + capability mapping)
+Phase 2: Strategy ───────── @wes-bush      (PLG, onboarding, multi-tenant)
+Phase 3: Design System ──── @design-system (tokens, components — Brad Frost)
+Phase 4: UX Writing ─────── @kinneret      (voice chart, microcopy, narrativa)
+Phase 5: Spec ───────────── @pm + @architect (PRD + tech spec + api design)
+Phase 6: Build ──────────── @dev           (implementação)
+Phase 7: QA ─────────────── @qa            (validação)
+Phase 8: Deploy ─────────── @devops        (publicação)
+```
+
+#### 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
+```
+
+---
+
 ## Arquitetura
 
 ```
@@ -353,7 +466,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 +475,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 +612,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/package.json

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