wizz-method 1.0.2 → 1.1.0

package/src/squads/traffic-masters/agents/traffic-chief.md

@@ -0,0 +1,97 @@
+# Traffic Chief
+
+> ACTIVATION-NOTICE: You are the Traffic Chief — orchestrator of the Traffic Masters Squad. You do NOT buy media or write ads. You DIAGNOSE traffic problems, ROUTE them to the correct specialist, and REVIEW their output. You think in platforms, funnels, metrics, and creative. Every traffic problem maps to a platform expert or functional specialist.
+
+## COMPLETE AGENT DEFINITION
+
+```yaml
+agent:
+  name: "Traffic Chief"
+  id: traffic-chief
+  title: "Traffic Masters Orchestrator"
+  icon: "🎯"
+  tier: 0
+  squad: traffic-masters
+  role: orchestrator
+
+persona:
+  role: "Traffic Problem Diagnostician & Squad Router"
+  identity: "The central nervous system of the Traffic Masters Squad. Fluent in all major ad platforms and traffic strategies. Diagnoses whether a traffic problem is platform-specific, creative-related, targeting-based, budget-driven, or funnel-connected. Routes to the right expert or specialist."
+  style: "Analytical, metric-driven, diagnostic. Gets to the root cause fast. Speaks in ROAS, CPA, CTR, and funnel stages."
+
+core_diagnostic:
+  step_1: "What's the ACTUAL problem? (Not enough traffic? Wrong traffic? Traffic that doesn't convert?)"
+  step_2: "Which platform(s)? (Facebook, Google, YouTube, TikTok, LinkedIn, multi-platform)"
+  step_3: "Where in the funnel? (Top = awareness/reach, Middle = consideration/clicks, Bottom = conversion)"
+  step_4: "What's the budget level? (<$1K/mo, $1K-$10K, $10K-$100K, $100K+)"
+  step_5: "Route to the right specialist."
+
+routing_logic:
+  platform_specific:
+    facebook_meta:
+      signals: ["Facebook ads", "Meta ads", "Instagram ads", "Reels ads"]
+      route_to: [molly-pittman, depesh-mandalia, ralph-burns]
+    youtube:
+      signals: ["YouTube ads", "pre-roll", "TrueView", "video ads on YouTube"]
+      route_to: tom-breeze
+    google:
+      signals: ["Google Ads", "Search ads", "Performance Max", "Shopping ads"]
+      route_to: kasim-aslam
+    brazil_latam:
+      signals: ["Brazilian market", "LATAM", "Portuguese-speaking", "gestor de trafego"]
+      route_to: pedro-sobral
+
+  function_specific:
+    creative_problem:
+      signals: ["ads not getting clicks", "creative fatigue", "need better ad creative", "low CTR"]
+      route_to: [ad-midas, creative-analyst]
+    scaling_problem:
+      signals: ["can't scale spend", "CPA increases with budget", "diminishing returns"]
+      route_to: [scale-optimizer, depesh-mandalia]
+    tracking_problem:
+      signals: ["attribution issues", "pixel not firing", "iOS tracking", "conversion tracking broken"]
+      route_to: pixel-specialist
+    analysis_problem:
+      signals: ["don't know what's working", "need audit", "can't read the data"]
+      route_to: [performance-analyst, ads-analyst]
+    budget_problem:
+      signals: ["budget allocation", "cashflow for ads", "ROAS targets", "profitability"]
+      route_to: fiscal
+    execution_problem:
+      signals: ["need someone to set up campaigns", "campaign structure", "media buying"]
+      route_to: media-buyer
+
+quality_review:
+  checks:
+    - "Is the offer validated before spending on ads?"
+    - "Is tracking properly set up?"
+    - "Are we testing creatives systematically?"
+    - "Is the CPA sustainable relative to LTV?"
+    - "Are we scaling profitably, not just spending more?"
+    - "Is there a clear funnel from click to conversion?"
+
+commands:
+  - name: diagnose
+    description: "Diagnose the traffic problem and recommend the right specialist"
+  - name: route
+    description: "Route a specific request to the correct traffic agent"
+  - name: review
+    description: "Review any traffic strategy for completeness"
+  - name: roster
+    description: "Show all 16 Traffic Masters agents and their specialties"
+  - name: metrics
+    description: "Quick metrics health check on any campaign"
+```
+
+---
+
+## How the Traffic Chief Routes
+
+1. **Listen to the problem.** What's actually happening with their traffic/ads?
+2. **Identify the platform.** Facebook? Google? YouTube? Multi-platform?
+3. **Identify the function.** Creative? Targeting? Scaling? Tracking? Budget?
+4. **Check the budget level.** Strategy differs at $1K/mo vs. $100K/mo.
+5. **Route to specialist.** Platform expert for strategy, functional agent for execution.
+6. **Review output.** Does it meet ROAS targets? Is it scalable?
+
+The Chief NEVER writes ads, buys media, or sets up campaigns. The Chief DIAGNOSES and ROUTES.

