bmad-visual 0.1.0

package/bin/bmad-visual.js

@@ -0,0 +1,255 @@
+#!/usr/bin/env node
+
+const fs = require('node:fs');
+const path = require('node:path');
+const { execSync } = require('node:child_process');
+
+// ─── ANSI Colors ───────────────────────────────────────────────
+const c = {
+  reset: '\x1b[0m',
+  bold: '\x1b[1m',
+  dim: '\x1b[2m',
+  green: '\x1b[32m',
+  cyan: '\x1b[36m',
+  yellow: '\x1b[33m',
+  red: '\x1b[31m',
+  magenta: '\x1b[35m',
+  white: '\x1b[37m',
+};
+
+const LOGO = `
+${c.green}  ┏━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━┓${c.reset}
+${c.green}  ┃${c.reset}  ${c.bold}${c.white}BMAD Visual${c.reset} ${c.dim}— AI Agent Dashboard${c.reset} ${c.green}┃${c.reset}
+${c.green}  ┗━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━┛${c.reset}
+`;
+
+function log(msg) {
+  console.log(`  ${c.green}>${c.reset} ${msg}`);
+}
+
+function success(msg) {
+  console.log(`  ${c.green}✓${c.reset} ${msg}`);
+}
+
+function warn(msg) {
+  console.log(`  ${c.yellow}!${c.reset} ${msg}`);
+}
+
+function error(msg) {
+  console.error(`  ${c.red}✗${c.reset} ${msg}`);
+}
+
+function step(n, total, msg) {
+  process.stdout.write(`  ${c.dim}[${n}/${total}]${c.reset} ${msg}...`);
+}
+
+function done() {
+  console.log(` ${c.green}done${c.reset}`);
+}
+
+// ─── Template Resolver ─────────────────────────────────────────
+function getTemplatesDir() {
+  const dir = path.resolve(__dirname, '..', 'templates');
+  if (!fs.existsSync(dir)) {
+    error('Templates directory not found. Try reinstalling: npm install -g bmad-visual');
+    process.exit(1);
+  }
+  return dir;
+}
+
+// ─── Copy Helper ───────────────────────────────────────────────
+function copyDir(src, dest) {
+  fs.cpSync(src, dest, { recursive: true });
+}
+
+function copyFile(src, dest) {
+  fs.mkdirSync(path.dirname(dest), { recursive: true });
+  fs.copyFileSync(src, dest);
+}
+
+// ─── Commands ──────────────────────────────────────────────────
+
+function handleInit(projectName) {
+  console.log(LOGO);
+
+  // Determine target directory
+  let targetDir;
+  if (projectName) {
+    targetDir = path.resolve(process.cwd(), projectName);
+    if (fs.existsSync(targetDir)) {
+      const entries = fs.readdirSync(targetDir);
+      if (entries.length > 0) {
+        error(`Directory "${projectName}" already exists and is not empty.`);
+        process.exit(1);
+      }
+    }
+    fs.mkdirSync(targetDir, { recursive: true });
+    log(`Creating project in ${c.cyan}${targetDir}${c.reset}`);
+  } else {
+    targetDir = process.cwd();
+    log(`Scaffolding into ${c.cyan}${targetDir}${c.reset}`);
+  }
+
+  const templatesDir = getTemplatesDir();
+  const totalSteps = 6;
+
+  console.log('');
+
+  // Step 1: Dashboard
+  step(1, totalSteps, 'Copying dashboard');
+  const dashSrc = path.join(templatesDir, 'dashboard');
+  const dashDest = path.join(targetDir, 'dashboard');
+  if (fs.existsSync(dashDest)) {
+    warn('dashboard/ already exists, overwriting...');
+  }
+  copyDir(dashSrc, dashDest);
+  done();
+
+  // Step 2: Squad definition
+  step(2, totalSteps, 'Copying BMAD squad & agents');
+  copyDir(
+    path.join(templatesDir, 'squads'),
+    path.join(targetDir, 'squads'),
+  );
+  done();
+
+  // Step 3: Claude Code skills
+  step(3, totalSteps, 'Copying Claude Code skills');
+  copyDir(
+    path.join(templatesDir, '.claude'),
+    path.join(targetDir, '.claude'),
+  );
+  done();
+
+  // Step 4: Antigravity workflows
+  step(4, totalSteps, 'Copying Antigravity workflows');
+  copyDir(
+    path.join(templatesDir, '.agent'),
+    path.join(targetDir, '.agent'),
+  );
+  done();
+
+  // Step 5: CLAUDE.md
+  step(5, totalSteps, 'Copying CLAUDE.md');
+  copyFile(
+    path.join(templatesDir, 'CLAUDE.md'),
+    path.join(targetDir, 'CLAUDE.md'),
+  );
+  done();
+
+  // Step 6: .gitignore
+  step(6, totalSteps, 'Updating .gitignore');
+  const gitignorePath = path.join(targetDir, '.gitignore');
+  const entries = [
+    '',
+    '# bmad-visual',
+    'dashboard/node_modules/',
+    'dashboard/dist/',
+    'squads/*/state.json',
+  ];
+  const entriesToAdd = entries.join('\n') + '\n';
+
+  if (fs.existsSync(gitignorePath)) {
+    const current = fs.readFileSync(gitignorePath, 'utf-8');
+    if (!current.includes('# bmad-visual')) {
+      fs.appendFileSync(gitignorePath, entriesToAdd);
+    }
+  } else {
+    fs.writeFileSync(gitignorePath, entriesToAdd.trimStart());
+  }
+  done();
+
+  // Install dependencies
+  console.log('');
+  log('Installing dashboard dependencies...');
+  try {
+    execSync('npm install', {
+      cwd: path.join(targetDir, 'dashboard'),
+      stdio: 'pipe',
+    });
+    success('Dependencies installed');
+  } catch {
+    warn('Could not auto-install. Run manually: cd dashboard && npm install');
+  }
+
+  // Done!
+  console.log('');
+  console.log(`  ${c.green}${c.bold}Done!${c.reset} Your BMAD Visual dashboard is ready.`);
+  console.log('');
+  console.log(`  ${c.dim}Next steps:${c.reset}`);
+  if (projectName) {
+    console.log(`    ${c.cyan}cd ${projectName}${c.reset}`);
+  }
+  console.log(`    ${c.cyan}bmad-visual dev${c.reset}    ${c.dim}Start the dashboard${c.reset}`);
+  console.log('');
+  console.log(`  ${c.dim}Available agents:${c.reset}`);
+  console.log(`    /analyst  /pm  /ux  /architect  /sm  /dev  /qa  /solo-dev  /bmad-help`);
+  console.log('');
+}
+
+function handleDev() {
+  const dashboardDir = path.join(process.cwd(), 'dashboard');
+
+  if (!fs.existsSync(path.join(dashboardDir, 'package.json'))) {
+    error('No dashboard found in this directory.');
+    log('Run "bmad-visual init" first to scaffold the project.');
+    process.exit(1);
+  }
+
+  // Check if node_modules exists
+  if (!fs.existsSync(path.join(dashboardDir, 'node_modules'))) {
+    log('Installing dependencies first...');
+    execSync('npm install', { cwd: dashboardDir, stdio: 'inherit' });
+  }
+
+  console.log(LOGO);
+  log(`Starting dashboard at ${c.cyan}http://localhost:5174${c.reset}`);
+  console.log('');
+
+  try {
+    execSync('npm run dev', { cwd: dashboardDir, stdio: 'inherit' });
+  } catch {
+    // User hit Ctrl+C
+  }
+}
+
+function showHelp() {
+  console.log(LOGO);
+  console.log(`  ${c.bold}Usage:${c.reset}`);
+  console.log('');
+  console.log(`    ${c.cyan}bmad-visual init${c.reset}            Scaffold into current directory`);
+  console.log(`    ${c.cyan}bmad-visual init ${c.dim}<name>${c.reset}      Create new project directory`);
+  console.log(`    ${c.cyan}bmad-visual dev${c.reset}             Start the dashboard dev server`);
+  console.log('');
+  console.log(`  ${c.bold}Agents:${c.reset}`);
+  console.log('');
+  console.log(`    ${c.green}/analyst${c.reset}    Mary      Market research & requirements`);
+  console.log(`    ${c.green}/pm${c.reset}         John      PRD, epics & stories`);
+  console.log(`    ${c.green}/ux${c.reset}         Sally     UX design & wireframes`);
+  console.log(`    ${c.green}/architect${c.reset}  Winston   System architecture`);
+  console.log(`    ${c.green}/sm${c.reset}         Bob       Sprint planning`);
+  console.log(`    ${c.green}/dev${c.reset}        Amelia    TDD implementation`);
+  console.log(`    ${c.green}/qa${c.reset}         Quinn     QA & testing`);
+  console.log(`    ${c.green}/solo-dev${c.reset}   Barry     Quick dev end-to-end`);
+  console.log(`    ${c.green}/bmad-help${c.reset}            Agent guide`);
+  console.log('');
+}
+
+// ─── Main ──────────────────────────────────────────────────────
+const args = process.argv.slice(2);
+const command = args[0];
+
+if (!command || command === '--help' || command === '-h') {
+  showHelp();
+} else if (command === 'init') {
+  handleInit(args[1]);
+} else if (command === 'dev') {
+  handleDev();
+} else if (command === '--version' || command === '-v') {
+  const pkg = require('../package.json');
+  console.log(pkg.version);
+} else {
+  error(`Unknown command: ${command}`);
+  showHelp();
+  process.exit(1);
+}

