adi_dev_workflow 1.1.1 → 1.2.0

package/src/installer.js

@@ -1,136 +1,155 @@
-import { readdir, readFile, writeFile, mkdir, stat } from 'node:fs/promises';
-import { join, dirname } from 'node:path';
-import { fileURLToPath } from 'node:url';
-import { transformContent } from './transformer.js';
-
-const __dirname = dirname(fileURLToPath(import.meta.url));
-const FRAMEWORKS_DIR = join(__dirname, '..', 'frameworks');
-
-const FRAMEWORK_MAP = {
-  sdd: {
-    commands: 'sdd',
-    skills: ['sdd-prd-expert', 'sdd-spec-tech-expert', 'sdd-task-plan-expert', 'sdd-qa-expert'],
-  },
-  ministack: {
-    commands: 'ministack',
-    skills: ['ministack-intent-expert', 'ministack-scope-expert', 'ministack-expert', 'ministack-qa-expert'],
-  },
-  taskcard: {
-    commands: 'taskcard',
-    skills: ['taskcard-expert', 'taskcard-qa-expert'],
-  },
-  shared: {
-    commands: null, // root-level commands
-    skills: [],
-  },
-};
-
-const IDE_DIRS = {
-  claude: '.claude',
-  cursor: '.cursor',
-};
-
-/**
- * Copy a directory recursively, applying transformation.
- */
-async function copyDir(src, dest, target) {
-  await mkdir(dest, { recursive: true });
-  const entries = await readdir(src, { withFileTypes: true });
-
-  for (const entry of entries) {
-    const srcPath = join(src, entry.name);
-    const destPath = join(dest, entry.name);
-
-    if (entry.isDirectory()) {
-      await copyDir(srcPath, destPath, target);
-    } else if (entry.name.endsWith('.md')) {
-      const content = await readFile(srcPath, 'utf-8');
-      const transformed = transformContent(content, target);
-      await writeFile(destPath, transformed, 'utf-8');
-    } else {
-      const content = await readFile(srcPath);
-      await writeFile(destPath, content);
-    }
-  }
-}
-
-/**
- * Check if a path exists.
- */
-async function exists(path) {
-  try {
-    await stat(path);
-    return true;
-  } catch {
-    return false;
-  }
-}
-
-/**
- * Install selected frameworks to the target directory.
- *
- * @param {Object} options
- * @param {string} options.cwd - Current working directory
- * @param {'claude'|'cursor'} options.target - Target IDE
- * @param {string[]} options.frameworks - Frameworks to install ('sdd', 'ministack', 'taskcard', 'shared')
- * @returns {Object} Summary of installed items
- */
-export async function install({ cwd, target, frameworks }) {
-  const ideDir = join(cwd, IDE_DIRS[target]);
-  const commandsDir = join(ideDir, 'commands');
-  const skillsDir = join(ideDir, 'skills');
-  const templatesDir = join(ideDir, 'templates');
-
-  const summary = { commands: 0, skills: 0, templates: 0 };
-
-  for (const fw of frameworks) {
-    const config = FRAMEWORK_MAP[fw];
-    if (!config) continue;
-
-    // Copy commands
-    if (fw === 'shared') {
-      // Root-level commands (generate-prompt.md, sync-tasks-to-linear.md)
-      await mkdir(commandsDir, { recursive: true });
-      const srcCmds = join(FRAMEWORKS_DIR, 'commands');
-      const entries = await readdir(srcCmds, { withFileTypes: true });
-
-      for (const entry of entries) {
-        if (entry.isFile() && entry.name.endsWith('.md')) {
-          const content = await readFile(join(srcCmds, entry.name), 'utf-8');
-          const transformed = transformContent(content, target);
-          await writeFile(join(commandsDir, entry.name), transformed, 'utf-8');
-          summary.commands++;
-        }
-      }
-
-      // Shared templates
-      const srcTemplates = join(FRAMEWORKS_DIR, 'templates');
-      if (await exists(srcTemplates)) {
-        await copyDir(srcTemplates, templatesDir, target);
-        const tplEntries = await readdir(srcTemplates);
-        summary.templates += tplEntries.filter((f) => f.endsWith('.md')).length;
-      }
-    } else {
-      // Framework-specific commands
-      if (config.commands) {
-        const srcCmdDir = join(FRAMEWORKS_DIR, 'commands', config.commands);
-        const destCmdDir = join(commandsDir, config.commands);
-        await copyDir(srcCmdDir, destCmdDir, target);
-        const entries = await readdir(srcCmdDir);
-        summary.commands += entries.filter((f) => f.endsWith('.md')).length;
-      }
-
-      // Framework-specific skills
-      for (const skillName of config.skills) {
-        const srcSkillDir = join(FRAMEWORKS_DIR, 'skills', skillName);
-        const destSkillDir = join(skillsDir, skillName);
-        if (await exists(srcSkillDir)) {
-          await copyDir(srcSkillDir, destSkillDir, target);
-          summary.skills++;
-        }
-      }
-    }
-  }
-
-  return summary;
-}
+import { readdir, readFile, writeFile, mkdir, stat } from 'node:fs/promises';
+import { join, dirname } from 'node:path';
+import { fileURLToPath } from 'node:url';
+import { transformContent } from './transformer.js';
+
+const __dirname = dirname(fileURLToPath(import.meta.url));
+const FRAMEWORKS_DIR = join(__dirname, '..', 'frameworks');
+
+const FRAMEWORK_MAP = {
+  sdd: {
+    commands: 'sdd',
+    skills: ['sdd-prd-expert', 'sdd-spec-tech-expert', 'sdd-task-plan-expert', 'sdd-qa-expert'],
+  },
+  ministack: {
+    commands: 'ministack',
+    skills: ['ministack-intent-expert', 'ministack-scope-expert', 'ministack-expert', 'ministack-qa-expert'],
+  },
+  taskcard: {
+    commands: 'taskcard',
+    skills: ['taskcard-expert', 'taskcard-qa-expert'],
+  },
+  shared: {
+    commands: null, // root-level commands
+    skills: [],
+  },
+};
+
+const IDE_DIRS = {
+  claude: '.claude',
+  cursor: '.cursor',
+};
+
+/**
+ * Copy a directory recursively, applying transformation.
+ */
+async function copyDir(src, dest, target) {
+  await mkdir(dest, { recursive: true });
+  const entries = await readdir(src, { withFileTypes: true });
+
+  for (const entry of entries) {
+    const srcPath = join(src, entry.name);
+    const destPath = join(dest, entry.name);
+
+    if (entry.isDirectory()) {
+      await copyDir(srcPath, destPath, target);
+    } else if (entry.name.endsWith('.md')) {
+      const content = await readFile(srcPath, 'utf-8');
+      const transformed = transformContent(content, target);
+      await writeFile(destPath, transformed, 'utf-8');
+    } else {
+      const content = await readFile(srcPath);
+      await writeFile(destPath, content);
+    }
+  }
+}
+
+/**
+ * Check if a path exists.
+ */
+async function exists(path) {
+  try {
+    await stat(path);
+    return true;
+  } catch {
+    return false;
+  }
+}
+
+/**
+ * Install selected frameworks to the target directory.
+ *
+ * @param {Object} options
+ * @param {string} options.cwd - Current working directory
+ * @param {'claude'|'cursor'} options.target - Target IDE
+ * @param {string[]} options.frameworks - Frameworks to install ('sdd', 'ministack', 'taskcard', 'shared')
+ * @returns {Object} Summary of installed items
+ */
+export async function install({ cwd, target, frameworks }) {
+  const ideDir = join(cwd, IDE_DIRS[target]);
+  const commandsDir = join(ideDir, 'commands');
+  const skillsDir = join(ideDir, 'skills');
+  const templatesDir = join(ideDir, 'templates');
+  const agentsDir = join(ideDir, 'agents');
+
+  const summary = { commands: 0, skills: 0, templates: 0, agents: 0, config: 0 };
+
+  for (const fw of frameworks) {
+    const config = FRAMEWORK_MAP[fw];
+    if (!config) continue;
+
+    // Copy commands
+    if (fw === 'shared') {
+      // Root-level commands (generate-prompt.md, sync-tasks-to-linear.md)
+      await mkdir(commandsDir, { recursive: true });
+      const srcCmds = join(FRAMEWORKS_DIR, 'commands');
+      const entries = await readdir(srcCmds, { withFileTypes: true });
+
+      for (const entry of entries) {
+        if (entry.isFile() && entry.name.endsWith('.md')) {
+          const content = await readFile(join(srcCmds, entry.name), 'utf-8');
+          const transformed = transformContent(content, target);
+          await writeFile(join(commandsDir, entry.name), transformed, 'utf-8');
+          summary.commands++;
+        }
+      }
+
+      // Shared templates
+      const srcTemplates = join(FRAMEWORKS_DIR, 'templates');
+      if (await exists(srcTemplates)) {
+        await copyDir(srcTemplates, templatesDir, target);
+        const tplEntries = await readdir(srcTemplates);
+        summary.templates += tplEntries.filter((f) => f.endsWith('.md')).length;
+      }
+
+      // Shared agents
+      const srcAgents = join(FRAMEWORKS_DIR, 'agents');
+      if (await exists(srcAgents)) {
+        await copyDir(srcAgents, agentsDir, target);
+        const agentEntries = await readdir(srcAgents);
+        summary.agents += agentEntries.filter((f) => f.endsWith('.md')).length;
+      }
+
+      // Config file
+      const srcConfig = join(FRAMEWORKS_DIR, 'config', 'ai-framework-config.yaml');
+      if (await exists(srcConfig)) {
+        const configDestDir = join(ideDir, 'config');
+        await mkdir(configDestDir, { recursive: true });
+        const content = await readFile(srcConfig);
+        await writeFile(join(configDestDir, 'ai-framework-config.yaml'), content);
+        summary.config = 1;
+      }
+    } else {
+      // Framework-specific commands
+      if (config.commands) {
+        const srcCmdDir = join(FRAMEWORKS_DIR, 'commands', config.commands);
+        const destCmdDir = join(commandsDir, config.commands);
+        await copyDir(srcCmdDir, destCmdDir, target);
+        const entries = await readdir(srcCmdDir);
+        summary.commands += entries.filter((f) => f.endsWith('.md')).length;
+      }
+
+      // Framework-specific skills
+      for (const skillName of config.skills) {
+        const srcSkillDir = join(FRAMEWORKS_DIR, 'skills', skillName);
+        const destSkillDir = join(skillsDir, skillName);
+        if (await exists(srcSkillDir)) {
+          await copyDir(srcSkillDir, destSkillDir, target);
+          summary.skills++;
+        }
+      }
+    }
+  }
+
+  return summary;
+}

