@eximia-ventures/claude-code-toolkit 4.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">
@@ -27,7 +27,8 @@ O `claude-code-toolkit` transforma sua experiência com o Claude Code instalando
 | **Statusline** | Barra de status em tempo real com modelo, contexto, custo, tempo e git |
 | **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** | Integração com orquestração de agentes AI (opt-in) |
+| **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 v4.0.0        ║
+  ║   claude-code-toolkit v5.1.0        ║
   ║   Setup completo para Claude Code   ║
   ╚══════════════════════════════════════╝
 
@@ -104,12 +105,24 @@ O wizard guia você pelas opções:
 
   ? Vai utilizar o AIOS? (s/N)
 
+  ? Selecione os componentes AIOS:
+  ◉ AIOS Core          — Framework base (npx aios-core install)
+  ◉ /aios-integrate    — Gerenciar artefatos (agents/squads)
+  ◉ /aios-story        — Operações de story (criar, validar, desenvolver, QA)
+  ◉ /aios-epic         — Gestão de epics (criar, executar, status)
+  ◉ /aios-qa           — QA toolkit (scan, gate, loop, testes, security)
+  ◉ /aios-publish      — Release management (version, changelog, publish)
+  ◉ /aios-bootstrap    — Setup de projeto (greenfield, brownfield, team, GitHub)
+  ◉ /aios-help         — Guia de comandos AIOS (reference, busca, workflows)
+
   ─── Instalando... ───
 
   ✓ Statusline instalada em ~/.claude/statusline.sh
   ✓ settings.json atualizado com statusLine
   ✓ claude-code-handoff instalado (7 commands, 2 hooks, 2 rules)
   ✓ eximia-meter instalado
+  ✓ AIOS Core instalado/atualizado
+  ✓ 7 Skills AIOS instaladas
   ✓ Pronto!
 ```
 
@@ -138,13 +151,15 @@ flowchart TD
 
     F -->|Sim| F1{Sub-opções}
     F1 --> F2["AIOS Core\nnpx aios-core install"]
-    F1 --> F3["Skill /aios-integrate\n.claude/commands/"]
+    F1 --> F3["7 Skills AIOS\n.claude/commands/"]
+
+    F3 --> F4["integrate · story · epic\nqa · publish · bootstrap · help"]
 
     D2 --> G["Salva manifest\n.toolkit-manifest.json"]
     E2 --> G
     M2 --> G
     F2 --> G
-    F3 --> G
+    F4 --> G
 
     G --> H["✓ Pronto!\nReinicie o Claude Code"]
 
@@ -155,6 +170,7 @@ flowchart TD
     style M1 fill:#22c55e,color:#fff,stroke:none
     style F2 fill:#8b5cf6,color:#fff,stroke:none
     style F3 fill:#8b5cf6,color:#fff,stroke:none
+    style F4 fill:#8b5cf6,color:#fff,stroke:none
 ```
 
 ---
@@ -180,7 +196,7 @@ npx @eximia-ventures/claude-code-toolkit doctor
 ```
   ─── Diagnóstico ───
 
-  ✓ Manifest encontrado (v4.0.0)
+  ✓ Manifest encontrado (v5.1.0)
   ✓ Diretório ~/.claude/ existe
   ✓ settings.json contém statusLine
   ✓ statusline.sh existe e é executável
@@ -189,7 +205,7 @@ npx @eximia-ventures/claude-code-toolkit doctor
   ✓ Node.js v25.6.0
   ✓ Handoff commands encontrados (7 de 7)
   ✓ AIOS Core instalado no projeto
-  ✓ Skill /aios-integrate instalada
+  ✓ 7 Skills AIOS instaladas (integrate, story, epic, qa, publish, bootstrap, help)
 
   ✓ Tudo OK! (10 verificações passaram)
 ```
@@ -212,7 +228,7 @@ npx @eximia-ventures/claude-code-toolkit update meter
 ```
   ─── Atualização ───
 
-  ℹ Instalação encontrada (v4.0.0, 3 módulos)
+  ℹ Instalação encontrada (v5.1.0, 4 módulos)
 
   ─── Statusline ───
 
@@ -225,9 +241,9 @@ npx @eximia-ventures/claude-code-toolkit update meter
 
   ─── AIOS Framework ───
 
-  ✓ Skill /aios-integrate já atualizada
+  ✓ 7 Skills AIOS atualizadas (integrate, story, epic, qa, publish, bootstrap, help)
 
-  ✓ Atualização completa (3 atualizado(s), 0 já em dia)
+  ✓ Atualização completa (4 atualizado(s), 0 já em dia)
 ```
 
 ### `uninstall`
@@ -290,26 +306,147 @@ Para quem usa o [Synkra AIOS](https://github.com/eximIA-Ventures) — framework
 
 **AIOS Core** — Instala/atualiza o framework via `npx aios-core install`
 
-**Skill `/aios-integrate`** — Slash command para o Claude Code que funciona como gerenciador de artefatos:
+**7 Skills AIOS** — Slash commands com wizards interativos para o Claude Code:
+
+| Skill | Descrição |
+|-------|-----------|
+| `/aios-integrate` | Gerenciar artefatos (agents/squads) — importar, listar, exportar |
+| `/aios-story` | Operações de story (criar, validar, desenvolver, QA gate) |
+| `/aios-epic` | Gestão de epics (criar, executar, acompanhar status) |
+| `/aios-qa` | QA toolkit (scan, gate, loop, testes, security audit) |
+| `/aios-publish` | Release management (version bump, changelog, publish) |
+| `/aios-bootstrap` | Setup de projeto (greenfield, brownfield, team config, GitHub) |
+| `/aios-help` | Guia de comandos AIOS (reference, busca, workflows) |
 
 ```mermaid
 flowchart LR
-    A["/aios-integrate"] --> B{Ação}
-    B --> C["Integrar artefato\nexterno"]
-    B --> D["Listar artefatos\ninstalados"]
-    B --> E["Exportar\nartefatos"]
+    A["AIOS Skills"] --> B["/aios-story\n/aios-epic"]
+    A --> C["/aios-qa\n/aios-publish"]
+    A --> D["/aios-bootstrap\n/aios-integrate"]
+    A --> E["/aios-help"]
+
+    B --> F["Criar, validar,\ndesenvolver stories\ne epics"]
+    C --> G["QA gate, loop,\nrelease management"]
+    D --> H["Setup de projeto,\ngerenciar artefatos"]
+    E --> I["Referência completa\nde comandos AIOS"]
+
+    style A fill:#5B4FE5,color:#fff,stroke:none
+    style F fill:#f59e0b,color:#000,stroke:none
+    style G fill:#3b82f6,color:#fff,stroke:none
+    style H fill:#22c55e,color:#fff,stroke:none
+    style I fill:#8b5cf6,color:#fff,stroke:none
+```
+
+---
 
-    C --> C1["Agent .md/.yaml"]
-    C --> C2["Squad folder"]
+## Squad Arsenal
 
-    C1 --> F[".codex/agents/\n.antigravity/agents/\n.agent/workflows/\nagents.csv\nslash commands"]
+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.
 
-    C2 --> G["./squads/\nagents.csv\nslash commands"]
+### Squad Forge 🔥
 
-    style A fill:#5B4FE5,color:#fff,stroke:none
-    style C fill:#f59e0b,color:#000,stroke:none
-    style D fill:#3b82f6,color:#fff,stroke:none
-    style E fill:#22c55e,color:#fff,stroke:none
+> **"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
 ```
 
 ---
@@ -329,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
@@ -338,11 +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         # Slash command para Claude Code
+├── 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
 ```
 
 ---
@@ -445,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