package/package.json

@@ -0,0 +1,31 @@
+{
+  "name": "bmad-visual",
+  "version": "0.1.0",
+  "description": "BMAD Method visual dashboard — AI agent squad with Phaser.js office",
+  "bin": {
+    "bmad-visual": "./bin/bmad-visual.js"
+  },
+  "files": [
+    "bin/",
+    "templates/"
+  ],
+  "scripts": {
+    "sync-templates": "node scripts/sync-templates.js",
+    "prepublishOnly": "node scripts/sync-templates.js"
+  },
+  "keywords": [
+    "bmad",
+    "bmad-method",
+    "ai-agents",
+    "dashboard",
+    "phaser",
+    "claude",
+    "multi-agent",
+    "visual-office"
+  ],
+  "author": "Manoel Neto",
+  "license": "MIT",
+  "engines": {
+    "node": ">=18"
+  }
+}

package/templates/.agent/workflows/analyst.md

@@ -0,0 +1,20 @@
+---
+description: BMAD Analyst — Mary. Market research, competitive analysis, brainstorming, product brief, and requirements.
+---
+
+## Dashboard Update (MANDATORY — do this FIRST)
+
+1. Read `squads/bmad/state.json`
+2. Set `"status": "running"` on the squad
+3. Find the agent with `"id": "analyst"` and set its `"status"` to `"working"`
+4. **If invoked WITHOUT arguments**: also set `"step"` to `{ "current": 0, "total": 12, "label": "intro" }`
+5. Set `"updatedAt"` to current ISO timestamp
+6. Write the updated `state.json` back
+
+Then read `.claude/skills/analyst/SKILL.md` and follow ALL instructions (skip the Dashboard Update section there since you already did it above).
+
+When your work is complete:
+1. Read `squads/bmad/state.json`
+2. Find the agent with `"id": "analyst"` and set its `"status"` to `"done"`
+3. Set `"updatedAt"` to current ISO timestamp
+4. Write the updated `state.json` back

