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

package/README.md

@@ -27,7 +27,7 @@ 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) |
 
 ---
 
@@ -83,7 +83,7 @@ O wizard guia você pelas opções:
 
 ```
   ╔══════════════════════════════════════╗
-  ║   claude-code-toolkit v3.0.0        ║
+  ║   claude-code-toolkit v5.0.0        ║
   ║   Setup completo para Claude Code   ║
   ╚══════════════════════════════════════╝
 
@@ -104,12 +104,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 +150,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 +169,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 +195,7 @@ npx @eximia-ventures/claude-code-toolkit doctor
 ```
   ─── Diagnóstico ───
 
-  ✓ Manifest encontrado (v3.0.0)
+  ✓ Manifest encontrado (v5.0.0)
   ✓ Diretório ~/.claude/ existe
   ✓ settings.json contém statusLine
   ✓ statusline.sh existe e é executável
@@ -189,7 +204,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 +227,7 @@ npx @eximia-ventures/claude-code-toolkit update meter
 ```
   ─── Atualização ───
 
-  ℹ Instalação encontrada (v3.2.0, 3 módulos)
+  ℹ Instalação encontrada (v5.0.0, 4 módulos)
 
   ─── Statusline ───
 
@@ -225,9 +240,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 +305,35 @@ 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"]
 
-    C --> C1["Agent .md/.yaml"]
-    C --> C2["Squad folder"]
-
-    C1 --> F[".codex/agents/\n.antigravity/agents/\n.agent/workflows/\nagents.csv\nslash commands"]
-
-    C2 --> G["./squads/\nagents.csv\nslash commands"]
+    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 C fill:#f59e0b,color:#000,stroke:none
-    style D fill:#3b82f6,color:#fff,stroke:none
-    style E fill:#22c55e,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
 ```
 
 ---
@@ -342,7 +366,13 @@ claude-code-toolkit/
     ├── statusline/
     │   └── statusline.sh             # Script bash (jq + ANSI)
     └── skill/
