@brunosps00/dev-workflow 0.0.7 → 0.0.8

package/bin/dev-workflow.js

@@ -1,6 +1,7 @@
 #!/usr/bin/env node
 
 const { run } = require('../lib/init');
+const installDeps = require('../lib/install-deps');
 
 const args = process.argv.slice(2);
 const command = args[0];
@@ -19,13 +20,15 @@ const HELP_TEXT = `
   Usage:
     npx dev-workflow init [--force] [--lang=en|pt-br]
     npx dev-workflow update [--lang=en|pt-br]
+    npx dev-workflow install-deps
     npx dev-workflow help
 
   Commands:
-    init      Scaffold .dw/ (commands, templates, references, scripts, skills, rules, MCPs)
-    update    Update managed files (commands, templates, references, scripts, skills, wrappers, MCPs)
-              Preserves: .dw/rules/, .dw/spec/, user data
-    help      Show this help message
+    init           Scaffold .dw/ (commands, templates, references, scripts, skills, rules, MCPs)
+    update         Update managed files (commands, templates, references, scripts, skills, wrappers, MCPs)
+                   Preserves: .dw/rules/, .dw/spec/, user data
+    install-deps   Install system dependencies (Playwright browsers, MCP servers)
+    help           Show this help message
 
   Options:
     --force        Overwrite existing files (init only; update always overwrites managed files)
@@ -37,6 +40,7 @@ const HELP_TEXT = `
     npx dev-workflow init --lang=pt-br     # Portuguese, no prompt
     npx dev-workflow init --force          # Overwrite existing files
     npx dev-workflow update --lang=en      # Update all managed files to latest version
