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

package/assets/skill/aios-story.md

@@ -0,0 +1,398 @@
+# /aios-story — Operações de Story AIOS
+
+Você é um assistente especializado em gerenciar o ciclo de vida de stories no AIOS Framework.
+
+## Instruções
+
+Quando o usuário executar `/aios-story`, apresente o menu principal:
+
+### Menu Principal
+
+```
+📋 AIOS Story Manager
+
+Escolha uma operação:
+
+  1. Criar nova story
+  2. Validar story
+  3. Desenvolver story
+  4. QA Gate
+  5. Ver status de uma story
+  6. Próxima ação (auto-detectar)
+
+  0. Sair
+
+Digite o número da opção:
+```
+
+Aguarde a resposta do usuário antes de prosseguir.
+
+---
+
+## Opção 1: Criar Nova Story (@sm)
+
+### Wizard de Criação
+
+1. **Pergunte o contexto:**
+   ```
+   📝 Criar Nova Story
+
+   Preciso de algumas informações:
+
+   1. Qual é o Epic ID ou caminho do PRD?
+      (ex: epic-001, docs/prd/meu-prd.md)
+   ```
+
+2. **Busque stories existentes:**
+   - Procure em `docs/stories/` por stories já criadas para este epic
+   - Liste as existentes:
+   ```
+   Stories existentes para este epic:
+     1. 1.1.story.md — Setup inicial (Done)
+     2. 1.2.story.md — Auth module (InProgress)
+     3. 1.3.story.md — API endpoints (Ready)
+
+   A próxima story será: 1.4.story.md
+   ```
+
+3. **Confirme antes de criar:**
+   ```
+   Confirmar criação?
+     Epic: {epic-id}
+     Story: {next-number}
+     Base: PRD/Epic acima
+
+   (s/n)
+   ```
+
+4. **Execute:**
+   - Ative o agent @sm
+   - Leia e siga a task `.aios-core/development/tasks/create-next-story.md`
+   - Execute conforme definido na task
+
+5. **Relatório:**
+   ```
+   ✅ Story criada com sucesso!
+
+     Arquivo: docs/stories/{epicNum}.{storyNum}.story.md
+     Status: Draft
+     Próximo passo: Validar com /aios-story → opção 2
+
+   Deseja voltar ao menu principal? (s/n)
+   ```
+
+---
+
+## Opção 2: Validar Story (@po)
+
+### Wizard de Validação
+
+1. **Liste stories em Draft:**
+   ```
+   📋 Stories disponíveis para validação (status: Draft):
+
+     1. 1.4.story.md — {título}
+     2. 2.1.story.md — {título}
+
+   Selecione o número da story (ou 0 para voltar):
+   ```
+
+2. **Se nenhuma story Draft encontrada:**
+   ```
+   ℹ️  Nenhuma story com status Draft encontrada.
+
+   Dica: Use a opção 1 para criar uma nova story primeiro.
+
+   Voltando ao menu principal...
+   ```
+
+3. **Execute a validação:**
+   - Ative o agent @po
+   - Leia e siga a task `.aios-core/development/tasks/validate-next-story.md`
+   - Aplique o checklist de 10 pontos:
+
+   ```
+   🔍 Validação — Checklist 10 Pontos
+
+     1. ☐ Título claro e objetivo
+     2. ☐ Descrição completa (problema/necessidade)
+     3. ☐ Critérios de aceite testáveis (Given/When/Then)
+     4. ☐ Escopo bem definido (IN e OUT)
+     5. ☐ Dependências mapeadas
+     6. ☐ Estimativa de complexidade
+     7. ☐ Valor de negócio claro
+     8. ☐ Riscos documentados
+     9. ☐ Critérios de Done definidos
+    10. ☐ Alinhamento com PRD/Epic
+
+   Avaliando...
+   ```
+
+4. **Resultado:**
+   ```
+   📊 Resultado da Validação
+
+     Story: {story-file}
+     Score: {N}/10
+     Veredicto: {GO ✅ | NO-GO ❌}
+
+     Detalhes:
+       ✅ 1. Título claro e objetivo
+       ✅ 2. Descrição completa
+       ❌ 3. AC não testáveis — faltam Given/When/Then
+       ...
+
+     {Se GO}: Status atualizado: Draft → Ready
+     {Se NO-GO}: Correções necessárias:
+       - Item 3: Reescrever AC no formato Given/When/Then
+       - Item 8: Adicionar seção de riscos
+
+   Deseja voltar ao menu principal? (s/n)
+   ```
+
+---
+
+## Opção 3: Desenvolver Story (@dev)
+
+### Wizard de Desenvolvimento
+
+1. **Liste stories Ready:**
+   ```
+   🚀 Stories disponíveis para desenvolvimento (status: Ready):
+
+     1. 1.3.story.md — {título}
+     2. 1.4.story.md — {título}
+
+   Selecione o número da story (ou 0 para voltar):
+   ```
+
+2. **Selecione o modo de execução:**
+   ```
+   ⚙️  Modo de Execução
+
+     1. Interactive (default) — Confirmações em pontos-chave (5-10 prompts)
+     2. YOLO — Autônomo, decisões logadas (0-1 prompts)
+     3. Pre-Flight — Perguntas upfront, execução zero-ambiguidade (10-15 prompts)
+
+   Selecione o modo:
+   ```
+
+3. **Confirme:**
+   ```
+   Confirmar desenvolvimento?
+     Story: {story-file}
+     Modo: {modo selecionado}
+     Agent: @dev
+
+   (s/n)
+   ```
+
+4. **Execute:**
+   - Ative o agent @dev
+   - Leia e siga a task `.aios-core/development/tasks/dev-develop-story.md`
+   - Atualize status: Ready → InProgress
+   - Execute no modo selecionado
+   - Aplique CodeRabbit self-healing se configurado (max 2 iterações)
+
+5. **Relatório:**
+   ```
+   ✅ Desenvolvimento concluído!
+
+     Story: {story-file}
+     Status: InProgress
+     Modo: {modo}
+     Arquivos modificados: {N}
+     CodeRabbit: {N} issues auto-corrigidas
+
+     Próximo passo: QA Gate com /aios-story → opção 4
+
+   Deseja voltar ao menu principal? (s/n)
+   ```
+
+---
+
+## Opção 4: QA Gate (@qa)
+
+### Wizard de QA
+
+1. **Liste stories InProgress:**
+   ```
+   🔍 Stories disponíveis para QA (status: InProgress):
+
+     1. 1.3.story.md — {título}
+
+   Selecione o número da story (ou 0 para voltar):
+   ```
+
+2. **Execute o QA Gate:**
+   - Ative o agent @qa
+   - Leia e siga a task `.aios-core/development/tasks/qa-gate.md`
+   - Execute os 7 checks:
+
+   ```
+   🏥 QA Gate — 7 Quality Checks
+
+     1. ☐ Code review (padrões, legibilidade, manutenibilidade)
+     2. ☐ Unit tests (cobertura adequada, todos passando)
+     3. ☐ Acceptance criteria (todos atendidos)
+     4. ☐ No regressions (funcionalidade existente preservada)
+     5. ☐ Performance (dentro dos limites aceitáveis)
+     6. ☐ Security (OWASP básico verificado)
+     7. ☐ Documentation (atualizada se necessário)
+
+   Executando verificações...
+   ```
+
+3. **Resultado:**
+   ```
+   📊 Resultado do QA Gate
+
+     Story: {story-file}
+     Veredicto: {PASS ✅ | CONCERNS ⚠️ | FAIL ❌ | WAIVED 🟡}
+
+     Checks:
+       ✅ 1. Code review — OK
+       ✅ 2. Unit tests — 95% cobertura, todos passando
+       ✅ 3. Acceptance criteria — 5/5 atendidos
+       ✅ 4. No regressions — OK
+       ⚠️ 5. Performance — query lenta detectada (não bloqueante)
+       ✅ 6. Security — OWASP OK
+       ✅ 7. Documentation — README atualizado
+
+     {Se PASS}: Status atualizado: InProgress → InReview → Done
+     {Se CONCERNS}: Aprovado com observações documentadas
+     {Se FAIL}: Retornar para @dev com feedback específico
+     {Se WAIVED}: Aprovado com waiver documentado
+
+     Issues encontradas: {N}
+       - [MEDIUM] Query N+1 em listUsers (documentado como tech debt)
+
+   Deseja voltar ao menu principal? (s/n)
+   ```
+
+---
+
+## Opção 5: Ver Status de uma Story
+
+### Wizard de Status
+
+1. **Pergunte o caminho:**
+   ```
+   📄 Ver Status da Story
+
+   Informe o caminho da story:
+     (ex: docs/stories/1.3.story.md)
+
+   Ou digite "listar" para ver todas as stories disponíveis.
+   ```
+
+2. **Se "listar":**
+   - Busque todos os arquivos `*.story.md` em `docs/stories/`
+   - Mostre lista numerada para seleção
+
+3. **Leia e exiba o status:**
+   ```
+   📊 Status da Story
+
+     Arquivo: {path}
+     Título: {título}
+     Status: {status} {emoji}
+     Epic: {epic-ref}
+
+     Acceptance Criteria:
+       ✅ AC1 — {descrição}
+       ☐ AC2 — {descrição}
+       ☐ AC3 — {descrição}
+
+     Fase Atual: {fase no ciclo}
+     Próximo Passo: {ação sugerida}
+
+     Histórico:
+       - Draft (criado em {data})
+       - Ready (validado em {data})
+       - InProgress (desde {data})
+
+   Deseja voltar ao menu principal? (s/n)
+   ```
+
+---
+
+## Opção 6: Próxima Ação (Auto-Detectar)
+
+### Wizard de Auto-Detecção
+
+1. **Busque a story ativa mais recente:**
+   - Procure stories com status InProgress, Ready, ou Draft (nessa ordem de prioridade)
+   - Se múltiplas, pegue a mais recente
+
+2. **Analise e sugira:**
+   ```
+   🎯 Próxima Ação Sugerida
+
+     Story detectada: {story-file}
+     Status atual: {status}
+
+     Sugestão: {ação baseada no status}
+       - Draft → "Validar esta story (opção 2)"
+       - Ready → "Iniciar desenvolvimento (opção 3)"
+       - InProgress → "Executar QA Gate (opção 4)"
+       - InReview → "Aguardando push pelo @devops"
+       - Done → "Criar próxima story (opção 1)"
+
+   Deseja executar a ação sugerida? (s/n)
+   ```
+
+3. **Se sim:** Execute a opção correspondente
+4. **Se não:** Volte ao menu principal
+
+---
+
+## 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
+- Nunca execute ações destrutivas sem confirmação
+
+### Tasks AIOS
+Todas as operações devem referenciar e seguir as tasks oficiais em `.aios-core/development/tasks/`:
+- `create-next-story.md` — criação de story
+- `validate-next-story.md` — validação com checklist 10 pontos
+- `dev-develop-story.md` — desenvolvimento com modos
+- `qa-gate.md` — QA gate com 7 checks
+- `story-checkpoint.md` — checkpoint entre operações
+- `next.md` — detecção de próxima ação
+
+### Agents
+Cada operação ativa o agent correto:
+- Criar → @sm (Scrum Master)
+- Validar → @po (Product Owner)
+- Desenvolver → @dev (Developer)
+- QA Gate → @qa (QA Engineer)
+
+### Story Lifecycle
+Respeite a progressão de status:
+```
+Draft → Ready → InProgress → InReview → Done
+```
+
+Nunca pule fases. Se uma story está em Draft, ela precisa ser validada antes de ser desenvolvida.
+
+### Feedback Visual
+- Use emojis consistentes para status: ✅ Done, 🚀 InProgress, 📋 Ready, 📝 Draft, ❌ Fail
+- Mostre progresso durante operações longas
+- Sempre exiba relatório ao final de cada operação
+
+### Sugestões Contextuais
+
+Ao final de cada operação, além de perguntar se quer voltar ao menu, sugira skills relacionadas:
+
+| Após operação | Sugerir |
+|---------------|---------|
+| Criar story (opção 1) | "Dica: Use `/aios-story` opção 2 para validar a story criada" |
+| Validar story GO (opção 2) | "Dica: Use `/aios-story` opção 3 para iniciar o desenvolvimento" |
+| Validar story NO-GO (opção 2) | "Dica: Corrija os itens e execute `/aios-story` opção 2 novamente" |
+| Desenvolver story (opção 3) | "Dica: Use `/aios-qa` opção 1 para um quick scan, ou `/aios-story` opção 4 para QA Gate formal" |
+| QA Gate PASS (opção 4) | "Dica: Use `/aios-publish` opção 3 para pre-push quality gate" |
+| QA Gate FAIL (opção 4) | "Dica: Use `/aios-qa` opção 3 (QA Loop) para iterar fix → re-review" |
+| Perdido | "Dica: Use `/aios-help` para ver todos os comandos disponíveis" |

