adi_dev_workflow 1.1.0 → 1.2.0

package/frameworks/skills/ministack-scope-expert/SKILL.md

@@ -6,7 +6,23 @@ argument-hint: [INTENT aprovada + detalhes tecnicos]
 
 Voce e um **Arquiteto de Software Senior** que transforma INTENTs em especificacoes tecnicas concretas.
 
-Voce domina completamente o framework miniStack e seu foco e **EXCLUSIVAMENTE** na etapa SCOPE — definindo COMO a feature sera implementada, com limites claros do que esta dentro e fora do escopo.
+> **Paths**: Leia `.claude/config/ai-framework-config.yaml` secao `ministack` antes de salvar artefatos. Os paths abaixo sao exemplos — o path real vem do config.
+
+Você domina completamente o framework miniStack e seu foco é **EXCLUSIVAMENTE** na etapa SCOPE — definindo COMO a feature será implementada, com limites claros do que está dentro e fora do escopo.
+
+> **Paths**: Leia `.claude/config/ai-framework-config.yaml` secao `ministack` antes de salvar artefatos. Os paths abaixo sao exemplos — o path real vem do config.
+
+---
+
+# Regra de Acentuação
+
+Todo artefato gerado por esta skill é um documento em português brasileiro. Todo conteúdo textual (títulos, descrições, instruções, regras, mensagens) deve usar acentuação correta do pt-BR:
+
+- Títulos e seções: `Descrição`, `Restrições`, `Instruções`, `Validação`, `Configuração`
+- Corpo do texto: `não`, `é`, `está`, `será`, `também`, `através`, `após`, `até`, `único`
+- Termos técnicos em português: `autenticação`, `paginação`, `migração`, `funcionalidade`
+
+Apenas nomes de código (funções, variáveis, structs, pacotes) permanecem sem acento por serem em inglês.
 
 ---
 

package/frameworks/skills/sdd-prd-expert/SKILL.md

@@ -23,6 +23,20 @@ Foco: **O QUÊ** e **POR QUÊ**. Questões de COMO → registrar como Premissa/R
 
 Estilo: Objetivo. Estruturado. Sem redundância.
 
+> **Paths**: Leia `.claude/config/ai-framework-config.yaml` secao `sdd` antes de salvar artefatos. Os paths abaixo sao exemplos — o path real vem do config.
+
+---
+
+# Regra de Acentuação
+
+Todo artefato gerado por esta skill é um documento em português brasileiro. Todo conteúdo textual (títulos, descrições, instruções, regras, mensagens) deve usar acentuação correta do pt-BR:
+
+- Títulos e seções: `Descrição`, `Restrições`, `Instruções`, `Validação`, `Configuração`
+- Corpo do texto: `não`, `é`, `está`, `será`, `também`, `através`, `após`, `até`, `único`
+- Termos técnicos em português: `autenticação`, `paginação`, `migração`, `funcionalidade`
+
+Apenas nomes de código (funções, variáveis, structs, pacotes) permanecem sem acento por serem em inglês.
+
 ---
 
 # Framework SDD — Etapa PRD

package/frameworks/skills/sdd-task-plan-expert/SKILL.md

@@ -14,6 +14,20 @@ Sua missão é transformar um SPEC_TECH aprovado em:
 
 Seu foco é **EXCLUSIVAMENTE** no **COMO executar** — decomposição técnica de engenharia. Você transforma especificações técnicas em planos de execução granulares, sem ambiguidade, prontos para serem executados por desenvolvedores ou agentes de IA.
 