package/templates/.agent/workflows/architect.md

@@ -0,0 +1,20 @@
+---
+description: BMAD Architect — Winston. System architecture, tech stack, ADRs, and implementation readiness.
+---
+
+## Dashboard Update (MANDATORY — do this FIRST)
+
+1. Read `squads/bmad/state.json`
+2. Set `"status": "running"` on the squad
+3. Find the agent with `"id": "architect"` and set its `"status"` to `"working"`
+4. **If invoked WITHOUT arguments**: also set `"step"` to `{ "current": 0, "total": 12, "label": "intro" }`
+5. Set `"updatedAt"` to current ISO timestamp
+6. Write the updated `state.json` back
+
+Then read `.claude/skills/architect/SKILL.md` and follow ALL instructions (skip the Dashboard Update section there since you already did it above).
+
+When your work is complete:
+1. Read `squads/bmad/state.json`
+2. Find the agent with `"id": "architect"` and set its `"status"` to `"done"`
+3. Set `"updatedAt"` to current ISO timestamp
+4. Write the updated `state.json` back

package/templates/.agent/workflows/bmad-advanced-elicitation.md

@@ -0,0 +1,5 @@
+---
+description: Push the LLM to reconsider and refine output. Use when user asks for deeper critique (socratic, first principles, pre-mortem, red team).
+---
+
+Read the file `.claude/skills/bmad-advanced-elicitation/SKILL.md` and follow ALL instructions.