+    npx dev-workflow install-deps          # Install Playwright browsers and MCP servers
 `;
 
 async function main() {
@@ -47,6 +51,9 @@ async function main() {
     case 'update':
       await run({ force: !!flags.force, lang: flags.lang, mode: 'update' });
       break;
+    case 'install-deps':
+      installDeps.run();
+      break;
     case 'help':
     case '--help':
     case '-h':

package/lib/install-deps.js

@@ -0,0 +1,42 @@
+const { execSync } = require('child_process');
+
+function run() {
+  console.log('\n  dev-workflow install-deps');
+  console.log(`  ${'='.repeat(40)}\n`);
+
+  const deps = [
+    {
+      name: 'Playwright browsers',
+      check: 'npx playwright --version',
+      install: 'npx playwright install --with-deps',
+    },
+    {
+      name: 'Context7 MCP',
+      check: null,
+      install: 'npx -y @upstash/context7-mcp --help',
+    },
+  ];
+
+  let installed = 0;
+  let skipped = 0;
+  let failed = 0;
+
+  for (const dep of deps) {
+    process.stdout.write(`  Installing ${dep.name}...`);
+    try {
+      execSync(dep.install, { stdio: 'pipe', timeout: 300000 });
+      console.log(' \x1b[32m✓\x1b[0m');
+      installed++;
+    } catch (err) {
+      console.log(' \x1b[31m✗\x1b[0m');
+      console.log(`    Error: ${err.message.split('\n')[0]}`);
+      failed++;
+    }
+  }
+
+  console.log(`\n  ${'='.repeat(40)}`);
+  console.log(`  Done! ${installed} installed, ${skipped} skipped, ${failed} failed`);
+  console.log();
+}
+
+module.exports = { run };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@brunosps00/dev-workflow",
-  "version": "0.0.7",
+  "version": "0.0.8",
   "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/en/commands/dw-bugfix.md

@@ -16,7 +16,6 @@
     When available in the project at `./.agents/skills/`, use these skills as contextual support without replacing this command:
 
     - `vercel-react-best-practices`: use when the bug affects React/Next.js and there is suspicion of render, hydration, fetching, waterfall, bundle, or re-render issues
-    - `agent-browser`: use when the bug requires reproduction in a real browser, persistent session, request inspection, or visual capture
     - `webapp-testing`: use when the fix requires a reproducible E2E/retest flow in a web app
     - `security-review`: use when the root cause touches auth, authorization, external input, upload, secrets, SQL, XSS, SSRF, or other sensitive surfaces
 
@@ -158,7 +157,7 @@
     - Related error messages
     - Stack traces
     - Recently modified files
-    - If the bug is UI-related or depends on browser flow, supplement collection with `agent-browser` or `webapp-testing`
+    - If the bug is UI-related or depends on browser flow, supplement collection with `webapp-testing`
 
     ### 3. Clarification Questions (MANDATORY - EXACTLY 3)
 
@@ -196,7 +195,7 @@
     - **Probable Cause**: Based on the evidence
     - **Affected Files**: List of files to modify
     - **Impact**: Other components that may be affected
-    - **Skills used**: explicitly record if the analysis used `vercel-react-best-practices`, `agent-browser`, `webapp-testing`, or `security-review`
+    - **Skills used**: explicitly record if the analysis used `vercel-react-best-practices`, `webapp-testing`, or `security-review`
 
     ### 4.1 Scope Checkpoint (MANDATORY)
 

package/scaffold/en/commands/dw-fix-qa.md

@@ -17,7 +17,6 @@ You are an AI assistant specialized in post-QA bug fixing with evidence-driven r
 
 When available in the project under `./.agents/skills/`, use these skills as operational support without replacing this command:
 
-- `agent-browser`: support for reproducing bugs with persistent sessions, capturing network data, additional screenshots, and validating fixes browser-first
 - `webapp-testing`: support for structuring retests, captures, and scripts when complementary to Playwright MCP
 - `vercel-react-best-practices`: use only if the fix affects React/Next.js frontend and there is risk of rendering, hydration, fetching, or performance regression
 
@@ -87,7 +86,7 @@ For each fixed bug:
    - `QA/logs/console-retest.log`
    - `QA/logs/network-retest.log`
 7. Record in the QA report which user/profile was used in the retest
-8. If the retest requires persistent auth, request inspection beyond MCP, or more faithful real-browser reproduction, complement with `agent-browser` and record this in the report
+8. If the retest requires persistent auth, request inspection beyond MCP, or more faithful real-browser reproduction, record this in the report
 
 ### 4. Update Artifacts
 

package/scaffold/en/commands/dw-functional-doc.md

@@ -49,7 +49,6 @@ Works best with project analyzed by `/dw-analyze-project`
 
 When available in the project under `./.agents/skills/`, use these skills as operational support without replacing this command as source of truth:
 
-- `agent-browser`: support for real navigation, request inspection, screenshots, persistent auth, and browser-first reproduction
 - `webapp-testing`: support for structuring E2E flows, local retests, and evidence collection
 - `remotion-best-practices`: mandatory support when there is a final human video, captions, composition, transitions, FFmpeg, or Remotion
 - `humanizer`: mandatory support for reviewing and naturalizing all captions, `.srt` files, descriptive texts, and any human-facing writing before final delivery

package/scaffold/en/commands/dw-run-qa.md

@@ -20,7 +20,6 @@ You are an AI assistant specialized in Quality Assurance. Your task is to valida
 
 When available in the project under `./.agents/skills/`, use these skills as operational support without replacing this command:
 
-- `agent-browser`: support for operational navigation, persistent auth, additional screenshots, request inspection, and session debugging
 - `webapp-testing`: support for structuring test flows, retests, screenshots, and logs when complementary to Playwright MCP
 - `vercel-react-best-practices`: use only if the frontend under test is React/Next.js and there is indication of regression related to rendering, fetching, hydration, or perceived performance
 
@@ -96,7 +95,7 @@ Refer to `.dw/rules/` for project-specific URLs and frameworks.
 - Verify the application is running on localhost
 - Use `browser_navigate` from Playwright MCP to access the application
 - Confirm the page loaded correctly with `browser_snapshot`
-- If persistent session, auth import, network inspection beyond MCP, or browser-first reproduction is needed, complement with `agent-browser`
+- If persistent session, auth import, or network inspection beyond MCP is needed, complement with `webapp-testing`
 
 ### 3. Menu Page Verification (Required -- Execute BEFORE RF tests)
 
@@ -163,7 +162,7 @@ For each functional requirement from the PRD:
 8. Mark as PASSED or FAILED
 9. Save the Playwright flow script in `{{PRD_PATH}}/QA/scripts/` with standardized name: `RF-XX-[slug].spec.ts` (or `.js`)
 10. Record in the report which credentials (user/profile) were used in each permission-sensitive flow
-11. When the MCP flow becomes unstable or insufficient for operational evidence, complement with `agent-browser` or `webapp-testing`, recording this explicitly in the report
+11. When the MCP flow becomes unstable or insufficient for operational evidence, complement with `webapp-testing`, recording this explicitly in the report
 
 <critical>It is not enough to validate only the happy path. Each requirement must be exercised against its boundary states and most likely regressions</critical>
 <critical>If a requirement cannot be fully validated via E2E, QA must be marked as REJECTED or BLOCKED, never APPROVED</critical>

package/scaffold/en/commands/dw-run-task.md

@@ -20,7 +20,6 @@ When available in the project at `./.agents/skills/`, use these skills as specia
 |-------|---------|
 | `vercel-react-best-practices` | Task touches React rendering, hydration, data fetching, bundle, cache, or performance |
 | `webapp-testing` | Task has interactive frontend needing E2E validation in a real browser |
-| `agent-browser` | UI validation requires persistent session, operational navigation inspection, or complementary visual evidence |
 
 ## File Locations
 
@@ -78,7 +77,7 @@ After providing the summary and approach, **begin implementation immediately**:
 - Follow established project patterns
 - Ensure all requirements are met
 - **Run tests**: use the project's test command
-- If there is interactive frontend, also validate real behavior with `webapp-testing` or `agent-browser` when doing so reduces the risk of invisible regression in unit tests
+- If there is interactive frontend, also validate real behavior with `webapp-testing` when doing so reduces the risk of invisible regression in unit tests
 
 **YOU MUST** start the implementation right after the process above.
 

package/scaffold/pt-br/commands/dw-bugfix.md

@@ -16,7 +16,6 @@
     Quando disponíveis no projeto em `./.agents/skills/`, use estas skills como suporte contextual sem substituir este comando:
 
     - `vercel-react-best-practices`: use quando o bug afeta React/Next.js e há suspeita de problemas de render, hidratação, fetching, waterfall, bundle ou re-render
-    - `agent-browser`: use quando o bug requer reprodução em navegador real, sessão persistente, inspeção de requests ou captura visual
     - `webapp-testing`: use quando a correção requer fluxo E2E/reteste reproduzível em uma web app
     - `security-review`: use quando a causa raiz toca auth, autorização, input externo, upload, secrets, SQL, XSS, SSRF ou outras superfícies sensíveis
 
@@ -152,7 +151,7 @@
     - Mensagens de erro relacionadas
     - Stack traces
     - Arquivos modificados recentemente
-    - Se o bug for relacionado a UI ou depender de fluxo no navegador, complemente a coleta com `agent-browser` ou `webapp-testing`
+    - Se o bug for relacionado a UI ou depender de fluxo no navegador, complemente a coleta com `webapp-testing`
 
     ### 3. Perguntas de Clarificação (OBRIGATÓRIO - EXATAMENTE 3)
 
@@ -179,7 +178,7 @@
     - **Causa Provável**: Baseado nas evidências
     - **Arquivos Afetados**: Lista de arquivos a modificar
     - **Impacto**: Outros componentes que podem ser afetados
-    - **Skills utilizadas**: registre explicitamente se a análise usou `vercel-react-best-practices`, `agent-browser`, `webapp-testing` ou `security-review`
+    - **Skills utilizadas**: registre explicitamente se a análise usou `vercel-react-best-practices`, `webapp-testing` ou `security-review`
 
     ### 4.1 Checkpoint de Escopo (OBRIGATÓRIO)
 

package/scaffold/pt-br/commands/dw-fix-qa.md

@@ -17,7 +17,6 @@ Você é um assistente IA especializado em correção de bugs pós-QA com retest
 
 Quando disponíveis no projeto em `./.agents/skills/`, use estas skills como suporte operacional sem substituir este comando:
 
-- `agent-browser`: suporte para reproduzir bugs com sessões persistentes, capturar dados de rede, screenshots adicionais e validar correções browser-first
 - `webapp-testing`: suporte para estruturar retestes, capturas e scripts quando complementar ao Playwright MCP
 - `vercel-react-best-practices`: use apenas se a correção afetar frontend React/Next.js e houver risco de regressão de renderização, hidratação, fetching ou performance
 
@@ -87,7 +86,7 @@ Para cada bug corrigido:
    - `QA/logs/console-retest.log`
    - `QA/logs/network-retest.log`
 7. Registrar no relatório de QA qual usuário/perfil foi usado no reteste
-8. Se o reteste exigir auth persistente, inspeção além do MCP, ou reprodução mais fiel em navegador real, complementar com `agent-browser` e registrar no relatório
+8. Se o reteste exigir auth persistente, inspeção além do MCP, ou reprodução mais fiel em navegador real, registrar no relatório
 
 ### 4. Atualização de Artefatos
 

package/scaffold/pt-br/commands/dw-functional-doc.md

@@ -49,7 +49,6 @@ Funciona melhor com projeto analisado por `/dw-analyze-project`
 
 Quando disponíveis no projeto em `./.agents/skills/`, use estas skills como apoio operacional, sem substituir este comando como fonte de verdade:
 
-- `agent-browser`: apoio para navegação real, inspeção de requests, screenshots, auth persistente e reprodução browser-first
 - `webapp-testing`: apoio para estruturar fluxos E2E, retestes locais e coleta de evidências
 - `remotion-best-practices`: apoio obrigatório quando houver vídeo humano final, legendas, composição, transições, FFmpeg ou Remotion
 - `humanizer`: apoio obrigatório para revisar e naturalizar todas as legendas, captions `.srt`, textos descritivos e qualquer redação voltada a leitura humana antes da entrega final

package/scaffold/pt-br/commands/dw-run-qa.md

@@ -20,7 +20,6 @@ Você é um assistente IA especializado em Quality Assurance. Sua tarefa é vali
 
 Quando disponíveis no projeto em `./.agents/skills/`, use estas skills como apoio operacional sem substituir este comando:
 
-- `agent-browser`: apoio para navegação operacional, auth persistente, screenshots adicionais, inspeção de requests e debugging de sessão
 - `webapp-testing`: apoio para estruturar fluxos de teste, retestes, screenshots e logs quando complementar ao Playwright MCP
 - `vercel-react-best-practices`: use apenas se o frontend sob teste for React/Next.js e houver indicação de regressão relacionada a renderização, fetching, hidratação ou performance percebida
 
@@ -96,7 +95,7 @@ Consulte `.dw/rules/` para URLs e frameworks específicos do projeto.
 - Verificar se a aplicação está rodando em localhost
 - Usar `browser_navigate` do Playwright MCP para acessar a aplicação
 - Confirmar que a página carregou corretamente com `browser_snapshot`
-- Se sessão persistente, import de auth, inspeção de rede além do MCP ou reprodução browser-first forem necessários, complementar com `agent-browser`
+- Se sessão persistente, import de auth, inspeção de rede além do MCP ou reprodução browser-first forem necessários, complementar com `webapp-testing`
 
 ### 3. Verificação de Páginas do Menu (Obrigatório — Executar ANTES dos testes de RF)
 
@@ -163,7 +162,7 @@ Para cada requisito funcional do PRD:
 8. Marcar como PASSOU ou FALHOU
 9. Salvar o script Playwright do fluxo em `{{PRD_PATH}}/QA/scripts/` com nome padronizado: `RF-XX-[slug].spec.ts` (ou `.js`)
 10. Registrar no relatório quais credenciais (usuário/perfil) foram usadas em cada fluxo sensível a permissões
-11. Quando o fluxo MCP ficar instável ou insuficiente para evidência operacional, complementar com `agent-browser` ou `webapp-testing`, registrando isso explicitamente no relatório
+11. Quando o fluxo MCP ficar instável ou insuficiente para evidência operacional, complementar com `webapp-testing`, registrando isso explicitamente no relatório
 
 <critical>Não basta validar apenas o caminho feliz. Cada requisito deve ser exercitado contra seus estados de borda e suas regressões mais prováveis</critical>
 <critical>Se um requisito não puder ser completamente validado via E2E, o QA deve ser marcado como REJEITADO ou BLOQUEADO, nunca APROVADO</critical>

package/scaffold/pt-br/commands/dw-run-task.md

@@ -20,7 +20,6 @@ Quando disponíveis no projeto em `./.agents/skills/`, use estas skills como sup
 |-------|---------|
 | `vercel-react-best-practices` | Task envolve renderização React, hidratação, data fetching, bundle, cache ou performance |
 | `webapp-testing` | Task tem frontend interativo que necessita validação E2E em navegador real |
-| `agent-browser` | Validação de UI requer sessão persistente, inspeção de navegação operacional ou evidência visual complementar |
 
 ## Localização dos Arquivos
 
@@ -78,7 +77,7 @@ Após fornecer o resumo e abordagem, **comece imediatamente** a implementar a ta
 - Seguir padrões estabelecidos do projeto
 - Garantir que todos os requisitos sejam atendidos
 - **Rodar testes**: use o comando de teste do projeto
-- Se houver frontend interativo, valide também o comportamento real com `webapp-testing` ou `agent-browser` quando isso reduzir o risco de regressão invisível nos testes unitários
+- Se houver frontend interativo, valide também o comportamento real com `webapp-testing` quando isso reduzir o risco de regressão invisível nos testes unitários
 
 **VOCÊ DEVE** iniciar a implementação logo após o processo acima.