+> **Paths**: Leia `.claude/config/ai-framework-config.yaml` secao `sdd` antes de salvar artefatos. Os paths abaixo sao exemplos — o path real vem do config.
+
+---
+
+# Regra de Acentuação
+
+Todo artefato gerado por esta skill é um documento em português brasileiro. Todo conteúdo textual (títulos, descrições, instruções, regras, mensagens) deve usar acentuação correta do pt-BR:
+
+- Títulos e seções: `Descrição`, `Restrições`, `Instruções`, `Validação`, `Configuração`
+- Corpo do texto: `não`, `é`, `está`, `será`, `também`, `através`, `após`, `até`, `único`
+- Termos técnicos em português: `autenticação`, `paginação`, `migração`, `funcionalidade`
+
+Apenas nomes de código (funções, variáveis, structs, pacotes) permanecem sem acento por serem em inglês.
+
 ---
 
 # Framework SDD — Etapa TASK PLAN

package/frameworks/skills/taskcard-expert/SKILL.md

@@ -6,7 +6,23 @@ argument-hint: [pergunta, contexto ou caminho da taskcard]
 
 Voce e um **Especialista no Framework TaskCard** — o sistema de planejamento e execucao de tasks deste projeto.
 
-Voce domina completamente o framework: template, regras, guardrails, convencoes de nomenclatura, estrutura de diretorios e fluxos de geracao/execucao.
+> **Paths**: Leia `.claude/config/ai-framework-config.yaml` secao `taskcard` antes de salvar artefatos. Os paths abaixo sao exemplos — o path real vem do config.
+
+Você domina completamente o framework: template, regras, guardrails, convenções de nomenclatura, estrutura de diretórios e fluxos de geração/execução.
+
+> **Paths**: Leia `.claude/config/ai-framework-config.yaml` secao `taskcard` antes de salvar artefatos. Os paths abaixo sao exemplos — o path real vem do config.
+
+---
+
+# Regra de Acentuação
+
+Todo artefato gerado por esta skill é um documento em português brasileiro. Todo conteúdo textual (títulos, descrições, instruções, regras, mensagens) deve usar acentuação correta do pt-BR:
+
+- Títulos e seções: `Descrição`, `Restrições`, `Instruções`, `Validação`, `Configuração`
+- Corpo do texto: `não`, `é`, `está`, `será`, `também`, `através`, `após`, `até`, `único`
+- Termos técnicos em português: `autenticação`, `paginação`, `migração`, `funcionalidade`
+
+Apenas nomes de código (funções, variáveis, structs, pacotes) permanecem sem acento por serem em inglês.
 
 ---
 
@@ -60,15 +76,18 @@ Se `project-profile.md` NAO existir, execute `/generate-project-profile` antes d
 
 ---
 
-## Secao 10 (Testes): Delegacao ao qa-staff-engineer
+## Seção 10 (Testes): Delegação ao qa-staff-engineer
+
+A seção 10 (Testes) NÃO é preenchida diretamente pelo gerador da TaskCard. O fluxo é:
+
+1. O orquestrador (`generate-taskcard`) dispara o agente `qa-staff-engineer` (modo GERAR_TESTES)
+2. O agente retorna um **JSON estruturado** com casos de teste, rastreabilidade e padrões detectados
+3. O orquestrador **transforma o JSON** no formato do template oficial (subseções 10.1 a 10.6) e edita o arquivo
 
-A secao 10 (Testes) NAO e preenchida pelo gerador da TaskCard. Ela e delegada ao agente `qa-staff-engineer` (modo GERAR_TESTES) que:
-- Analisa o codebase, testes existentes e padroes do projeto
-- Mapeia criterios de aceite (secao 9) para testes
-- Preenche as subsecoes 10.1 a 10.6 diretamente no arquivo da TaskCard
+O agente QA é compartilhado entre processos (SDD, miniStack, TaskCard) e sempre retorna JSON — a adaptação ao formato do template é responsabilidade do orquestrador.
 
-> **Nunca gere uma TaskCard sem disparar o qa-staff-engineer para preencher a secao 10.**
-> Salve o arquivo com secoes 1-9 e 11 primeiro, depois delegue a secao 10 ao agente.
+> **Nunca gere uma TaskCard sem disparar o qa-staff-engineer para a seção 10.**
+> Salve o arquivo com seções 1-9 e 11 primeiro, depois dispare o agente e formate o resultado.
 
 ---
 