package/templates/.agent/workflows/bmad-brainstorming.md

@@ -0,0 +1,5 @@
+---
+description: Facilitate interactive brainstorming sessions using diverse creative techniques. Use when the user says 'help me brainstorm' or 'help me ideate'.
+---
+
+Read the file `.claude/skills/bmad-brainstorming/SKILL.md` and follow ALL instructions.

package/templates/.agent/workflows/bmad-check-implementation-readiness.md

@@ -0,0 +1,5 @@
+---
+description: Validate PRD, UX, Architecture and Epics specs are complete for implementation. Use when the user says 'check implementation readiness'.
+---
+
+Read the file `.claude/skills/bmad-check-implementation-readiness/SKILL.md` and follow ALL instructions.

package/templates/.agent/workflows/bmad-checkpoint-preview.md

@@ -0,0 +1,5 @@
+---
+description: LLM-assisted human-in-the-loop review. Use when the user says 'checkpoint', 'human review', or 'walk me through this change'.
+---
+
+Read the file `.claude/skills/bmad-checkpoint-preview/SKILL.md` and follow ALL instructions.

package/templates/.agent/workflows/bmad-code-review.md

@@ -0,0 +1,5 @@
+---
+description: Adversarial code review using parallel review layers. Use when the user says 'run code review' or 'review this code'.
+---
+
+Read the file `.claude/skills/bmad-code-review/SKILL.md` and follow ALL instructions.

package/templates/.agent/workflows/bmad-correct-course.md

@@ -0,0 +1,5 @@
+---
+description: Manage significant changes during sprint execution. Use when the user says 'correct course' or 'propose sprint change'.
+---
+
+Read the file `.claude/skills/bmad-correct-course/SKILL.md` and follow ALL instructions.

package/templates/.agent/workflows/bmad-create-architecture.md

@@ -0,0 +1,5 @@
+---
+description: Create architecture solution design decisions. Use when the user says 'lets create architecture' or 'create technical architecture'.
+---
+
+Read the file `.claude/skills/bmad-create-architecture/SKILL.md` and follow ALL instructions.

package/templates/.agent/workflows/bmad-create-epics-and-stories.md

@@ -0,0 +1,5 @@
+---
+description: Break requirements into epics and user stories. Use when the user says 'create the epics and stories list'.
+---
+
+Read the file `.claude/skills/bmad-create-epics-and-stories/SKILL.md` and follow ALL instructions.

package/templates/.agent/workflows/bmad-create-prd.md

@@ -0,0 +1,5 @@
+---
+description: Create a PRD from scratch. Use when the user says 'lets create a product requirements document' or 'I want to create a new PRD'.
+---
+
+Read the file `.claude/skills/bmad-create-prd/SKILL.md` and follow ALL instructions.

package/templates/.agent/workflows/bmad-create-story.md

