@spec-wave/cli 0.8.1 → 0.10.0

package/README.md

@@ -26,7 +26,6 @@ O resultado é um board Kanban no GitHub Projects v2 que avança automaticamente
   → 📋 Spec          ← label spec-wave:spec → Action gera spec.md
   → 📋 Plan          ← label spec-wave:plan → Action gera plan.md
   → ✅ Ready         ← label spec-wave:ready → Action valida ambos
-  → 📋 Backlog Técnico
   → 🚧 Desenvolvimento ← comando local: spec-wave implement <n>
   → 👀 Code Review   ← PR aberto → Action move automaticamente
   → 🧪 QA            ← PR aprovado → Action move automaticamente
@@ -117,7 +116,7 @@ Arquivo em `.github/config/tech_context.yml` que descreve a stack tecnológica d
 Não é necessário instalar globalmente — use `npx`:
 
 ```bash
-npx @spec-wave/cli --help
+npx @spec-wave/cli@latest --help
 ```
 
 Para instalar globalmente:
@@ -137,7 +136,7 @@ A skill permite usar o fluxo diretamente no seu agente via `/spec-wave`.
 
 ```bash
 # Autodetecta o agente em uso e instala no local/formato correto
-npx @spec-wave/cli install-skill
+npx @spec-wave/cli@latest install-skill
 ```
 
 O comando suporta Claude Code, Cursor, opencode, Cline, Kilo Code, Antigravity e o
@@ -184,7 +183,7 @@ gh auth status
 gh auth refresh --scopes project,repo,workflow
 
 # Configurar spec-wave (cria Project, labels e workflows)
-npx @spec-wave/cli init --repo acme/loja --project-title "Loja — Spec Wave"
+npx @spec-wave/cli@latest init --repo acme/loja --project-title "Loja — Spec Wave"
 ```
 
 O `init` cria:
@@ -201,7 +200,7 @@ Adicionar o secret de IA no GitHub: **Settings → Secrets → Actions → `ANTH
 
 ```bash
 # Criar Epic
-npx @spec-wave/cli issue \
+npx @spec-wave/cli@latest issue \
   --type epic \
   --title "Checkout e Pagamentos" \
   --priority P1 \
@@ -209,7 +208,7 @@ npx @spec-wave/cli issue \
 # → Issue #5 criada: [EPIC] Checkout e Pagamentos
 
 # Criar Feature como sub-issue do Epic
-npx @spec-wave/cli feature \
+npx @spec-wave/cli@latest feature \
   --title "Checkout com PIX" \
   --parent 5 \
   --priority P1 \
@@ -304,7 +303,7 @@ O Action `decompose.yml` usa IA para criar sub-issues da Feature #12:
   #19 [TASK] Notificação por e-mail ao confirmar
 ```
 
-Todas as Stories e Tasks são adicionadas ao board em **📋 Backlog Técnico** com Status `Todo`.
+Todas as Stories e Tasks são adicionadas ao board em **✅ Ready** com Status `Todo`.
 
 ---
 
@@ -315,8 +314,8 @@ Todas as Stories e Tasks são adicionadas ao board em **📋 Backlog Técnico**
 /spec-wave implement 13
 
 # Ou direto:
-npx @spec-wave/cli implement 13 --dry-run   # ver contexto antes
-npx @spec-wave/cli implement 13             # executar
+npx @spec-wave/cli@latest implement 13 --dry-run   # ver contexto antes
+npx @spec-wave/cli@latest implement 13             # executar
 ```
 
 O comando monta um arquivo de contexto com spec.md, plan.md e todas as Tasks da Story, e aciona o spec-kit configurado.
@@ -380,7 +379,7 @@ Isso atualiza apenas os arquivos de workflow sem recriar o Project ou as labels.
 
 Configurar no `init`:
 ```bash
-npx @spec-wave/cli init --repo owner/repo --provider openrouter --model anthropic/claude-3.7-sonnet
+npx @spec-wave/cli@latest init --repo owner/repo --provider openrouter --model anthropic/claude-3.7-sonnet
 ```
 
 ---

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@spec-wave/cli",
-  "version": "0.8.1",
+  "version": "0.10.0",
   "description": "Setup spec-driven GitHub workflow with Projects v2, labels, issue templates, and AI-powered Actions",
   "type": "module",
   "bin": {
@@ -28,4 +28,4 @@
     "commander": "^13.1.0",
     "js-yaml": "^4.1.0"
   }
-}
+}

package/src/commands/decompose.mjs

@@ -265,7 +265,7 @@ async function decomposeFeature(ctx) {
     token, owner, repo, parseInt(issueNumber, 10),
     `🔀 **Decomposição concluída!**\n\n` +
     `Foram criados ${decomposition.stories.length} stories e suas tasks:\n\n${list}\n\n` +
-    `Mova o card para **📋 Backlog Técnico** para iniciar o desenvolvimento.` +
+    `Tudo posicionado em **✅ Ready**. Inicie o desenvolvimento com \`npx @spec-wave/cli@latest implement ${issueNumber}\` (Stories em ordem de dependência).` +
     formatItemsLintWarning(generatedTexts)
   );
   console.log(`Decomposição concluída: ${decomposition.stories.length} stories criadas.`);
@@ -321,7 +321,7 @@ async function decomposeRFC(ctx) {
     token, owner, repo, parseInt(issueNumber, 10),
     `🔀 **Decomposição do RFC concluída!**\n\n` +
     `Foram criadas ${created.length} tasks:\n\n${list}\n\n` +
-    `Mova o card para **📋 Backlog Técnico** para iniciar o desenvolvimento.` +
+    `Tudo posicionado em **✅ Ready**. Inicie o desenvolvimento com \`npx @spec-wave/cli@latest implement <task>\`.` +
     formatItemsLintWarning(generatedTexts)
   );
   console.log(`Decomposição concluída: ${created.length} tasks criadas.`);

package/src/commands/doctor.mjs

@@ -202,7 +202,7 @@ async function checkConfig(ctx) {
     return {
       name,
       status: 'fail',
-      detail: `${CONFIG_FILE} não encontrado em ${ctx.cwd}. Rode \`npx @spec-wave/cli init\`.`,
+      detail: `${CONFIG_FILE} não encontrado em ${ctx.cwd}. Rode \`npx @spec-wave/cli@latest init\`.`,
     };
   }
   if (ctx.cfgError) {
@@ -219,7 +219,7 @@ async function checkConfig(ctx) {
       status: 'warn',
       detail:
         notes.join('\n') +
-        `\nproject.fields sem ${missingFields.map((f) => `"${f}"`).join(' e ')} — rode \`npx @spec-wave/cli refresh\`.`,
+        `\nproject.fields sem ${missingFields.map((f) => `"${f}"`).join(' e ')} — rode \`npx @spec-wave/cli@latest refresh\`.`,
     };
   }
 