package/src/transformer.js

@@ -1,86 +1,86 @@
-const REPLACEMENTS = [
-  // Remove Claude Code specific tool instructions
-  {
-    pattern: /- \*\*Claude Code\*\*: use a ferramenta `AskUserQuestion`[^\n]*/g,
-    replacement: '',
-  },
-  {
-    pattern: /\*\*Claude Code\*\*: use a ferramenta `AskUserQuestion`[^\n]*/g,
-    replacement: '',
-  },
-  // Replace AskUserQuestion references with generic
-  {
-    pattern: /`AskUserQuestion`/g,
-    replacement: 'perguntas interativas ao usuario',
-  },
-  {
-    pattern: /AskUserQuestion/g,
-    replacement: 'pergunte ao usuario',
-  },
-  // Replace directory references
-  {
-    pattern: /\.claude\/rules\//g,
-    replacement: '.cursor/rules/',
-  },
-  {
-    pattern: /\.claude\/templates\//g,
-    replacement: '.cursor/templates/',
-  },
-  {
-    pattern: /\.claude\/skills\//g,
-    replacement: '.cursor/skills/',
-  },
-  {
-    pattern: /\.claude\/commands\//g,
-    replacement: '.cursor/commands/',
-  },
-  // Replace .claude/agents/ references
-  {
-    pattern: /\.claude\/agents\//g,
-    replacement: '.cursor/agents/',
-  },
-  // Replace all remaining .claude/ references
-  {
-    pattern: /`\.claude\//g,
-    replacement: '`.cursor/',
-  },
-  // Replace tool/IDE name references
-  {
-    pattern: /no Claude Code/g,
-    replacement: 'no Cursor',
-  },
-  {
-    pattern: /do Claude Code/g,
-    replacement: 'do Cursor',
-  },
-  {
-    pattern: /Claude Code Review Agent/g,
-    replacement: 'Code Review Agent',
-  },
-  {
-    pattern: /\(Claude Code\)/g,
-    replacement: '(Cursor)',
-  },
-  {
-    pattern: /Claude Code/g,
-    replacement: 'Cursor',
-  },
-];
-
-/**
- * Transform file content from Claude Code format to Cursor format.
- * Returns unchanged content if target is 'claude'.
- */
-export function transformContent(content, target) {
-  if (target === 'claude') return content;
-
-  let result = content;
-  for (const { pattern, replacement } of REPLACEMENTS) {
-    result = result.replace(pattern, replacement);
-  }
-
-  // Clean up empty lines left by removed lines
-  result = result.replace(/\n{3,}/g, '\n\n');
-
-  return result;
-}
+const REPLACEMENTS = [
+  // Remove Claude Code specific tool instructions
+  {
+    pattern: /- \*\*Claude Code\*\*: use a ferramenta `AskUserQuestion`[^\n]*/g,
+    replacement: '',
+  },
+  {
+    pattern: /\*\*Claude Code\*\*: use a ferramenta `AskUserQuestion`[^\n]*/g,
+    replacement: '',
+  },
+  // Replace AskUserQuestion references with generic
+  {
+    pattern: /`AskUserQuestion`/g,
+    replacement: 'perguntas interativas ao usuario',
+  },
+  {
+    pattern: /AskUserQuestion/g,
+    replacement: 'pergunte ao usuario',
+  },
+  // Replace directory references
+  {
+    pattern: /\.claude\/rules\//g,
+    replacement: '.cursor/rules/',
+  },
+  {
+    pattern: /\.claude\/templates\//g,
+    replacement: '.cursor/templates/',
+  },
+  {
+    pattern: /\.claude\/skills\//g,
+    replacement: '.cursor/skills/',
+  },
+  {
+    pattern: /\.claude\/commands\//g,
+    replacement: '.cursor/commands/',
+  },
+  // Replace .claude/agents/ references
+  {
+    pattern: /\.claude\/agents\//g,
+    replacement: '.cursor/agents/',
+  },
+  // Replace all remaining .claude/ references
+  {
+    pattern: /`\.claude\//g,
+    replacement: '`.cursor/',
+  },
+  // Replace tool/IDE name references
+  {
+    pattern: /no Claude Code/g,
+    replacement: 'no Cursor',
+  },
+  {
+    pattern: /do Claude Code/g,
+    replacement: 'do Cursor',
+  },
+  {
+    pattern: /Claude Code Review Agent/g,
+    replacement: 'Code Review Agent',
+  },
+  {
+    pattern: /\(Claude Code\)/g,
+    replacement: '(Cursor)',
+  },
+  {
+    pattern: /Claude Code/g,
+    replacement: 'Cursor',
+  },
+];
+
+/**
+ * Transform file content from Claude Code format to Cursor format.
+ * Returns unchanged content if target is 'claude'.
+ */
+export function transformContent(content, target) {
+  if (target === 'claude') return content;
+
+  let result = content;
+  for (const { pattern, replacement } of REPLACEMENTS) {
+    result = result.replace(pattern, replacement);
+  }
+
+  // Clean up empty lines left by removed lines
+  result = result.replace(/\n{3,}/g, '\n\n');
+
+  return result;
+}

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

