@brunosps00/dev-workflow 0.6.1 → 0.7.0

package/lib/constants.js

@@ -1,61 +1,61 @@
 const COMMANDS = {
   en: [
-    { name: 'dw-adr', description: 'Record an Architecture Decision Record (ADR) for a non-trivial decision during PRD execution' },
-    { name: 'dw-analyze-project', description: 'Analyze repository stack, patterns, and conventions to generate project rules' },
-    { name: 'dw-autopilot', description: 'Full pipeline orchestrator from a wish to a PR with minimal intervention (research, PRD, tasks, execution, QA, review, commit)' },
-    { name: 'dw-brainstorm', description: 'Explore ideas and directions before starting implementation' },
-    { name: 'dw-bugfix', description: 'Analyze and fix bugs with automatic triage (bug vs feature vs scope)' },
-    { name: 'dw-code-review', description: 'Formal code review (Level 3) with persisted report' },
-    { name: 'dw-commit', description: 'Create semantic commits following Conventional Commits' },
-    { name: 'dw-create-prd', description: 'Create a Product Requirements Document with clarification questions' },
-    { name: 'dw-create-tasks', description: 'Break down PRD and TechSpec into implementable tasks' },
-    { name: 'dw-create-techspec', description: 'Create a Technical Specification from an existing PRD' },
-    { name: 'dw-deep-research', description: 'Conduct multi-source research with citation tracking and verification' },
-    { name: 'dw-fix-qa', description: 'Fix bugs found during QA and retest until stable' },
-    { name: 'dw-functional-doc', description: 'Generate functional documentation dossier with screen mapping, E2E flows, and Playwright validation' },
-    { name: 'dw-generate-pr', description: 'Generate a Pull Request with structured description' },
-    { name: 'dw-help', description: 'Show complete guide of available commands and workflows' },
-    { name: 'dw-intel', description: 'Query codebase intelligence to understand patterns, conventions, and architecture' },
-    { name: 'dw-quick', description: 'Execute a one-off task with workflow guarantees without requiring a full PRD' },
-    { name: 'dw-redesign-ui', description: 'Analyze, propose, and implement frontend page/component redesigns with design system integration' },
-    { name: 'dw-refactoring-analysis', description: 'Audit codebase for code smells and refactoring opportunities with prioritized report' },
-    { name: 'dw-resume', description: 'Restore session context and suggest the next workflow step' },
-    { name: 'dw-review-implementation', description: 'Review if all PRD requirements were correctly implemented' },
-    { name: 'dw-revert-task', description: 'Safely revert the commits of a specific task with dependency-aware checks' },
-    { name: 'dw-run-plan', description: 'Execute ALL tasks sequentially until the plan is complete' },
-    { name: 'dw-run-qa', description: 'Run visual QA with browser automation, E2E tests, and accessibility' },
-    { name: 'dw-run-task', description: 'Execute a single task with built-in validation and testing' },
-    { name: 'dw-security-check', description: 'Run a rigid multi-layer security check (OWASP static + Trivy SCA/IaC + native audit) for TS, Python, C#, or Rust projects' },
-    { name: 'dw-update', description: 'Update dev-workflow to the latest version published on npm without leaving the agent session' },
+    { name: 'dw-adr', description: 'Records an architectural decision and the trade-offs accepted, before they get lost.' },
+    { name: 'dw-analyze-project', description: 'Scans the repo to learn its stack and conventions, then writes the rules other commands rely on.' },
+    { name: 'dw-autopilot', description: 'Takes a wish and runs the full PRD-to-PR pipeline, stopping only at three approval gates.' },
+    { name: 'dw-brainstorm', description: 'Refines an idea using the product\'s existing features as ground truth, before any PRD.' },
+    { name: 'dw-bugfix', description: 'Triages a bug report, asks three sharp questions, then fixes it or routes it to a PRD.' },
+    { name: 'dw-code-review', description: 'Level-3 review against PRD, rules, tests, and security; saves a verdict you can act on.' },
+    { name: 'dw-commit', description: 'Groups changes by intent and writes Conventional Commits messages that read clean.' },
+    { name: 'dw-create-prd', description: 'Writes a PRD after asking the questions that would otherwise haunt the techspec later.' },
+    { name: 'dw-create-tasks', description: 'Breaks the PRD and techspec into tasks small enough to ship one at a time.' },
+    { name: 'dw-create-techspec', description: 'Translates a finished PRD into a techspec the team can actually build from.' },
+    { name: 'dw-deep-research', description: 'Researches a topic across sources, tracks citations, and flags claims that don\'t check out.' },
+    { name: 'dw-fix-qa', description: 'Fixes bugs found in QA and retests them with screenshot evidence until they stay fixed.' },
+    { name: 'dw-functional-doc', description: 'Maps screens and user flows into a functional doc, validated end-to-end with Playwright.' },
+    { name: 'dw-generate-pr', description: 'Pushes the branch and opens a PR with a body that explains what changed and how to test it.' },
+    { name: 'dw-help', description: 'Lists every command and the flows that connect them. Pass a keyword for a contextual shortcut.' },
+    { name: 'dw-intel', description: 'Answers questions about the codebase using its own rules and intel as the source of truth.' },
+    { name: 'dw-quick', description: 'Runs a small, well-defined change with workflow guarantees, no PRD needed.' },
+    { name: 'dw-redesign-ui', description: 'Audits a frontend page, proposes design directions you choose from, then ships the redesign.' },
+    { name: 'dw-refactoring-analysis', description: 'Catalogs code smells in Fowler\'s vocabulary and ranks them by impact, P0 to P3.' },
+    { name: 'dw-resume', description: 'Picks up where you left off — reads the active PRD, the last task, and tells you what\'s next.' },
+    { name: 'dw-review-implementation', description: 'Maps every PRD requirement to the code that delivers it, and lists what is still missing.' },
+    { name: 'dw-revert-task', description: 'Reverts the commits of one task, but only after checking nothing downstream depends on it.' },
+    { name: 'dw-run-plan', description: 'Runs every pending task in order, with PRD-compliance review at the end.' },
+    { name: 'dw-run-qa', description: 'Drives the browser to test happy paths, edge cases, and accessibility, with screenshot proof.' },
+    { name: 'dw-run-task', description: 'Implements one task, runs the validation that comes with it, and commits when it passes.' },
+    { name: 'dw-security-check', description: 'OWASP review plus Trivy CVE/secret/IaC scan for TS, Python, C#, or Rust. CRITICAL or HIGH blocks the PR.' },
+    { name: 'dw-update', description: 'Updates dev-workflow to the latest npm release in-place, with a snapshot you can roll back to.' },
   ],
   'pt-br': [
-    { name: 'dw-adr', description: 'Registrar um Architecture Decision Record (ADR) para uma decisao nao-trivial durante o PRD' },
-    { name: 'dw-analyze-project', description: 'Analisa stack, patterns e convencoes do repositorio para gerar regras do projeto' },
-    { name: 'dw-autopilot', description: 'Orquestrador completo de um desejo ate o PR com minima intervencao (pesquisa, PRD, tasks, execucao, QA, review, commit)' },
-    { name: 'dw-brainstorm', description: 'Explorar ideias e direcoes antes de comecar a implementacao' },
-    { name: 'dw-bugfix', description: 'Analisar e corrigir bugs com triagem automatica (bug vs feature vs escopo)' },
-    { name: 'dw-code-review', description: 'Code review formal (Nivel 3) com relatorio persistido' },
-    { name: 'dw-commit', description: 'Criar commits semanticos seguindo Conventional Commits' },
-    { name: 'dw-create-prd', description: 'Criar um Product Requirements Document com perguntas de clarificacao' },
-    { name: 'dw-create-tasks', description: 'Quebrar PRD e TechSpec em tasks implementaveis' },
-    { name: 'dw-create-techspec', description: 'Criar uma Especificacao Tecnica a partir de um PRD existente' },
-    { name: 'dw-deep-research', description: 'Pesquisa multi-fonte com rastreamento de citacoes e verificacao' },
-    { name: 'dw-fix-qa', description: 'Corrigir bugs encontrados no QA e retestar ate estabilizar' },
-    { name: 'dw-functional-doc', description: 'Gerar dossie funcional com mapeamento de telas, fluxos E2E e validacao com Playwright' },
-    { name: 'dw-generate-pr', description: 'Gerar um Pull Request com descricao estruturada' },
-    { name: 'dw-help', description: 'Mostrar guia completo dos comandos e fluxos disponiveis' },
-    { name: 'dw-intel', description: 'Consultar inteligencia do codebase para entender padroes, convencoes e arquitetura' },
-    { name: 'dw-quick', description: 'Executar uma task pontual com garantias do workflow sem precisar de PRD completo' },
-    { name: 'dw-redesign-ui', description: 'Analisar, propor e implementar redesign de paginas/componentes frontend com integracao de design system' },
-    { name: 'dw-refactoring-analysis', description: 'Auditar codebase para code smells e oportunidades de refatoracao com relatorio priorizado' },
-    { name: 'dw-resume', description: 'Restaurar contexto da sessao e sugerir o proximo passo do workflow' },
-    { name: 'dw-review-implementation', description: 'Revisar se todos os requisitos do PRD foram implementados corretamente' },
-    { name: 'dw-revert-task', description: 'Reverter com seguranca os commits de uma task especifica com checks de dependencia' },
-    { name: 'dw-run-plan', description: 'Executar TODAS as tasks sequencialmente ate completar o plano' },
-    { name: 'dw-run-qa', description: 'Executar QA visual com automacao de browser, testes E2E e acessibilidade' },
-    { name: 'dw-run-task', description: 'Executar uma task com validacao e testes integrados' },
-    { name: 'dw-security-check', description: 'Check de seguranca rigido multi-camada (OWASP estatico + Trivy SCA/IaC + audit nativo) para projetos TS, Python, C# ou Rust' },
-    { name: 'dw-update', description: 'Atualizar o dev-workflow para a versao mais recente publicada no npm sem sair da sessao do agente' },
+    { name: 'dw-adr', description: 'Registra uma decisao arquitetural e os trade-offs aceitos, antes que se percam.' },
+    { name: 'dw-analyze-project', description: 'Escaneia o repo para aprender stack e convencoes, e escreve as regras que os outros commands usam.' },
+    { name: 'dw-autopilot', description: 'Pega um desejo e roda do PRD ao PR, parando so em tres gates de aprovacao.' },
+    { name: 'dw-brainstorm', description: 'Refina uma ideia usando as features existentes do produto como base, antes de qualquer PRD.' },
+    { name: 'dw-bugfix', description: 'Tria um bug, faz tres perguntas certas, e entao corrige ou redireciona para PRD.' },
+    { name: 'dw-code-review', description: 'Review Nivel 3 contra PRD, rules, testes e seguranca; gera um veredicto acionavel.' },
+    { name: 'dw-commit', description: 'Agrupa as mudancas por intencao e escreve mensagens Conventional Commits limpas.' },
+    { name: 'dw-create-prd', description: 'Escreve um PRD depois de fazer as perguntas que assombrariam o techspec depois.' },
+    { name: 'dw-create-tasks', description: 'Quebra PRD e techspec em tasks pequenas o suficiente para entregar uma de cada vez.' },
+    { name: 'dw-create-techspec', description: 'Traduz um PRD pronto em um techspec que o time consegue construir de fato.' },
+    { name: 'dw-deep-research', description: 'Pesquisa um topico em varias fontes, rastreia citacoes e marca o que nao confere.' },
+    { name: 'dw-fix-qa', description: 'Corrige bugs do QA e retesta com evidencia em screenshot ate ficarem estaveis.' },
+    { name: 'dw-functional-doc', description: 'Mapeia telas e fluxos em um dossie funcional, validado E2E com Playwright.' },
+    { name: 'dw-generate-pr', description: 'Faz push da branch e abre um PR com corpo explicando o que mudou e como testar.' },
+    { name: 'dw-help', description: 'Lista todos os commands e os fluxos que os conectam. Passe uma keyword para atalho contextual.' },
+    { name: 'dw-intel', description: 'Responde perguntas sobre o codebase usando suas proprias rules e intel como fonte.' },
+    { name: 'dw-quick', description: 'Roda uma mudanca pequena e bem definida com garantias do workflow, sem precisar de PRD.' },
+    { name: 'dw-redesign-ui', description: 'Audita uma pagina frontend, propoe direcoes de design que voce escolhe, e entrega o redesign.' },
+    { name: 'dw-refactoring-analysis', description: 'Cataloga code smells no vocabulario de Fowler e ranqueia por impacto, P0 a P3.' },
+    { name: 'dw-resume', description: 'Retoma de onde voce parou — le o PRD ativo, a ultima task, e diz qual o proximo passo.' },
+    { name: 'dw-review-implementation', description: 'Mapeia cada requisito do PRD ao codigo que o entrega, e lista o que ainda falta.' },
+    { name: 'dw-revert-task', description: 'Reverte os commits de uma task, mas so depois de checar que nada a frente depende dela.' },
+    { name: 'dw-run-plan', description: 'Roda todas as tasks pendentes em ordem, com review de PRD compliance no final.' },
+    { name: 'dw-run-qa', description: 'Pilota o browser para testar fluxo feliz, edge cases e acessibilidade, com screenshot.' },
+    { name: 'dw-run-task', description: 'Implementa uma task, roda a validacao que vem com ela, e commita quando passa.' },
+    { name: 'dw-security-check', description: 'Review OWASP + scan Trivy CVE/secret/IaC para TS, Python, C# ou Rust. CRITICAL ou HIGH bloqueia PR.' },
+    { name: 'dw-update', description: 'Atualiza o dev-workflow para o release mais recente no npm, com snapshot para rollback.' },
   ],
 };
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@brunosps00/dev-workflow",
-  "version": "0.6.1",
+  "version": "0.7.0",
   "description": "AI-driven development workflow commands for any project. Scaffolds a complete PRD-to-PR pipeline with multi-platform AI assistant support.",
   "bin": {
     "dev-workflow": "./bin/dev-workflow.js"

package/scaffold/skills/dw-council/SKILL.md

@@ -1,13 +1,6 @@
 ---
 name: dw-council
-description: |
-  Orchestrates a multi-advisor debate (3-5 archetypes) to stress-test
-  high-stakes product, architecture, or scope decisions. Uses parallel
-  subagents with steel-manning, concession tracking, and dissent-preserving
-  synthesis. Invoked opt-in via `--council` flag from dw-brainstorm and
-  dw-create-techspec, or standalone when the user explicitly needs a
-  rigorous debate. Do not use for small decisions, routine implementation,
-  or when a single answer is already obvious.
+description: Multi-advisor debate (3-5 archetypes) with steel-manning and dissent preserved, for high-stakes product or architecture calls.
 allowed-tools:
   - Read
   - Task

package/scaffold/skills/dw-memory/SKILL.md

@@ -1,13 +1,6 @@
 ---
 name: dw-memory
-description: |
-  Maintains workflow-scoped memory for dev-workflow PRD runs using
-  .dw/spec/prd-<name>/MEMORY.md (shared) and .dw/spec/prd-<name>/tasks/<N>_memory.md
-  (task-local). Use when a dev-workflow command needs to persist or recall
-  durable cross-task context (decisions, constraints, risks) across task
-  executions. Invoked from dw-run-task, dw-run-plan, dw-autopilot, and
-  dw-resume. Do not use for PR review remediation, user preferences, or
-  event-log summarization.
+description: Two-tier workflow memory (shared + per-task) with promotion test, so cross-task context survives without bloating files.
 allowed-tools:
   - Read
   - Write

package/scaffold/skills/dw-review-rigor/SKILL.md

@@ -1,12 +1,6 @@
 ---
 name: dw-review-rigor
-description: |
-  Applies review discipline to code-review and analysis commands:
-  de-duplicates issues, orders by severity, verifies intent before flagging,
-  prioritizes signal over volume, and skips concerns that linters already
-  catch. Invoked from dw-code-review, dw-review-implementation, and
-  dw-refactoring-analysis. Do not use for fetching reviews from external
-  providers or for executing fixes.
+description: Five rules for review output — dedupe, severity-order, verify intent, skip linter noise, prefer signal over volume.
 allowed-tools:
   - Read
   - Grep

package/scaffold/skills/dw-verify/SKILL.md

@@ -1,11 +1,6 @@
 ---
 name: dw-verify
-description: |
-  Enforces fresh verification evidence before any completion, fix, or passing
-  claim — and before commits or PR creation. Use when a dev-workflow command
-  is about to report success, hand off work, or commit code. Invoked from
-  dw-run-task, dw-run-plan, dw-fix-qa, dw-bugfix, dw-code-review, dw-generate-pr,
-  and dw-quick. Do not use for early planning or brainstorming.
+description: Demands fresh verification evidence before any success claim or commit. No PASS report, no claim — no exceptions.
 allowed-tools:
   - Bash
   - Read