@@ -0,0 +1,5 @@
+---
+description: Create a dedicated story file with all context needed for implementation. Use when the user says 'create the next story' or 'create story [id]'.
+---
+
+Read the file `.claude/skills/bmad-create-story/SKILL.md` and follow ALL instructions.

package/templates/.agent/workflows/bmad-create-ux-design.md

@@ -0,0 +1,5 @@
+---
+description: Plan UX patterns and design specifications. Use when the user says 'lets create UX design' or 'create UX specifications'.
+---
+
+Read the file `.claude/skills/bmad-create-ux-design/SKILL.md` and follow ALL instructions.

package/templates/.agent/workflows/bmad-dev-story.md

@@ -0,0 +1,5 @@
+---
+description: Execute story implementation following a story spec file. Use when the user says 'dev this story' or 'implement the next story'.
+---
+
+Read the file `.claude/skills/bmad-dev-story/SKILL.md` and follow ALL instructions.

package/templates/.agent/workflows/bmad-distillator.md

@@ -0,0 +1,5 @@
+---
+description: Lossless LLM-optimized compression of source documents. Use when the user requests to 'distill documents' or 'create a distillate'.
+---
+
+Read the file `.claude/skills/bmad-distillator/SKILL.md` and follow ALL instructions.

package/templates/.agent/workflows/bmad-document-project.md

@@ -0,0 +1,5 @@
+---
+description: Document brownfield projects for AI context. Use when the user says 'document this project' or 'generate project docs'.
+---
+
+Read the file `.claude/skills/bmad-document-project/SKILL.md` and follow ALL instructions.

package/templates/.agent/workflows/bmad-domain-research.md

@@ -0,0 +1,5 @@
+---
+description: Conduct domain and industry research. Use when the user wants to do domain research for a topic or industry.
+---
+
+Read the file `.claude/skills/bmad-domain-research/SKILL.md` and follow ALL instructions.

package/templates/.agent/workflows/bmad-edit-prd.md

@@ -0,0 +1,5 @@
+---
+description: Edit an existing PRD. Use when the user says 'edit this PRD'.
+---
+
+Read the file `.claude/skills/bmad-edit-prd/SKILL.md` and follow ALL instructions.

package/templates/.agent/workflows/bmad-editorial-review-prose.md

@@ -0,0 +1,5 @@
+---
+description: Clinical copy-editor that reviews text for communication issues. Use when user says 'review for prose' or 'improve the prose'.
+---
+
+Read the file `.claude/skills/bmad-editorial-review-prose/SKILL.md` and follow ALL instructions.

package/templates/.agent/workflows/bmad-editorial-review-structure.md

@@ -0,0 +1,5 @@
+---
+description: Structural editor that proposes cuts, reorganization, and simplification. Use when user requests 'structural review' or 'editorial review of structure'.
+---
+
+Read the file `.claude/skills/bmad-editorial-review-structure/SKILL.md` and follow ALL instructions.

package/templates/.agent/workflows/bmad-generate-project-context.md

@@ -0,0 +1,5 @@
+---
+description: Create project-context.md with AI rules for the project. Use when the user says 'generate project context'.
+---
+
+Read the file `.claude/skills/bmad-generate-project-context/SKILL.md` and follow ALL instructions.

package/templates/.agent/workflows/bmad-help-full.md

@@ -0,0 +1,5 @@
+---
+description: Full BMAD workflow navigator. Analyzes current state and recommends the next skill to use.
+---
+
+Read the file `.claude/skills/bmad-help-full/SKILL.md` and follow ALL instructions.

package/templates/.agent/workflows/bmad-help.md

@@ -0,0 +1,5 @@
+---
+description: BMAD Help — Interactive guide to choose the right BMAD agent or workflow for your task.
+---
+
+Read the file `.claude/skills/bmad-help/SKILL.md` and follow ALL instructions exactly as written.

package/templates/.agent/workflows/bmad-index-docs.md

@@ -0,0 +1,5 @@
+---
+description: Generate or update an index.md to reference all docs in a folder. Use when user requests to create or update a file index.
+---
+
+Read the file `.claude/skills/bmad-index-docs/SKILL.md` and follow ALL instructions.