@@ -1,204 +0,0 @@
----
-name: ministack-tasks-expert
-description: Especialista em geracao de TASKS do framework miniStack. Atua como Engenheiro de Software Senior decompondo SCOPE em tasks atomicas e executaveis.
-argument-hint: [INTENT aprovada + SCOPE aprovado]
----
-
-Voce e um **Engenheiro de Software Senior** que decompoe SCOPE aprovado em tasks atomicas e executaveis.
-
-Você domina completamente o framework miniStack e seu foco é **EXCLUSIVAMENTE** na geração de TASKS — definindo COMO EXECUTAR a implementação em unidades atômicas de trabalho.
-
----
-
-# 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 miniStack — Especialista TASKS
-
-## Visao Geral
-
-**miniStack** e um framework estruturado para decomposicao e execucao de features de forma colaborativa, baseado em documentacao clara com **3 etapas principais**: INTENT, SCOPE e TASKS.
-
-### Fluxo Completo
-
-```
-Descricao da Feature
-        |
-   /generate-intent          (ministack-intent-expert)
-        | (INTENT aprovada)
-   /generate-scope            (ministack-scope-expert)
-        | (SCOPE aprovado)
-   /generate-tasks            <-- voce esta aqui (ministack-tasks-expert)
-        | (TASKS aprovadas)
-   /run-ministack-tasks       (comando orquestrador)
-        |
-   Feature Implementada
-```
-
-O TASKS Expert responde: **COMO decompor o SCOPE em unidades atomicas de trabalho?**
-
----
-
-## Principio Fundamental
-
-As TASKS transformam o SCOPE aprovado em **unidades atomicas de trabalho** executaveis por humanos ou agentes de IA.
-
-## Regras Obrigatorias
-
-- **NUNCA** deduzir escopo ou inventar informacoes — na DUVIDA, PERGUNTE AO USUARIO
-- **SEMPRE** salvar os arquivos fisicos antes de pedir aprovacao
-- **NUNCA** iniciar automaticamente a proxima etapa
-- **Claude Code**: use a ferramenta `AskUserQuestion` para esclarecer duvidas com o usuario
-
-## Criterios de Qualidade
-
-| Atributo | Descricao |
-|----------|-----------|
-| Atomica | Executavel sem novas decisoes |
-| Independente | Minimize dependencias |
-| Pequena | Se > 3 subtarefas, quebre em tasks |
-| Clara | Suficiente para LLM executar |
-| Verificavel | Criterio claro de conclusao |
-| Ordenada | Ordem e dependencias definidas |
-
-## Processo (3 Fases)
-
-### Fase 1: Analise e Validacao
-
-**ANTES de gerar as tasks**, analise Intent e Scope:
-
-- Intent esta claro sobre o objetivo?
-- Scope delimita claramente o que entra e sai?
-- Ha ambiguidades que precisam esclarecimento?
-- Detectou dependencias ocultas?
-- Algo parece inviavel ou conflitante?
-
-Se houver duvidas, pergunte ao usuario antes de prosseguir.
-
-### Fase 2: Geracao das Tasks
-
-Para cada task, preencha o template individual (`task_template.md`) com:
-- **ID**: T1, T2, T3... (unico)
-- **Nome**: Descricao curta
-- **Objetivo**: O que sera entregue
-- **Arquivos**: Criados/modificados (economiza tokens e scans)
-- **Dependencias**: Quais tasks antes
-- **Criterio de Conclusao**: Como validar
-- **Detalhes de Implementacao**: Subtasks com checklist
-- **Testes**: Secao controlada pelo comando orquestrador (ver nota abaixo)
-
-Alem disso, preencha o `task_plan_template.md` com:
-- **Macro-Fases**: agrupamento logico das tasks
-- **Lista de Tasks**: tabela com links para cada arquivo individual
-- **Grafo de Dependencias**: ordem de execucao e paralelismo
-- **Visao consolidada de arquivos**: todos os arquivos impactados
-
-> **IMPORTANTE**: A secao de **Testes** de cada task e controlada pelo comando orquestrador
-> (`/ministack:generate-tasks`) que delega ao agente QA especializado (`qa-staff-engineer`).
-> Voce NAO deve delegar diretamente ao agente QA — apenas deixe a secao de Testes vazia
-> com o marcador `[PENDENTE — sera preenchida pelo agente QA]`.
-
-### Fase 3: Salvar Arquivos (OBRIGATORIO)
-
-1. Identificar nome da feature a partir da INTENT/SCOPE
-2. **Remover todos os comentarios `<!-- LLM-ONLY: ... -->`** do conteudo antes de salvar — sao instrucoes internas do template e NAO devem aparecer nos arquivos gerados
-3. **Salvar os arquivos fisicos**:
-   - Task Plan: `docs/[nome-feature]/vN/task_plan.md`
-   - Cada task individual: `docs/[nome-feature]/vN/tasks/T1.md`, `T2.md`, ...
-4. Confirmar que todos os arquivos foram criados
-
-## Templates
-
-- **Task Plan (indice)**: [task_plan_template.md](templates/task_plan_template.md)
-- **Task Individual**: [task_template.md](templates/task_template.md)
-
-## Estrutura de Saida
-
-```
-docs/
-  <nome-feature>/
-    vN/
-      intent.md          # INTENT aprovada (ministack-intent-expert)
-      scope.md           # SCOPE aprovado (ministack-scope-expert)
-      task_plan.md       # Indice e coordenacao (voce gera este arquivo)
-      tasks/
-        T1.md            # Task individual (voce gera cada arquivo)
-        T2.md
-        T3.md
-        ...
-```
-
-## Saida Esperada
-
-```
-Arquivos salvos em: docs/[nome-feature]/vN/
-  - task_plan.md (indice com [N] tasks)
-  - tasks/T1.md ... tasks/T[N].md
-
-Tarefas Geradas
-Total: [N] tasks
-Sequencia: T1 -> T2 -> T3 (paralelo: T4, T5) -> T6
-
-Aprova essas tasks para execucao? (sim/nao)
-```
-
-**IMPORTANTE:**
-- NAO inicie `/run-ministack-tasks` automaticamente
-- NAO sugira executar o proximo comando
-- Apenas aguarde a confirmacao do usuario e encerre
-
----
-
-## Guardrails Inviolaveis
-
-1. **Aprovacao obrigatoria** — nunca avance sem confirmacao do usuario
-2. **Sem invencao** — se faltar informacao, PERGUNTE ao usuario
-3. **Escopo fechado** — cada documento deve ser auto-suficiente
-4. **Template completo** — todas as secoes devem ser preenchidas
-5. **Arquivos fisicos** — SEMPRE salvar antes de apresentar ao usuario
-6. **AskUserQuestion** — no Claude Code, use esta ferramenta para esclarecer duvidas
-7. **Testes via orquestrador** — NAO delegue testes diretamente, o comando orquestrador faz isso
-
----
-
-## Convencoes
-
-### Nomenclatura
-
-| Elemento | Convencao | Exemplo |
-|----------|-----------|---------|
-| Nome da feature | kebab-case | `auth-oauth2`, `user-profile` |
-| ID de task | T + numero | `T1`, `T2`, `T3` |
-| Diretorio | `docs/<nome>/vN/` | `docs/auth/v1/` |
-| Arquivo task plan | `task_plan.md` | `docs/auth/v1/task_plan.md` |
-| Arquivo task individual | `T[N].md` | `docs/auth/v1/tasks/T1.md` |
-
-### Estrutura de Diretorios
-
-```
-docs/
-  <nome-feature>/
-    vN/
-      intent.md          # INTENT aprovada (ministack-intent-expert)
-      scope.md           # SCOPE aprovado (ministack-scope-expert)
-      task_plan.md       # Indice e coordenacao (voce gera este arquivo)
-      tasks/
-        T1.md            # Task individual (voce gera cada arquivo)
-        T2.md
-        ...
-```
-
----
-
-## Entrada
-
-$ARGUMENTS