package/src/squads/traffic-masters/squad.yaml

@@ -0,0 +1,59 @@
+name: traffic-masters
+version: "1.0.0"
+short-title: "Traffic Masters"
+description: "Squad de 16 agentes especialistas em trafego pago. Facebook, YouTube, Google Ads, media buying, creative analysis, scaling, tracking."
+author: "Synkra AIOS"
+license: MIT
+slashPrefix: "traffic-masters"
+
+aios:
+  minVersion: "4.0.0"
+  type: squad
+
+tags:
+  - traffic
+  - ads
+  - facebook
+  - google
+  - youtube
+  - media-buying
+  - creative
+  - scaling
+  - tracking
+
+components:
+  agents:
+    - traffic-chief.md
+    - molly-pittman.md
+    - ralph-burns.md
+    - depesh-mandalia.md
+    - nicholas-kusmich.md
+    - tom-breeze.md
+    - kasim-aslam.md
+    - pedro-sobral.md
+    - ad-midas.md
+    - media-buyer.md
+    - performance-analyst.md
+    - creative-analyst.md
+    - scale-optimizer.md
+    - pixel-specialist.md
+    - ads-analyst.md
+    - fiscal.md
+  tasks:
+    - analyze-performance.md
+    - audit-ad-account.md
+    - create-ad-creative.md
+    - create-ad-strategy.md
+    - diagnose.md
+    - manage-budget.md
+    - review.md
+    - scale-campaign.md
+    - setup-tracking.md
+  workflows:
+    - wf-account-audit.yaml
+    - wf-campaign-launch.yaml
+  checklists:
+    - output-quality.md
+
+config:
+  extends: extend

package/tools/bundle-web-bundles.js

@@ -109,7 +109,7 @@ function main() {
   console.log('\nNext step — create or update the GitHub Release:\n');
   console.log(`  gh release create ${releaseTag} dist/web-bundles/*.zip \\`);
   console.log(`    --title "${releaseTag}" \\`);
-  console.log(`    --notes "BMad web bundles for Gemini Gems and ChatGPT Custom GPTs. See https://bmadcode.com/web-bundles/"\n`);
+  console.log(`    --notes "Wizz web bundles for Gemini Gems and ChatGPT Custom GPTs. See https://bmadcode.com/web-bundles/"\n`);
   console.log('Or, to refresh an existing release:\n');
   console.log(`  gh release upload ${releaseTag} dist/web-bundles/*.zip --clobber\n`);
 }

package/tools/format-workflow-md.js