package/templates/.agent/workflows/bmad-market-research.md

@@ -0,0 +1,5 @@
+---
+description: Conduct market research on competition and customers. Use when the user says they need market research.
+---
+
+Read the file `.claude/skills/bmad-market-research/SKILL.md` and follow ALL instructions.

package/templates/.agent/workflows/bmad-party-mode.md

@@ -0,0 +1,5 @@
+---
+description: Orchestrate group discussions between BMAD agents. Use when user wants multiple agent perspectives or a roundtable discussion.
+---
+
+Read the file `.claude/skills/bmad-party-mode/SKILL.md` and follow ALL instructions.

package/templates/.agent/workflows/bmad-prfaq.md

@@ -0,0 +1,5 @@
+---
+description: Working Backwards PRFAQ challenge to forge product concepts. Use when the user requests to 'create a PRFAQ', 'work backwards', or 'run the PRFAQ challenge'.
+---
+
+Read the file `.claude/skills/bmad-prfaq/SKILL.md` and follow ALL instructions.

package/templates/.agent/workflows/bmad-product-brief.md

@@ -0,0 +1,5 @@
+---
+description: Create or update product briefs through guided or autonomous discovery. Use when the user requests to create or update a Product Brief.
+---
+
+Read the file `.claude/skills/bmad-product-brief/SKILL.md` and follow ALL instructions.

package/templates/.agent/workflows/bmad-qa-generate-e2e-tests.md

@@ -0,0 +1,5 @@
+---
+description: Generate end-to-end automated tests for existing features. Use when the user says 'create qa automated tests for [feature]'.
+---
+
+Read the file `.claude/skills/bmad-qa-generate-e2e-tests/SKILL.md` and follow ALL instructions.

package/templates/.agent/workflows/bmad-quick-dev.md

@@ -0,0 +1,5 @@
+---
+description: Implements any user intent following project conventions. Use when the user wants to build, fix, tweak, refactor, add or modify code.
+---
+
+Read the file `.claude/skills/bmad-quick-dev/SKILL.md` and follow ALL instructions.

package/templates/.agent/workflows/bmad-retrospective.md

@@ -0,0 +1,5 @@
+---
+description: Post-epic review to extract lessons and assess success. Use when the user says 'run a retrospective' or 'lets retro the epic'.
+---
+
+Read the file `.claude/skills/bmad-retrospective/SKILL.md` and follow ALL instructions.

package/templates/.agent/workflows/bmad-review-adversarial-general.md

@@ -0,0 +1,5 @@
+---
+description: Cynical adversarial review of any content. Use when the user requests a critical review.
+---
+
+Read the file `.claude/skills/bmad-review-adversarial-general/SKILL.md` and follow ALL instructions.

package/templates/.agent/workflows/bmad-review-edge-case-hunter.md

@@ -0,0 +1,5 @@
+---
+description: Exhaustive path enumeration to find unhandled edge cases. Use when you need edge-case analysis of code, specs, or diffs.
+---
+
+Read the file `.claude/skills/bmad-review-edge-case-hunter/SKILL.md` and follow ALL instructions.

package/templates/.agent/workflows/bmad-shard-doc.md

@@ -0,0 +1,5 @@
+---
+description: Split large markdown documents into smaller organized files. Use when the user says 'shard document' or needs to split a large doc.
+---
+
+Read the file `.claude/skills/bmad-shard-doc/SKILL.md` and follow ALL instructions.

package/templates/.agent/workflows/bmad-sprint-planning.md

@@ -0,0 +1,5 @@
+---
+description: Generate sprint plan from epics. Use when the user says 'run sprint planning' or 'generate sprint plan'.
+---
+
+Read the file `.claude/skills/bmad-sprint-planning/SKILL.md` and follow ALL instructions.

package/templates/.agent/workflows/bmad-sprint-status.md

@@ -0,0 +1,5 @@
+---
+description: Summarize sprint status and surface risks. Use when the user says 'check sprint status' or 'show sprint status'.
+---
+
+Read the file `.claude/skills/bmad-sprint-status/SKILL.md` and follow ALL instructions.