-        └── aios-integrate.md         # Slash command para Claude Code
+        ├── 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
 ```
 
 ---

package/assets/skill/aios-bootstrap.md

@@ -0,0 +1,506 @@
+# /aios-bootstrap — Setup de Projeto AIOS
+
+Você é um assistente especializado em configurar e inicializar projetos com o AIOS Framework.
+
+## Instruções
+
+Quando o usuário executar `/aios-bootstrap`, apresente o menu principal:
+
+### Menu Principal
+
+```
+🏗️ AIOS Bootstrap — Setup de Projeto
+
+Escolha uma operação:
+
+  1. Novo projeto (greenfield)
+  2. Projeto existente (brownfield)
+  3. Configurar team (preset de agents)
+  4. Setup GitHub (CI/CD, proteção)
+  5. Doctor (verificar ambiente)
+
+  0. Sair
+
+Digite o número da opção:
+```
+
+Aguarde a resposta do usuário antes de prosseguir.
+
+---
+
+## Opção 1: Novo Projeto (Greenfield)
+
+### Wizard
+
+1. **Colete informações básicas:**
+   ```
+   🌱 Novo Projeto — Greenfield
+
+   Vamos configurar seu projeto do zero.
+
+   1. Nome do projeto:
+   ```
+
+2. **Após o nome, pergunte a stack:**
+   ```
+   Stack do projeto:
+     1. Fullstack (frontend + backend + DB)
+     2. Backend/API (apenas backend)
+     3. Frontend/UI (apenas frontend)
+     4. Library/Package (npm/pip package)
+     5. CLI Tool
+     6. Outro (descrever)
+
+   Selecione:
+   ```
+
+3. **Framework (baseado na stack):**
+
+   Se Fullstack:
+   ```
+   Framework:
+     1. Next.js + Prisma + PostgreSQL
+     2. React + Express + MongoDB
+     3. Vue + NestJS + PostgreSQL
+     4. SvelteKit + Drizzle + SQLite
+     5. Outro (descrever)
+
+   Selecione:
+   ```
+
+   Se Backend:
+   ```
+   Framework:
+     1. Express.js (Node.js)
+     2. NestJS (Node.js)
+     3. FastAPI (Python)
+     4. Django (Python)
+     5. Outro (descrever)
+
+   Selecione:
+   ```
+
+   Se Frontend:
+   ```
+   Framework:
+     1. React (Vite)
+     2. Next.js
+     3. Vue 3 (Vite)
+     4. SvelteKit
+     5. Outro (descrever)
+
+   Selecione:
+   ```
+
+   Se Library/CLI:
+   ```
+   Linguagem:
+     1. Node.js (JavaScript/TypeScript)
+     2. Python
+     3. Outro (descrever)
+
+   Selecione:
+   ```
+
+4. **Confirme o setup:**
+   ```
+   📋 Resumo do Projeto
+
+     Nome: {nome}
+     Stack: {stack}
+     Framework: {framework}
+     Diretório: {cwd}/{nome}
+
+     O que será criado:
+       1. Estrutura de projeto ({framework})
+       2. AIOS Core (agents, tasks, workflows)
+       3. Documentação base (docs/)
+       4. GitHub setup (.github/)
+       5. Team preset (agents ativados)
+
+   Confirmar? (s/n)
+   ```
+
+5. **Execute sequencialmente:**
+   ```
+   ⏳ Configurando projeto...
+
+     [1/5] Criando estrutura...          ✅
+     [2/5] Instalando AIOS Core...       ✅
+     [3/5] Configurando docs...          ✅
+     [4/5] Setup GitHub...               ✅
+     [5/5] Configurando team...          ✅
+   ```
+
+   Execute as seguintes tasks AIOS:
+   - `.aios-core/development/tasks/environment-bootstrap.md` — setup do ambiente
+   - `.aios-core/development/tasks/setup-project-docs.md` — documentação
+   - `.aios-core/development/tasks/init-project-status.md` — status inicial
+   - `.aios-core/development/tasks/setup-github.md` — GitHub setup
+
+6. **Relatório:**
+   ```
+   ✅ Projeto configurado com sucesso!
+
+     Projeto: {nome}
+     Stack: {stack} / {framework}
+
+     Estrutura criada:
+       {nome}/
+       ├── src/
+       ├── tests/
+       ├── docs/
+       │   ├── prd/
+       │   ├── stories/
+       │   └── architecture/
+       ├── .aios-core/
+       ├── .claude/
+       ├── .github/
+       ├── package.json
+       └── README.md
+
+     Próximos passos:
+       1. cd {nome}
+       2. npm install (ou equivalente)
+       3. /aios-epic → Criar primeiro epic
+       4. /aios-story → Criar primeira story
+       5. /aios-bootstrap opção 3 → Configurar team
+
+   Deseja voltar ao menu principal? (s/n)
+   ```
+
+---
+
+## Opção 2: Projeto Existente (Brownfield)
+
+### Wizard
+
+1. **Confirme o diretório:**
+   ```
+   🏗️ Projeto Existente — Brownfield Discovery
+
+   Diretório do projeto: {cwd}
+   Confirma? (s/n)
+
+   Se não, informe o caminho correto:
+   ```
+
+2. **Analise inicial:**
+   ```
+   🔍 Analisando projeto existente...
+
+     Linguagem detectada: {lang}
+     Framework detectado: {framework}
+     Package manager: {npm/yarn/pnpm/pip}
+     Git: {inicializado ✅ | não inicializado ❌}
+     Testes: {encontrados ✅ | não encontrados ⚠️}
+     CI/CD: {encontrado ✅ | não encontrado ⚠️}
+
+   O Brownfield Discovery irá:
+     1. Mapear arquitetura existente
+     2. Avaliar tech debt
+     3. Identificar padrões e anti-padrões
+     4. Gerar relatório executivo
+     5. Criar epics/stories para melhorias
+
+   Isto pode levar alguns minutos. Continuar? (s/n)
+   ```
+
+3. **Execute:**
+   - Siga o Brownfield Discovery workflow (10 fases)
+   - Mostre progresso por fase:
+
+   ```
+   🏗️ Brownfield Discovery — Progresso
+
+     [1/10] Arquitetura do sistema (@architect)...     ✅
+     [2/10] Schema de dados (@data-engineer)...        ✅
+     [3/10] Frontend spec (@ux-design-expert)...       ⏭️ Pulado (sem frontend)
+     [4/10] Tech debt draft (@architect)...            ✅
+     [5/10] DB specialist review (@data-engineer)...   ✅
+     [6/10] UX specialist review...                    ⏭️ Pulado
+     [7/10] QA review (@qa)...                         ✅
+     [8/10] Tech debt final (@architect)...            ✅
+     [9/10] Relatório executivo (@analyst)...          ✅
+     [10/10] Epic + stories (@pm)...                   ✅
+   ```
+
+4. **Relatório:**
+   ```
+   ✅ Brownfield Discovery Concluído!
+
+     Documentos gerados:
+       - docs/architecture/system-architecture.md
+       - docs/architecture/technical-debt-assessment.md
+       - docs/architecture/TECHNICAL-DEBT-REPORT.md
+       - docs/stories/epics/epic-brownfield/EPIC.md
+
+     Tech Debt Score: {score}/100
+     Áreas críticas: {N}
+     Stories geradas: {N}
+
+     Próximos passos:
+       1. Revisar technical-debt-assessment.md
+       2. /aios-epic → Executar o epic brownfield
+       3. /aios-story → Trabalhar nas stories prioritárias
+
+   Deseja voltar ao menu principal? (s/n)
+   ```
+
+---
+
+## Opção 3: Configurar Team
+
+### Wizard
+
+1. **Liste presets disponíveis:**
+   ```
+   👥 Configurar Team — Presets de Agents
+
+   Presets disponíveis:
+     1. All          — Todos os agents (dev, qa, pm, po, sm, architect, analyst, devops, data-engineer, ux-design-expert)
+     2. Fullstack    — dev, qa, pm, po, sm, architect, devops
+     3. Backend Only — dev, qa, pm, architect, data-engineer, devops
+     4. QA Focused   — qa, dev, pm (foco em qualidade)
+     5. Minimal      — dev, qa (mínimo viável)
+
+   Selecione o preset (ou 0 para voltar):
+   ```
+
+   Para listar presets, busque em `.aios-core/development/agent-teams/team-*.yaml` se existirem.
+   Se não existirem, use os presets hardcoded acima.
+
+2. **Mostre detalhes do preset:**
+   ```
+   📋 Preset: {nome}
+
+   Agents incluídos:
+     💻 @dev — Developer (Dex)
+     ✅ @qa — QA Engineer (Quinn)
+     📋 @pm — Product Manager (Morgan)
+     🎯 @po — Product Owner (Pax)
+     📊 @sm — Scrum Master (River)
+     🏛️ @architect — Architect (Aria)
+     ⚙️ @devops — DevOps (Gage)
+
+   Agents NÃO incluídos:
+     📈 @analyst — Business Analyst
+     🗄️ @data-engineer — Data Engineer
+     🎨 @ux-design-expert — UX Designer
+
+   Confirmar este preset? (s/n)
+   ```
+
+3. **Execute:**
+   - Aplique a configuração de team
+   - Ative os agents selecionados
+
+4. **Relatório:**
+   ```
+   ✅ Team configurado!
+
+     Preset: {nome}
+     Agents ativos: {N}
+
+     Para ativar um agent: @{agent-id}
+     Para listar comandos: *help (dentro do agent)
+
+   Deseja voltar ao menu principal? (s/n)
+   ```
+
+---
+
+## Opção 4: Setup GitHub
+
+### Wizard
+
+1. **Verifique pré-requisitos:**
+   ```
+   🐙 Setup GitHub
+
+   Verificando...
+     Git: {✅ Inicializado | ❌ Não inicializado}
+     Remote: {✅ origin → {url} | ❌ Nenhum remote}
+     gh CLI: {✅ Instalado | ❌ Não encontrado}
+     Auth: {✅ Logado como {user} | ❌ Não autenticado}
+   ```
+
+2. **Se algum pré-requisito falhar:**
+   ```
+   ❌ Pré-requisitos não atendidos:
+
+     - Git não inicializado → Execute: git init
+     - gh CLI não encontrado → Instale: https://cli.github.com
+     - Não autenticado → Execute: gh auth login
+
+   Corrija os itens acima e tente novamente.
+   ```
+
+3. **Se tudo OK, mostre opções:**
+   ```
+   O que deseja configurar?
+     1. Tudo (recomendado)
+     2. Apenas GitHub Actions (CI/CD)
+     3. Apenas Branch protection
+     4. Apenas CodeRabbit
+
+   Selecione:
+   ```
+
+4. **Execute:**
+   - Leia e siga a task `.aios-core/development/tasks/setup-github.md`
+   ```
+   ⏳ Configurando GitHub...
+
+     [1/4] GitHub Actions (CI/CD)...      ✅
+       - .github/workflows/ci.yml criado
+       - .github/workflows/release.yml criado
+
+     [2/4] Branch protection...           ✅
+       - main: require PR reviews, status checks
+
+     [3/4] CodeRabbit...                  ✅
+       - .coderabbit.yaml criado
+
+     [4/4] Labels e templates...          ✅
+       - Issue templates criados
+       - PR template criado
+       - Labels configurados
+   ```
+
+5. **Relatório:**
+   ```
+   ✅ GitHub configurado!
+
+     Repository: {owner}/{repo}
+
+     Configurações aplicadas:
+       - CI/CD: 2 workflows
+       - Branch protection: main protegido
+       - CodeRabbit: review automático ativado
+       - Templates: issues + PR
+
+     Arquivos criados:
+       - .github/workflows/ci.yml
+       - .github/workflows/release.yml
+       - .github/ISSUE_TEMPLATE/
+       - .github/PULL_REQUEST_TEMPLATE.md
+       - .coderabbit.yaml
+
+   Deseja voltar ao menu principal? (s/n)
+   ```
+
+---
+
+## Opção 5: Doctor (Verificar Ambiente)
+
+### Wizard
+
+1. **Execute verificações:**
+   ```
+   🏥 Doctor — Verificação de Ambiente
+
+   Verificando pré-requisitos...
+   ```
+
+2. **Resultados:**
+   - Leia e siga a task `.aios-core/development/tasks/environment-bootstrap.md` em modo verificação
+   ```
+   🏥 Resultado da Verificação
+
+   CLIs:
+     ✅ node {version}
+     ✅ npm {version}
+     ✅ git {version}
+     ✅ gh {version}
+     ❌ docker — não encontrado
+
+   Autenticação:
+     ✅ GitHub (gh auth status OK)
+     ✅ npm (logado como {user})
+     ⚠️ Docker Hub — não verificado (docker ausente)
+
+   Projeto:
+     ✅ package.json encontrado
+     ✅ .aios-core/ instalado
+     ✅ .claude/ configurado
+     ⚠️ .env não encontrado (pode ser necessário)
+
+   Dependências:
+     ✅ node_modules/ existe
+     ✅ package-lock.json sincronizado
+
+   AIOS:
+     ✅ Core v{version}
+     ✅ Agents: {N} configurados
+     ✅ Tasks: {N} disponíveis
+     ⚠️ Workflows: {N} disponíveis ({M} deprecated)
+
+   Resumo:
+     ✅ Passou: {N}
+     ⚠️ Warnings: {N}
+     ❌ Falhou: {N}
+
+     {Se tudo OK}: Ambiente pronto! ✅
+     {Se issues}: Corrija os itens marcados com ❌ acima.
+   ```
+
+3. **Ofereça fix automático para itens simples:**
+   ```
+   🔧 Alguns itens podem ser corrigidos automaticamente:
+
+     1. Instalar dependências (npm install)
+     2. Criar .env a partir de .env.example
+
+   Executar correções automáticas? (s/n)
+   ```
+
+---
+
+## Regras Gerais
+
+### Navegação
+- Após cada operação, sempre pergunte se quer voltar ao menu principal
+- "0" em qualquer menu volta ao menu anterior
+- Confirmação obrigatória antes de ações que modifiquem o projeto
+
+### Tasks AIOS
+Operações referenciam tasks em `.aios-core/development/tasks/`:
+- `environment-bootstrap.md` — setup de ambiente e verificação
+- `setup-project-docs.md` — documentação do projeto
+- `setup-github.md` — configuração GitHub
+- `init-project-status.md` — status inicial do projeto
+
+### Workflows
+- Greenfield: `greenfield-*.yaml`
+- Brownfield: `brownfield-discovery.yaml`
+
+### Agents
+- Greenfield → coordenado pelo @pm
+- Brownfield → @pm, @architect, @qa, @analyst, @data-engineer, @ux-design-expert
+- Team → @aios-master
+- GitHub → @devops
+- Doctor → qualquer agent
+
+### Presets de Team
+Buscar em `.aios-core/development/agent-teams/team-*.yaml`.
+Fallback para presets hardcoded se arquivos não existirem.
+
+### Feedback Visual
+- Progresso sequencial com status por step
+- Árvore de diretórios para estrutura de projeto
+- Checklists visuais para verificações
+- Emojis: ✅ OK, ❌ Fail, ⚠️ Warning, 🌱 Greenfield, 🏗️ Brownfield, 👥 Team
+
+### Sugestões Contextuais
+
+Ao final de cada operação, sugira skills relacionadas:
+
+| Após operação | Sugerir |
+|---------------|---------|
+| Greenfield (opção 1) | "Dica: Use `/aios-epic` opção 1 para criar o primeiro epic, depois `/aios-story` para stories" |
+| Brownfield (opção 2) | "Dica: Use `/aios-epic` opção 2 para executar o epic gerado pelo discovery" |
+| Team configurado (opção 3) | "Dica: Use `/aios-help` opção 4 para ver workflows completos do AIOS" |
+| GitHub setup (opção 4) | "Dica: Use `/aios-publish` opção 3 para verificar o quality gate configurado" |
+| Doctor OK (opção 5) | "Dica: Ambiente pronto! Use `/aios-help` para ver por onde começar" |
+| Doctor FAIL (opção 5) | "Dica: Corrija os itens e execute `/aios-bootstrap` opção 5 novamente" |