@@ -178,9 +197,9 @@ Contexto do usuario
   -> Preencher template (secoes 1-9 e 11)
   -> Remover todos os comentarios <!-- LLM-ONLY: ... --> do conteudo antes de salvar
   -> Salvar em docs/<feature>/vN/ (GERAR ARQUIVOS IMEDIATAMENTE, SEM PEDIR APROVACAO)
-  -> Delegar secao 10 (Testes) ao agente qa-staff-engineer (modo GERAR_TESTES)
-     O agente analisa o codebase, testes existentes e criterios de aceite (secao 9)
-     e preenche as subsecoes 10.1 a 10.6 diretamente no arquivo da TaskCard
+  -> Disparar qa-staff-engineer (modo GERAR_TESTES) → recebe JSON
+  -> Transformar JSON no formato do template (subseções 10.1 a 10.6)
+  -> Editar arquivo da TaskCard com a seção 10 formatada
   -> Se multiplas: gerar task-plan.md
   -> Apresentar resumo curto do que foi criado (arquivos gerados, IDs, nomes)
 ```

package/frameworks/templates/prompt_template.md

@@ -0,0 +1,207 @@
+# 🎯 Prompt Template 5 Estrelas
+
+> **Como usar:** Preencha cada seção abaixo com as informações específicas da sua tarefa. Delete as dicas entre colchetes após preencher.
+
+> 💡 **Novo!** Seção **DEVE/NÃO DEVE** adicionada para estabelecer limites claros e evitar comportamentos indesejados da IA.
+
+---
+
+## 1. 🌍 Contexto
+
+[Descreva o ambiente técnico, stack, público e restrições relevantes]
+
+**Linguagem/Framework:**
+[Ex: Python 3.11 com FastAPI / Go com Gin / React com TypeScript]
+
+**Arquitetura/Padrão:**
+[Ex: Clean Architecture / Arquitetura em camadas / MVC / Microserviços]
+
+**Público-alvo:**
+[Ex: Desenvolvedores backend / Equipe de frontend / Arquitetos de software]
+
+**Limitações/Restrições:**
+[Ex: Não pode usar bibliotecas externas / Deve ser compatível com PostgreSQL 14 / Budget limitado de memória]
+
+---
+
+## 2. 🎯 Objetivo
+
+[Descreva claramente o que você deseja obter da IA]
+
+**O que precisa ser entregue:**
+[Ex: Implementar feature de autenticação JWT / Criar testes unitários / Refatorar código legado]
+
+**Propósito da tarefa:**
+[Ex: Melhorar segurança / Aumentar cobertura de testes / Facilitar manutenção]
+
+**Resultado esperado:**
+[Ex: Código funcional / Documentação técnica / Plano de implementação]
+
+---
+
+## 3. ⚙️ Instruções Específicas
+
+[Defina COMO a IA deve construir a resposta]
+
+**Detalhes técnicos:**
+- [Ex: Usar pgx/v5 para conexão com banco]
+- [Ex: Implementar validação de entrada com tags do Gin]
+- [Ex: Seguir padrão de nomenclatura do projeto]
+
+**Restrições:**
+- [Ex: NÃO usar bibliotecas ORM]
+- [Ex: NÃO modificar arquivos de configuração existentes]
+- [Ex: Manter compatibilidade com API v1]
+
+**Estrutura lógica:**
+- [Ex: Separar camadas: handler → service → repository]
+- [Ex: Implementar tratamento de erros em cada camada]
+- [Ex: Adicionar logs estruturados]
+
+---
+
+## 4. ✓ Regras: DEVE / NÃO DEVE
+
+[Defina limites claros do que a IA DEVE e NÃO DEVE fazer]
+
+### ✅ DEVE:
+- [Ex: DEVE usar Context para operações de I/O]
+- [Ex: DEVE seguir o padrão de nomenclatura do projeto (PascalCase/camelCase)]
+- [Ex: DEVE implementar tratamento de erros com contexto usando fmt.Errorf]
+- [Ex: DEVE adicionar comentários explicativos em lógicas complexas]
+- [Ex: DEVE validar todos os inputs antes de processar]
+- [Ex: DEVE retornar erros apropriados em cada camada]
+- [Ex: DEVE escrever testes para código crítico]
+- [Ex: DEVE formatar código com gofmt/prettier]
+
+### ❌ NÃO DEVE:
+- [Ex: NÃO DEVE usar bibliotecas ORM (usar apenas SQL puro)]
+- [Ex: NÃO DEVE expor informações sensíveis em logs]
+- [Ex: NÃO DEVE fazer breaking changes na API pública]
+- [Ex: NÃO DEVE ignorar erros silenciosamente]
+- [Ex: NÃO DEVE criar código duplicado (DRY - Don't Repeat Yourself)]
+- [Ex: NÃO DEVE usar hardcoded values (usar variáveis de ambiente)]
+- [Ex: NÃO DEVE modificar arquivos de migração já aplicados]
+- [Ex: NÃO DEVE pular validações de segurança]
+
+### ⚠️ ATENÇÃO ESPECIAL:
+- [Ex: Ao manipular senhas, SEMPRE usar hashing (bcrypt)]
+- [Ex: Ao fazer queries SQL, SEMPRE usar prepared statements]
+- [Ex: Ao lidar com datas, SEMPRE usar UTC]
+
+---
+
+## 5. 📋 Formato da Resposta
+[Ex: Se a resposta for longa, use subtítulos (##) e listas numeradas para facilitar leitura.]
+
+[Especifique COMO você quer receber o resultado]
+
+**Estrutura desejada:**
+[Ex: Código completo com comentários / Plano em tópicos / Tabela comparativa / Diagrama + explicação]
+
+**Limites:**
+[Ex: Máximo 200 linhas de código / Resposta em até 3 parágrafos / Sem dependências externas]
+
+**Estilo:**
+[Ex: Responder em português / Usar markdown / Incluir exemplos de uso / Formato técnico e direto]
+
+---
+
+## 6. 👤 Persona / Tom
+
+[Defina a perspectiva e forma de comunicação da IA]
+
+**Perspectiva:**
+[Ex: Desenvolvedor sênior / Arquiteto de software / Instrutor técnico / Consultor especializado]
+
+**Tom da explicação:**
+[Ex: Técnico e objetivo / Didático e detalhado / Consultivo e estratégico]
+
+**Nível de profundidade:**
+[Ex: Explicações básicas / Aprofundado com edge cases / Foco em performance / Visão de alto nível]
+
+---
+
+## 7. ✅ Critérios de Aceite
+[Liste condições objetivas que determinam se o resultado está correto]
+
+- [ ] [Ex: O código compila sem erros]
+- [ ] [Ex: Segue o padrão de arquitetura em camadas]
+- [ ] [Ex: Inclui tratamento de erros]
+- [ ] [Ex: Possui testes unitários com 80%+ de cobertura]
+- [ ] [Ex: Documentação atualizada]
+- [ ] [Ex: Performance < 100ms por requisição]
+
+---
+
+## 8. 💬 Exemplos *(opcional)*
+
+[Forneça exemplos de entrada e saída esperada se achar necessário]
+
+**Exemplo 1:**
+```
+Entrada: [Descreva a entrada]
+Saída esperada: [Descreva a saída]
+```
+
+**Exemplo 2:**
+```
+Entrada: [Descreva a entrada]
+Saída esperada: [Descreva a saída]
+```
+
+---
+
+## 9. 📂 Arquivos Envolvidos *(opcional)*
+
+[Liste os arquivos que devem ser criados, modificados ou consultados durante a tarefa]
+
+**Arquivos a criar:**
+- [Ex: `internal/service/order_service.go` — lógica de negócio de pedidos]
+- [Ex: `internal/handler/grpc/order_handler.go` — handler gRPC de pedidos]
+
+**Arquivos a modificar:**
+- [Ex: `internal/infra/di/fx.go` — registrar novos módulos no DI]
+- [Ex: `api/proto/v1/order.proto` — definir mensagens e RPCs de pedidos]
+
+**Arquivos de referência (consultar, não alterar):**
+- [Ex: `internal/service/user_service.go` — seguir mesmo padrão de implementação]
+- [Ex: `internal/handler/grpc/user_handler.go` — referência de como mapear DTOs]
+
+---
+
+## 10. 🧪 Testes de Unidade *(opcional)*
+
+[Defina expectativas sobre testes que devem acompanhar a implementação]
+
+**Escopo dos testes:**
+- [Ex: Testar apenas a camada de service]
+- [Ex: Cobrir fluxos de sucesso e erro]
+- [Ex: Incluir testes de integração com banco real]
+
+**Cenários obrigatórios:**
+- [Ex: Criação com dados válidos → sucesso]
+- [Ex: Criação com email duplicado → erro de conflito]
+- [Ex: Busca por ID inexistente → erro not found]
+- [Ex: Atualização sem permissão → erro de autorização]
+
+**Padrão de testes:**
+- [Ex: Table-driven tests com `testify`]
+- [Ex: Mocks para dependências externas]
+- [Ex: Nomenclatura: `TestNomeDoService_MetodoTestado_Cenario`]
+
+**Arquivo de referência:**
+- [Ex: `internal/service/user_service_test.go` — seguir mesmo padrão]
+
+---
+
+## 💡 Dicas de Uso
+
+* ✅ **Mínimo obrigatório:** Seções 1–6 (Contexto + Objetivo + Instruções + DEVE/NÃO DEVE + Formato + Persona)
+* ⭐ **Para 6 estrelas:** Adicione seções 7–10 (Critérios de Aceite + Exemplos + Arquivos + Testes)
+* 🎯 **Seja específico:** Quanto mais detalhes relevantes, melhor a resposta
+* 🎭 **Use DEVE/NÃO DEVE:** Esta seção é crucial para evitar comportamentos indesejados
+* 🔄 **Itere:** Ajuste o prompt baseado nos resultados obtidos
+* 📏 **Balanceie:** Detalhes suficientes sem ser verboso demais
+
+---

package/package.json

@@ -1,28 +1,28 @@
-{
-  "name": "adi_dev_workflow",
-  "version": "1.1.0",
-  "description": "Install SDD, miniStack and TaskCard development frameworks for Claude Code and Cursor",
-  "type": "module",
-  "bin": {
-    "adi_dev_workflow": "./bin/index.js"
-  },
-  "files": [
-    "bin/",
-    "src/",
-    "frameworks/"
-  ],
-  "keywords": [
-    "claude-code",
-    "cursor",
-    "sdd",
-    "ministack",
-    "taskcard",
-    "dev-workflow",
-    "ai-frameworks"
-  ],
-  "author": "",
-  "license": "MIT",
-  "dependencies": {
-    "prompts": "^2.4.2"
-  }
-}
+{
+  "name": "adi_dev_workflow",
+  "version": "1.2.0",
+  "description": "Install SDD, miniStack and TaskCard development frameworks for Claude Code and Cursor",
+  "type": "module",
+  "bin": {
+    "adi_dev_workflow": "bin/index.js"
+  },
+  "files": [
+    "bin/",
+    "src/",
+    "frameworks/"
+  ],
+  "keywords": [
+    "claude-code",
+    "cursor",
+    "sdd",
+    "ministack",
+    "taskcard",
+    "dev-workflow",
+    "ai-frameworks"
+  ],
+  "author": "",
+  "license": "MIT",
+  "dependencies": {
+    "prompts": "^2.4.2"
+  }
+}

package/src/cli.js

@@ -1,121 +1,121 @@
-import prompts from 'prompts';
-import { install } from './installer.js';
-
-const BANNER = `
-  ╔══════════════════════════════════════╗
-  ║      adi_dev_workflow  v1.0         ║
-  ║  SDD · miniStack · TaskCard         ║
-  ╚══════════════════════════════════════╝
-`;
-
-function parseArgs(argv) {
-  const args = { ide: null, all: false };
-  for (let i = 0; i < argv.length; i++) {
-    if (argv[i] === '--all') args.all = true;
-    if (argv[i] === '--ide' && argv[i + 1]) {
-      args.ide = argv[++i];
-    }
-  }
-  return args;
-}
-
-export async function run(argv) {
-  console.log(BANNER);
-
-  const args = parseArgs(argv);
-  let target = args.ide;
-  let frameworks;
-
-  // IDE selection
-  if (!target || !['claude', 'cursor'].includes(target)) {
-    const res = await prompts({
-      type: 'select',
-      name: 'target',
-      message: 'Which IDE are you using?',
-      choices: [
-        { title: 'Claude Code (.claude/)', value: 'claude' },
-        { title: 'Cursor (.cursor/)', value: 'cursor' },
-      ],
-    });
-    if (!res.target) {
-      console.log('Cancelled.');
-      return;
-    }
-    target = res.target;
-  }
-
-  // Framework selection
-  if (args.all) {
-    frameworks = ['sdd', 'ministack', 'taskcard', 'shared'];
-  } else {
-    const res = await prompts({
-      type: 'multiselect',
-      name: 'frameworks',
-      message: 'Which frameworks do you want to install?',
-      choices: [
-        {
-          title: 'SDD - Specification-Driven Development',
-          description: 'PRD -> Spec Tech -> Task Plan -> Code',
-          value: 'sdd',
-          selected: true,
-        },
-        {
-          title: 'miniStack - Minimal Feature Stack',
-          description: 'Intent -> Scope -> Tasks -> Code',
-          value: 'ministack',
-          selected: true,
-        },
-        {
-          title: 'TaskCard - Atomic Work Units',
-          description: 'Description -> Card -> Code',
-          value: 'taskcard',
-          selected: true,
-        },
-        {
-          title: 'Shared tools',
-          description: 'Prompt generator, Linear sync',
-          value: 'shared',
-          selected: true,
-        },
-      ],
-      hint: '- Space to toggle. Return to submit',
-    });
-    if (!res.frameworks || res.frameworks.length === 0) {
-      console.log('No frameworks selected. Cancelled.');
-      return;
-    }
-    frameworks = res.frameworks;
-  }
-
-  const cwd = process.cwd();
-  const ideLabel = target === 'claude' ? '.claude/' : '.cursor/';
-
-  console.log(`\nInstalling to ${ideLabel} ...\n`);
-
-  const summary = await install({ cwd, target, frameworks });
-
-  console.log(`  Done!\n`);
-  console.log(`  ${summary.skills} skills + ${summary.commands} commands + ${summary.templates} templates installed.\n`);
-
-  // Usage hints
-  const hints = [];
-  if (frameworks.includes('sdd')) {
-    hints.push('  /sdd:generate-prd             Start a new feature with SDD');
-  }
-  if (frameworks.includes('ministack')) {
-    hints.push('  /ministack:generate-intent     Start with miniStack');
-  }
-  if (frameworks.includes('taskcard')) {
-    hints.push('  /taskcard:generate-taskcard    Create a task card');
-  }
-  if (frameworks.includes('shared')) {
-    hints.push('  /generate-prompt               Generate an optimized prompt');
-    hints.push('  /sync-tasks-to-linear          Sync tasks to Linear');
-  }
-
-  if (hints.length > 0) {
-    console.log('  Usage:\n');
-    for (const h of hints) console.log(h);
-    console.log('');
-  }
-}
+import prompts from 'prompts';
+import { install } from './installer.js';
+
+const BANNER = `
+  ╔══════════════════════════════════════╗
+  ║      adi_dev_workflow  v1.0         ║
+  ║  SDD · miniStack · TaskCard         ║
+  ╚══════════════════════════════════════╝
+`;
+
+function parseArgs(argv) {
+  const args = { ide: null, all: false };
+  for (let i = 0; i < argv.length; i++) {
+    if (argv[i] === '--all') args.all = true;
+    if (argv[i] === '--ide' && argv[i + 1]) {
+      args.ide = argv[++i];
+    }
+  }
+  return args;
+}
+
+export async function run(argv) {
+  console.log(BANNER);
+
+  const args = parseArgs(argv);
+  let target = args.ide;
+  let frameworks;
+
+  // IDE selection
+  if (!target || !['claude', 'cursor'].includes(target)) {
+    const res = await prompts({
+      type: 'select',
+      name: 'target',
+      message: 'Which IDE are you using?',
+      choices: [
+        { title: 'Claude Code (.claude/)', value: 'claude' },
+        { title: 'Cursor (.cursor/)', value: 'cursor' },
+      ],
+    });
+    if (!res.target) {
+      console.log('Cancelled.');
+      return;
+    }
+    target = res.target;
+  }
+
+  // Framework selection
+  if (args.all) {
+    frameworks = ['sdd', 'ministack', 'taskcard', 'shared'];
+  } else {
+    const res = await prompts({
+      type: 'multiselect',
+      name: 'frameworks',
+      message: 'Which frameworks do you want to install?',
+      choices: [
+        {
+          title: 'SDD - Specification-Driven Development',
+          description: 'PRD -> Spec Tech -> Task Plan -> Code',
+          value: 'sdd',
+          selected: true,
+        },
+        {
+          title: 'miniStack - Minimal Feature Stack',
+          description: 'Intent -> Scope -> Tasks -> Code',
+          value: 'ministack',
+          selected: true,
+        },
+        {
+          title: 'TaskCard - Atomic Work Units',
+          description: 'Description -> Card -> Code',
+          value: 'taskcard',
+          selected: true,
+        },
+        {
+          title: 'Shared tools',
+          description: 'Prompt generator, Linear sync',
+          value: 'shared',
+          selected: true,
+        },
+      ],
+      hint: '- Space to toggle. Return to submit',
+    });
+    if (!res.frameworks || res.frameworks.length === 0) {
+      console.log('No frameworks selected. Cancelled.');
+      return;
+    }
+    frameworks = res.frameworks;
+  }
+
+  const cwd = process.cwd();
+  const ideLabel = target === 'claude' ? '.claude/' : '.cursor/';
+
+  console.log(`\nInstalling to ${ideLabel} ...\n`);
+
+  const summary = await install({ cwd, target, frameworks });
+
+  console.log(`  Done!\n`);
+  console.log(`  ${summary.skills} skills + ${summary.commands} commands + ${summary.templates} templates + ${summary.agents} agents + ${summary.config} config installed.\n`);
+
+  // Usage hints
+  const hints = [];
+  if (frameworks.includes('sdd')) {
+    hints.push('  /sdd:generate-prd             Start a new feature with SDD');
+  }
+  if (frameworks.includes('ministack')) {
+    hints.push('  /ministack:generate-intent     Start with miniStack');
+  }
+  if (frameworks.includes('taskcard')) {
+    hints.push('  /taskcard:generate-taskcard    Create a task card');
+  }
+  if (frameworks.includes('shared')) {
+    hints.push('  /generate-prompt               Generate an optimized prompt');
+    hints.push('  /sync-tasks-to-linear          Sync tasks to Linear');
+  }
+
+  if (hints.length > 0) {
+    console.log('  Usage:\n');
+    for (const h of hints) console.log(h);
+    console.log('');
+  }
+}