@@ -240,7 +240,7 @@ async function checkConfig(ctx) {
           status: 'warn',
           detail:
             notes.join('\n') +
-            `\nOpções de Etapa do config ausentes no project real: ${diverged.join(', ')} — rode \`npx @spec-wave/cli refresh\`.`,
+            `\nOpções de Etapa do config ausentes no project real: ${diverged.join(', ')} — rode \`npx @spec-wave/cli@latest refresh\`.`,
         };
       }
       notes.push(`Project "${snapshot.title}" verificado — campos Etapa/Status em sincronia.`);
@@ -371,7 +371,7 @@ async function checkWorkflows(ctx) {
     return {
       name,
       status: 'warn',
-      detail: '.github/workflows/ não encontrado — rode `npx @spec-wave/cli init` (ou `update`) para instalar os workflows.',
+      detail: '.github/workflows/ não encontrado — rode `npx @spec-wave/cli@latest init` (ou `update`) para instalar os workflows.',
     };
   }
   const present = readdirSync(dir);
@@ -380,7 +380,7 @@ async function checkWorkflows(ctx) {
     return {
       name,
       status: 'warn',
-      detail: `Workflows faltando em .github/workflows/: ${missing.join(', ')} — rode \`npx @spec-wave/cli update\`.`,
+      detail: `Workflows faltando em .github/workflows/: ${missing.join(', ')} — rode \`npx @spec-wave/cli@latest update\`.`,
     };
   }
   return { name, status: 'ok', detail: `Os ${WORKFLOW_FILES.length} workflows do spec-wave estão presentes.` };

package/src/commands/implement.mjs

@@ -14,6 +14,7 @@ import { detectIssueType } from '../lib/issue-type.mjs';
 import { slugify } from '../lib/slugify.mjs';
 import { parseDependencies, orderStories, formatDependencyLine } from '../lib/dependencies.mjs';
 import { loadProjectConfig, resolveField } from '../lib/board.mjs';
+import { planBoardMoves, applyBoardMoves } from '../lib/implement-board.mjs';
 import { extractPathsFromPlan, buildCodeDigest } from '../lib/code-digest.mjs';
 
 // Diretório onde montamos o arquivo de contexto entregue ao spec-kit.
