adi_dev_workflow 1.1.1 → 1.2.0

package/frameworks/commands/taskcard/run-taskcard.md

@@ -3,6 +3,8 @@ description: "Executa uma TaskCard com gates QA + Tech Review. Params: <caminho_
 argument-hint: "<caminho da taskcard> [agente opcional ex: go-expert]"
 ---
 
+> **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.
+
 Voce e um **Executor de TaskCard com Validacao**. Execute com precisao, sem desvios ou reinterpretacao.
 
 Carregue a skill **taskcard-expert** para obter o framework completo (template, regras, guardrails, convencoes).

package/frameworks/config/ai-framework-config.yaml

@@ -0,0 +1,112 @@
+# ============================================================================
+# AI Framework Config — Configuracao centralizada de paths
+# ============================================================================
+#
+# Este arquivo define ONDE cada artefato de cada framework deve ser gravado.
+# Todos os commands e skills DEVEM ler este arquivo antes de salvar qualquer
+# artefato, usando os paths aqui definidos.
+#
+# Variaveis dinamicas:
+#   {feature}  — nome da feature em kebab-case (ex: auth-oauth2)
+#   {version}  — versao do artefato (ex: v1, v2)
+#
+# Para alterar a estrutura de pastas, edite APENAS este arquivo.
+# ============================================================================
+
+# --------------------------------------------------------------------------
+# SDD (Software Design Document)
+# Pipeline: PRD → Tech Direction → SPEC_TECH → Task Plan + Tasks → Execution
+# --------------------------------------------------------------------------
+sdd:
+  # Artefatos de produto (O QUE / POR QUE)
+  prd:
+    path: "docs/specs/{feature}/{version}/prd.md"
+    generated_by: "sdd:generate-prd"
+
+  tech_direction:
+    path: "docs/specs/{feature}/{version}/tech_direction.md"
+    generated_by: "sdd:generate-tech-direction"
+
+  state:
+    path: "docs/specs/{feature}/{version}/sdd_state.yaml"
+    generated_by: "sdd:generate-prd"
+    updated_by: "all sdd commands"
+
+  # Artefatos tecnicos (COMO)
+  spec_tech:
+    path: "docs/specs/{feature}/{version}/spec_tech.md"
+    generated_by: "sdd:generate-tech-spec"
+
+  validation:
+    path: "docs/specs/{feature}/{version}/validation_report.md"
+    generated_by: "sdd:validate-sdd"
+
+  task_plan:
+    path: "docs/specs/{feature}/{version}/task_plan.md"
+    generated_by: "sdd:generate-task-plan"
+
+  tasks:
+    dir: "docs/specs/{feature}/{version}/tasks/"
+    pattern: "T{n}.md"
+    generated_by: "sdd:generate-task-plan"
+
+  code_review:
+    dir: "docs/specs/{feature}/{version}/code_review/"
+    generated_by: "sdd:code-review"
+
+  tests:
+    generated_by: "sdd:generate-tests"
+    note: "Gera secoes dentro do spec_tech.md ou tasks/TN.md, nao cria arquivo separado"
+
+# --------------------------------------------------------------------------
+# miniStack
+# Pipeline: INTENT → Tech Direction → SCOPE → Task Plan + Tasks → Execution
+# --------------------------------------------------------------------------
+ministack:
+  intent:
+    path: "docs/specs/{feature}/{version}/intent.md"
+    generated_by: "ministack:generate-intent"
+
+  tech_direction:
+    path: "docs/specs/{feature}/{version}/tech_direction.md"
+    generated_by: "ministack:generate-tech-direction"
+
+  state:
+    path: "docs/specs/{feature}/{version}/ministack_state.yaml"
+    generated_by: "ministack:generate-intent"
+    updated_by: "all ministack commands"
+
+  scope:
+    path: "docs/specs/{feature}/{version}/scope.md"
+    generated_by: "ministack:generate-scope"
+
+  task_plan:
+    path: "docs/specs/{feature}/{version}/task_plan.md"
+    generated_by: "ministack:generate-tasks"
+
+  tasks:
+    dir: "docs/specs/{feature}/{version}/tasks/"
+    pattern: "T{n}.md"
+    generated_by: "ministack:generate-tasks"
+
+# --------------------------------------------------------------------------
+# TaskCard
+# Pipeline: TaskCard generation → Execution (QA + Tech Review)
+# --------------------------------------------------------------------------
+taskcard:
+  task_plan:
+    path: "docs/specs/{feature}/{version}/task-plan.md"
+    generated_by: "taskcard:generate-taskcard"
+
+  tasks:
+    dir: "docs/specs/{feature}/{version}/"
+    pattern: "task-{nn}-{slug}.md"
+    generated_by: "taskcard:generate-taskcard"
+
+# --------------------------------------------------------------------------
+# Compartilhado (cross-framework)
+# --------------------------------------------------------------------------
+shared:
+  linear_sync:
+    path: "docs/specs/{feature}/{version}/linear-sync.json"
+    generated_by: "sync-tasks-to-linear"

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

@@ -8,6 +8,8 @@ Voce e um **Product Owner / PM experiente** com vies de produto e clareza estrat
 
 Você domina completamente o framework miniStack e seu foco é **EXCLUSIVAMENTE** na etapa INTENT — definindo O QUE precisa ser feito e POR QUÊ, sem nunca entrar em detalhes técnicos de implementação.
 
+> **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

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

@@ -6,8 +6,12 @@ argument-hint: [INTENT aprovada + detalhes tecnicos]
 
 Voce e um **Arquiteto de Software Senior** que transforma INTENTs em especificacoes tecnicas concretas.
 
+> **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

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

@@ -23,6 +23,8 @@ 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

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

@@ -14,6 +14,8 @@ 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

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

@@ -6,8 +6,12 @@ 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.
 
+> **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

package/package.json

@@ -1,28 +1,28 @@
-{
-  "name": "adi_dev_workflow",
-  "version": "1.1.1",
-  "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('');
+  }
+}