@@ -1,5 +1,5 @@
 /**
- * BMAD Workflow Markdown Formatter
+ * WIZZ Workflow Markdown Formatter
  *
  * Formats mixed markdown + XML workflow instruction files with:
  * - 2-space XML indentation
@@ -195,7 +195,7 @@ function main() {
 
   if (args.length === 0 || args.includes('--help') || args.includes('-h')) {
     console.log(`
-BMAD Workflow Markdown Formatter
+WIZZ Workflow Markdown Formatter
 
 Usage:
   node format-workflow-md.js <file-pattern> [options]

package/tools/installer/commands/install.js

@@ -18,6 +18,18 @@ module.exports = {
       'Comma-separated list of tool/IDE IDs to configure (e.g., "claude-code,cursor"). Required for fresh non-interactive (--yes) installs. Run with --list-tools to see all valid IDs.',
     ],
     ['--list-tools', 'Print all supported tool/IDE IDs (with target directories) and exit.'],
+    [
+      '--areas <areas>',
+      'Comma-separated global-skill areas to install (e.g. "designer,copy,ads"), or "all". Only applies when the wizz module is selected. Default interactive prompt.',
+    ],
+    [
+      '--mcps <mcps>',
+      'Comma-separated MCP ids to write to .mcp.json for the chosen areas, "all", or "none". Unlisted ones are recommended as `claude mcp add` commands. Only with the wizz module.',
+    ],
+    [
+      '--clis <clis>',
+      'Comma-separated CLI ids to install for the chosen areas (e.g. "agent-browser,rtk"), "all", or "none". Already-installed ones are skipped; unlisted ones are recommended. Only with the wizz module.',
+    ],
     [
       '--set <spec>',
       'Set a module config option non-interactively. Spec format: <module>.<key>=<value> (e.g. bmm.project_knowledge=research). Repeatable. Run --list-options to see available keys.',
@@ -80,7 +92,7 @@ module.exports = {
 
       // Set debug flag as environment variable for all components
       if (options.debug) {
-        process.env.BMAD_DEBUG_MANIFEST = 'true';
+        process.env.WIZZ_DEBUG_MANIFEST = 'true';
         await prompts.log.info('Debug mode enabled');
       }
 

package/tools/installer/commands/status.js

@@ -14,22 +14,22 @@ module.exports = {
   options: [],
   action: async (options) => {
     try {
-      // Find the bmad directory
+      // Find the wizz directory
       const projectDir = process.cwd();
-      const { bmadDir } = await installer.findBmadDir(projectDir);
+      const { wizzDir } = await installer.findWizzDir(projectDir);
 
-      // Check if bmad directory exists
+      // Check if wizz directory exists
       const fs = require('../fs-native');
-      if (!(await fs.pathExists(bmadDir))) {
+      if (!(await fs.pathExists(wizzDir))) {
         await prompts.log.warn('No Wizz installation found in the current directory.');
-        await prompts.log.message(`Expected location: ${bmadDir}`);
+        await prompts.log.message(`Expected location: ${wizzDir}`);
         await prompts.log.message('Run "wizz install" to set up a new installation.');
         process.exit(0);
         return;
       }
 
       // Read manifest
-      const manifestData = await manifest._readRaw(bmadDir);
+      const manifestData = await manifest._readRaw(wizzDir);
 
       if (!manifestData) {
         await prompts.log.warn('No Wizz installation manifest found.');
@@ -43,20 +43,20 @@ module.exports = {
       const modules = manifestData.modules || [];
 
       // Check for available updates (only for external modules)
-      const availableUpdates = await manifest.checkForUpdates(bmadDir);
+      const availableUpdates = await manifest.checkForUpdates(wizzDir);
 
       // Display status
       await ui.displayStatus({
         installation,
         modules,
         availableUpdates,
-        bmadDir,
+        wizzDir,
       });
 
       process.exit(0);
     } catch (error) {
       await prompts.log.error(`Status check failed: ${error.message}`);
-      if (process.env.BMAD_DEBUG) {
+      if (process.env.WIZZ_DEBUG) {
         await prompts.log.message(error.stack);
       }
       process.exit(1);

package/tools/installer/commands/uninstall.js

@@ -54,9 +54,9 @@ module.exports = {
         process.exit(1);
       }
 
-      const { bmadDir } = await installer.findBmadDir(projectDir);
+      const { wizzDir } = await installer.findWizzDir(projectDir);
 
-      if (!(await fs.pathExists(bmadDir))) {
+      if (!(await fs.pathExists(wizzDir))) {
         await prompts.log.warn('No Wizz installation found.');
         process.exit(0);
       }
@@ -82,7 +82,7 @@ module.exports = {
           options: [
             {
               value: 'modules',
-              label: `Wizz Modules & data (${installer.bmadFolderName}/)`,
+              label: `Wizz Modules & data (${installer.wizzFolderName}/)`,
               hint: 'Core installation, agents, workflows, config',
             },
             { value: 'ide', label: 'IDE integrations', hint: ides || 'No IDEs configured' },
@@ -133,10 +133,10 @@ module.exports = {
         s.stop('User artifacts removed');
       }
 
-      // Phase 3: BMAD modules & data (last — other phases may need _wizz/)
+      // Phase 3: WIZZ modules & data (last — other phases may need _wizz/)
       if (removeModules) {
         const s = await prompts.spinner();
-        s.start(`Removing Wizz modules & data (${installer.bmadFolderName}/)...`);
+        s.start(`Removing Wizz modules & data (${installer.wizzFolderName}/)...`);
         await installer.uninstallModules(projectDir);
         s.stop('Modules & data removed');
       }

package/tools/installer/core/config.js

@@ -7,6 +7,9 @@ class Config {
     directory,
     modules,
     ides,
+    selectedAreas,
+    mcpPlan,
+    cliPlan,
     skipPrompts,
     verbose,
     actionType,
@@ -19,6 +22,20 @@ class Config {
     this.directory = directory;
     this.modules = Object.freeze([...modules]);
     this.ides = Object.freeze([...ides]);
+    // Global-skills areas the user chose to install (from skills-registry.yaml).
+    // Empty means "all areas" when skills-lib is installed; see installSkillsLib.
+    this.selectedAreas = Object.freeze([...(selectedAreas || [])]);
+    // MCP plan resolved from the registry for the chosen areas:
+    //   toWrite     — merged into the project .mcp.json (placeholder secrets)
+    //   toRecommend — printed as `claude mcp add ...` for the user to run later
+    // Empty/absent on quick-update or non-wizz installs. See modules/mcp-config.js.
+    this.mcpPlan = mcpPlan || { toWrite: [], toRecommend: [] };
+    // CLI plan resolved from the registry for the chosen areas:
+    //   toInstall        — `install` command run during the install (opt-in)
+    //   toRecommend      — printed for the user to run later
+    //   alreadyInstalled — detected on PATH, reported and skipped
+    // Empty/absent on quick-update or non-wizz installs. See modules/cli-config.js.
+    this.cliPlan = cliPlan || { toInstall: [], toRecommend: [], alreadyInstalled: [] };
     this.skipPrompts = skipPrompts;
     this.verbose = verbose;
     this.actionType = actionType;
@@ -50,6 +67,9 @@ class Config {
       directory: userInput.directory,
       modules,
       ides: userInput.skipIde ? [] : [...(userInput.ides || [])],
+      selectedAreas: userInput.selectedAreas || [],
+      mcpPlan: userInput.mcpPlan || { toWrite: [], toRecommend: [] },
+      cliPlan: userInput.cliPlan || { toInstall: [], toRecommend: [], alreadyInstalled: [] },
       skipPrompts: userInput.skipPrompts || false,
       verbose: userInput.verbose || false,
       actionType: userInput.actionType,

package/tools/installer/core/existing-install.js

@@ -4,7 +4,7 @@ const yaml = require('yaml');
 const { Manifest } = require('./manifest');
 
 /**
- * Immutable snapshot of an existing BMAD installation.
+ * Immutable snapshot of an existing WIZZ installation.
  * Pure query object — no filesystem operations after construction.
  */
 class ExistingInstall {
@@ -38,12 +38,12 @@ class ExistingInstall {
   }
 
   /**
-   * Scan a bmad directory and return an immutable snapshot of what's installed.
-   * @param {string} bmadDir - Path to bmad directory
+   * Scan a wizz directory and return an immutable snapshot of what's installed.
+   * @param {string} wizzDir - Path to wizz directory
    * @returns {Promise<ExistingInstall>}
    */
-  static async detect(bmadDir) {
-    if (!(await fs.pathExists(bmadDir))) {
+  static async detect(wizzDir) {
+    if (!(await fs.pathExists(wizzDir))) {
       return ExistingInstall.empty();
     }
 
@@ -53,7 +53,7 @@ class ExistingInstall {
     let ides = [];
 
     const manifest = new Manifest();
-    const manifestData = await manifest.read(bmadDir);
+    const manifestData = await manifest.read(wizzDir);
     if (manifestData) {
       version = manifestData.version;
       if (manifestData.ides) {
@@ -61,7 +61,7 @@ class ExistingInstall {
       }
     }
 
-    const corePath = path.join(bmadDir, 'core');
+    const corePath = path.join(wizzDir, 'core');
     if (await fs.pathExists(corePath)) {
       hasCore = true;
 
@@ -83,7 +83,7 @@ class ExistingInstall {
 
     if (manifestData && manifestData.modules && manifestData.modules.length > 0) {
       for (const moduleId of manifestData.modules) {
-        const modulePath = path.join(bmadDir, moduleId);
+        const modulePath = path.join(wizzDir, moduleId);
         const moduleConfigPath = path.join(modulePath, 'config.yaml');
 
         const moduleInfo = {

package/tools/installer/core/install-paths.js

@@ -1,7 +1,7 @@
 const path = require('node:path');
 const fs = require('../fs-native');
 const { getProjectRoot } = require('../project-root');
-const { BMAD_FOLDER_NAME } = require('../ide/shared/path-utils');
+const { WIZZ_FOLDER_NAME } = require('../ide/shared/path-utils');
 
 class InstallPaths {
   static async create(config) {
@@ -15,16 +15,16 @@ class InstallPaths {
     const projectRoot = path.resolve(config.directory);
     await ensureWritableDir(projectRoot, 'project root');
 
-    const bmadDir = path.join(projectRoot, BMAD_FOLDER_NAME);
-    const isUpdate = await fs.pathExists(bmadDir);
+    const wizzDir = path.join(projectRoot, WIZZ_FOLDER_NAME);
+    const isUpdate = await fs.pathExists(wizzDir);
 
-    const configDir = path.join(bmadDir, '_config');
-    const coreDir = path.join(bmadDir, 'core');
-    const scriptsDir = path.join(bmadDir, 'scripts');
-    const customDir = path.join(bmadDir, 'custom');
+    const configDir = path.join(wizzDir, '_config');
+    const coreDir = path.join(wizzDir, 'core');
+    const scriptsDir = path.join(wizzDir, 'scripts');
+    const customDir = path.join(wizzDir, 'custom');
 
     for (const [dir, label] of [
-      [bmadDir, 'bmad directory'],
+      [wizzDir, 'wizz directory'],
       [configDir, 'config directory'],
       [coreDir, 'core module directory'],
       [scriptsDir, 'shared scripts directory'],
@@ -37,7 +37,7 @@ class InstallPaths {
       srcDir,
       version,
       projectRoot,
-      bmadDir,
+      wizzDir,
       configDir,
       coreDir,
       scriptsDir,
@@ -55,10 +55,10 @@ class InstallPaths {
     return path.join(this.configDir, 'manifest.yaml');
   }
   centralConfig() {
-    return path.join(this.bmadDir, 'config.toml');
+    return path.join(this.wizzDir, 'config.toml');
   }
   centralUserConfig() {
-    return path.join(this.bmadDir, 'config.user.toml');
+    return path.join(this.wizzDir, 'config.user.toml');
   }
   filesManifest() {
     return path.join(this.configDir, 'files-manifest.csv');
@@ -67,10 +67,10 @@ class InstallPaths {
     return path.join(this.configDir, 'wizz-help.csv');
   }
   moduleDir(name) {
-    return path.join(this.bmadDir, name);
+    return path.join(this.wizzDir, name);
   }
   moduleConfig(name) {
-    return path.join(this.bmadDir, name, 'config.yaml');
+    return path.join(this.wizzDir, name, 'config.yaml');
   }
 }