@@ -160,6 +161,13 @@ function buildContext({
   lines.push('');
   lines.push(boardFieldsExplainer());
   lines.push('');
+  lines.push(
+    '> **O board é atualizado automaticamente pelo spec-wave**: no início, ' +
+    'Feature/Story vão para Desenvolvimento (In Progress); na conclusão, ' +
+    'Tasks vão para Done e a Story para Code Review. As instruções de board ' +
+    'abaixo descrevem o modelo — você NÃO precisa mover cards manualmente.'
+  );
+  lines.push('');
   if (type === 'Story') {
     lines.push(
       `Nesta fase, a Story #${issue.number} e suas Tasks estão na Etapa **${STAGE_DEVELOPMENT}**. ` +
@@ -365,6 +373,11 @@ async function implementFeature({ token, owner, repo, config, feature, featureDi
   }
   p.log.info(`Feature com ${stories.length} story(ies): ${stories.map(s => `#${s.number}`).join(', ')}`);
 
+  // F1-board. Feature → Desenvolvimento (In Progress) já no início.
+  await applyBoardMoves({ token, moves: planBoardMoves('start', {
+    feature: { nodeId: feature.node_id, number: feature.number },
+  }) });
+
   // F2. Dependências de cada Story: linha "Depende de:" do body ∪ blocked_by nativo.
   const enriched = await Promise.all(stories.map(async (s) => {
     let body = s.body;
@@ -425,7 +438,7 @@ async function implementFeature({ token, owner, repo, config, feature, featureDi
     const storySubs = await listSubIssues(token, s.nodeId).catch(() => []);
     s.tasks = storySubs
       .filter(t => detectIssueType({ title: t.title, labels: t.labels }) === 'Task')
-      .map(t => ({ number: t.number, title: t.title, body: t.body || '' }));
+      .map(t => ({ number: t.number, title: t.title, body: t.body || '', nodeId: t.nodeId }));
     if (s.tasks.length === 0) noTasks.push(s.number);
   }
   if (noTasks.length > 0) {
@@ -509,7 +522,7 @@ async function implementFeature({ token, owner, repo, config, feature, featureDi
     codeDigest,
     blockedByWarnings,
   });
-  writeContextAndRunSpecKit({
+  await writeContextAndRunSpecKit({
     config,
     issueNumber: feature.number,
     type: 'Feature',
@@ -521,6 +534,16 @@ async function implementFeature({ token, owner, repo, config, feature, featureDi
       `${chalk.green('✓')} Implementação acionada para a Feature #${feature.number} ` +
       `(${pending.length} story(ies) pendente(s)).\n` +
       `  Próximo: acompanhe os PRs de cada Story; a Feature avança para ${STAGE_CODE_REVIEW} após a última.`,
+    onSuccess: async () => {
+      // Execução única para todas as pendentes: no sucesso, Tasks → Done e
+      // Stories → Code Review (a Feature fica com a Action de PR/code-review).
+      for (const s of pending) {
+        await applyBoardMoves({ token, moves: planBoardMoves('success', {
+          story: { nodeId: s.nodeId, number: s.number },
+          tasks: s.tasks || [],
+        }) });
+      }
+    },
   });
 }
 
@@ -588,7 +611,7 @@ export async function implement({ issue: issueArg, featureDir: featureDirOpt, dr
     }
     p.log.info(`Story com ${tasks.length} task(s): ${tasks.map(t => `#${t.number}`).join(', ')}`);
   } else if (type === 'Task') {
-    tasks = [{ number: issue.number, title: issue.title, body: issue.body || '' }];
+    tasks = [{ number: issue.number, title: issue.title, body: issue.body || '', nodeId: issue.node_id }];
     p.log.info(`Task única #${issueNumber}.`);
   } else if (type === 'Feature') {
     // Modo Feature: Stories pendentes em ordem de dependência, contexto único.
@@ -618,6 +641,16 @@ export async function implement({ issue: issueArg, featureDir: featureDirOpt, dr
     p.log.warn('Não foi possível resolver a Feature; seguindo só com as tasks (use --feature-dir).');
   }
 
+  // 4a-board. Board determinístico: Feature/Story → Desenvolvimento (In
+  // Progress) já no início — a UI mostra o desenvolvimento em andamento sem
+  // depender de o LLM mover cards. Best-effort: falha vira warn.
+  await applyBoardMoves({ token, moves: planBoardMoves('start', {
+    feature: feature ? { nodeId: feature.nodeId, number: feature.number } : null,
+    story: type === 'Story' ? { nodeId: issue.node_id, number: issue.number } : null,
+    tasks: tasks.map(t => ({ nodeId: t.nodeId, number: t.number })),
+    tasksStartStatus: type === 'Task' ? PROGRESS_IN_PROGRESS : PROGRESS_TODO,
+  }) });
+
   // 4b. Stories irmãs da Feature — a Feature só avança para Code Review quando
   // TODAS as suas Stories estiverem implementadas. Lista as outras para o agente
   // verificar antes de mover a Feature.
@@ -690,17 +723,21 @@ export async function implement({ issue: issueArg, featureDir: featureDirOpt, dr
     type, issue, tasks, feature, siblingStories, ...specPlan,
     comments, codeDigest, blockedByWarnings,
   });
-  writeContextAndRunSpecKit({
+  await writeContextAndRunSpecKit({
     config, issueNumber, type, title: issue.title, specPlan, context, dryRun,
     outroSuccess:
       `${chalk.green('✓')} Implementação acionada para ${type} #${issueNumber}.\n` +
-      '  Próximo: revise as mudanças, abra o PR e mova o card para 👀 Code Review.',
+      '  Próximo: revise as mudanças e abra o PR — o board já foi atualizado.',
+    onSuccess: () => applyBoardMoves({ token, moves: planBoardMoves('success', {
+      story: type === 'Story' ? { nodeId: issue.node_id, number: issue.number } : null,
+      tasks: tasks.map(t => ({ nodeId: t.nodeId, number: t.number })),
+    }) }),
   });
 }
 
 // Grava o arquivo de contexto e aciona o spec-kit (comando configurável) —
 // fecho comum dos modos Feature e Story/Task.
-function writeContextAndRunSpecKit({ config, issueNumber, type, title, specPlan, context, dryRun, outroSuccess }) {
+async function writeContextAndRunSpecKit({ config, issueNumber, type, title, specPlan, context, dryRun, outroSuccess, onSuccess }) {
   mkdirSync(WORK_DIR, { recursive: true });
   const tasksFile = path.join(WORK_DIR, `implement-${issueNumber}.md`);
   writeFileSync(tasksFile, context);
@@ -746,5 +783,6 @@ function writeContextAndRunSpecKit({ config, issueNumber, type, title, specPlan,
     return;
   }
 
+  if (onSuccess) await onSuccess();
   p.outro(outroSuccess);
 }

package/src/commands/info.mjs

@@ -23,7 +23,7 @@ function reportSkill(status) {
   if (status.agentsDetected.length === 0) {
     p.log.warn(
       'Nenhum agente de código detectado neste diretório — a skill spec-wave ' +
-      'não parece instalada. Rode `npx @spec-wave/cli install-skill`.'
+      'não parece instalada. Rode `npx @spec-wave/cli@latest install-skill`.'
     );
     return;
   }
@@ -34,7 +34,7 @@ function reportSkill(status) {
   p.log.warn(
     'Skill pendente de instalação/atualização:\n' +
     status.pending.map(s => `  ${chalk.yellow('↻')} ${s.agent} (${s.reason}) — ${chalk.dim(s.path)}`).join('\n') +
-    '\nRode `npx @spec-wave/cli install-skill` (ou `npx @spec-wave/cli update`).'
+    '\nRode `npx @spec-wave/cli@latest install-skill` (ou `npx @spec-wave/cli@latest update`).'
   );
 }
 
@@ -55,7 +55,7 @@ export async function info(options = {}) {
     p.log.warn(`Este repositório ${chalk.bold('não foi inicializado')} (sem ${CONFIG_FILE}).`);
     reportSkill(skill);
     p.log.info(`🌐 Acesse o Portal Web da ferramenta em ${chalk.cyan(PORTAL_URL)}`);
-    p.outro('Execute `npx @spec-wave/cli init` para configurar.');
+    p.outro('Execute `npx @spec-wave/cli@latest init` para configurar.');
     return;
   }
 

package/src/commands/init.mjs

@@ -223,7 +223,7 @@ export async function init(options) {
     `  ${configWritten ? '3' : '2'}. Configure o board view para agrupar por "Etapa"\n` +
     `  ${configWritten ? '4' : '3'}. Crie uma Feature com o prefixo [FEATURE] no título\n` +
     `  ${configWritten ? '5' : '4'}. Use a skill spec-wave para guiar o fluxo\n\n` +
-    `  ${chalk.dim('Para instalar a skill no seu agente: npx @spec-wave/cli install-skill')}\n\n` +
+    `  ${chalk.dim('Para instalar a skill no seu agente: npx @spec-wave/cli@latest install-skill')}\n\n` +
     `  🌐 Acesse o Portal Web da ferramenta em ${chalk.cyan(PORTAL_URL)}`
   );
 }

package/src/commands/install-skill.mjs

@@ -100,13 +100,13 @@ export function parseSkill(raw) {
 }
 
 // Banner de versão inserido no topo do corpo da skill instalada. O agente lê
-// esta linha e, se `npx @spec-wave/cli --version` for maior, orienta reinstalar.
+// esta linha e, se `npx @spec-wave/cli@latest --version` for maior, orienta reinstalar.
 function versionBanner(version) {
   return (
     `> ⚙️ **spec-wave skill v${version}** — esta skill é uma cópia estática. ` +
-    'Se `npx @spec-wave/cli --version` indicar uma versão maior, ela está ' +
-    'desatualizada: rode `npx @spec-wave/cli update` (atualiza só o que mudou) ' +
-    'ou `npx @spec-wave/cli install-skill --force` (só a skill).'
+    'Se `npx @spec-wave/cli@latest --version` indicar uma versão maior, ela está ' +
+    'desatualizada: rode `npx @spec-wave/cli@latest update` (atualiza só o que mudou) ' +
+    'ou `npx @spec-wave/cli@latest install-skill --force` (só a skill).'
   );
 }
 

package/src/commands/update.mjs

@@ -210,7 +210,7 @@ export async function update(options = {}) {
   // Config (.spec-wave.json) — reconsulta o Project e reescreve local.
   if (configStale) {
     if (!configStale.canApply) {
-      p.log.warn(`${CONFIG_FILE}: sem project.id — pulei. Rode \`npx @spec-wave/cli init\` (sem --skip-project).`);
+      p.log.warn(`${CONFIG_FILE}: sem project.id — pulei. Rode \`npx @spec-wave/cli@latest init\` (sem --skip-project).`);
     } else {
       const tk = await getToken();
       if (!tk) {

package/src/config.mjs

@@ -52,7 +52,6 @@ export const STATUS_OPTIONS = [
   { name: '📋 Spec',             color: 'YELLOW' },
   { name: '📋 Plan',             color: 'YELLOW' },
   { name: '✅ Ready',            color: 'GREEN'  },
-  { name: '📋 Backlog Técnico',  color: 'BLUE'   },
   { name: '🚧 Desenvolvimento',  color: 'ORANGE' },
   { name: '👀 Code Review',      color: 'PURPLE' },
   { name: '🧪 QA',              color: 'PINK'   },

package/src/lib/implement-board.mjs

@@ -0,0 +1,104 @@
+// Movimentos de board do `implement` — decisão pura + executor não-fatal.
+//
+// O implement passa a mover os cards DETERMINISTICAMENTE (em código, não em
+// prosa para o LLM seguir): no início a Feature/Story vão para Desenvolvimento
+// (In Progress) e, no sucesso do spec-kit, as Tasks vão para Done e a Story
+// para Code Review — mesma semântica de `task start`/`task done`/`story review`
+// e do que o contexto em prosa sempre pediu. Falha de board NUNCA derruba a
+// implementação (warn e segue).
+
+import * as p from '@clack/prompts';
+import { loadProjectConfig, resolveField, advanceToStage, setItemStatus } from './board.mjs';
+import {
+  STAGE_DEVELOPMENT, STAGE_CODE_REVIEW, STAGE_DONE,
+  PROGRESS_TODO, PROGRESS_IN_PROGRESS, PROGRESS_DONE,
+} from '../config.mjs';
+
+/**
+ * Decide os movimentos de board de uma fase do implement. Pura, sem I/O.
+ *
+ * @param {'start'|'success'} phase
+ * @param {{ feature?: {nodeId:string,number:number}|null,
+ *           story?:   {nodeId:string,number:number}|null,
+ *           tasks?:   Array<{nodeId?:string,number:number}> }} refs
+ * @returns {Array<{nodeId:string, label:string, stage:string, status:string,
+ *                  statusFallback:boolean}>}
+ *   statusFallback: se a Etapa já estiver adiante (advanceToStage devolve
+ *   false), ainda assim alinhar o Status — usado nos movimentos de início
+ *   (ex.: Feature já em Desenvolvimento volta a mostrar In Progress).
+ */
+export function planBoardMoves(phase, {
+  feature = null, story = null, tasks = [],
+  // Status das Tasks na fase start: Todo quando enfileiradas atrás de uma
+  // Story; In Progress quando a própria Task é o item sendo implementado.
+  tasksStartStatus = PROGRESS_TODO,
+} = {}) {
+  const moves = [];
+  if (phase === 'start') {
+    if (feature?.nodeId) {
+      moves.push({ nodeId: feature.nodeId, label: `Feature #${feature.number}`,
+                   stage: STAGE_DEVELOPMENT, status: PROGRESS_IN_PROGRESS, statusFallback: true });
+    }
+    if (story?.nodeId) {
+      moves.push({ nodeId: story.nodeId, label: `Story #${story.number}`,
+                   stage: STAGE_DEVELOPMENT, status: PROGRESS_IN_PROGRESS, statusFallback: true });
+    }
+    for (const t of tasks) {
+      if (!t?.nodeId) continue;
+      moves.push({ nodeId: t.nodeId, label: `Task #${t.number}`,
+                   stage: STAGE_DEVELOPMENT, status: tasksStartStatus,
+                   statusFallback: tasksStartStatus === PROGRESS_IN_PROGRESS });
+    }
+  } else if (phase === 'success') {
+    for (const t of tasks) {
+      if (!t?.nodeId) continue;
+      moves.push({ nodeId: t.nodeId, label: `Task #${t.number}`,
+                   stage: STAGE_DONE, status: PROGRESS_DONE, statusFallback: false });
+    }
+    if (story?.nodeId) {
+      moves.push({ nodeId: story.nodeId, label: `Story #${story.number}`,
+                   stage: STAGE_CODE_REVIEW, status: PROGRESS_TODO, statusFallback: false });
+    }
+  }
+  return moves;
+}
+
+/**
+ * Executa os movimentos no Projects v2. Best-effort: qualquer falha vira
+ * warn e a implementação continua. Usa PROJECT_TOKEN quando definido (PAT
+ * com scope de Project em org — mesmo padrão do code-review/qa).
+ */
+export async function applyBoardMoves({ token, moves, cwd = process.cwd(), log = p.log }) {
+  if (!moves || moves.length === 0) return;
+  try {
+    const { project, error } = loadProjectConfig({ cwd });
+    if (error) {
+      log.warn(`board: ${error} — Etapas não atualizadas.`);
+      return;
+    }
+    const projectToken = process.env.PROJECT_TOKEN || token;
+    const etapaField = await resolveField(projectToken, project, 'Etapa').catch(() => null);
+    const statusField = await resolveField(projectToken, project, 'Status').catch(() => null);
+    if (!etapaField?.id) {
+      log.warn('board: campo Etapa não resolvido — Etapas não atualizadas.');
+      return;
+    }
+    for (const m of moves) {
+      try {
+        const advanced = await advanceToStage(
+          projectToken, project, etapaField, statusField, m.nodeId, m.stage, m.status);
+        if (advanced) {
+          log.info(`board: ${m.label} → ${m.stage} (${m.status})`);
+        } else if (m.statusFallback && statusField?.id) {
+          // Etapa já está nessa fase ou adiante: ao menos alinha o Status.
+          await setItemStatus(projectToken, project, statusField, m.nodeId, m.status);
+          log.info(`board: ${m.label} já em ${m.stage}+ — Status → ${m.status}`);
+        }
+      } catch (err) {
+        log.warn(`board: falha ao mover ${m.label}: ${err.message}`);
+      }
+    }
+  } catch (err) {
+    log.warn(`board: indisponível (${err.message}) — implementação segue.`);
+  }
+}

package/src/templates/skill/SKILL.md

@@ -4,6 +4,7 @@ description: "Use when the user wants to set up a spec-driven GitHub workflow, c
 argument-hint: "[info|setup|update|doctor|issue|feature|spec|plan|ready|decompose|order|implement|task|story|uninstall|rfc|fix-pr] [target]"
 user-invocable: true
 allowed-tools:
+  - Bash(npx @spec-wave/cli@latest *)
   - Bash(npx @spec-wave/cli *)
   - Bash(gh issue *)
   - Bash(gh project *)
@@ -27,18 +28,18 @@ Este skill guia o usuário pelo fluxo spec-driven definido no RFC-001.
 
 > **Antes de responder a qualquer sub-comando**, leia o arquivo `rfc/rfc-integrate-spec-kit-into-kanban.md` se ele existir no diretório atual, para embasar suas respostas no processo real da equipe.
 
-> **Verifique se esta skill está atualizada:** logo no topo deste arquivo há um banner `spec-wave skill vX.Y.Z` (inserido na instalação). Compare com `npx @spec-wave/cli --version`. Se a CLI for **mais recente** (ou o banner estiver ausente = instalada por versão antiga), esta skill está desatualizada — avise o usuário e sugira `npx @spec-wave/cli update` (detecta e atualiza só o que mudou: skill, `.spec-wave.json` e workflows/labels do repo) ou, para atualizar só a skill, `npx @spec-wave/cli install-skill --force`. A skill é uma cópia estática e **não** acompanha o `npx` sozinha.
+> **Verifique se esta skill está atualizada:** logo no topo deste arquivo há um banner `spec-wave skill vX.Y.Z` (inserido na instalação). Compare com `npx @spec-wave/cli@latest --version`. Se a CLI for **mais recente** (ou o banner estiver ausente = instalada por versão antiga), esta skill está desatualizada — avise o usuário e sugira `npx @spec-wave/cli@latest update` (detecta e atualiza só o que mudou: skill, `.spec-wave.json` e workflows/labels do repo) ou, para atualizar só a skill, `npx @spec-wave/cli@latest install-skill --force`. A skill é uma cópia estática e **não** acompanha o `npx` sozinha.
 
 ---
 
 ## Detecção de configuração (faça isto primeiro, sempre)
 
-Antes de qualquer sub-comando, leia o arquivo `.spec-wave.json` na raiz do repositório atual (use o tool Read). Esse arquivo é gravado pelo `npx @spec-wave/cli init` e é a fonte de estado persistente entre sessões.
+Antes de qualquer sub-comando, leia o arquivo `.spec-wave.json` na raiz do repositório atual (use o tool Read). Esse arquivo é gravado pelo `npx @spec-wave/cli@latest init` e é a fonte de estado persistente entre sessões.
 
 - **Se existir**, o spec-wave já foi configurado. Use seus campos para contextualizar as respostas, sem perguntar de novo:
   - `owner`/`repo` → repositório alvo dos comandos `gh`
   - `project.url` / `project.title` → o GitHub Project a referenciar
-  - `version` → versão da CLI usada no `init` (compare com `npx @spec-wave/cli --version`; se divergir, sugira `npx @spec-wave/cli refresh --config` para atualizar o arquivo, ou re-rodar o `init` para atualizar workflows/labels)
+  - `version` → versão da CLI usada no `init` (compare com `npx @spec-wave/cli@latest --version`; se divergir, sugira `npx @spec-wave/cli@latest refresh --config` para atualizar o arquivo, ou re-rodar o `init` para atualizar workflows/labels)
   - `initializedAt` → quando foi configurado
   Não rode `/spec-wave setup` de novo a menos que o usuário peça explicitamente.
 - **Se não existir**, o repositório provavelmente ainda não foi configurado. Sugira começar por `/spec-wave setup`.
@@ -72,7 +73,7 @@ Exceção: se o usuário pedir explicitamente para revisar ou melhorar um docume
 
 ```
 📥 Backlog → 🎯 Priorizado → 📋 Spec → 📋 Plan → ✅ Ready
-→ 📋 Backlog Técnico → 🚧 Desenvolvimento → 👀 Code Review
+→ 🚧 Desenvolvimento → 👀 Code Review
 → 🧪 QA → 📋 Homologação → 🚀 Deploy → 🎉 Done
 ```
 
@@ -86,13 +87,13 @@ Labels de **estado** (gravadas pelas automações — **não** são gatilhos, n
 - `spec-wave:critique-failed` → a crítica adversarial apontou contradições **graves** nos documentos; **bloqueia** o `spec-wave:ready` até ser removida (veja *Crítica adversarial* abaixo)
 - `spec-wave:decomposed` → a Feature/RFC já foi decomposta; o `decompose` pula silenciosamente enquanto ela existir (veja *Guard de idempotência* abaixo)
 
-A etapa **🚧 Desenvolvimento** é coberta pelo comando **local** `npx @spec-wave/cli implement <número>` (não é uma label/Action): lê uma **Feature** (todas as Stories pendentes, em ordem de dependência), uma Story ou uma Task e aciona o spec-kit para implementar. Veja `/spec-wave implement`.
+A etapa **🚧 Desenvolvimento** é coberta pelo comando **local** `npx @spec-wave/cli@latest implement <número>` (não é uma label/Action): lê uma **Feature** (todas as Stories pendentes, em ordem de dependência), uma Story ou uma Task e aciona o spec-kit para implementar. Veja `/spec-wave implement`.
 
 ---
 
 ## Referência da CLI (conheça os parâmetros ANTES de executar)
 
-Esta skill é um **wrapper** da CLI `@spec-wave/cli`, sempre invocada como `npx @spec-wave/cli <comando>`. Regra de ouro: **nunca rode um comando sem os parâmetros que ele aceita** esperando que ele pergunte — colete os valores com o usuário e passe via flags. Em especial, **`init` sem `--repo` abre um wizard interativo (@clack/prompts) que a skill NÃO consegue dirigir** — sempre passe `--repo`.
+Esta skill é um **wrapper** da CLI `@spec-wave/cli`, sempre invocada como `npx @spec-wave/cli@latest <comando>`. Regra de ouro: **nunca rode um comando sem os parâmetros que ele aceita** esperando que ele pergunte — colete os valores com o usuário e passe via flags. Em especial, **`init` sem `--repo` abre um wizard interativo (@clack/prompts) que a skill NÃO consegue dirigir** — sempre passe `--repo`.
 
 ### `@spec-wave/cli init` — configura o repositório
 | Flag | Tipo | Descrição |
@@ -261,12 +262,12 @@ Edite o bloco `ai` no `.spec-wave.json` (e commite) — o `doctor` mostra o prov
 Mostra se o repositório atual já foi configurado com o spec-wave.
 
 **Passos:**
-1. Execute: `npx @spec-wave/cli info`
+1. Execute: `npx @spec-wave/cli@latest info`
 2. **Se o repositório estiver inicializado**, o comando mostra os dados do `.spec-wave.json` (owner/repo, project, versão da CLI, data). Apresente essas informações ao usuário.
 3. **Se NÃO estiver inicializado**, pergunte ao usuário: "Este repositório ainda não foi configurado com o spec-wave. Quer rodar o `init` agora?"
    - Se sim → siga o fluxo de `/spec-wave setup`.
    - Se não → encerre sem alterar nada.
-4. **Se a saída indicar skill pendente** (aviso "Skill pendente de instalação/atualização" ou, no `--json`, `skill.installNeeded: true`), pergunte ao usuário se quer instalar/atualizar agora: skill `ausente` → `npx @spec-wave/cli install-skill`; skill `desatualizada` → `npx @spec-wave/cli update` (atualiza tudo que ficou para trás). Lembre-o de recarregar o agente depois.
+4. **Se a saída indicar skill pendente** (aviso "Skill pendente de instalação/atualização" ou, no `--json`, `skill.installNeeded: true`), pergunte ao usuário se quer instalar/atualizar agora: skill `ausente` → `npx @spec-wave/cli@latest install-skill`; skill `desatualizada` → `npx @spec-wave/cli@latest update` (atualiza tudo que ficou para trás). Lembre-o de recarregar o agente depois.
 
 ---
 
@@ -277,12 +278,12 @@ Traz tudo para a versão atual da CLI, atualizando **só o que mudou**: a skill
 **Passos:**
 1. **Sempre comece com `--dry-run`** para inspecionar o que está desatualizado sem alterar nada:
    ```bash
-   npx @spec-wave/cli update --dry-run
+   npx @spec-wave/cli@latest update --dry-run
    ```
 2. Mostre ao usuário o resumo (skill / config / arquivos do repo / labels que divergiram). Se **nada** estiver desatualizado, informe que já está tudo na versão atual e encerre.
 3. Se o usuário aprovar, aplique:
    ```bash
-   npx @spec-wave/cli update --yes
+   npx @spec-wave/cli@latest update --yes
    ```
    - Escopos podem ser limitados com `--skip-skill`, `--skip-config`, `--skip-repo`.
    - Atualizações de **arquivos do repo** são commitadas no remoto; o **`.spec-wave.json`** é local (lembre o usuário de commitá-lo).
@@ -292,17 +293,17 @@ Traz tudo para a versão atual da CLI, atualizando **só o que mudou**: a skill
 
 ### `/spec-wave setup`
 
-Configura o spec-wave no repositório. Você dirige o `init` com flags — **nunca rode `npx @spec-wave/cli init` sem `--repo`** (abre o wizard interativo que você não controla).
+Configura o spec-wave no repositório. Você dirige o `init` com flags — **nunca rode `npx @spec-wave/cli@latest init` sem `--repo`** (abre o wizard interativo que você não controla).
 
 **Passos:**
-1. **Já configurado?** Leia `.spec-wave.json` (ou rode `npx @spec-wave/cli info`). Se existir, avise (mostre `project.url` e `version`) e confirme com o usuário antes de reconfigurar.
+1. **Já configurado?** Leia `.spec-wave.json` (ou rode `npx @spec-wave/cli@latest info`). Se existir, avise (mostre `project.url` e `version`) e confirme com o usuário antes de reconfigurar.
 2. **Descubra o repositório alvo** (parâmetro `--repo`): rode `gh repo view --json nameWithOwner -q .nameWithOwner` para obter `owner/repo` do repo atual. Confirme com o usuário; se não houver remote, pergunte o `owner/repo`.
 3. **Pergunte o título do Project** (parâmetro `--project-title`). Ofereça o default `<repo> — Spec Wave` e aceite-o se o usuário não tiver preferência.
 4. **Cheque o auth:** `gh auth status`. Se faltarem os escopos `project,repo,workflow`, oriente o usuário a rodar ele mesmo `gh auth refresh --scopes project,repo,workflow` (comando interativo — o usuário executa, não você).
-5. **(Opcional) Pré-visualize** antes de aplicar: `npx @spec-wave/cli init --repo <owner/repo> --dry-run`.
+5. **(Opcional) Pré-visualize** antes de aplicar: `npx @spec-wave/cli@latest init --repo <owner/repo> --dry-run`.
 6. **Execute com os parâmetros coletados:**
    ```bash
-   npx @spec-wave/cli init --repo <owner/repo> --project-title "<título>"
+   npx @spec-wave/cli@latest init --repo <owner/repo> --project-title "<título>"
    ```
    Use `--skip-project` / `--skip-labels` / `--skip-files` **apenas** para re-rodar uma fase específica que falhou antes.
 7. O `init` cria o Project, as labels, os workflows, um **scaffold de `.github/config/tech_context.yml`** (só se ainda não existir) e grava `.spec-wave.json`. Oriente o usuário a fazer `git pull` para trazer os arquivos ao checkout local.
@@ -323,7 +324,7 @@ Crie um work item tipado (Initiative/Epic/Feature/Story/Task/...) já adicionado
 1. Pergunte ao usuário: tipo (initiative/epic/feature/story/task/...), título (sem prefixo), descrição e se há uma issue **pai** (número). **Prioridade e área são opcionais**: só as inclua se o usuário pedir explicitamente. **Nunca atribua uma prioridade por conta própria** — se o usuário não informou, **omita `--priority`** e a prioridade fica `null` (sem prioridade) no board.
 2. Execute o comando com os parâmetros coletados (inclua **apenas** as flags que o usuário forneceu):
    ```bash
-   npx @spec-wave/cli issue \
+   npx @spec-wave/cli@latest issue \
      --type "<tipo>" \
      --title "<título>" \
      --body "<descrição>" \
@@ -331,7 +332,7 @@ Crie um work item tipado (Initiative/Epic/Feature/Story/Task/...) já adicionado
      --priority "<prioridade>" \  # opcional — só se o usuário pediu; caso contrário OMITA (prioridade fica null)
      --parent "<número-do-pai>"   # opcional
    ```
-   Para Features, pode usar o atalho `npx @spec-wave/cli feature --title ...` (equivale a `--type feature`).
+   Para Features, pode usar o atalho `npx @spec-wave/cli@latest feature --title ...` (equivale a `--type feature`).
    A CLI cria a issue (label de tipo — e de prioridade **apenas se `--priority` for informado**), vincula como sub-issue do parent, adiciona ao Project e define Etapa = 📥 Backlog + Work Item Type + Area (+ Priority só se informada). **Não use `gh issue create`** (não adiciona ao board nem vincula o parent).
 3. Informe o número criado e o vínculo com o pai (se houver).
 4. Para Features: "Quando quiser iniciar, mova para **📋 Spec** e use `/spec-wave spec <número>` para gerar a especificação funcional (o plano técnico vem depois)".
@@ -344,8 +345,8 @@ Remove a configuração do spec-wave do repositório (labels, arquivos `.github`
 
 **Passos:**
 1. Confirme com o usuário que ele quer remover (a ação remove labels e faz commits removendo os workflows).
-2. Mostre antes o que será removido com `npx @spec-wave/cli uninstall --dry-run`.
-3. Execute `npx @spec-wave/cli uninstall` (a CLI pede confirmação; use `--yes` só se o usuário já confirmou).
+2. Mostre antes o que será removido com `npx @spec-wave/cli@latest uninstall --dry-run`.
+3. Execute `npx @spec-wave/cli@latest uninstall` (a CLI pede confirmação; use `--yes` só se o usuário já confirmou).
 4. Lembre o usuário de excluir o **GitHub Project** manualmente, se desejar — a CLI não o apaga de propósito.
 
 ---
@@ -389,7 +390,7 @@ O plano técnico segue o schema do RFC-002 §3.2: **Estratégia Técnica** (com
 
 ### Tech Context (`.github/config/tech_context.yml`)
 
-Fonte de verdade estática da stack do sistema (RFC-002 §4). O `generate-plan` lê este arquivo para embasar o plano técnico e usar **APENAS** as tecnologias/serviços nele declarados — sem ele, o plano fica genérico e pode inventar APIs inexistentes. O `npx @spec-wave/cli init` gera um **scaffold de exemplo** que **deve ser adaptado** à stack real. Use este fluxo quando o arquivo estiver ausente ou desatualizado.
+Fonte de verdade estática da stack do sistema (RFC-002 §4). O `generate-plan` lê este arquivo para embasar o plano técnico e usar **APENAS** as tecnologias/serviços nele declarados — sem ele, o plano fica genérico e pode inventar APIs inexistentes. O `npx @spec-wave/cli@latest init` gera um **scaffold de exemplo** que **deve ser adaptado** à stack real. Use este fluxo quando o arquivo estiver ausente ou desatualizado.
 
 **Como ajudar a criar (quando não existir):**
 
@@ -455,7 +456,7 @@ Valida que spec.md e plan.md estão completos e a Feature pode avançar.
 2. Informe: "Validação iniciada. O workflow verificará se spec.md e plan.md contêm todas as seções obrigatórias."
 3. Se a validação falhar, o workflow comentará os problemas na issue e adicionará automaticamente `spec-wave:spec`. Informe o usuário para corrigir e tentar novamente.
 4. **Se a issue tiver a label `spec-wave:critique-failed`**, a validação falha de imediato: a crítica adversarial apontou contradições graves (comentário 🔎 na issue). Siga o fluxo de resolução da seção *Crítica adversarial*: corrigir os documentos → remover a label → re-aplicar `spec-wave:ready`.
-5. Se passar, oriente: "Feature validada! Mova o card para **✅ Ready** e depois para **📋 Backlog Técnico** para iniciar a decomposição."
+5. Se passar, oriente: "Feature validada! Mova o card para **✅ Ready** e use `/spec-wave decompose <número>` para gerar as Stories."
 
 ---
 
@@ -474,7 +475,7 @@ Para qualquer outro tipo (Spike, Bug, Story, Task, …) o Action **recusa** e co
    gh issue edit <número> --add-label "spec-wave:decompose"
    ```
 3. Informe: "Decomposição iniciada — Feature gera Stories+Tasks; RFC gera Tasks."
-4. Após a conclusão, as issues filhas aparecerão como comentário na issue pai, junto com o comentário 🔎 da crítica adversarial. A issue pai e as Stories/Tasks criadas entram no board na Etapa **✅ Ready** (Status Todo; a Etapa nunca retrocede — itens já adiante não são tocados). As Stories geradas trazem a linha `Depende de: #N` (+ relação *blocked by*) — use `npx @spec-wave/cli order <número>` para ver a ordem de execução.
+4. Após a conclusão, as issues filhas aparecerão como comentário na issue pai, junto com o comentário 🔎 da crítica adversarial. A issue pai e as Stories/Tasks criadas entram no board na Etapa **✅ Ready** (Status Todo; a Etapa nunca retrocede — itens já adiante não são tocados). As Stories geradas trazem a linha `Depende de: #N` (+ relação *blocked by*) — use `npx @spec-wave/cli@latest order <número>` para ver a ordem de execução.
 5. A issue recebe a label `spec-wave:decomposed` (guard de idempotência): rodar de novo **não** duplica as issues. Para forçar um re-decompose, siga a seção *Guard de idempotência*.
 
 ---
@@ -485,23 +486,23 @@ Aciona o spec-kit para implementar uma **Feature** (todas as Stories pendentes,
 
 **Pré-requisitos:** o repositório atual precisa estar inicializado (`.spec-wave.json` presente) e a issue deve ser do tipo Feature, Story ou Task. Para executar de fato (fora do `--dry-run`), o spec-kit precisa estar configurado via `specKit.command` no `.spec-wave.json` ou a env `SPEC_WAVE_IMPLEMENT_CMD`.
 
-**Modo Feature:** o comando avalia as Stories da Feature — ordena topologicamente pelas dependências (`Depende de:` + *blocked by*), consulta a Etapa de cada uma no board e **pula as já implementadas** (👀 Code Review ou além). O contexto único (`.spec-wave/implement-<feature>.md`) traz as pendentes em ordem, cada uma com suas Tasks. **Ciclo de dependências entre Stories pendentes → o comando aborta** (corrija as linhas `Depende de:`; use `npx @spec-wave/cli order <feature>` para visualizar). Story pendente sem Tasks → aborta pedindo decomposição. Todas implementadas → encerra sem acionar o spec-kit.
+**Modo Feature:** o comando avalia as Stories da Feature — ordena topologicamente pelas dependências (`Depende de:` + *blocked by*), consulta a Etapa de cada uma no board e **pula as já implementadas** (👀 Code Review ou além). O contexto único (`.spec-wave/implement-<feature>.md`) traz as pendentes em ordem, cada uma com suas Tasks. **Ciclo de dependências entre Stories pendentes → o comando aborta** (corrija as linhas `Depende de:`; use `npx @spec-wave/cli@latest order <feature>` para visualizar). Story pendente sem Tasks → aborta pedindo decomposição. Todas implementadas → encerra sem acionar o spec-kit.
 
 **Passos:**
 1. Confirme que há `.spec-wave.json` no repo (senão, oriente `/spec-wave setup`).
 2. **Sempre comece com `--dry-run`** para inspecionar o que será feito — detecção do tipo, lista de Tasks coletadas (Story) ou a ordem/puladas/ciclos das Stories (Feature) e o comando do spec-kit que seria executado:
    ```bash
-   npx @spec-wave/cli implement <número> --dry-run
+   npx @spec-wave/cli@latest implement <número> --dry-run
    ```
 3. Mostre ao usuário o contexto montado em `.spec-wave/implement-<número>.md` e o comando. Esse arquivo contém as **instruções de execução sequencial**: implemente as Tasks **uma por vez** — mova a task para **🚧 Desenvolvimento** só ao iniciá-la e para **🎉 Done** ao concluí-la, antes de passar para a próxima. **Nunca** coloque várias tasks em "in progress" ao mesmo tempo.
-4. **Se você (agente) for implementar diretamente** (sem `specKit.command`): siga o contexto task por task. Para cada task: `npx @spec-wave/cli task start <n>` ao iniciar (Etapa 🚧 Desenvolvimento + Status In Progress) e `npx @spec-wave/cli task done <n>` ao concluir (Etapa 🎉 Done + Status Done) — **prefira esses comandos a mutações GraphQL/`gh` manuais**: eles embutem as regras do board (Etapa nunca retrocede; uma task In Progress por vez). Se o contexto trouxer **aviso de dependência pendente** (a issue depende de outra não concluída), confirme com o usuário antes de seguir. **Ao concluir toda a Story**: faça o commit, abra o PR e mova a Story com `npx @spec-wave/cli story review <n>` (Etapa 👀 Code Review, Status → Todo) — as Tasks já estão em 🎉 Done. A **Feature só avança** quando **TODAS as suas Stories** já estiverem em Code Review — se houver Story pendente, deixe a Feature em 🚧 Desenvolvimento. Lembre: Etapa só avança (nunca volta); Status é o progresso dentro da etapa.
+4. **Se você (agente) for implementar diretamente** (sem `specKit.command`): siga o contexto task por task. Para cada task: `npx @spec-wave/cli@latest task start <n>` ao iniciar (Etapa 🚧 Desenvolvimento + Status In Progress) e `npx @spec-wave/cli@latest task done <n>` ao concluir (Etapa 🎉 Done + Status Done) — **prefira esses comandos a mutações GraphQL/`gh` manuais**: eles embutem as regras do board (Etapa nunca retrocede; uma task In Progress por vez). Se o contexto trouxer **aviso de dependência pendente** (a issue depende de outra não concluída), confirme com o usuário antes de seguir. **Ao concluir toda a Story**: faça o commit, abra o PR e mova a Story com `npx @spec-wave/cli@latest story review <n>` (Etapa 👀 Code Review, Status → Todo) — as Tasks já estão em 🎉 Done. A **Feature só avança** quando **TODAS as suas Stories** já estiverem em Code Review — se houver Story pendente, deixe a Feature em 🚧 Desenvolvimento. Lembre: Etapa só avança (nunca volta); Status é o progresso dentro da etapa.
 5. Se o usuário aprovar e o spec-kit estiver configurado, rode sem `--dry-run`:
    ```bash
-   npx @spec-wave/cli implement <número>
+   npx @spec-wave/cli@latest implement <número>
    ```
    - Se o spec-kit **não** estiver configurado, o comando só monta o contexto e mostra como configurar (`specKit.command` / `SPEC_WAVE_IMPLEMENT_CMD`). Ajude o usuário a definir o template (placeholders: `{tasksFile} {specFile} {planFile} {issue} {type} {title}`).
    - Use `--feature-dir docs/features/<slug>` se a resolução automática da Feature falhar (a skill avisa com warning) e você quiser anexar `spec.md`/`plan.md` como contexto.
-6. **No modo Feature**, siga o contexto Story a Story, na ordem listada: para cada Story pendente, implemente as Tasks com `task start`/`task done`, depois commit + PR + `npx @spec-wave/cli story review <n>`; só então passe à próxima Story. Se a issue **não** for Feature, Story nem Task (ex.: Bug, Spike, Epic), o comando recusa. Feature **sem Stories** → rode `/spec-wave decompose` primeiro. **Ciclo de dependências** → corrija as linhas `Depende de:` (veja `spec-wave order`).
+6. **No modo Feature**, siga o contexto Story a Story, na ordem listada: para cada Story pendente, implemente as Tasks com `task start`/`task done`, depois commit + PR + `npx @spec-wave/cli@latest story review <n>`; só então passe à próxima Story. Se a issue **não** for Feature, Story nem Task (ex.: Bug, Spike, Epic), o comando recusa. Feature **sem Stories** → rode `/spec-wave decompose` primeiro. **Ciclo de dependências** → corrija as linhas `Depende de:` (veja `spec-wave order`).
 7. Ao final (Tasks em **🎉 Done**, Story em **👀 Code Review**; a Feature só vai para Code Review quando a última Story concluir — no modo Feature, isso acontece dentro da mesma execução): confirme o resultado com o usuário e oriente a revisão dos PRs.
 
 ---

package/src/templates/workflows/code-review.yml

@@ -24,7 +24,7 @@ jobs:
           node-version: '24'
 
       - name: Move Feature to Code Review
-        run: npx @spec-wave/cli code-review --pr-number ${{ github.event.pull_request.number }}
+        run: npx @spec-wave/cli@latest code-review --pr-number ${{ github.event.pull_request.number }}
         env:
           GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}
           PROJECT_TOKEN: ${{ secrets.GH_PROJECT_TOKEN }}

package/src/templates/workflows/decompose.yml

@@ -29,7 +29,7 @@ jobs:
           node-version: '24'
 
       - name: Decompose into Stories and Tasks
-        run: npx @spec-wave/cli decompose --issue-number ${{ github.event.issue.number }}
+        run: npx @spec-wave/cli@latest decompose --issue-number ${{ github.event.issue.number }}
         env:
           GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}
           PROJECT_TOKEN: ${{ secrets.GH_PROJECT_TOKEN }}

package/src/templates/workflows/generate-plan.yml

@@ -28,7 +28,7 @@ jobs:
           node-version: '24'
 
       - name: Generate plan.md
-        run: npx @spec-wave/cli generate-plan --issue-number ${{ github.event.issue.number }}
+        run: npx @spec-wave/cli@latest generate-plan --issue-number ${{ github.event.issue.number }}
         env:
           GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}
           ANTHROPIC_API_KEY: ${{ secrets.ANTHROPIC_API_KEY }}

package/src/templates/workflows/generate-spec.yml

@@ -28,7 +28,7 @@ jobs:
           node-version: '24'
 
       - name: Generate spec.md
-        run: npx @spec-wave/cli generate-spec --issue-number ${{ github.event.issue.number }}
+        run: npx @spec-wave/cli@latest generate-spec --issue-number ${{ github.event.issue.number }}
         env:
           GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}
           ANTHROPIC_API_KEY: ${{ secrets.ANTHROPIC_API_KEY }}

package/src/templates/workflows/qa.yml

@@ -25,7 +25,7 @@ jobs:
           node-version: '24'
 
       - name: Move Feature to QA
-        run: npx @spec-wave/cli qa --pr-number ${{ github.event.pull_request.number }}
+        run: npx @spec-wave/cli@latest qa --pr-number ${{ github.event.pull_request.number }}
         env:
           GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}
           PROJECT_TOKEN: ${{ secrets.GH_PROJECT_TOKEN }}

package/src/templates/workflows/validate.yml

@@ -26,7 +26,7 @@ jobs:
           node-version: '24'
 
       - name: Validate spec and plan
-        run: npx @spec-wave/cli validate --issue-number ${{ github.event.issue.number }}
+        run: npx @spec-wave/cli@latest validate --issue-number ${{ github.event.issue.number }}
         env:
           GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}
           GITHUB_REPOSITORY: ${{ github.repository }}