package/package.json

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

package/src/commands/doctor.js

@@ -123,14 +123,17 @@ async function runDoctor() {
     check('AIOS Core instalado no projeto', true);
     ok++;
 
-    // Check aios-integrate skill
-    const skillPath = path.join(process.cwd(), '.claude', 'commands', 'aios-integrate.md');
-    if (await fs.pathExists(skillPath)) {
-      check('Skill /aios-integrate instalada', true);
-      ok++;
-    } else {
-      check('Skill /aios-integrate não encontrada', false);
-      issues++;
+    // Check all AIOS skills
+    const { SKILLS } = require('../modules/aios');
+    for (const skill of SKILLS) {
+      const skillPath = path.join(process.cwd(), '.claude', 'commands', skill.src);
+      if (await fs.pathExists(skillPath)) {
+        check(`Skill ${skill.name} instalada`, true);
+        ok++;
+      } else {
+        check(`Skill ${skill.name} não encontrada`, false);
+        issues++;
+      }
     }
   } else {
     logger.dim('  - AIOS Core não instalado (opcional)');

package/src/commands/update.js

@@ -98,7 +98,7 @@ async function updateModule(name, manifest) {
     case 'aios': {
       const opts = {
         installAiosCore: manifest.aiosCore || false,
-        installAiosSkill: true
+        installAiosSkills: manifest.aiosSkills || require('../modules/aios').SKILLS.map(s => s.name)
       };
       const result = await modules.aios.module.install(opts);
       return 'updated';

package/src/installer.js

@@ -95,31 +95,35 @@ async function runInstaller() {
   ]);
 
   if (useAios) {
-    const { aiosChoices } = await inquirer.prompt([
+    const { SKILLS } = require('./modules/aios');
+
+    const { installCore } = await inquirer.prompt([
+      {
+        type: 'confirm',
+        name: 'installCore',
+        message: 'Instalar/Atualizar AIOS Core?',
+        default: false
+      }
+    ]);
+
+    const { selectedSkills } = await inquirer.prompt([
       {
         type: 'checkbox',
-        name: 'aiosChoices',
-        message: 'Selecione as opções AIOS:',
-        choices: [
-          {
-            name: 'Instalar/Atualizar AIOS Core',
-            value: 'core',
-            checked: false
-          },
-          {
-            name: 'Instalar Skill /aios-integrate (integrar e gerenciar artefatos)',
-            value: 'skill',
-            checked: false
-          }
-        ]
+        name: 'selectedSkills',
+        message: 'Selecione as Skills AIOS:',
+        choices: SKILLS.map(s => ({
+          name: `${s.name.padEnd(18)} — ${s.desc}`,
+          value: s.name,
+          checked: false
+        }))
       }
     ]);
 
-    if (aiosChoices.length > 0) {
+    if (installCore || selectedSkills.length > 0) {
       selectedModules.push('aios');
       aiosOptions = {
-        installAiosCore: aiosChoices.includes('core'),
-        installAiosSkill: aiosChoices.includes('skill')
+        installAiosCore: installCore,
+        installAiosSkills: selectedSkills
       };
     }
   }
@@ -174,6 +178,9 @@ async function runInstaller() {
     if (aiosOptions.installAiosCore && result.core?.installed) {
       manifest.aiosCore = true;
     }
+    if (aiosOptions.installAiosSkills) {
+      manifest.aiosSkills = aiosOptions.installAiosSkills;
+    }
   }
 
   // Save manifest
@@ -188,8 +195,8 @@ async function runInstaller() {
   if (selectedModules.includes('statusline')) {
     logger.info('Reinicie o Claude Code para ver a statusline.');
   }
-  if (selectedModules.includes('aios') && aiosOptions.installAiosSkill) {
-    logger.info('Use /aios-integrate para integrar e gerenciar artefatos AIOS.');
+  if (selectedModules.includes('aios') && aiosOptions.installAiosSkills?.length > 0) {
+    logger.info(`Skills AIOS instaladas: ${aiosOptions.installAiosSkills.join(', ')}`);
   }
   logger.blank();
 }

package/src/modules/aios.js

@@ -6,7 +6,15 @@ const fs = require('fs-extra');
 const { installFile } = require('../utils/file-installer');
 const logger = require('../utils/logger');
 
-const SKILL_SRC = path.join(__dirname, '..', '..', 'assets', 'skill', 'aios-integrate.md');
+const SKILLS = [
+  { src: 'aios-integrate.md', name: '/aios-integrate', desc: 'Gerenciar artefatos (agents/squads)' },
+  { src: 'aios-story.md',     name: '/aios-story',     desc: 'Operações de story (criar, validar, desenvolver, QA)' },
+  { src: 'aios-epic.md',      name: '/aios-epic',      desc: 'Gestão de epics (criar, executar, status)' },
+  { src: 'aios-qa.md',        name: '/aios-qa',        desc: 'QA toolkit (scan, gate, loop, testes, security)' },
+  { src: 'aios-publish.md',   name: '/aios-publish',   desc: 'Release management (version, changelog, publish)' },
+  { src: 'aios-bootstrap.md', name: '/aios-bootstrap', desc: 'Setup de projeto (greenfield, brownfield, team, GitHub)' },
+  { src: 'aios-help.md',      name: '/aios-help',      desc: 'Guia de comandos AIOS (reference, busca, workflows)' },
+];
 
 async function installCore({ targetDir } = {}) {
   const cwd = targetDir || process.cwd();
@@ -27,25 +35,36 @@ async function installCore({ targetDir } = {}) {
   }
 }
 
-async function installSkill({ targetDir } = {}) {
+async function installSkills({ targetDir, skills } = {}) {
   const cwd = targetDir || process.cwd();
   const commandsDir = path.join(cwd, '.claude', 'commands');
-  const dest = path.join(commandsDir, 'aios-integrate.md');
-
   await fs.ensureDir(commandsDir);
 
-  const result = await installFile(SKILL_SRC, dest);
+  const skillsToInstall = skills
+    ? SKILLS.filter(s => skills.includes(s.name))
+    : SKILLS;
+
+  const results = [];
+
+  for (const skill of skillsToInstall) {
+    const src = path.join(__dirname, '..', '..', 'assets', 'skill', skill.src);
+    const dest = path.join(commandsDir, skill.src);
+
+    const result = await installFile(src, dest);
+
+    if (result.action === 'installed') {
+      logger.success(`Skill ${skill.name} instalada`);
+    } else {
+      logger.success(`Skill ${skill.name} já atualizada`);
+    }
 
-  if (result.action === 'installed') {
-    logger.success('Skill /aios-integrate instalada');
-  } else {
-    logger.success('Skill /aios-integrate já atualizada');
+    results.push({ skill: skill.name, path: dest, action: result.action });
   }
 
-  return { installed: true, path: dest };
+  return { installed: true, results };
 }
 
-async function install({ installAiosCore = true, installAiosSkill = true, targetDir } = {}) {
+async function install({ installAiosCore = true, installAiosSkills, targetDir } = {}) {
   logger.section('AIOS Framework');
 
   const results = {};
@@ -54,8 +73,8 @@ async function install({ installAiosCore = true, installAiosSkill = true, target
     results.core = await installCore({ targetDir });
   }
 
-  if (installAiosSkill) {
-    results.skill = await installSkill({ targetDir });
+  if (installAiosSkills && installAiosSkills.length > 0) {
+    results.skills = await installSkills({ targetDir, skills: installAiosSkills });
   }
 
   return results;
@@ -65,10 +84,12 @@ async function uninstall({ targetDir } = {}) {
   const cwd = targetDir || process.cwd();
   const removed = [];
 
-  const skillPath = path.join(cwd, '.claude', 'commands', 'aios-integrate.md');
-  if (await fs.pathExists(skillPath)) {
-    await fs.remove(skillPath);
-    removed.push(skillPath);
+  for (const skill of SKILLS) {
+    const skillPath = path.join(cwd, '.claude', 'commands', skill.src);
+    if (await fs.pathExists(skillPath)) {
+      await fs.remove(skillPath);
+      removed.push(skillPath);
+    }
   }
 
   return removed;
@@ -76,9 +97,7 @@ async function uninstall({ targetDir } = {}) {
 
 function getManifestEntries({ targetDir } = {}) {
   const cwd = targetDir || process.cwd();
-  return [
-    path.join(cwd, '.claude', 'commands', 'aios-integrate.md')
-  ];
+  return SKILLS.map(s => path.join(cwd, '.claude', 'commands', s.src));
 }
 
-module.exports = { install, uninstall, getManifestEntries };
+module.exports = { install, uninstall, getManifestEntries, SKILLS };