package/templates/.agent/workflows/bmad-technical-research.md

@@ -0,0 +1,5 @@
+---
+description: Conduct technical research on technologies and architecture. Use when the user would like to produce a technical research report.
+---
+
+Read the file `.claude/skills/bmad-technical-research/SKILL.md` and follow ALL instructions.

package/templates/.agent/workflows/bmad-validate-prd.md

@@ -0,0 +1,5 @@
+---
+description: Validate a PRD against standards. Use when the user says 'validate this PRD' or 'run PRD validation'.
+---
+
+Read the file `.claude/skills/bmad-validate-prd/SKILL.md` and follow ALL instructions.

package/templates/.agent/workflows/dev.md

@@ -0,0 +1,20 @@
+---
+description: BMAD Developer — Amelia. Dev story, TDD implementation, code review, strict adherence to specs.
+---
+
+## Dashboard Update (MANDATORY — do this FIRST)
+
+1. Read `squads/bmad/state.json`
+2. Set `"status": "running"` on the squad
+3. Find the agent with `"id": "developer"` and set its `"status"` to `"working"`
+4. **If invoked WITHOUT arguments**: also set `"step"` to `{ "current": 0, "total": 12, "label": "intro" }`
+5. Set `"updatedAt"` to current ISO timestamp
+6. Write the updated `state.json` back
+
+Then read `.claude/skills/dev/SKILL.md` and follow ALL instructions (skip the Dashboard Update section there since you already did it above).
+
+When your work is complete:
+1. Read `squads/bmad/state.json`
+2. Find the agent with `"id": "developer"` and set its `"status"` to `"done"`
+3. Set `"updatedAt"` to current ISO timestamp
+4. Write the updated `state.json` back

package/templates/.agent/workflows/pm.md

@@ -0,0 +1,20 @@
+---
+description: BMAD Product Manager — John. PRD creation, validation, epics, stories, and implementation readiness.
+---
+
+## Dashboard Update (MANDATORY — do this FIRST)
+
+1. Read `squads/bmad/state.json`
+2. Set `"status": "running"` on the squad
+3. Find the agent with `"id": "pm"` and set its `"status"` to `"working"`
+4. **If invoked WITHOUT arguments**: also set `"step"` to `{ "current": 0, "total": 12, "label": "intro" }`
+5. Set `"updatedAt"` to current ISO timestamp
+6. Write the updated `state.json` back
+
+Then read `.claude/skills/pm/SKILL.md` and follow ALL instructions (skip the Dashboard Update section there since you already did it above).
+
+When your work is complete:
+1. Read `squads/bmad/state.json`
+2. Find the agent with `"id": "pm"` and set its `"status"` to `"done"`
+3. Set `"updatedAt"` to current ISO timestamp
+4. Write the updated `state.json` back

package/templates/.agent/workflows/qa.md

@@ -0,0 +1,20 @@
+---
+description: BMAD QA Engineer — Quinn. BMAD QA validation, E2E tests, API tests, and coverage analysis.
+---
+
+## Dashboard Update (MANDATORY — do this FIRST)
+
+1. Read `squads/bmad/state.json`
+2. Set `"status": "running"` on the squad
+3. Find the agent with `"id": "qa-engineer"` and set its `"status"` to `"working"`
+4. **If invoked WITHOUT arguments**: also set `"step"` to `{ "current": 0, "total": 12, "label": "intro" }`
+5. Set `"updatedAt"` to current ISO timestamp
+6. Write the updated `state.json` back
+
+Then read `.claude/skills/qa/SKILL.md` and follow ALL instructions (skip the Dashboard Update section there since you already did it above).
+
+When your work is complete:
+1. Read `squads/bmad/state.json`
+2. Find the agent with `"id": "qa-engineer"` and set its `"status"` to `"done"`
+3. Set `"updatedAt"` to current ISO timestamp
+4. Write the updated `state.json` back